@ai-ecoverse/slicc-agent 7.13.4 → 7.14.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -66,7 +66,7 @@ const agent = await openAgent({ models, model, storage, registry, env: kernelEnv
66
66
  - **Timeouts and aborts** kill only that command: its descendants are read from `ps()` first, then all are killed together with it, so a background job the agent started earlier keeps running. A process forked in the instant between that snapshot and the kill can slip through; it ends when the agent's groups are stopped;
67
67
  - output past the spill limits goes to `/tmp/slicc-agent-output-*.log`;
68
68
  - files and directories go through the kernel's OPFS view and metadata sidecar;
69
- - `watch()` uses the kernel client's own `fs.watch` (slicc-kernel protocol 1.1), so a change made through the kernel by any process or client is reported in the same task. A watched path whose parent is renamed or replaced counts as changed, and a watched symbolic link also reports changes to its target. Writers that bypass the kernel, such as spectrum's Files panel writing OPFS directly, are caught by a rescan every 2 s (`watch: { rescanMs }`). On a kernel without `fs.watch` (`ENOSYS`), or for a target that doesn't exist yet, it polls every 100 ms instead; `watch: { mode: 'polling' }` forces that.
69
+ - `watch()` uses the kernel client's own `fs.watch` (slicc-kernel protocol 1.1), so a change made through the kernel by any process or client is reported in the same task. A watched path whose parent is renamed or replaced counts as changed, and a watched symbolic link also reports changes to its target. The kernel's watches are on names, so a target that doesn't exist yet is watched natively like any other and its creation is reported; the rest of its group isn't affected. A target under a symlinked directory is also watched at its real path (for a missing target, the real path of its nearest existing directory with the rest after it), and that is resolved again when the target or a directory above it changes. A missing target the client may not reach (`EACCES` under `users`) is left to the rescan, which retries its watch once it shows up. Writers that bypass the kernel, such as spectrum's Files panel writing OPFS directly, are caught by a rescan: every 2 s for a single file or directory (`watch: { rescanMs }`), and every 30 s for a recursive target (`watch: { deepRescanMs }`), at least 50 times the last rescan's duration later. On a kernel whose client watches also hear other kernels on the root and `postFsNotice` (it has `/proc/sys/kernel/slicc_meta_transactions`, read once per client with `cat`, and that shows shared metadata), recursive targets aren't rescanned at all unless `deepRescanMs` is set, so a writer outside the kernel has to post `postFsNotice` to be heard there. Only a kernel without `fs.watch` (`ENOSYS`) makes the whole watch poll; `watch: { mode: 'polling' }` forces that. Polling starts the next scan `intervalMs` after the last one finished (by default 2 s when a target is recursive, 500 ms otherwise), and at least 10 times the last scan's duration later. Scans never overlap or queue up: all watches of the worker take turns, one scan at a time, and each watch has at most one waiting.
70
70
 
71
71
  A conversation without a `cwd` works in `/home`.
72
72
 
@@ -255,7 +255,9 @@ function wasmCandidates(from) {
255
255
  async function locateWasm(fetcher, from) {
256
256
  for (const url of wasmCandidates(from)) {
257
257
  const response = await fetcher(url).catch(() => void 0);
258
- if (response?.ok) return WebAssembly.compile(await response.arrayBuffer());
258
+ if (!response?.ok) continue;
259
+ const module = await response.arrayBuffer().then((bytes) => WebAssembly.compile(bytes)).catch(() => void 0);
260
+ if (module) return module;
259
261
  }
260
262
  return void 0;
261
263
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/codemode/index.ts"],
4
- "sourcesContent": ["import type { Context, JsonValue } from '@earendil-works/chord';\nimport { withAbortSignal } from '@earendil-works/chord/context';\nimport {\n type CodemodeError,\n type CodemodeJsonSchema,\n type CodemodeOutputItem,\n type CodemodeResult,\n type CodemodeRun,\n type CodemodeRunOptions,\n CodemodeSandbox,\n type CodemodeSandboxOptions,\n type CodemodeTool,\n loadQuickJSWasm,\n parseCodemodeSource,\n renderDeclarations,\n} from '@earendil-works/pi-codemode';\nimport {\n type Agent,\n defineDoc,\n defineExtension,\n defineTool,\n type Extension,\n type JsonObject,\n type NestedToolExecutionResult,\n type ToolExecutionApi,\n type ToolRegistration,\n} from '@earendil-works/pi-durable';\nimport { obj, str } from '@earendil-works/pi-schema';\nimport { boundedDeltas } from '../checkpoints.ts';\nimport { scrubItems } from '../secrets/scrub.ts';\n\nexport const CODEMODE = 'codemode';\nexport const DEFAULT_MAX_OUTPUT_TOKENS = 10_000;\nexport const MEMORY_LIMIT_BYTES = 256 * 1024 * 1024;\nconst CHARS_PER_TOKEN = 4;\n\nexport const CodemodeDoc = defineDoc<{ store: Record<string, JsonValue> }>({\n kind: 'slicc.codemode',\n checkpointWhen: boundedDeltas,\n version: 1,\n scope: 'conversation',\n history: 'rewindable',\n fork: 'asOf',\n initial: () => ({ store: {} }),\n});\n\nexport interface Sandbox {\n execute(\n code: string,\n options: { signal?: AbortSignal; store?: Record<string, unknown> }\n ): Promise<CodemodeResult>;\n start(code: string, options: CodemodeRunOptions): CodemodeRun;\n close(): Promise<void>;\n}\n\nexport type SandboxFactory = (options: CodemodeSandboxOptions) => Sandbox;\n\nexport interface CodemodeExtra {\n tools: CodemodeTool[];\n globals: CodemodeTool[];\n}\n\nexport interface CodemodeOptions {\n sandbox: SandboxFactory;\n declared: readonly ToolRegistration[];\n extra?: (api: ToolExecutionApi, agent: Agent, context: Context) => Promise<CodemodeExtra>;\n}\n\nconst INTRO = `Run JavaScript that calls other tools. The input is raw JavaScript (not JSON, no code fence), run as an async function body in a QuickJS sandbox: top-level \\`await\\` and \\`return\\` work. No Node, file system, network, or timers.\n- \\`await tools.<name>({ ...args })\\` resolves to a string, or an object if the tool's declaration says so, and rejects with an Error on failure. Calls still running when the script ends are cancelled.\n- Optional first line: \\`// @options: {\"max_output_tokens\": 10000, \"timeout_ms\": 60000}\\``;\n\nconst GLOBALS = [\n 'Globals:',\n '- `text(value)`, `image(dataUrlOrImageBlock)`, `console.log(...)`, and top-level `return` add output; `exit()` ends the script. With several text items, each starts with a `==> text N/M <==` line, and `console` lines follow the other output in one `<console_output>` block.',\n '- `store(key, value)` and `load(key)` keep JSON values across codemode calls in this conversation.',\n '- `ALL_TOOLS` lists every tool scripts can call.',\n].join('\\n');\n\nconst DISCOVERY =\n '- `await searchTools(query, { limit?, namespace? })`, `await describeTool(name)`, `await describeNamespace(name)`: find unlisted tools, such as MCP tools.';\n\nconst BASH_OUTPUT: CodemodeJsonSchema = {\n type: 'object',\n properties: {\n output: { type: 'string' },\n exit_code: { type: 'number' },\n truncated: { type: 'boolean' },\n full_output_path: { type: 'string' },\n },\n required: ['output', 'exit_code'],\n};\n\nfunction scriptTool(tool: ToolRegistration): Omit<CodemodeTool, 'execute'> {\n return {\n name: tool.name,\n description: tool.description,\n inputSchema: tool.parameters as CodemodeJsonSchema,\n ...(tool.name === 'bash' ? { outputSchema: BASH_OUTPUT } : {}),\n };\n}\n\nexport function codemodeDescription(\n declared: readonly ToolRegistration[],\n discovery = false\n): string {\n const tools = declared\n .filter((tool) => tool.name !== CODEMODE)\n .map((tool) => ({ ...scriptTool(tool), execute: () => undefined }));\n const sections = [INTRO, discovery ? `${GLOBALS}\\n${DISCOVERY}` : GLOBALS];\n if (tools.length) sections.push(`Nested tools:\\n${renderDeclarations({ tools })}`);\n return sections.join('\\n\\n');\n}\n\nfunction textOf(value: unknown): string {\n if (typeof value === 'string') return value;\n if (!Array.isArray(value)) return '';\n return value\n .filter((part) => part?.type === 'text')\n .map((part) => part.text)\n .join('\\n');\n}\n\nfunction errorOf(result: NestedToolExecutionResult): string {\n const errors = result.diagnostics\n .filter((diagnostic) => diagnostic.severity === 'error')\n .map((diagnostic) => diagnostic.message);\n return [textOf(result.structuredOutput), ...errors].filter(Boolean).join('\\n');\n}\n\ninterface ShellOutput {\n output: string;\n exitCode: number;\n truncated?: boolean;\n fullOutputPath?: string;\n}\n\nfunction shellOutput(value: unknown): ShellOutput | undefined {\n const shell = value as Partial<ShellOutput> | undefined;\n return typeof shell?.output === 'string' && typeof shell.exitCode === 'number'\n ? (shell as ShellOutput)\n : undefined;\n}\n\nexport async function callNested(\n name: string,\n args: unknown,\n api: ToolExecutionApi,\n context: Context\n): Promise<unknown> {\n const result = await api.executeTool(name, (args ?? {}) as JsonObject, context);\n const shell = name === 'bash' ? shellOutput(result.structuredOutput) : undefined;\n if (shell)\n return {\n output: shell.output,\n exit_code: shell.exitCode,\n ...(shell.truncated ? { truncated: true } : {}),\n ...(shell.fullOutputPath ? { full_output_path: shell.fullOutputPath } : {}),\n };\n if (result.isError) throw new Error(errorOf(result) || `Tool \"${name}\" failed`);\n return textOf(result.structuredOutput);\n}\n\nfunction valueText(value: unknown): string {\n return typeof value === 'string' ? value : (JSON.stringify(value) ?? String(value));\n}\n\nexport function formatOutput(output: readonly CodemodeOutputItem[]): CodemodeOutputItem[] {\n const total = output.filter((item) => item.type === 'text' && !item.console).length;\n const items: CodemodeOutputItem[] = [];\n const lines: string[] = [];\n let index = 0;\n for (const item of output) {\n if (item.type === 'image') items.push(item);\n else if (item.console) lines.push(item.text);\n else {\n index++;\n items.push({\n type: 'text',\n text: total > 1 ? `==> text ${index}/${total} <==\\n${item.text}` : item.text,\n });\n }\n }\n if (lines.length)\n items.push({ type: 'text', text: `<console_output>\\n${lines.join('\\n')}\\n</console_output>` });\n return items;\n}\n\nexport function joinText(items: readonly CodemodeOutputItem[]): CodemodeOutputItem[] {\n const joined: CodemodeOutputItem[] = [];\n for (const item of items) {\n const last = joined.at(-1);\n if (item.type === 'text' && last?.type === 'text') {\n const separator = last.text === '' || last.text.endsWith('\\n') ? '' : '\\n';\n joined[joined.length - 1] = { type: 'text', text: `${last.text}${separator}${item.text}` };\n } else joined.push(item);\n }\n return joined;\n}\n\nexport function formatError(error: CodemodeError, calls: CodemodeResult['calls']): string {\n const heads: Record<string, string> = {\n timeout: `Script timed out: ${error.message}`,\n aborted: `Script aborted: ${error.message}`,\n sandbox: `Script sandbox failed: ${error.message}`,\n };\n const head =\n error.kind === 'script'\n ? (error.stack ?? `${error.name ?? 'Error'}: ${error.message}`)\n : heads[error.kind];\n const summary = calls.length\n ? `Tool calls made before the failure (they are not undone): ${calls.map((call) => `${call.name} (${call.status})`).join(', ')}`\n : 'No tool calls were made.';\n return `${head}\\n\\n${summary}`;\n}\n\nexport function truncate(\n items: readonly CodemodeOutputItem[],\n maxTokens: number\n): { items: CodemodeOutputItem[]; full: string | null } {\n const text = items\n .filter((item) => item.type === 'text')\n .map((item) => item.text)\n .join('\\n');\n const limit = maxTokens * CHARS_PER_TOKEN;\n if (text.length <= limit) return { items: [...items], full: null };\n const half = Math.floor(limit / 2);\n const kept = `${text.slice(0, half)}\\n\\n[\u2026 ${text.length - 2 * half} characters omitted \u2026]\\n\\n${text.slice(-half)}`;\n return {\n items: [{ type: 'text', text: kept }, ...items.filter((item) => item.type === 'image')],\n full: text,\n };\n}\n\nasync function spill(api: ToolExecutionApi, text: string, context: Context): Promise<string> {\n const path = `/tmp/slicc-codemode-${api.callId.replace(/[^\\w-]/g, '_')}.txt`;\n const written = await api.env?.writeFile(path, text, context);\n return written?.ok ? path : '';\n}\n\nasync function saveStore(\n api: ToolExecutionApi,\n result: CodemodeResult,\n context: Context\n): Promise<void> {\n if (!result.ok) return;\n const { set, delete: removed } = result.storeWrites;\n if (!Object.keys(set).length && !removed.length) return;\n await api.commit(async (tx) => {\n const doc = await tx.doc(CodemodeDoc, api.conversationId);\n for (const key of removed) delete doc.store[key];\n Object.assign(doc.store, set);\n }, context);\n}\n\nexport function codemodeTool(options: CodemodeOptions): ToolRegistration {\n return defineTool({\n name: CODEMODE,\n description: codemodeDescription(options.declared, options.extra !== undefined),\n parameters: obj({ code: str({ description: 'Raw JavaScript source.' }) }),\n replay: 'unsafe',\n callers: ['model'],\n async execute({ code }, api, context) {\n const started = performance.now();\n const parsed = parseCodemodeSource(code);\n const agent = await api.agent(context);\n const callable = agent.tools.filter((tool) => tool.name !== CODEMODE);\n const tools: CodemodeTool[] = callable.map((tool) => ({\n ...scriptTool(tool),\n execute: (args, { signal }) =>\n callNested(tool.name, args, api, withAbortSignal(signal, context)),\n }));\n const extra = options.extra\n ? await options.extra(api, agent, context)\n : { tools: [], globals: [] };\n const replaced = new Set(extra.tools.map((tool) => tool.name));\n const scripted = [...tools.filter((tool) => !replaced.has(tool.name)), ...extra.tools];\n const saved = await api.snapshot(CodemodeDoc, api.conversationId, context);\n const sandbox = options.sandbox({\n tools: scripted,\n ...(extra.globals.length ? { globals: extra.globals } : {}),\n timeoutMs: parsed.options.timeoutMs ?? Number.POSITIVE_INFINITY,\n memoryLimitBytes: MEMORY_LIMIT_BYTES,\n });\n let result: CodemodeResult;\n try {\n result = await sandbox.execute(parsed.code, {\n signal: context.abortSignal as AbortSignal,\n store: { ...saved?.store },\n });\n } finally {\n await sandbox.close();\n }\n await saveStore(api, result, context);\n const output = [...result.output];\n if (result.ok && result.value !== undefined)\n output.push({ type: 'text', text: valueText(result.value) });\n const items = formatOutput(output);\n if (!result.ok)\n items.push({\n type: 'text',\n text: `Script error:\\n${formatError(result.error, result.calls)}`,\n });\n const cut = truncate(\n await scrubItems(joinText(items)),\n parsed.options.maxOutputTokens ?? DEFAULT_MAX_OUTPUT_TOKENS\n );\n const path = cut.full === null ? '' : await spill(api, cut.full, context);\n const note = path ? [{ type: 'text' as const, text: `Full output: ${path}` }] : [];\n const seconds = ((performance.now() - started) / 1000).toFixed(1);\n const header = `${result.ok ? 'Script completed' : 'Script failed'}\\nWall time ${seconds} seconds\\nOutput:\\n`;\n return {\n output: [{ type: 'text', text: header }, ...joinText([...cut.items, ...note])],\n ...(result.ok ? {} : { isError: true }),\n };\n },\n }) as ToolRegistration;\n}\n\nexport function codemodeExtension(tools: readonly ToolRegistration[]): Extension {\n return defineExtension({ name: 'slicc-codemode', tools });\n}\n\nexport function disabledBySettings(text: string | undefined, tool = CODEMODE): boolean {\n if (!text) return false;\n try {\n const settings = JSON.parse(text) as { defaultTools?: unknown };\n return Array.isArray(settings.defaultTools) && settings.defaultTools.includes(`-${tool}`);\n } catch {\n return false;\n }\n}\n\nexport type Fetcher = (url: string) => Promise<Response>;\n\nexport function wasmCandidates(from: URL): string[] {\n const out: string[] = [];\n let dir = new URL('.', from);\n for (;;) {\n out.push(new URL('node_modules/quickjs-wasi/quickjs.wasm', dir).href);\n if (dir.pathname === '/') return out;\n dir = new URL('..', dir);\n }\n}\n\nexport async function locateWasm(\n fetcher: Fetcher,\n from: URL\n): Promise<WebAssembly.Module | undefined> {\n for (const url of wasmCandidates(from)) {\n const response = await fetcher(url).catch(() => undefined);\n if (response?.ok) return WebAssembly.compile(await response.arrayBuffer());\n }\n return undefined;\n}\n\nlet shared: SandboxFactory | undefined;\n\nexport function sharedSandbox(): SandboxFactory | undefined {\n return shared;\n}\n\nexport function sandboxFactory(\n wasm: () => Promise<WebAssembly.Module | undefined>,\n workerUrl?: string | URL\n): SandboxFactory {\n let found: Promise<WebAssembly.Module | undefined> | undefined;\n const factory: SandboxFactory = (options) => {\n found ??= wasm().catch(() => undefined);\n return new CodemodeSandbox({\n ...options,\n ...(workerUrl ? { workerUrl } : {}),\n wasm: found.then((module) => module ?? loadQuickJSWasm()),\n });\n };\n shared = factory;\n return factory;\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import type { Context, JsonValue } from '@earendil-works/chord';\nimport { withAbortSignal } from '@earendil-works/chord/context';\nimport {\n type CodemodeError,\n type CodemodeJsonSchema,\n type CodemodeOutputItem,\n type CodemodeResult,\n type CodemodeRun,\n type CodemodeRunOptions,\n CodemodeSandbox,\n type CodemodeSandboxOptions,\n type CodemodeTool,\n loadQuickJSWasm,\n parseCodemodeSource,\n renderDeclarations,\n} from '@earendil-works/pi-codemode';\nimport {\n type Agent,\n defineDoc,\n defineExtension,\n defineTool,\n type Extension,\n type JsonObject,\n type NestedToolExecutionResult,\n type ToolExecutionApi,\n type ToolRegistration,\n} from '@earendil-works/pi-durable';\nimport { obj, str } from '@earendil-works/pi-schema';\nimport { boundedDeltas } from '../checkpoints.ts';\nimport { scrubItems } from '../secrets/scrub.ts';\n\nexport const CODEMODE = 'codemode';\nexport const DEFAULT_MAX_OUTPUT_TOKENS = 10_000;\nexport const MEMORY_LIMIT_BYTES = 256 * 1024 * 1024;\nconst CHARS_PER_TOKEN = 4;\n\nexport const CodemodeDoc = defineDoc<{ store: Record<string, JsonValue> }>({\n kind: 'slicc.codemode',\n checkpointWhen: boundedDeltas,\n version: 1,\n scope: 'conversation',\n history: 'rewindable',\n fork: 'asOf',\n initial: () => ({ store: {} }),\n});\n\nexport interface Sandbox {\n execute(\n code: string,\n options: { signal?: AbortSignal; store?: Record<string, unknown> }\n ): Promise<CodemodeResult>;\n start(code: string, options: CodemodeRunOptions): CodemodeRun;\n close(): Promise<void>;\n}\n\nexport type SandboxFactory = (options: CodemodeSandboxOptions) => Sandbox;\n\nexport interface CodemodeExtra {\n tools: CodemodeTool[];\n globals: CodemodeTool[];\n}\n\nexport interface CodemodeOptions {\n sandbox: SandboxFactory;\n declared: readonly ToolRegistration[];\n extra?: (api: ToolExecutionApi, agent: Agent, context: Context) => Promise<CodemodeExtra>;\n}\n\nconst INTRO = `Run JavaScript that calls other tools. The input is raw JavaScript (not JSON, no code fence), run as an async function body in a QuickJS sandbox: top-level \\`await\\` and \\`return\\` work. No Node, file system, network, or timers.\n- \\`await tools.<name>({ ...args })\\` resolves to a string, or an object if the tool's declaration says so, and rejects with an Error on failure. Calls still running when the script ends are cancelled.\n- Optional first line: \\`// @options: {\"max_output_tokens\": 10000, \"timeout_ms\": 60000}\\``;\n\nconst GLOBALS = [\n 'Globals:',\n '- `text(value)`, `image(dataUrlOrImageBlock)`, `console.log(...)`, and top-level `return` add output; `exit()` ends the script. With several text items, each starts with a `==> text N/M <==` line, and `console` lines follow the other output in one `<console_output>` block.',\n '- `store(key, value)` and `load(key)` keep JSON values across codemode calls in this conversation.',\n '- `ALL_TOOLS` lists every tool scripts can call.',\n].join('\\n');\n\nconst DISCOVERY =\n '- `await searchTools(query, { limit?, namespace? })`, `await describeTool(name)`, `await describeNamespace(name)`: find unlisted tools, such as MCP tools.';\n\nconst BASH_OUTPUT: CodemodeJsonSchema = {\n type: 'object',\n properties: {\n output: { type: 'string' },\n exit_code: { type: 'number' },\n truncated: { type: 'boolean' },\n full_output_path: { type: 'string' },\n },\n required: ['output', 'exit_code'],\n};\n\nfunction scriptTool(tool: ToolRegistration): Omit<CodemodeTool, 'execute'> {\n return {\n name: tool.name,\n description: tool.description,\n inputSchema: tool.parameters as CodemodeJsonSchema,\n ...(tool.name === 'bash' ? { outputSchema: BASH_OUTPUT } : {}),\n };\n}\n\nexport function codemodeDescription(\n declared: readonly ToolRegistration[],\n discovery = false\n): string {\n const tools = declared\n .filter((tool) => tool.name !== CODEMODE)\n .map((tool) => ({ ...scriptTool(tool), execute: () => undefined }));\n const sections = [INTRO, discovery ? `${GLOBALS}\\n${DISCOVERY}` : GLOBALS];\n if (tools.length) sections.push(`Nested tools:\\n${renderDeclarations({ tools })}`);\n return sections.join('\\n\\n');\n}\n\nfunction textOf(value: unknown): string {\n if (typeof value === 'string') return value;\n if (!Array.isArray(value)) return '';\n return value\n .filter((part) => part?.type === 'text')\n .map((part) => part.text)\n .join('\\n');\n}\n\nfunction errorOf(result: NestedToolExecutionResult): string {\n const errors = result.diagnostics\n .filter((diagnostic) => diagnostic.severity === 'error')\n .map((diagnostic) => diagnostic.message);\n return [textOf(result.structuredOutput), ...errors].filter(Boolean).join('\\n');\n}\n\ninterface ShellOutput {\n output: string;\n exitCode: number;\n truncated?: boolean;\n fullOutputPath?: string;\n}\n\nfunction shellOutput(value: unknown): ShellOutput | undefined {\n const shell = value as Partial<ShellOutput> | undefined;\n return typeof shell?.output === 'string' && typeof shell.exitCode === 'number'\n ? (shell as ShellOutput)\n : undefined;\n}\n\nexport async function callNested(\n name: string,\n args: unknown,\n api: ToolExecutionApi,\n context: Context\n): Promise<unknown> {\n const result = await api.executeTool(name, (args ?? {}) as JsonObject, context);\n const shell = name === 'bash' ? shellOutput(result.structuredOutput) : undefined;\n if (shell)\n return {\n output: shell.output,\n exit_code: shell.exitCode,\n ...(shell.truncated ? { truncated: true } : {}),\n ...(shell.fullOutputPath ? { full_output_path: shell.fullOutputPath } : {}),\n };\n if (result.isError) throw new Error(errorOf(result) || `Tool \"${name}\" failed`);\n return textOf(result.structuredOutput);\n}\n\nfunction valueText(value: unknown): string {\n return typeof value === 'string' ? value : (JSON.stringify(value) ?? String(value));\n}\n\nexport function formatOutput(output: readonly CodemodeOutputItem[]): CodemodeOutputItem[] {\n const total = output.filter((item) => item.type === 'text' && !item.console).length;\n const items: CodemodeOutputItem[] = [];\n const lines: string[] = [];\n let index = 0;\n for (const item of output) {\n if (item.type === 'image') items.push(item);\n else if (item.console) lines.push(item.text);\n else {\n index++;\n items.push({\n type: 'text',\n text: total > 1 ? `==> text ${index}/${total} <==\\n${item.text}` : item.text,\n });\n }\n }\n if (lines.length)\n items.push({ type: 'text', text: `<console_output>\\n${lines.join('\\n')}\\n</console_output>` });\n return items;\n}\n\nexport function joinText(items: readonly CodemodeOutputItem[]): CodemodeOutputItem[] {\n const joined: CodemodeOutputItem[] = [];\n for (const item of items) {\n const last = joined.at(-1);\n if (item.type === 'text' && last?.type === 'text') {\n const separator = last.text === '' || last.text.endsWith('\\n') ? '' : '\\n';\n joined[joined.length - 1] = { type: 'text', text: `${last.text}${separator}${item.text}` };\n } else joined.push(item);\n }\n return joined;\n}\n\nexport function formatError(error: CodemodeError, calls: CodemodeResult['calls']): string {\n const heads: Record<string, string> = {\n timeout: `Script timed out: ${error.message}`,\n aborted: `Script aborted: ${error.message}`,\n sandbox: `Script sandbox failed: ${error.message}`,\n };\n const head =\n error.kind === 'script'\n ? (error.stack ?? `${error.name ?? 'Error'}: ${error.message}`)\n : heads[error.kind];\n const summary = calls.length\n ? `Tool calls made before the failure (they are not undone): ${calls.map((call) => `${call.name} (${call.status})`).join(', ')}`\n : 'No tool calls were made.';\n return `${head}\\n\\n${summary}`;\n}\n\nexport function truncate(\n items: readonly CodemodeOutputItem[],\n maxTokens: number\n): { items: CodemodeOutputItem[]; full: string | null } {\n const text = items\n .filter((item) => item.type === 'text')\n .map((item) => item.text)\n .join('\\n');\n const limit = maxTokens * CHARS_PER_TOKEN;\n if (text.length <= limit) return { items: [...items], full: null };\n const half = Math.floor(limit / 2);\n const kept = `${text.slice(0, half)}\\n\\n[\u2026 ${text.length - 2 * half} characters omitted \u2026]\\n\\n${text.slice(-half)}`;\n return {\n items: [{ type: 'text', text: kept }, ...items.filter((item) => item.type === 'image')],\n full: text,\n };\n}\n\nasync function spill(api: ToolExecutionApi, text: string, context: Context): Promise<string> {\n const path = `/tmp/slicc-codemode-${api.callId.replace(/[^\\w-]/g, '_')}.txt`;\n const written = await api.env?.writeFile(path, text, context);\n return written?.ok ? path : '';\n}\n\nasync function saveStore(\n api: ToolExecutionApi,\n result: CodemodeResult,\n context: Context\n): Promise<void> {\n if (!result.ok) return;\n const { set, delete: removed } = result.storeWrites;\n if (!Object.keys(set).length && !removed.length) return;\n await api.commit(async (tx) => {\n const doc = await tx.doc(CodemodeDoc, api.conversationId);\n for (const key of removed) delete doc.store[key];\n Object.assign(doc.store, set);\n }, context);\n}\n\nexport function codemodeTool(options: CodemodeOptions): ToolRegistration {\n return defineTool({\n name: CODEMODE,\n description: codemodeDescription(options.declared, options.extra !== undefined),\n parameters: obj({ code: str({ description: 'Raw JavaScript source.' }) }),\n replay: 'unsafe',\n callers: ['model'],\n async execute({ code }, api, context) {\n const started = performance.now();\n const parsed = parseCodemodeSource(code);\n const agent = await api.agent(context);\n const callable = agent.tools.filter((tool) => tool.name !== CODEMODE);\n const tools: CodemodeTool[] = callable.map((tool) => ({\n ...scriptTool(tool),\n execute: (args, { signal }) =>\n callNested(tool.name, args, api, withAbortSignal(signal, context)),\n }));\n const extra = options.extra\n ? await options.extra(api, agent, context)\n : { tools: [], globals: [] };\n const replaced = new Set(extra.tools.map((tool) => tool.name));\n const scripted = [...tools.filter((tool) => !replaced.has(tool.name)), ...extra.tools];\n const saved = await api.snapshot(CodemodeDoc, api.conversationId, context);\n const sandbox = options.sandbox({\n tools: scripted,\n ...(extra.globals.length ? { globals: extra.globals } : {}),\n timeoutMs: parsed.options.timeoutMs ?? Number.POSITIVE_INFINITY,\n memoryLimitBytes: MEMORY_LIMIT_BYTES,\n });\n let result: CodemodeResult;\n try {\n result = await sandbox.execute(parsed.code, {\n signal: context.abortSignal as AbortSignal,\n store: { ...saved?.store },\n });\n } finally {\n await sandbox.close();\n }\n await saveStore(api, result, context);\n const output = [...result.output];\n if (result.ok && result.value !== undefined)\n output.push({ type: 'text', text: valueText(result.value) });\n const items = formatOutput(output);\n if (!result.ok)\n items.push({\n type: 'text',\n text: `Script error:\\n${formatError(result.error, result.calls)}`,\n });\n const cut = truncate(\n await scrubItems(joinText(items)),\n parsed.options.maxOutputTokens ?? DEFAULT_MAX_OUTPUT_TOKENS\n );\n const path = cut.full === null ? '' : await spill(api, cut.full, context);\n const note = path ? [{ type: 'text' as const, text: `Full output: ${path}` }] : [];\n const seconds = ((performance.now() - started) / 1000).toFixed(1);\n const header = `${result.ok ? 'Script completed' : 'Script failed'}\\nWall time ${seconds} seconds\\nOutput:\\n`;\n return {\n output: [{ type: 'text', text: header }, ...joinText([...cut.items, ...note])],\n ...(result.ok ? {} : { isError: true }),\n };\n },\n }) as ToolRegistration;\n}\n\nexport function codemodeExtension(tools: readonly ToolRegistration[]): Extension {\n return defineExtension({ name: 'slicc-codemode', tools });\n}\n\nexport function disabledBySettings(text: string | undefined, tool = CODEMODE): boolean {\n if (!text) return false;\n try {\n const settings = JSON.parse(text) as { defaultTools?: unknown };\n return Array.isArray(settings.defaultTools) && settings.defaultTools.includes(`-${tool}`);\n } catch {\n return false;\n }\n}\n\nexport type Fetcher = (url: string) => Promise<Response>;\n\nexport function wasmCandidates(from: URL): string[] {\n const out: string[] = [];\n let dir = new URL('.', from);\n for (;;) {\n out.push(new URL('node_modules/quickjs-wasi/quickjs.wasm', dir).href);\n if (dir.pathname === '/') return out;\n dir = new URL('..', dir);\n }\n}\n\nexport async function locateWasm(\n fetcher: Fetcher,\n from: URL\n): Promise<WebAssembly.Module | undefined> {\n for (const url of wasmCandidates(from)) {\n const response = await fetcher(url).catch(() => undefined);\n if (!response?.ok) continue;\n const module = await response\n .arrayBuffer()\n .then((bytes) => WebAssembly.compile(bytes))\n .catch(() => undefined);\n if (module) return module;\n }\n return undefined;\n}\n\nlet shared: SandboxFactory | undefined;\n\nexport function sharedSandbox(): SandboxFactory | undefined {\n return shared;\n}\n\nexport function sandboxFactory(\n wasm: () => Promise<WebAssembly.Module | undefined>,\n workerUrl?: string | URL\n): SandboxFactory {\n let found: Promise<WebAssembly.Module | undefined> | undefined;\n const factory: SandboxFactory = (options) => {\n found ??= wasm().catch(() => undefined);\n return new CodemodeSandbox({\n ...options,\n ...(workerUrl ? { workerUrl } : {}),\n wasm: found.then((module) => module ?? loadQuickJSWasm()),\n });\n };\n shared = factory;\n return factory;\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -7,7 +7,14 @@ import { mimeOf } from "../images/index.js";
7
7
  import { execute } from "./exec.js";
8
8
  import { attempt, info, KernelDirReader, SnapshotLines, SnapshotReader } from "./files.js";
9
9
  import { dirname, normalize, resolve } from "./paths.js";
10
- import { nativeWatch, pollWatch, RESCAN_MS } from "./watch.js";
10
+ import {
11
+ DEEP_RESCAN_MS,
12
+ hearsPeers,
13
+ nativeWatch,
14
+ pollWatch,
15
+ RESCAN_BACKOFF,
16
+ RESCAN_MS
17
+ } from "./watch.js";
11
18
  const STREAMED_READ = 8 * 1024 * 1024;
12
19
  const READ_CHUNK = 1024 * 1024;
13
20
  async function scrubbedFile(scrub, bytes) {
@@ -191,18 +198,42 @@ class SliccKernelEnv {
191
198
  onChange(change);
192
199
  };
193
200
  const native = this.#poll.mode === "polling" ? void 0 : await nativeWatch(this.#fs, this.cwd, targets, reported);
194
- const intervalMs = native ? this.#poll.rescanMs ?? RESCAN_MS : this.#poll.intervalMs;
195
- const polled = await pollWatch(this.#fs, this.cwd, targets, onChange, {
196
- ...intervalMs === void 0 ? {} : { intervalMs }
197
- });
198
- absorb = (paths) => polled.absorb(paths);
199
- const watcher = native ? {
200
- mode: "native",
201
+ const rescanned = (change) => {
202
+ native?.recheck(change.paths);
203
+ onChange(change);
204
+ };
205
+ const poll = (group, timing2) => pollWatch(this.#fs, this.cwd, group, rescanned, timing2);
206
+ const polled = [];
207
+ const timing = (intervalMs) => intervalMs === void 0 ? {} : { intervalMs };
208
+ if (!native) polled.push(await poll(targets, timing(this.#poll.intervalMs)));
209
+ else {
210
+ const backoff = RESCAN_BACKOFF;
211
+ const { deepRescanMs } = this.#poll;
212
+ const peers = deepRescanMs === void 0 && await hearsPeers(this.#client);
213
+ const deep = targets.filter(
214
+ (target) => target.recursive === true && (!peers || native.blind.includes(target))
215
+ );
216
+ const shallow = targets.filter((target) => target.recursive !== true);
217
+ if (deep.length)
218
+ polled.push(await poll(deep, { intervalMs: deepRescanMs ?? DEEP_RESCAN_MS, backoff }));
219
+ if (shallow.length)
220
+ polled.push(
221
+ await poll(shallow, { intervalMs: this.#poll.rescanMs ?? RESCAN_MS, backoff })
222
+ );
223
+ }
224
+ absorb = (paths) => {
225
+ for (const each of polled) each.absorb(paths);
226
+ };
227
+ const stopPolls = async (closing) => {
228
+ for (const each of polled) await each.stop(closing);
229
+ };
230
+ const watcher = {
231
+ mode: native ? "native" : "polling",
201
232
  async stop(closing) {
202
- await native.stop(closing);
203
- await polled.stop(closing);
233
+ await native?.stop(closing);
234
+ await stopPolls(closing);
204
235
  }
205
- } : polled;
236
+ };
206
237
  this.#watchers.add(watcher);
207
238
  return {
208
239
  mode: watcher.mode,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/kernel/env.ts"],
4
- "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport {\n type BinaryReader,\n type DirReader,\n type ExecutionEnv,\n type ExecutionError,\n err,\n type FileChange,\n FileError,\n type FileInfo,\n type FileWatcher,\n ok,\n type Result,\n type ShellExecOptions,\n type ShellExecResult,\n type TextLineReader,\n type WatchTarget,\n} from '@earendil-works/pi-durable/env';\nimport { mimeOf } from '../images/index.ts';\nimport type { Scrub } from '../secrets/scrub.ts';\nimport type { Activity } from './activity.ts';\nimport type { KernelClient, KernelProcess } from './client.ts';\nimport { type ExecHooks, execute } from './exec.ts';\nimport { attempt, info, KernelDirReader, SnapshotLines, SnapshotReader } from './files.ts';\nimport type { ProcessGroups } from './groups.ts';\nimport type { Jobs } from './jobs.ts';\nimport { dirname, normalize, resolve } from './paths.ts';\nimport { nativeWatch, type PollOptions, pollWatch, RESCAN_MS } from './watch.ts';\n\nexport interface KernelEnvOptions {\n cwd: string;\n id?: string;\n watch?: PollOptions;\n activity?: Activity;\n groups?: ProcessGroups;\n jobs?: Jobs;\n owner?: number;\n exports?: Readonly<Record<string, string>>;\n scrub?: Scrub;\n spawn?: (argv: readonly string[]) => readonly string[];\n tag?: (context: Context) => Promise<string | undefined>;\n}\n\nexport const STREAMED_READ = 8 * 1024 * 1024;\nexport const READ_CHUNK = 1024 * 1024;\n\nexport async function scrubbedFile(scrub: Scrub, bytes: Uint8Array): Promise<Uint8Array> {\n if (mimeOf(bytes)) return bytes;\n if (bytes.length <= STREAMED_READ) return (await scrub.texts([bytes]))[0] as Uint8Array;\n const stream = scrub.stream();\n const parts: Uint8Array[] = [];\n for (let at = 0; at < bytes.length; at += READ_CHUNK)\n parts.push(await stream.push(bytes.subarray(at, at + READ_CHUNK)));\n parts.push(await stream.end());\n const all = new Uint8Array(parts.reduce((sum, part) => sum + part.length, 0));\n let offset = 0;\n for (const part of parts) {\n all.set(part, offset);\n offset += part.length;\n }\n return all;\n}\n\nexport function quote(value: string): string {\n return `'${value.replace(/'/g, \"'\\\\''\")}'`;\n}\n\nexport function prefixed(\n command: string,\n exports: Readonly<Record<string, string>> | undefined\n): string {\n const names = Object.keys(exports ?? {}).filter((name) => /^[A-Z_][A-Z0-9_]*$/.test(name));\n if (!names.length) return command;\n return `export ${names.map((name) => `${name}=${quote((exports as Record<string, string>)[name] as string)}`).join(' ')}; ${command}`;\n}\n\ntype FileResult<T> = Promise<Result<T, FileError>>;\n\nexport class SliccKernelEnv implements ExecutionEnv {\n readonly id: string;\n cwd: string;\n readonly #client: KernelClient;\n readonly #watchers = new Set<FileWatcher>();\n readonly #poll: PollOptions;\n readonly #activity: Activity | undefined;\n readonly #groups: ProcessGroups | undefined;\n readonly #jobs: Jobs | undefined;\n readonly #owner: number | undefined;\n readonly #exports: Readonly<Record<string, string>> | undefined;\n readonly #hooks: ExecHooks;\n readonly #scrub: Scrub | undefined;\n\n constructor(client: KernelClient, options: KernelEnvOptions) {\n this.#client = client;\n this.cwd = options.cwd;\n this.id = options.id ?? 'slicc-kernel';\n this.#poll = options.watch ?? {};\n this.#activity = options.activity;\n this.#groups = options.groups;\n this.#jobs = options.jobs;\n this.#owner = options.owner;\n this.#exports = options.exports;\n this.#scrub = options.scrub;\n const scrub = options.scrub;\n this.#hooks = {\n ...(scrub ? { scrub: () => scrub.stream() } : {}),\n ...(options.spawn ? { spawn: options.spawn } : {}),\n ...(options.tag ? { tag: options.tag } : {}),\n };\n }\n\n #path(path: string): string {\n return resolve(this.cwd, path);\n }\n\n #written(path: string): string {\n const resolved = this.#path(path);\n this.#activity?.wrote(resolved);\n return resolved;\n }\n\n get #fs() {\n return this.#client.fs;\n }\n\n async absolutePath(path: string): FileResult<string> {\n return ok(this.#path(path));\n }\n\n async joinPath(parts: string[]): FileResult<string> {\n return ok(normalize(parts.join('/')));\n }\n\n readTextFile(path: string, context: Context): FileResult<string> {\n const resolved = this.#path(path);\n return attempt(context, resolved, () => this.#fs.readText(resolved));\n }\n\n readBinaryFile(path: string, context: Context): FileResult<Uint8Array> {\n const resolved = this.#path(path);\n return attempt(context, resolved, () => this.#fs.readFile(resolved));\n }\n\n async openTextLineReader(path: string, context: Context): FileResult<TextLineReader> {\n const text = await this.readTextFile(path, context);\n return text.ok ? ok(new SnapshotLines(text.value)) : text;\n }\n\n async readTextLines(\n path: string,\n options: { maxLines?: number } | undefined,\n context: Context\n ): FileResult<string[]> {\n if (options?.maxLines !== undefined && options.maxLines <= 0) return ok([]);\n const text = await this.readTextFile(path, context);\n if (!text.ok) return text;\n const reader = new SnapshotLines(text.value);\n const lines: string[] = [];\n for (\n let line = await reader.readLine();\n line.ok && line.value;\n line = await reader.readLine()\n ) {\n if (options?.maxLines !== undefined && lines.length >= options.maxLines) break;\n lines.push(line.value.text);\n }\n return ok(lines);\n }\n\n openBinaryReader(\n path: string,\n options: { noFollow?: boolean } | undefined,\n context: Context\n ): FileResult<BinaryReader> {\n const resolved = this.#path(path);\n return attempt(context, resolved, async () => {\n if (options?.noFollow && (await this.#fs.lstat(resolved)).isSymbolicLink) {\n throw new FileError('invalid', 'Refusing to follow a symbolic link', resolved);\n }\n const stat = await this.#fs.stat(resolved);\n if (stat.isDirectory) throw new FileError('is_directory', 'Is a directory', resolved);\n if (!stat.isFile) throw new FileError('invalid', 'Not a regular file', resolved);\n const bytes = await this.#fs.readFile(resolved);\n if (!this.#scrub) return new SnapshotReader(bytes, info(resolved, stat));\n const shown = await scrubbedFile(this.#scrub, bytes);\n return new SnapshotReader(shown, { ...info(resolved, stat), size: shown.length });\n });\n }\n\n writeFile(path: string, content: string | Uint8Array, context: Context): FileResult<void> {\n const resolved = this.#written(path);\n return attempt(context, resolved, async () => {\n await this.#fs.mkdir(dirname(resolved));\n await this.#fs.writeFile(resolved, content);\n });\n }\n\n appendFile(path: string, content: string | Uint8Array, context: Context): FileResult<void> {\n const resolved = this.#written(path);\n return attempt(context, resolved, async () => {\n const before = (await this.#fs.exists(resolved))\n ? await this.#fs.readFile(resolved)\n : new Uint8Array();\n const added = typeof content === 'string' ? new TextEncoder().encode(content) : content;\n const all = new Uint8Array(before.length + added.length);\n all.set(before);\n all.set(added, before.length);\n await this.#fs.mkdir(dirname(resolved));\n await this.#fs.writeFile(resolved, all);\n });\n }\n\n truncateFile(path: string, size: number, context: Context): FileResult<void> {\n const resolved = this.#written(path);\n if (!Number.isSafeInteger(size) || size < 0) {\n return Promise.resolve(\n err(new FileError('invalid', 'File size must be a non-negative integer', resolved))\n );\n }\n return attempt(context, resolved, async () => {\n const before = await this.#fs.readFile(resolved);\n const after = new Uint8Array(size);\n after.set(before.subarray(0, size));\n await this.#fs.writeFile(resolved, after);\n });\n }\n\n flushFile(path: string, context: Context): FileResult<void> {\n const resolved = this.#path(path);\n return attempt(context, resolved, async () => {\n if ((await this.#fs.stat(resolved)).isDirectory)\n throw Object.assign(new Error('Is a directory'), { code: 'EISDIR' });\n });\n }\n\n renameFile(sourcePath: string, destinationPath: string, context: Context): FileResult<void> {\n const source = this.#written(sourcePath);\n return attempt(context, source, () => this.#fs.rename(source, this.#written(destinationPath)));\n }\n\n fileInfo(path: string, context: Context): FileResult<FileInfo> {\n const resolved = this.#path(path);\n return attempt(context, resolved, async () => info(resolved, await this.#fs.lstat(resolved)));\n }\n\n async listDir(path: string, context: Context): FileResult<FileInfo[]> {\n const reader = await this.openDirReader(path, context);\n if (!reader.ok) return reader;\n return ok(await (reader.value as KernelDirReader).rest());\n }\n\n openDirReader(path: string, context: Context): FileResult<DirReader> {\n const resolved = this.#path(path);\n return attempt(context, resolved, async () => {\n if (!(await this.#fs.stat(resolved)).isDirectory) {\n throw Object.assign(new Error('Not a directory'), { code: 'ENOTDIR' });\n }\n return new KernelDirReader(this.#fs, resolved, await this.#fs.readdir(resolved));\n });\n }\n\n watch(\n targets: readonly WatchTarget[],\n onChange: (change: FileChange) => void,\n context: Context\n ): FileResult<FileWatcher> {\n return attempt(context, this.cwd, async () => {\n let absorb: (paths: readonly string[]) => void = () => undefined;\n const reported = (change: FileChange) => {\n if (change.kind === 'paths') absorb(change.paths);\n onChange(change);\n };\n const native =\n this.#poll.mode === 'polling'\n ? undefined\n : await nativeWatch(this.#fs, this.cwd, targets, reported);\n const intervalMs = native ? (this.#poll.rescanMs ?? RESCAN_MS) : this.#poll.intervalMs;\n const polled = await pollWatch(this.#fs, this.cwd, targets, onChange, {\n ...(intervalMs === undefined ? {} : { intervalMs }),\n });\n absorb = (paths) => polled.absorb(paths);\n const watcher: FileWatcher = native\n ? {\n mode: 'native',\n async stop(closing: Context) {\n await native.stop(closing);\n await polled.stop(closing);\n },\n }\n : polled;\n this.#watchers.add(watcher);\n return {\n mode: watcher.mode,\n stop: async (closing: Context) => {\n this.#watchers.delete(watcher);\n await watcher.stop(closing);\n },\n };\n });\n }\n\n canonicalPath(path: string, context: Context): FileResult<string> {\n const resolved = this.#path(path);\n return attempt(context, resolved, () => this.#fs.realpath(resolved));\n }\n\n async exists(path: string, context: Context): FileResult<boolean> {\n const found = await this.fileInfo(path, context);\n if (found.ok) return ok(true);\n return found.error.code === 'not_found' ? ok(false) : found;\n }\n\n createDir(\n path: string,\n _options: { recursive?: boolean } | undefined,\n context: Context\n ): FileResult<void> {\n const resolved = this.#written(path);\n return attempt(context, resolved, () => this.#fs.mkdir(resolved));\n }\n\n remove(\n path: string,\n options: { recursive?: boolean; force?: boolean } | undefined,\n context: Context\n ): FileResult<void> {\n const resolved = this.#written(path);\n return attempt(context, resolved, async () => {\n if (!options?.recursive) {\n const stat = await this.#fs.lstat(resolved).catch((error: unknown) => {\n if (options?.force) return undefined;\n throw error;\n });\n if (stat?.isDirectory) throw Object.assign(new Error('Is a directory'), { code: 'EISDIR' });\n }\n await this.#fs.rm(resolved, { force: options?.force ?? false });\n });\n }\n\n async createTempDir(prefix: string | undefined, context: Context): FileResult<string> {\n const path = `/tmp/${prefix ?? 'tmp-'}${crypto.randomUUID()}`;\n return attempt(context, path, async () => {\n await this.#fs.mkdir(path);\n return path;\n });\n }\n\n async createTempFile(\n options: { prefix?: string; suffix?: string } | undefined,\n context: Context\n ): FileResult<string> {\n const dir = await this.createTempDir('tmp-', context);\n if (!dir.ok) return dir;\n const path = `${dir.value}/${options?.prefix ?? ''}${crypto.randomUUID()}${options?.suffix ?? ''}`;\n return attempt(context, path, async () => {\n await this.#fs.writeFile(path, '');\n return path;\n });\n }\n\n exec(\n command: string | readonly string[],\n options: ShellExecOptions | undefined,\n context: Context\n ): Promise<Result<ShellExecResult, ExecutionError>> {\n const ended = this.#activity?.began();\n const line = typeof command === 'string' ? prefixed(command, this.#exports) : command;\n const jobs = this.#jobs;\n const client = this.#client;\n let recorded: Promise<void> | undefined;\n const tracked =\n jobs && typeof command === 'string'\n ? (process: KernelProcess) => {\n recorded = jobs.started(client, command, process);\n }\n : undefined;\n const groups = this.#groups;\n const owner = this.#owner;\n const run =\n !groups || owner === undefined\n ? execute(client, this.cwd, line, options, context, tracked, undefined, this.#hooks)\n : this.#grouped(groups, owner, line, options, context, tracked);\n return run\n .then(async (result) => {\n await recorded;\n return result;\n })\n .finally(ended);\n }\n\n async #grouped(\n groups: ProcessGroups,\n owner: number,\n line: string | readonly string[],\n options: ShellExecOptions | undefined,\n context: Context,\n tracked: ((process: KernelProcess) => void) | undefined\n ): Promise<Result<ShellExecResult, ExecutionError>> {\n for (let wait = groups.pending(owner); wait; wait = groups.pending(owner)) await wait;\n const pgid = groups.shared(owner);\n const release = pgid === undefined && groups.joins() ? groups.reserve(owner) : () => undefined;\n const spawned = (process: KernelProcess, tag?: string) => {\n groups.track(owner, process, tag);\n tracked?.(process);\n release();\n };\n const join = groups.joins()\n ? {\n ...(pgid === undefined ? {} : { pgid }),\n refused: (code: string) => groups.refused(owner, code),\n }\n : undefined;\n return execute(\n this.#client,\n this.cwd,\n line,\n options,\n context,\n spawned,\n join,\n this.#hooks\n ).finally(release);\n }\n\n async cleanup(context: Context): Promise<void> {\n for (const watcher of [...this.#watchers]) await watcher.stop(context);\n this.#watchers.clear();\n }\n}\n\nexport const HOME = '/home';\n\nexport type EnvTargetLike = { cwd?: string; conversationId?: number; read?: unknown };\n\nexport type EnvRoute = { client: KernelClient; home: string; cwd?: string };\n\nexport function kernelEnvironment(\n client: KernelClient,\n options: Omit<KernelEnvOptions, 'cwd'> & {\n identify?: (target: EnvTargetLike, context: Context) => Promise<Record<string, string>>;\n route?: (target: EnvTargetLike) => Promise<EnvRoute | undefined>;\n tagOf?: (conversationId: number, context: Context) => Promise<string | undefined>;\n } = {}\n): (target: EnvTargetLike, context?: Context) => SliccKernelEnv | Promise<SliccKernelEnv> {\n const { identify, route, tagOf, ...rest } = options;\n const make = (target: EnvTargetLike, exports?: Record<string, string>, routed?: EnvRoute) => {\n const owner = target.conversationId;\n return new SliccKernelEnv(routed?.client ?? client, {\n ...rest,\n cwd: routed?.cwd ?? target.cwd ?? routed?.home ?? HOME,\n ...(owner === undefined ? {} : { owner }),\n ...(owner !== undefined && tagOf ? { tag: (context: Context) => tagOf(owner, context) } : {}),\n ...(exports ? { exports } : {}),\n });\n };\n if (route)\n return async (target, context) => {\n const routed = await route(target);\n const exports = identify && context ? await identify(target, context) : undefined;\n return make(target, exports, routed);\n };\n return (target, context) =>\n identify && context\n ? identify(target, context).then((exports) => make(target, exports))\n : make(target);\n}\n"],
5
- "mappings": "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",
6
- "names": []
4
+ "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport {\n type BinaryReader,\n type DirReader,\n type ExecutionEnv,\n type ExecutionError,\n err,\n type FileChange,\n FileError,\n type FileInfo,\n type FileWatcher,\n ok,\n type Result,\n type ShellExecOptions,\n type ShellExecResult,\n type TextLineReader,\n type WatchTarget,\n} from '@earendil-works/pi-durable/env';\nimport { mimeOf } from '../images/index.ts';\nimport type { Scrub } from '../secrets/scrub.ts';\nimport type { Activity } from './activity.ts';\nimport type { KernelClient, KernelProcess } from './client.ts';\nimport { type ExecHooks, execute } from './exec.ts';\nimport { attempt, info, KernelDirReader, SnapshotLines, SnapshotReader } from './files.ts';\nimport type { ProcessGroups } from './groups.ts';\nimport type { Jobs } from './jobs.ts';\nimport { dirname, normalize, resolve } from './paths.ts';\nimport {\n DEEP_RESCAN_MS,\n hearsPeers,\n nativeWatch,\n type PathsChange,\n type PolledWatcher,\n type PollOptions,\n type PollTiming,\n pollWatch,\n RESCAN_BACKOFF,\n RESCAN_MS,\n} from './watch.ts';\n\nexport interface KernelEnvOptions {\n cwd: string;\n id?: string;\n watch?: PollOptions;\n activity?: Activity;\n groups?: ProcessGroups;\n jobs?: Jobs;\n owner?: number;\n exports?: Readonly<Record<string, string>>;\n scrub?: Scrub;\n spawn?: (argv: readonly string[]) => readonly string[];\n tag?: (context: Context) => Promise<string | undefined>;\n}\n\nexport const STREAMED_READ = 8 * 1024 * 1024;\nexport const READ_CHUNK = 1024 * 1024;\n\nexport async function scrubbedFile(scrub: Scrub, bytes: Uint8Array): Promise<Uint8Array> {\n if (mimeOf(bytes)) return bytes;\n if (bytes.length <= STREAMED_READ) return (await scrub.texts([bytes]))[0] as Uint8Array;\n const stream = scrub.stream();\n const parts: Uint8Array[] = [];\n for (let at = 0; at < bytes.length; at += READ_CHUNK)\n parts.push(await stream.push(bytes.subarray(at, at + READ_CHUNK)));\n parts.push(await stream.end());\n const all = new Uint8Array(parts.reduce((sum, part) => sum + part.length, 0));\n let offset = 0;\n for (const part of parts) {\n all.set(part, offset);\n offset += part.length;\n }\n return all;\n}\n\nexport function quote(value: string): string {\n return `'${value.replace(/'/g, \"'\\\\''\")}'`;\n}\n\nexport function prefixed(\n command: string,\n exports: Readonly<Record<string, string>> | undefined\n): string {\n const names = Object.keys(exports ?? {}).filter((name) => /^[A-Z_][A-Z0-9_]*$/.test(name));\n if (!names.length) return command;\n return `export ${names.map((name) => `${name}=${quote((exports as Record<string, string>)[name] as string)}`).join(' ')}; ${command}`;\n}\n\ntype FileResult<T> = Promise<Result<T, FileError>>;\n\nexport class SliccKernelEnv implements ExecutionEnv {\n readonly id: string;\n cwd: string;\n readonly #client: KernelClient;\n readonly #watchers = new Set<FileWatcher>();\n readonly #poll: PollOptions;\n readonly #activity: Activity | undefined;\n readonly #groups: ProcessGroups | undefined;\n readonly #jobs: Jobs | undefined;\n readonly #owner: number | undefined;\n readonly #exports: Readonly<Record<string, string>> | undefined;\n readonly #hooks: ExecHooks;\n readonly #scrub: Scrub | undefined;\n\n constructor(client: KernelClient, options: KernelEnvOptions) {\n this.#client = client;\n this.cwd = options.cwd;\n this.id = options.id ?? 'slicc-kernel';\n this.#poll = options.watch ?? {};\n this.#activity = options.activity;\n this.#groups = options.groups;\n this.#jobs = options.jobs;\n this.#owner = options.owner;\n this.#exports = options.exports;\n this.#scrub = options.scrub;\n const scrub = options.scrub;\n this.#hooks = {\n ...(scrub ? { scrub: () => scrub.stream() } : {}),\n ...(options.spawn ? { spawn: options.spawn } : {}),\n ...(options.tag ? { tag: options.tag } : {}),\n };\n }\n\n #path(path: string): string {\n return resolve(this.cwd, path);\n }\n\n #written(path: string): string {\n const resolved = this.#path(path);\n this.#activity?.wrote(resolved);\n return resolved;\n }\n\n get #fs() {\n return this.#client.fs;\n }\n\n async absolutePath(path: string): FileResult<string> {\n return ok(this.#path(path));\n }\n\n async joinPath(parts: string[]): FileResult<string> {\n return ok(normalize(parts.join('/')));\n }\n\n readTextFile(path: string, context: Context): FileResult<string> {\n const resolved = this.#path(path);\n return attempt(context, resolved, () => this.#fs.readText(resolved));\n }\n\n readBinaryFile(path: string, context: Context): FileResult<Uint8Array> {\n const resolved = this.#path(path);\n return attempt(context, resolved, () => this.#fs.readFile(resolved));\n }\n\n async openTextLineReader(path: string, context: Context): FileResult<TextLineReader> {\n const text = await this.readTextFile(path, context);\n return text.ok ? ok(new SnapshotLines(text.value)) : text;\n }\n\n async readTextLines(\n path: string,\n options: { maxLines?: number } | undefined,\n context: Context\n ): FileResult<string[]> {\n if (options?.maxLines !== undefined && options.maxLines <= 0) return ok([]);\n const text = await this.readTextFile(path, context);\n if (!text.ok) return text;\n const reader = new SnapshotLines(text.value);\n const lines: string[] = [];\n for (\n let line = await reader.readLine();\n line.ok && line.value;\n line = await reader.readLine()\n ) {\n if (options?.maxLines !== undefined && lines.length >= options.maxLines) break;\n lines.push(line.value.text);\n }\n return ok(lines);\n }\n\n openBinaryReader(\n path: string,\n options: { noFollow?: boolean } | undefined,\n context: Context\n ): FileResult<BinaryReader> {\n const resolved = this.#path(path);\n return attempt(context, resolved, async () => {\n if (options?.noFollow && (await this.#fs.lstat(resolved)).isSymbolicLink) {\n throw new FileError('invalid', 'Refusing to follow a symbolic link', resolved);\n }\n const stat = await this.#fs.stat(resolved);\n if (stat.isDirectory) throw new FileError('is_directory', 'Is a directory', resolved);\n if (!stat.isFile) throw new FileError('invalid', 'Not a regular file', resolved);\n const bytes = await this.#fs.readFile(resolved);\n if (!this.#scrub) return new SnapshotReader(bytes, info(resolved, stat));\n const shown = await scrubbedFile(this.#scrub, bytes);\n return new SnapshotReader(shown, { ...info(resolved, stat), size: shown.length });\n });\n }\n\n writeFile(path: string, content: string | Uint8Array, context: Context): FileResult<void> {\n const resolved = this.#written(path);\n return attempt(context, resolved, async () => {\n await this.#fs.mkdir(dirname(resolved));\n await this.#fs.writeFile(resolved, content);\n });\n }\n\n appendFile(path: string, content: string | Uint8Array, context: Context): FileResult<void> {\n const resolved = this.#written(path);\n return attempt(context, resolved, async () => {\n const before = (await this.#fs.exists(resolved))\n ? await this.#fs.readFile(resolved)\n : new Uint8Array();\n const added = typeof content === 'string' ? new TextEncoder().encode(content) : content;\n const all = new Uint8Array(before.length + added.length);\n all.set(before);\n all.set(added, before.length);\n await this.#fs.mkdir(dirname(resolved));\n await this.#fs.writeFile(resolved, all);\n });\n }\n\n truncateFile(path: string, size: number, context: Context): FileResult<void> {\n const resolved = this.#written(path);\n if (!Number.isSafeInteger(size) || size < 0) {\n return Promise.resolve(\n err(new FileError('invalid', 'File size must be a non-negative integer', resolved))\n );\n }\n return attempt(context, resolved, async () => {\n const before = await this.#fs.readFile(resolved);\n const after = new Uint8Array(size);\n after.set(before.subarray(0, size));\n await this.#fs.writeFile(resolved, after);\n });\n }\n\n flushFile(path: string, context: Context): FileResult<void> {\n const resolved = this.#path(path);\n return attempt(context, resolved, async () => {\n if ((await this.#fs.stat(resolved)).isDirectory)\n throw Object.assign(new Error('Is a directory'), { code: 'EISDIR' });\n });\n }\n\n renameFile(sourcePath: string, destinationPath: string, context: Context): FileResult<void> {\n const source = this.#written(sourcePath);\n return attempt(context, source, () => this.#fs.rename(source, this.#written(destinationPath)));\n }\n\n fileInfo(path: string, context: Context): FileResult<FileInfo> {\n const resolved = this.#path(path);\n return attempt(context, resolved, async () => info(resolved, await this.#fs.lstat(resolved)));\n }\n\n async listDir(path: string, context: Context): FileResult<FileInfo[]> {\n const reader = await this.openDirReader(path, context);\n if (!reader.ok) return reader;\n return ok(await (reader.value as KernelDirReader).rest());\n }\n\n openDirReader(path: string, context: Context): FileResult<DirReader> {\n const resolved = this.#path(path);\n return attempt(context, resolved, async () => {\n if (!(await this.#fs.stat(resolved)).isDirectory) {\n throw Object.assign(new Error('Not a directory'), { code: 'ENOTDIR' });\n }\n return new KernelDirReader(this.#fs, resolved, await this.#fs.readdir(resolved));\n });\n }\n\n watch(\n targets: readonly WatchTarget[],\n onChange: (change: FileChange) => void,\n context: Context\n ): FileResult<FileWatcher> {\n return attempt(context, this.cwd, async () => {\n let absorb: (paths: readonly string[]) => void = () => undefined;\n const reported = (change: FileChange) => {\n if (change.kind === 'paths') absorb(change.paths);\n onChange(change);\n };\n const native =\n this.#poll.mode === 'polling'\n ? undefined\n : await nativeWatch(this.#fs, this.cwd, targets, reported);\n const rescanned = (change: PathsChange) => {\n native?.recheck(change.paths);\n onChange(change);\n };\n const poll = (group: readonly WatchTarget[], timing: PollTiming) =>\n pollWatch(this.#fs, this.cwd, group, rescanned, timing);\n const polled: PolledWatcher[] = [];\n const timing = (intervalMs: number | undefined) =>\n intervalMs === undefined ? {} : { intervalMs };\n if (!native) polled.push(await poll(targets, timing(this.#poll.intervalMs)));\n else {\n const backoff = RESCAN_BACKOFF;\n const { deepRescanMs } = this.#poll;\n const peers = deepRescanMs === undefined && (await hearsPeers(this.#client));\n const deep = targets.filter(\n (target) => target.recursive === true && (!peers || native.blind.includes(target))\n );\n const shallow = targets.filter((target) => target.recursive !== true);\n if (deep.length)\n polled.push(await poll(deep, { intervalMs: deepRescanMs ?? DEEP_RESCAN_MS, backoff }));\n if (shallow.length)\n polled.push(\n await poll(shallow, { intervalMs: this.#poll.rescanMs ?? RESCAN_MS, backoff })\n );\n }\n absorb = (paths) => {\n for (const each of polled) each.absorb(paths);\n };\n const stopPolls = async (closing: Context) => {\n for (const each of polled) await each.stop(closing);\n };\n const watcher: FileWatcher = {\n mode: native ? 'native' : 'polling',\n async stop(closing: Context) {\n await native?.stop(closing);\n await stopPolls(closing);\n },\n };\n this.#watchers.add(watcher);\n return {\n mode: watcher.mode,\n stop: async (closing: Context) => {\n this.#watchers.delete(watcher);\n await watcher.stop(closing);\n },\n };\n });\n }\n\n canonicalPath(path: string, context: Context): FileResult<string> {\n const resolved = this.#path(path);\n return attempt(context, resolved, () => this.#fs.realpath(resolved));\n }\n\n async exists(path: string, context: Context): FileResult<boolean> {\n const found = await this.fileInfo(path, context);\n if (found.ok) return ok(true);\n return found.error.code === 'not_found' ? ok(false) : found;\n }\n\n createDir(\n path: string,\n _options: { recursive?: boolean } | undefined,\n context: Context\n ): FileResult<void> {\n const resolved = this.#written(path);\n return attempt(context, resolved, () => this.#fs.mkdir(resolved));\n }\n\n remove(\n path: string,\n options: { recursive?: boolean; force?: boolean } | undefined,\n context: Context\n ): FileResult<void> {\n const resolved = this.#written(path);\n return attempt(context, resolved, async () => {\n if (!options?.recursive) {\n const stat = await this.#fs.lstat(resolved).catch((error: unknown) => {\n if (options?.force) return undefined;\n throw error;\n });\n if (stat?.isDirectory) throw Object.assign(new Error('Is a directory'), { code: 'EISDIR' });\n }\n await this.#fs.rm(resolved, { force: options?.force ?? false });\n });\n }\n\n async createTempDir(prefix: string | undefined, context: Context): FileResult<string> {\n const path = `/tmp/${prefix ?? 'tmp-'}${crypto.randomUUID()}`;\n return attempt(context, path, async () => {\n await this.#fs.mkdir(path);\n return path;\n });\n }\n\n async createTempFile(\n options: { prefix?: string; suffix?: string } | undefined,\n context: Context\n ): FileResult<string> {\n const dir = await this.createTempDir('tmp-', context);\n if (!dir.ok) return dir;\n const path = `${dir.value}/${options?.prefix ?? ''}${crypto.randomUUID()}${options?.suffix ?? ''}`;\n return attempt(context, path, async () => {\n await this.#fs.writeFile(path, '');\n return path;\n });\n }\n\n exec(\n command: string | readonly string[],\n options: ShellExecOptions | undefined,\n context: Context\n ): Promise<Result<ShellExecResult, ExecutionError>> {\n const ended = this.#activity?.began();\n const line = typeof command === 'string' ? prefixed(command, this.#exports) : command;\n const jobs = this.#jobs;\n const client = this.#client;\n let recorded: Promise<void> | undefined;\n const tracked =\n jobs && typeof command === 'string'\n ? (process: KernelProcess) => {\n recorded = jobs.started(client, command, process);\n }\n : undefined;\n const groups = this.#groups;\n const owner = this.#owner;\n const run =\n !groups || owner === undefined\n ? execute(client, this.cwd, line, options, context, tracked, undefined, this.#hooks)\n : this.#grouped(groups, owner, line, options, context, tracked);\n return run\n .then(async (result) => {\n await recorded;\n return result;\n })\n .finally(ended);\n }\n\n async #grouped(\n groups: ProcessGroups,\n owner: number,\n line: string | readonly string[],\n options: ShellExecOptions | undefined,\n context: Context,\n tracked: ((process: KernelProcess) => void) | undefined\n ): Promise<Result<ShellExecResult, ExecutionError>> {\n for (let wait = groups.pending(owner); wait; wait = groups.pending(owner)) await wait;\n const pgid = groups.shared(owner);\n const release = pgid === undefined && groups.joins() ? groups.reserve(owner) : () => undefined;\n const spawned = (process: KernelProcess, tag?: string) => {\n groups.track(owner, process, tag);\n tracked?.(process);\n release();\n };\n const join = groups.joins()\n ? {\n ...(pgid === undefined ? {} : { pgid }),\n refused: (code: string) => groups.refused(owner, code),\n }\n : undefined;\n return execute(\n this.#client,\n this.cwd,\n line,\n options,\n context,\n spawned,\n join,\n this.#hooks\n ).finally(release);\n }\n\n async cleanup(context: Context): Promise<void> {\n for (const watcher of [...this.#watchers]) await watcher.stop(context);\n this.#watchers.clear();\n }\n}\n\nexport const HOME = '/home';\n\nexport type EnvTargetLike = { cwd?: string; conversationId?: number; read?: unknown };\n\nexport type EnvRoute = { client: KernelClient; home: string; cwd?: string };\n\nexport function kernelEnvironment(\n client: KernelClient,\n options: Omit<KernelEnvOptions, 'cwd'> & {\n identify?: (target: EnvTargetLike, context: Context) => Promise<Record<string, string>>;\n route?: (target: EnvTargetLike) => Promise<EnvRoute | undefined>;\n tagOf?: (conversationId: number, context: Context) => Promise<string | undefined>;\n } = {}\n): (target: EnvTargetLike, context?: Context) => SliccKernelEnv | Promise<SliccKernelEnv> {\n const { identify, route, tagOf, ...rest } = options;\n const make = (target: EnvTargetLike, exports?: Record<string, string>, routed?: EnvRoute) => {\n const owner = target.conversationId;\n return new SliccKernelEnv(routed?.client ?? client, {\n ...rest,\n cwd: routed?.cwd ?? target.cwd ?? routed?.home ?? HOME,\n ...(owner === undefined ? {} : { owner }),\n ...(owner !== undefined && tagOf ? { tag: (context: Context) => tagOf(owner, context) } : {}),\n ...(exports ? { exports } : {}),\n });\n };\n if (route)\n return async (target, context) => {\n const routed = await route(target);\n const exports = identify && context ? await identify(target, context) : undefined;\n return make(target, exports, routed);\n };\n return (target, context) =>\n identify && context\n ? identify(target, context).then((exports) => make(target, exports))\n : make(target);\n}\n"],
5
+ "mappings": "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",
6
+ "names": ["timing"]
7
7
  }
@@ -1,4 +1,4 @@
1
- import { dirname, resolve } from "./paths.js";
1
+ import { basename, dirname, resolve } from "./paths.js";
2
2
  function excluded(name, target) {
3
3
  const rule = target.exclude;
4
4
  if (!rule) return false;
@@ -42,43 +42,131 @@ function differences(before, after) {
42
42
  return [...changed];
43
43
  }
44
44
  const RESCAN_MS = 2e3;
45
+ const DEEP_RESCAN_MS = 3e4;
46
+ const POLL_MS = 500;
47
+ const SCAN_BACKOFF = 10;
48
+ const RESCAN_BACKOFF = 50;
49
+ let lane = Promise.resolve();
50
+ function exclusive(run) {
51
+ const turn = lane.then(run);
52
+ lane = turn.catch(() => void 0);
53
+ return turn;
54
+ }
55
+ function pollInterval(targets) {
56
+ return targets.some((target) => target.recursive === true) ? RESCAN_MS : POLL_MS;
57
+ }
45
58
  function baseOf(path, target) {
46
59
  if (inside(path, target.path)) return target.path;
47
60
  return inside(target.path, path) ? path : void 0;
48
61
  }
62
+ function outermost(paths) {
63
+ const out = [];
64
+ for (const path of [...paths].sort()) {
65
+ const last = out.at(-1);
66
+ if (last === void 0 || !inside(last, path)) out.push(path);
67
+ }
68
+ return out;
69
+ }
49
70
  async function absorbPaths(fs, current, targets, paths) {
50
71
  for (const path of paths)
51
72
  for (const target of targets) {
52
73
  const base = baseOf(path, target);
53
74
  if (base === void 0) continue;
54
- for (const key of [...current.keys()]) if (inside(base, key)) current.delete(key);
75
+ const was = current.get(base);
76
+ current.delete(base);
77
+ if (was?.startsWith("d")) {
78
+ for (const key of [...current.keys()]) if (inside(base, key)) current.delete(key);
79
+ }
55
80
  await scan(fs, base, target, base === target.path || target.recursive === true, current);
56
81
  }
57
82
  }
58
83
  async function pollWatch(fs, cwd, targets, onChange, options = {}) {
59
- let current = await snapshot(fs, cwd, targets);
84
+ let took = 0;
85
+ const timed = async (run) => {
86
+ const started = Date.now();
87
+ try {
88
+ return await run();
89
+ } finally {
90
+ took = Date.now() - started;
91
+ }
92
+ };
93
+ let current = await exclusive(() => timed(() => snapshot(fs, cwd, targets)));
60
94
  const resolved = targets.map((target) => ({ ...target, path: resolve(cwd, target.path) }));
61
- const refresh = (paths) => absorbPaths(fs, current, resolved, paths);
95
+ const interval = options.intervalMs ?? pollInterval(targets);
96
+ const backoff = options.backoff ?? SCAN_BACKOFF;
97
+ const absorbing = /* @__PURE__ */ new Set();
62
98
  let open = true;
63
- let running = Promise.resolve();
99
+ let due = false;
100
+ let timer;
101
+ let running = false;
102
+ let active;
103
+ const turn = (run) => exclusive(async () => {
104
+ if (!open) return;
105
+ active = run();
106
+ try {
107
+ await active;
108
+ } finally {
109
+ active = void 0;
110
+ }
111
+ });
64
112
  const tick = async () => {
65
- const next = await snapshot(fs, cwd, targets);
66
- const paths = differences(current, next);
67
- current = next;
113
+ let paths = [];
114
+ await turn(async () => {
115
+ const next = await timed(() => snapshot(fs, cwd, targets));
116
+ const heard = [...absorbing];
117
+ paths = differences(current, next).filter(
118
+ (path) => !heard.some((known) => inside(known, path) || dirname(known) === path)
119
+ );
120
+ current = next;
121
+ });
68
122
  if (open && paths.length > 0) onChange({ kind: "paths", paths });
69
123
  };
70
- const timer = setInterval(() => {
71
- running = running.then(tick);
72
- }, options.intervalMs ?? 100);
124
+ const work = async () => {
125
+ try {
126
+ while (open && (absorbing.size > 0 || due)) {
127
+ if (absorbing.size > 0) {
128
+ const paths = outermost(absorbing);
129
+ absorbing.clear();
130
+ await turn(() => absorbPaths(fs, current, resolved, paths));
131
+ } else {
132
+ due = false;
133
+ await tick().catch(() => void 0);
134
+ }
135
+ }
136
+ } finally {
137
+ running = false;
138
+ schedule();
139
+ }
140
+ };
141
+ const schedule = () => {
142
+ if (!open || timer !== void 0) return;
143
+ timer = setTimeout(
144
+ () => {
145
+ timer = void 0;
146
+ due = true;
147
+ kick();
148
+ },
149
+ Math.max(interval, took * backoff)
150
+ );
151
+ };
152
+ const kick = () => {
153
+ if (running) return;
154
+ running = true;
155
+ void work();
156
+ };
157
+ schedule();
73
158
  return {
74
159
  mode: "polling",
75
160
  absorb(paths) {
76
- running = running.then(() => refresh(paths));
161
+ if (!open || paths.length === 0) return;
162
+ for (const path of paths) absorbing.add(path);
163
+ kick();
77
164
  },
78
165
  async stop(_context) {
79
166
  open = false;
80
- clearInterval(timer);
81
- await running;
167
+ clearTimeout(timer);
168
+ timer = void 0;
169
+ await active?.catch(() => void 0);
82
170
  }
83
171
  };
84
172
  }
@@ -90,7 +178,6 @@ function hidden(base, path, target) {
90
178
  function inside(base, path) {
91
179
  return path === base || path.startsWith(base === "/" ? "/" : `${base}/`);
92
180
  }
93
- const FALLBACK = /* @__PURE__ */ new Set(["ENOSYS", "ENOENT", "ENOTDIR"]);
94
181
  function mapChange(targets, path) {
95
182
  const out = [];
96
183
  for (const target of targets) {
@@ -104,53 +191,142 @@ function mapChange(targets, path) {
104
191
  }
105
192
  return out;
106
193
  }
194
+ function codeOf(error) {
195
+ return String(Object(error).code);
196
+ }
197
+ async function realOf(fs, path) {
198
+ let at = path;
199
+ let rest = "";
200
+ for (; ; ) {
201
+ const real = await fs.realpath(at).catch(() => void 0);
202
+ if (real !== void 0) return `${real === "/" && rest ? "" : real}${rest}`;
203
+ if (at === "/") return path;
204
+ rest = `/${basename(at)}${rest}`;
205
+ at = dirname(at);
206
+ }
207
+ }
208
+ const PEERS_PROBE = "/proc/sys/kernel/slicc_meta_transactions";
209
+ const peerKernels = /* @__PURE__ */ new WeakMap();
210
+ async function probePeers(client) {
211
+ const decoder = new TextDecoder();
212
+ let text = "";
213
+ const probe = await client.spawn(["cat", PEERS_PROBE], {
214
+ onStdout: (bytes) => {
215
+ text += decoder.decode(bytes, { stream: true });
216
+ }
217
+ });
218
+ if (await probe.exited !== 0) return false;
219
+ return text.trim().split(/\s+/).map(Number).reduce((sum, count) => sum + count, 0) > 0;
220
+ }
221
+ function hearsPeers(client) {
222
+ let known = peerKernels.get(client);
223
+ if (!known) {
224
+ known = probePeers(client).catch(() => false);
225
+ peerKernels.set(client, known);
226
+ }
227
+ return known;
228
+ }
107
229
  async function nativeWatch(fs, cwd, targets, onChange) {
108
230
  const watch = fs.watch?.bind(fs);
109
231
  if (!watch) return void 0;
110
- const resolved = [];
111
- for (const target of targets) {
112
- const path = resolve(cwd, target.path);
113
- if (!await fs.exists(path).catch(() => false)) return void 0;
114
- resolved.push({ ...target, path, real: await fs.realpath(path).catch(() => path) });
115
- }
232
+ const entries = [];
233
+ const dirty = /* @__PURE__ */ new Set();
234
+ let settling = false;
235
+ let settled = Promise.resolve();
116
236
  let open = true;
117
- const handles = [];
118
- const closeAll = async () => {
119
- for (const handle of handles.splice(0)) await handle.close();
237
+ const recheck = (paths) => {
238
+ if (!open) return;
239
+ for (const entry of entries)
240
+ if (!paths || paths.some((at) => inside(at, entry.path))) dirty.add(entry);
241
+ if (dirty.size > 0) kick();
120
242
  };
121
243
  const report = (change) => {
122
244
  if (!open) return;
123
245
  if (!("paths" in change)) {
124
246
  onChange({ kind: "overflow" });
247
+ recheck(void 0);
125
248
  return;
126
249
  }
127
- const paths = [...new Set(change.paths.flatMap((path) => mapChange(resolved, path)))];
250
+ const paths = [...new Set(change.paths.flatMap((path) => mapChange(entries, path)))];
128
251
  if (paths.length) onChange({ kind: "paths", paths });
252
+ recheck(change.paths);
253
+ };
254
+ const opened = async (path, recursive) => {
255
+ try {
256
+ return await watch([path], { recursive }, report);
257
+ } catch (error) {
258
+ if (codeOf(error) !== "ENOSYS" && !await fs.exists(path).catch(() => false))
259
+ return void 0;
260
+ throw error;
261
+ }
262
+ };
263
+ const settle = async (entry) => {
264
+ const recursive = entry.recursive === true;
265
+ entry.main ??= await opened(entry.path, recursive);
266
+ const real = await realOf(fs, entry.path);
267
+ if (real === entry.real && (entry.alias || real === entry.path)) return;
268
+ const was = entry.alias;
269
+ entry.real = real;
270
+ entry.alias = real === entry.path ? void 0 : await opened(real, recursive);
271
+ await was?.close();
272
+ };
273
+ const drain = async () => {
274
+ try {
275
+ while (open && dirty.size > 0) {
276
+ const entry = dirty.values().next().value;
277
+ dirty.delete(entry);
278
+ await settle(entry).catch(() => void 0);
279
+ }
280
+ } finally {
281
+ settling = false;
282
+ }
283
+ };
284
+ const kick = () => {
285
+ if (settling) return;
286
+ settling = true;
287
+ settled = drain();
288
+ };
289
+ const closeAll = async () => {
290
+ open = false;
291
+ for (const entry of entries.splice(0)) {
292
+ await entry.main?.close();
293
+ await entry.alias?.close();
294
+ }
129
295
  };
130
296
  try {
131
- for (const target of resolved) {
132
- const recursive = { recursive: target.recursive === true };
133
- handles.push(await watch([target.path], recursive, report));
134
- if (target.real !== target.path) handles.push(await watch([target.real], recursive, report));
297
+ for (const target of targets) {
298
+ const path = resolve(cwd, target.path);
299
+ const entry = { ...target, path, real: path, main: void 0, alias: void 0 };
300
+ entries.push(entry);
301
+ await settle(entry);
135
302
  }
136
303
  } catch (error) {
137
304
  await closeAll();
138
- if (FALLBACK.has(error.code ?? "")) return void 0;
305
+ if (codeOf(error) === "ENOSYS") return void 0;
139
306
  throw error;
140
307
  }
141
308
  return {
142
309
  mode: "native",
310
+ blind: targets.filter((_, index) => !entries[index]?.main),
311
+ recheck,
143
312
  async stop(_context) {
144
- open = false;
145
313
  await closeAll();
314
+ await settled;
146
315
  }
147
316
  };
148
317
  }
149
318
  export {
319
+ DEEP_RESCAN_MS,
320
+ POLL_MS,
321
+ RESCAN_BACKOFF,
150
322
  RESCAN_MS,
323
+ SCAN_BACKOFF,
151
324
  differences,
325
+ exclusive,
326
+ hearsPeers,
152
327
  mapChange,
153
328
  nativeWatch,
329
+ pollInterval,
154
330
  pollWatch,
155
331
  snapshot
156
332
  };
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/kernel/watch.ts"],
4
- "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { FileChange, FileWatcher, WatchTarget } from '@earendil-works/pi-durable/env';\nimport type { KernelFs } from './client.ts';\nimport { dirname, resolve } from './paths.ts';\n\ntype Snapshot = Map<string, string>;\n\nfunction excluded(name: string, target: WatchTarget): boolean {\n const rule = target.exclude;\n if (!rule) return false;\n return (rule.hidden === true && name.startsWith('.')) || (rule.names?.includes(name) ?? false);\n}\n\nasync function record(fs: KernelFs, path: string, into: Snapshot): Promise<boolean> {\n const stat = await fs.stat(path).catch(() => undefined);\n if (!stat) return false;\n into.set(\n path,\n `${stat.isDirectory ? 'd' : 'f'}:${stat.ino}:${stat.size}:${new Date(stat.mtime).getTime()}`\n );\n return stat.isDirectory;\n}\n\nasync function scan(\n fs: KernelFs,\n path: string,\n target: WatchTarget,\n deep: boolean,\n into: Snapshot\n) {\n const directory = await record(fs, path, into);\n if (!directory || !deep) return;\n const names = await fs.readdir(path).catch(() => [] as string[]);\n for (const name of names) {\n if (excluded(name, target)) continue;\n const child = `${path === '/' ? '' : path}/${name}`;\n await scan(fs, child, target, target.recursive === true, into);\n }\n}\n\nexport async function snapshot(\n fs: KernelFs,\n cwd: string,\n targets: readonly WatchTarget[]\n): Promise<Snapshot> {\n const all: Snapshot = new Map();\n for (const target of targets) await scan(fs, resolve(cwd, target.path), target, true, all);\n return all;\n}\n\nexport function differences(before: Snapshot, after: Snapshot): string[] {\n const changed = new Set<string>();\n const moved = (path: string) => {\n changed.add(path);\n changed.add(dirname(path));\n };\n for (const [path, value] of after) {\n if (!before.has(path)) moved(path);\n else if (before.get(path) !== value) changed.add(path);\n }\n for (const path of before.keys()) if (!after.has(path)) moved(path);\n return [...changed];\n}\n\nexport interface PollOptions {\n intervalMs?: number;\n rescanMs?: number;\n mode?: 'native' | 'polling';\n}\n\nexport const RESCAN_MS = 2000;\n\nfunction baseOf(path: string, target: WatchTarget): string | undefined {\n if (inside(path, target.path)) return target.path;\n return inside(target.path, path) ? path : undefined;\n}\n\nasync function absorbPaths(\n fs: KernelFs,\n current: Snapshot,\n targets: readonly WatchTarget[],\n paths: readonly string[]\n): Promise<void> {\n for (const path of paths)\n for (const target of targets) {\n const base = baseOf(path, target);\n if (base === undefined) continue;\n for (const key of [...current.keys()]) if (inside(base, key)) current.delete(key);\n await scan(fs, base, target, base === target.path || target.recursive === true, current);\n }\n}\n\nexport type PolledWatcher = FileWatcher & { absorb(paths: readonly string[]): void };\n\nexport async function pollWatch(\n fs: KernelFs,\n cwd: string,\n targets: readonly WatchTarget[],\n onChange: (change: FileChange) => void,\n options: PollOptions = {}\n): Promise<PolledWatcher> {\n let current = await snapshot(fs, cwd, targets);\n const resolved = targets.map((target) => ({ ...target, path: resolve(cwd, target.path) }));\n const refresh = (paths: readonly string[]) => absorbPaths(fs, current, resolved, paths);\n let open = true;\n let running = Promise.resolve();\n const tick = async () => {\n const next = await snapshot(fs, cwd, targets);\n const paths = differences(current, next);\n current = next;\n if (open && paths.length > 0) onChange({ kind: 'paths', paths });\n };\n const timer = setInterval(() => {\n running = running.then(tick);\n }, options.intervalMs ?? 100);\n return {\n mode: 'polling',\n absorb(paths) {\n running = running.then(() => refresh(paths));\n },\n async stop(_context: Context) {\n open = false;\n clearInterval(timer);\n await running;\n },\n };\n}\n\nfunction hidden(base: string, path: string, target: WatchTarget): boolean {\n if (!target.exclude || path === base) return false;\n const below = path.slice(base === '/' ? 1 : base.length + 1);\n return below.split('/').some((name) => excluded(name, target));\n}\n\nfunction inside(base: string, path: string): boolean {\n return path === base || path.startsWith(base === '/' ? '/' : `${base}/`);\n}\n\nconst FALLBACK = new Set(['ENOSYS', 'ENOENT', 'ENOTDIR']);\n\ntype Watched = WatchTarget & { real: string };\n\nexport function mapChange(targets: readonly Watched[], path: string): string[] {\n const out: string[] = [];\n for (const target of targets) {\n if (inside(target.path, path)) {\n if (!hidden(target.path, path, target)) out.push(path);\n } else if (inside(path, target.path)) out.push(target.path);\n else if (target.real !== target.path && inside(target.real, path)) {\n const mapped = `${target.path}${path.slice(target.real.length)}`;\n if (!hidden(target.path, mapped, target)) out.push(mapped);\n }\n }\n return out;\n}\n\nexport async function nativeWatch(\n fs: KernelFs,\n cwd: string,\n targets: readonly WatchTarget[],\n onChange: (change: FileChange) => void\n): Promise<FileWatcher | undefined> {\n const watch = fs.watch?.bind(fs);\n if (!watch) return undefined;\n const resolved: Watched[] = [];\n for (const target of targets) {\n const path = resolve(cwd, target.path);\n if (!(await fs.exists(path).catch(() => false))) return undefined;\n resolved.push({ ...target, path, real: await fs.realpath(path).catch(() => path) });\n }\n let open = true;\n const handles: { close(): unknown }[] = [];\n const closeAll = async () => {\n for (const handle of handles.splice(0)) await handle.close();\n };\n const report = (change: { paths: string[] } | { overflow: true }) => {\n if (!open) return;\n if (!('paths' in change)) {\n onChange({ kind: 'overflow' });\n return;\n }\n const paths = [...new Set(change.paths.flatMap((path) => mapChange(resolved, path)))];\n if (paths.length) onChange({ kind: 'paths', paths });\n };\n try {\n for (const target of resolved) {\n const recursive = { recursive: target.recursive === true };\n handles.push(await watch([target.path], recursive, report));\n if (target.real !== target.path) handles.push(await watch([target.real], recursive, report));\n }\n } catch (error) {\n await closeAll();\n if (FALLBACK.has((error as { code?: string }).code ?? '')) return undefined;\n throw error;\n }\n return {\n mode: 'native',\n async stop(_context: Context) {\n open = false;\n await closeAll();\n },\n };\n}\n"],
5
- "mappings": "AAGA,SAAS,SAAS,eAAe;AAIjC,SAAS,SAAS,MAAc,QAA8B;AAC5D,QAAM,OAAO,OAAO;AACpB,MAAI,CAAC,KAAM,QAAO;AAClB,SAAQ,KAAK,WAAW,QAAQ,KAAK,WAAW,GAAG,MAAO,KAAK,OAAO,SAAS,IAAI,KAAK;AAC1F;AAEA,eAAe,OAAO,IAAc,MAAc,MAAkC;AAClF,QAAM,OAAO,MAAM,GAAG,KAAK,IAAI,EAAE,MAAM,MAAM,MAAS;AACtD,MAAI,CAAC,KAAM,QAAO;AAClB,OAAK;AAAA,IACH;AAAA,IACA,GAAG,KAAK,cAAc,MAAM,GAAG,IAAI,KAAK,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,KAAK,EAAE,QAAQ,CAAC;AAAA,EAC5F;AACA,SAAO,KAAK;AACd;AAEA,eAAe,KACb,IACA,MACA,QACA,MACA,MACA;AACA,QAAM,YAAY,MAAM,OAAO,IAAI,MAAM,IAAI;AAC7C,MAAI,CAAC,aAAa,CAAC,KAAM;AACzB,QAAM,QAAQ,MAAM,GAAG,QAAQ,IAAI,EAAE,MAAM,MAAM,CAAC,CAAa;AAC/D,aAAW,QAAQ,OAAO;AACxB,QAAI,SAAS,MAAM,MAAM,EAAG;AAC5B,UAAM,QAAQ,GAAG,SAAS,MAAM,KAAK,IAAI,IAAI,IAAI;AACjD,UAAM,KAAK,IAAI,OAAO,QAAQ,OAAO,cAAc,MAAM,IAAI;AAAA,EAC/D;AACF;AAEA,eAAsB,SACpB,IACA,KACA,SACmB;AACnB,QAAM,MAAgB,oBAAI,IAAI;AAC9B,aAAW,UAAU,QAAS,OAAM,KAAK,IAAI,QAAQ,KAAK,OAAO,IAAI,GAAG,QAAQ,MAAM,GAAG;AACzF,SAAO;AACT;AAEO,SAAS,YAAY,QAAkB,OAA2B;AACvE,QAAM,UAAU,oBAAI,IAAY;AAChC,QAAM,QAAQ,CAAC,SAAiB;AAC9B,YAAQ,IAAI,IAAI;AAChB,YAAQ,IAAI,QAAQ,IAAI,CAAC;AAAA,EAC3B;AACA,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO;AACjC,QAAI,CAAC,OAAO,IAAI,IAAI,EAAG,OAAM,IAAI;AAAA,aACxB,OAAO,IAAI,IAAI,MAAM,MAAO,SAAQ,IAAI,IAAI;AAAA,EACvD;AACA,aAAW,QAAQ,OAAO,KAAK,EAAG,KAAI,CAAC,MAAM,IAAI,IAAI,EAAG,OAAM,IAAI;AAClE,SAAO,CAAC,GAAG,OAAO;AACpB;AAQO,MAAM,YAAY;AAEzB,SAAS,OAAO,MAAc,QAAyC;AACrE,MAAI,OAAO,MAAM,OAAO,IAAI,EAAG,QAAO,OAAO;AAC7C,SAAO,OAAO,OAAO,MAAM,IAAI,IAAI,OAAO;AAC5C;AAEA,eAAe,YACb,IACA,SACA,SACA,OACe;AACf,aAAW,QAAQ;AACjB,eAAW,UAAU,SAAS;AAC5B,YAAM,OAAO,OAAO,MAAM,MAAM;AAChC,UAAI,SAAS,OAAW;AACxB,iBAAW,OAAO,CAAC,GAAG,QAAQ,KAAK,CAAC,EAAG,KAAI,OAAO,MAAM,GAAG,EAAG,SAAQ,OAAO,GAAG;AAChF,YAAM,KAAK,IAAI,MAAM,QAAQ,SAAS,OAAO,QAAQ,OAAO,cAAc,MAAM,OAAO;AAAA,IACzF;AACJ;AAIA,eAAsB,UACpB,IACA,KACA,SACA,UACA,UAAuB,CAAC,GACA;AACxB,MAAI,UAAU,MAAM,SAAS,IAAI,KAAK,OAAO;AAC7C,QAAM,WAAW,QAAQ,IAAI,CAAC,YAAY,EAAE,GAAG,QAAQ,MAAM,QAAQ,KAAK,OAAO,IAAI,EAAE,EAAE;AACzF,QAAM,UAAU,CAAC,UAA6B,YAAY,IAAI,SAAS,UAAU,KAAK;AACtF,MAAI,OAAO;AACX,MAAI,UAAU,QAAQ,QAAQ;AAC9B,QAAM,OAAO,YAAY;AACvB,UAAM,OAAO,MAAM,SAAS,IAAI,KAAK,OAAO;AAC5C,UAAM,QAAQ,YAAY,SAAS,IAAI;AACvC,cAAU;AACV,QAAI,QAAQ,MAAM,SAAS,EAAG,UAAS,EAAE,MAAM,SAAS,MAAM,CAAC;AAAA,EACjE;AACA,QAAM,QAAQ,YAAY,MAAM;AAC9B,cAAU,QAAQ,KAAK,IAAI;AAAA,EAC7B,GAAG,QAAQ,cAAc,GAAG;AAC5B,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,OAAO;AACZ,gBAAU,QAAQ,KAAK,MAAM,QAAQ,KAAK,CAAC;AAAA,IAC7C;AAAA,IACA,MAAM,KAAK,UAAmB;AAC5B,aAAO;AACP,oBAAc,KAAK;AACnB,YAAM;AAAA,IACR;AAAA,EACF;AACF;AAEA,SAAS,OAAO,MAAc,MAAc,QAA8B;AACxE,MAAI,CAAC,OAAO,WAAW,SAAS,KAAM,QAAO;AAC7C,QAAM,QAAQ,KAAK,MAAM,SAAS,MAAM,IAAI,KAAK,SAAS,CAAC;AAC3D,SAAO,MAAM,MAAM,GAAG,EAAE,KAAK,CAAC,SAAS,SAAS,MAAM,MAAM,CAAC;AAC/D;AAEA,SAAS,OAAO,MAAc,MAAuB;AACnD,SAAO,SAAS,QAAQ,KAAK,WAAW,SAAS,MAAM,MAAM,GAAG,IAAI,GAAG;AACzE;AAEA,MAAM,WAAW,oBAAI,IAAI,CAAC,UAAU,UAAU,SAAS,CAAC;AAIjD,SAAS,UAAU,SAA6B,MAAwB;AAC7E,QAAM,MAAgB,CAAC;AACvB,aAAW,UAAU,SAAS;AAC5B,QAAI,OAAO,OAAO,MAAM,IAAI,GAAG;AAC7B,UAAI,CAAC,OAAO,OAAO,MAAM,MAAM,MAAM,EAAG,KAAI,KAAK,IAAI;AAAA,IACvD,WAAW,OAAO,MAAM,OAAO,IAAI,EAAG,KAAI,KAAK,OAAO,IAAI;AAAA,aACjD,OAAO,SAAS,OAAO,QAAQ,OAAO,OAAO,MAAM,IAAI,GAAG;AACjE,YAAM,SAAS,GAAG,OAAO,IAAI,GAAG,KAAK,MAAM,OAAO,KAAK,MAAM,CAAC;AAC9D,UAAI,CAAC,OAAO,OAAO,MAAM,QAAQ,MAAM,EAAG,KAAI,KAAK,MAAM;AAAA,IAC3D;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAsB,YACpB,IACA,KACA,SACA,UACkC;AAClC,QAAM,QAAQ,GAAG,OAAO,KAAK,EAAE;AAC/B,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,WAAsB,CAAC;AAC7B,aAAW,UAAU,SAAS;AAC5B,UAAM,OAAO,QAAQ,KAAK,OAAO,IAAI;AACrC,QAAI,CAAE,MAAM,GAAG,OAAO,IAAI,EAAE,MAAM,MAAM,KAAK,EAAI,QAAO;AACxD,aAAS,KAAK,EAAE,GAAG,QAAQ,MAAM,MAAM,MAAM,GAAG,SAAS,IAAI,EAAE,MAAM,MAAM,IAAI,EAAE,CAAC;AAAA,EACpF;AACA,MAAI,OAAO;AACX,QAAM,UAAkC,CAAC;AACzC,QAAM,WAAW,YAAY;AAC3B,eAAW,UAAU,QAAQ,OAAO,CAAC,EAAG,OAAM,OAAO,MAAM;AAAA,EAC7D;AACA,QAAM,SAAS,CAAC,WAAqD;AACnE,QAAI,CAAC,KAAM;AACX,QAAI,EAAE,WAAW,SAAS;AACxB,eAAS,EAAE,MAAM,WAAW,CAAC;AAC7B;AAAA,IACF;AACA,UAAM,QAAQ,CAAC,GAAG,IAAI,IAAI,OAAO,MAAM,QAAQ,CAAC,SAAS,UAAU,UAAU,IAAI,CAAC,CAAC,CAAC;AACpF,QAAI,MAAM,OAAQ,UAAS,EAAE,MAAM,SAAS,MAAM,CAAC;AAAA,EACrD;AACA,MAAI;AACF,eAAW,UAAU,UAAU;AAC7B,YAAM,YAAY,EAAE,WAAW,OAAO,cAAc,KAAK;AACzD,cAAQ,KAAK,MAAM,MAAM,CAAC,OAAO,IAAI,GAAG,WAAW,MAAM,CAAC;AAC1D,UAAI,OAAO,SAAS,OAAO,KAAM,SAAQ,KAAK,MAAM,MAAM,CAAC,OAAO,IAAI,GAAG,WAAW,MAAM,CAAC;AAAA,IAC7F;AAAA,EACF,SAAS,OAAO;AACd,UAAM,SAAS;AACf,QAAI,SAAS,IAAK,MAA4B,QAAQ,EAAE,EAAG,QAAO;AAClE,UAAM;AAAA,EACR;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,KAAK,UAAmB;AAC5B,aAAO;AACP,YAAM,SAAS;AAAA,IACjB;AAAA,EACF;AACF;",
4
+ "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { FileChange, FileWatcher, WatchTarget } from '@earendil-works/pi-durable/env';\nimport type { KernelClient, KernelFs } from './client.ts';\nimport { basename, dirname, resolve } from './paths.ts';\n\ntype Snapshot = Map<string, string>;\n\nfunction excluded(name: string, target: WatchTarget): boolean {\n const rule = target.exclude;\n if (!rule) return false;\n return (rule.hidden === true && name.startsWith('.')) || (rule.names?.includes(name) ?? false);\n}\n\nasync function record(fs: KernelFs, path: string, into: Snapshot): Promise<boolean> {\n const stat = await fs.stat(path).catch(() => undefined);\n if (!stat) return false;\n into.set(\n path,\n `${stat.isDirectory ? 'd' : 'f'}:${stat.ino}:${stat.size}:${new Date(stat.mtime).getTime()}`\n );\n return stat.isDirectory;\n}\n\nasync function scan(\n fs: KernelFs,\n path: string,\n target: WatchTarget,\n deep: boolean,\n into: Snapshot\n) {\n const directory = await record(fs, path, into);\n if (!directory || !deep) return;\n const names = await fs.readdir(path).catch(() => [] as string[]);\n for (const name of names) {\n if (excluded(name, target)) continue;\n const child = `${path === '/' ? '' : path}/${name}`;\n await scan(fs, child, target, target.recursive === true, into);\n }\n}\n\nexport async function snapshot(\n fs: KernelFs,\n cwd: string,\n targets: readonly WatchTarget[]\n): Promise<Snapshot> {\n const all: Snapshot = new Map();\n for (const target of targets) await scan(fs, resolve(cwd, target.path), target, true, all);\n return all;\n}\n\nexport function differences(before: Snapshot, after: Snapshot): string[] {\n const changed = new Set<string>();\n const moved = (path: string) => {\n changed.add(path);\n changed.add(dirname(path));\n };\n for (const [path, value] of after) {\n if (!before.has(path)) moved(path);\n else if (before.get(path) !== value) changed.add(path);\n }\n for (const path of before.keys()) if (!after.has(path)) moved(path);\n return [...changed];\n}\n\nexport interface PollOptions {\n intervalMs?: number;\n rescanMs?: number;\n deepRescanMs?: number;\n mode?: 'native' | 'polling';\n}\n\nexport interface PollTiming {\n intervalMs?: number;\n backoff?: number;\n}\n\nexport const RESCAN_MS = 2000;\nexport const DEEP_RESCAN_MS = 30_000;\nexport const POLL_MS = 500;\nexport const SCAN_BACKOFF = 10;\nexport const RESCAN_BACKOFF = 50;\n\nlet lane: Promise<unknown> = Promise.resolve();\n\nexport function exclusive<T>(run: () => Promise<T>): Promise<T> {\n const turn = lane.then(run);\n lane = turn.catch(() => undefined);\n return turn;\n}\n\nexport function pollInterval(targets: readonly WatchTarget[]): number {\n return targets.some((target) => target.recursive === true) ? RESCAN_MS : POLL_MS;\n}\n\nfunction baseOf(path: string, target: WatchTarget): string | undefined {\n if (inside(path, target.path)) return target.path;\n return inside(target.path, path) ? path : undefined;\n}\n\nfunction outermost(paths: Iterable<string>): string[] {\n const out: string[] = [];\n for (const path of [...paths].sort()) {\n const last = out.at(-1);\n if (last === undefined || !inside(last, path)) out.push(path);\n }\n return out;\n}\n\nasync function absorbPaths(\n fs: KernelFs,\n current: Snapshot,\n targets: readonly WatchTarget[],\n paths: readonly string[]\n): Promise<void> {\n for (const path of paths)\n for (const target of targets) {\n const base = baseOf(path, target);\n if (base === undefined) continue;\n const was = current.get(base);\n current.delete(base);\n if (was?.startsWith('d'))\n for (const key of [...current.keys()]) if (inside(base, key)) current.delete(key);\n await scan(fs, base, target, base === target.path || target.recursive === true, current);\n }\n}\n\nexport type PathsChange = Extract<FileChange, { kind: 'paths' }>;\n\nexport type PolledWatcher = FileWatcher & { absorb(paths: readonly string[]): void };\n\nexport async function pollWatch(\n fs: KernelFs,\n cwd: string,\n targets: readonly WatchTarget[],\n onChange: (change: PathsChange) => void,\n options: PollTiming = {}\n): Promise<PolledWatcher> {\n let took = 0;\n const timed = async <T>(run: () => Promise<T>): Promise<T> => {\n const started = Date.now();\n try {\n return await run();\n } finally {\n took = Date.now() - started;\n }\n };\n let current = await exclusive(() => timed(() => snapshot(fs, cwd, targets)));\n const resolved = targets.map((target) => ({ ...target, path: resolve(cwd, target.path) }));\n const interval = options.intervalMs ?? pollInterval(targets);\n const backoff = options.backoff ?? SCAN_BACKOFF;\n const absorbing = new Set<string>();\n let open = true;\n let due = false;\n let timer: ReturnType<typeof setTimeout> | undefined;\n let running = false;\n let active: Promise<unknown> | undefined;\n const turn = (run: () => Promise<void>) =>\n exclusive(async () => {\n if (!open) return;\n active = run();\n try {\n await active;\n } finally {\n active = undefined;\n }\n });\n const tick = async () => {\n let paths: string[] = [];\n await turn(async () => {\n const next = await timed(() => snapshot(fs, cwd, targets));\n const heard = [...absorbing];\n paths = differences(current, next).filter(\n (path) => !heard.some((known) => inside(known, path) || dirname(known) === path)\n );\n current = next;\n });\n if (open && paths.length > 0) onChange({ kind: 'paths', paths });\n };\n const work = async () => {\n try {\n while (open && (absorbing.size > 0 || due)) {\n if (absorbing.size > 0) {\n const paths = outermost(absorbing);\n absorbing.clear();\n await turn(() => absorbPaths(fs, current, resolved, paths));\n } else {\n due = false;\n await tick().catch(() => undefined);\n }\n }\n } finally {\n running = false;\n schedule();\n }\n };\n const schedule = () => {\n if (!open || timer !== undefined) return;\n timer = setTimeout(\n () => {\n timer = undefined;\n due = true;\n kick();\n },\n Math.max(interval, took * backoff)\n );\n };\n const kick = () => {\n if (running) return;\n running = true;\n void work();\n };\n schedule();\n return {\n mode: 'polling',\n absorb(paths) {\n if (!open || paths.length === 0) return;\n for (const path of paths) absorbing.add(path);\n kick();\n },\n async stop(_context: Context) {\n open = false;\n clearTimeout(timer);\n timer = undefined;\n await active?.catch(() => undefined);\n },\n };\n}\n\nfunction hidden(base: string, path: string, target: WatchTarget): boolean {\n if (!target.exclude || path === base) return false;\n const below = path.slice(base === '/' ? 1 : base.length + 1);\n return below.split('/').some((name) => excluded(name, target));\n}\n\nfunction inside(base: string, path: string): boolean {\n return path === base || path.startsWith(base === '/' ? '/' : `${base}/`);\n}\n\ntype Watched = WatchTarget & { real: string };\n\nexport function mapChange(targets: readonly Watched[], path: string): string[] {\n const out: string[] = [];\n for (const target of targets) {\n if (inside(target.path, path)) {\n if (!hidden(target.path, path, target)) out.push(path);\n } else if (inside(path, target.path)) out.push(target.path);\n else if (target.real !== target.path && inside(target.real, path)) {\n const mapped = `${target.path}${path.slice(target.real.length)}`;\n if (!hidden(target.path, mapped, target)) out.push(mapped);\n }\n }\n return out;\n}\n\ntype Handle = { close(): unknown };\n\nexport type NativeWatcher = FileWatcher & {\n blind: readonly WatchTarget[];\n recheck(paths: readonly string[]): void;\n};\n\nfunction codeOf(error: unknown): string {\n return String((Object(error) as { code?: unknown }).code);\n}\n\nasync function realOf(fs: KernelFs, path: string): Promise<string> {\n let at = path;\n let rest = '';\n for (;;) {\n const real = await fs.realpath(at).catch(() => undefined);\n if (real !== undefined) return `${real === '/' && rest ? '' : real}${rest}`;\n if (at === '/') return path;\n rest = `/${basename(at)}${rest}`;\n at = dirname(at);\n }\n}\n\nconst PEERS_PROBE = '/proc/sys/kernel/slicc_meta_transactions';\nconst peerKernels = new WeakMap<KernelClient, Promise<boolean>>();\n\nasync function probePeers(client: KernelClient): Promise<boolean> {\n const decoder = new TextDecoder();\n let text = '';\n const probe = await client.spawn(['cat', PEERS_PROBE], {\n onStdout: (bytes) => {\n text += decoder.decode(bytes, { stream: true });\n },\n });\n if ((await probe.exited) !== 0) return false;\n return (\n text\n .trim()\n .split(/\\s+/)\n .map(Number)\n .reduce((sum, count) => sum + count, 0) > 0\n );\n}\n\nexport function hearsPeers(client: KernelClient): Promise<boolean> {\n let known = peerKernels.get(client);\n if (!known) {\n known = probePeers(client).catch(() => false);\n peerKernels.set(client, known);\n }\n return known;\n}\n\ntype Entry = Watched & { main: Handle | undefined; alias: Handle | undefined };\n\nexport async function nativeWatch(\n fs: KernelFs,\n cwd: string,\n targets: readonly WatchTarget[],\n onChange: (change: FileChange) => void\n): Promise<NativeWatcher | undefined> {\n const watch = fs.watch?.bind(fs);\n if (!watch) return undefined;\n const entries: Entry[] = [];\n const dirty = new Set<Entry>();\n let settling = false;\n let settled = Promise.resolve();\n let open = true;\n const recheck = (paths: readonly string[] | undefined) => {\n if (!open) return;\n for (const entry of entries)\n if (!paths || paths.some((at) => inside(at, entry.path))) dirty.add(entry);\n if (dirty.size > 0) kick();\n };\n const report = (change: { paths: string[] } | { overflow: true }) => {\n if (!open) return;\n if (!('paths' in change)) {\n onChange({ kind: 'overflow' });\n recheck(undefined);\n return;\n }\n const paths = [...new Set(change.paths.flatMap((path) => mapChange(entries, path)))];\n if (paths.length) onChange({ kind: 'paths', paths });\n recheck(change.paths);\n };\n const opened = async (path: string, recursive: boolean) => {\n try {\n return await watch([path], { recursive }, report);\n } catch (error) {\n if (codeOf(error) !== 'ENOSYS' && !(await fs.exists(path).catch(() => false)))\n return undefined;\n throw error;\n }\n };\n const settle = async (entry: Entry) => {\n const recursive = entry.recursive === true;\n entry.main ??= await opened(entry.path, recursive);\n const real = await realOf(fs, entry.path);\n if (real === entry.real && (entry.alias || real === entry.path)) return;\n const was = entry.alias;\n entry.real = real;\n entry.alias = real === entry.path ? undefined : await opened(real, recursive);\n await was?.close();\n };\n const drain = async () => {\n try {\n while (open && dirty.size > 0) {\n const entry = dirty.values().next().value as Entry;\n dirty.delete(entry);\n await settle(entry).catch(() => undefined);\n }\n } finally {\n settling = false;\n }\n };\n const kick = () => {\n if (settling) return;\n settling = true;\n settled = drain();\n };\n const closeAll = async () => {\n open = false;\n for (const entry of entries.splice(0)) {\n await entry.main?.close();\n await entry.alias?.close();\n }\n };\n try {\n for (const target of targets) {\n const path = resolve(cwd, target.path);\n const entry: Entry = { ...target, path, real: path, main: undefined, alias: undefined };\n entries.push(entry);\n await settle(entry);\n }\n } catch (error) {\n await closeAll();\n if (codeOf(error) === 'ENOSYS') return undefined;\n throw error;\n }\n return {\n mode: 'native',\n blind: targets.filter((_, index) => !entries[index]?.main),\n recheck,\n async stop(_context: Context) {\n await closeAll();\n await settled;\n },\n };\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -1,21 +1,40 @@
1
1
  import type { FileChange, FileWatcher, WatchTarget } from '@earendil-works/pi-durable/env';
2
- import type { KernelFs } from './client.ts';
2
+ import type { KernelClient, KernelFs } from './client.ts';
3
3
  type Snapshot = Map<string, string>;
4
4
  export declare function snapshot(fs: KernelFs, cwd: string, targets: readonly WatchTarget[]): Promise<Snapshot>;
5
5
  export declare function differences(before: Snapshot, after: Snapshot): string[];
6
6
  export interface PollOptions {
7
7
  intervalMs?: number;
8
8
  rescanMs?: number;
9
+ deepRescanMs?: number;
9
10
  mode?: 'native' | 'polling';
10
11
  }
12
+ export interface PollTiming {
13
+ intervalMs?: number;
14
+ backoff?: number;
15
+ }
11
16
  export declare const RESCAN_MS = 2000;
17
+ export declare const DEEP_RESCAN_MS = 30000;
18
+ export declare const POLL_MS = 500;
19
+ export declare const SCAN_BACKOFF = 10;
20
+ export declare const RESCAN_BACKOFF = 50;
21
+ export declare function exclusive<T>(run: () => Promise<T>): Promise<T>;
22
+ export declare function pollInterval(targets: readonly WatchTarget[]): number;
23
+ export type PathsChange = Extract<FileChange, {
24
+ kind: 'paths';
25
+ }>;
12
26
  export type PolledWatcher = FileWatcher & {
13
27
  absorb(paths: readonly string[]): void;
14
28
  };
15
- export declare function pollWatch(fs: KernelFs, cwd: string, targets: readonly WatchTarget[], onChange: (change: FileChange) => void, options?: PollOptions): Promise<PolledWatcher>;
29
+ export declare function pollWatch(fs: KernelFs, cwd: string, targets: readonly WatchTarget[], onChange: (change: PathsChange) => void, options?: PollTiming): Promise<PolledWatcher>;
16
30
  type Watched = WatchTarget & {
17
31
  real: string;
18
32
  };
19
33
  export declare function mapChange(targets: readonly Watched[], path: string): string[];
20
- export declare function nativeWatch(fs: KernelFs, cwd: string, targets: readonly WatchTarget[], onChange: (change: FileChange) => void): Promise<FileWatcher | undefined>;
34
+ export type NativeWatcher = FileWatcher & {
35
+ blind: readonly WatchTarget[];
36
+ recheck(paths: readonly string[]): void;
37
+ };
38
+ export declare function hearsPeers(client: KernelClient): Promise<boolean>;
39
+ export declare function nativeWatch(fs: KernelFs, cwd: string, targets: readonly WatchTarget[], onChange: (change: FileChange) => void): Promise<NativeWatcher | undefined>;
21
40
  export {};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ai-ecoverse/slicc-agent",
3
- "version": "7.13.4",
3
+ "version": "7.14.1",
4
4
  "description": "SLICC's agent core on pi durable: an agent worker, session storage, remoting and pi extensions",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
@@ -74,9 +74,9 @@
74
74
  "devDependencies": {
75
75
  "@ai-ecoverse/slicc-kernel": "1.171.0",
76
76
  "@ai-ecoverse/slicc-scrub": "1.1.0",
77
- "@ai-ecoverse/slicc-shared-web": "2.13.9",
78
- "@ai-ecoverse/slicc-spectrum": "1.108.3",
79
- "@ai-ecoverse/wasi-fnox": "1.42.1-1",
77
+ "@ai-ecoverse/slicc-shared-web": "2.13.10",
78
+ "@ai-ecoverse/slicc-spectrum": "1.108.4",
79
+ "@ai-ecoverse/wasi-fnox": "1.43.0-1",
80
80
  "@ai-ecoverse/wasm-bash": "5.3.0-23",
81
81
  "@ai-ecoverse/wasm-coreutils": "9.12.0-15",
82
82
  "@ai-ecoverse/wasm-git": "2.55.0-22",