mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
ec601ca13d
Machine-produced by `pnpm run rescope-vendor --apply` plus the regeneration it prints: `pnpm install` for the lockfile, `pnpm run gen-third-party-notices`, `verify-translation-pairing --write` for the touched bilingual pairs, `gen-doc-graphs`, and one typert snapshot whose ids embed character offsets. `pnpm run rescope-vendor --check` verifies the result. Renames nine vendored packages (cordis, cosmokit, schemastery and the six @cordisjs plugins) and every reference that resolves them: manifest names and dependency keys, module specifiers including declare-module merges, cordis.yml plugin names, tsconfig paths, every Markdown fence, and `docs/` prose. Directory names, upstream versions, and dependency ranges are unchanged, so vendor/README.md still reads as an upstream snapshot; its manifest table gains an upstream-name column so THIRD_PARTY_NOTICES keeps MIT attribution pointed at each fork's origin. The tutorial tier follows the rename end to end: its yaml fences named plugins the Loader can no longer resolve, its `ts ignore-check` fences disagreed with the compiled fences beside them, and its prose quoted both. The contracts that told readers to keep upstream names — the root convention and the vendoring cookbook's tree comment and manifest invariant — now say to rescope instead. Two rules read `@deepseek-ai/` as "another workspace plugin": the client bundle purity gate now names the vendored libraries a browser bundle inlines, and the files where a bare `cordis` is an agent-preset id keep that product data.
66 lines
2.3 KiB
TypeScript
66 lines
2.3 KiB
TypeScript
/**
|
|
* `LocalSpillStore`: the host-filesystem implementation of the
|
|
* `@deepseek-ai/dsh-spill` storage seam. Persists a tool's oversized text to a
|
|
* private, session-scoped file (see `./store.ts` for the traversal-safe naming
|
|
* and exclusive owner-only write) and returns a path locator plus local
|
|
* read/grep retrieval guidance.
|
|
*
|
|
* @module @deepseek-ai/dsh-spill-local
|
|
*/
|
|
|
|
import { Context } from '@deepseek-ai/cordis'
|
|
import { resolve } from 'node:path'
|
|
import z from '@deepseek-ai/schemastery'
|
|
import { SpillLocator, SpillStore } from '@deepseek-ai/dsh-spill'
|
|
import type { SaveTextSpill, SpillRef } from '@deepseek-ai/dsh-spill'
|
|
import { privateRoot, saveTextFile } from './store.ts'
|
|
|
|
export { encodeSegment, privateRoot, saveTextFile, sessionDir } from './store.ts'
|
|
export type { SavedText, SaveTextOptions } from './store.ts'
|
|
|
|
/** Plugin config (all optional — `static Config` supplies the defaults). */
|
|
export interface Config {
|
|
/**
|
|
* Root directory for spill files. Omitted uses a lazily-created private
|
|
* (0700) per-process directory under the OS temp dir — the safe default for
|
|
* a local deployment. Set it to keep spill files under a known location.
|
|
*/
|
|
root?: string
|
|
}
|
|
|
|
/**
|
|
* Local-filesystem spill backend. Files land under `<root>/session-<hash>/…`
|
|
* with unpredictable names, an exclusive owner-only (0600) write, and a private
|
|
* (0700) root — a spilled tool result must not be readable by other local users
|
|
* or redirectable via a planted symlink.
|
|
*/
|
|
export class LocalSpillStore extends SpillStore {
|
|
static Config: z<Config> = z.object({
|
|
root: z.string(),
|
|
})
|
|
|
|
/** Resolved absolute spill root (config `root`, else the private default), fixed at construction. */
|
|
readonly root: string
|
|
|
|
constructor(ctx: Context, config: Config) {
|
|
super(ctx)
|
|
this.root = config.root !== undefined ? resolve(config.root) : privateRoot()
|
|
}
|
|
|
|
async saveText(input: SaveTextSpill): Promise<SpillRef> {
|
|
const saved = await saveTextFile({
|
|
root: this.root,
|
|
sessionId: input.owner.sessionId,
|
|
suggestedName: input.suggestedName,
|
|
content: input.content,
|
|
})
|
|
return {
|
|
locator: SpillLocator(saved.path),
|
|
bytes: saved.bytes,
|
|
retrievalHint: 'Use read with offset/limit, or grep this path to search within it.',
|
|
}
|
|
}
|
|
}
|
|
|
|
export default LocalSpillStore
|