deepclause-sdk 0.0.88 → 0.1.0

package/dist/system/assets/docs/PROLOG_SNIPPETS.md

@@ -0,0 +1,117 @@
+# Common Prolog/DML snippets (tested)
+
+Tested against the bundled SWI-Prolog. These are **glue**, not the shape of a
+skill: use a snippet to bind or check a value between `task/N` steps, not to
+write a Prolog algorithm. Prefer a `task/N`/`prompt/N` step when the
+transformation is open-ended (`DML_AUTHORING.md` §0).
+`Y` is the output; `>>` introduces a yall lambda.
+
+## Strings
+
+| Task | Snippet | Result |
+|---|---|---|
+| Split on a separator | `split_string("a,b,,c", ",", "", L)` | `[a,b,'',c]` |
+| Join | `atomic_list_concat([a,b,c], "-", S)` | `a-b-c` |
+| Join (strings) | `atomics_to_string([a,b,c], "-", S)` | `a-b-c` |
+| Lower / upper | `string_lower("AbC", L)` / `string_upper("AbC", U)` | `abc` / `ABC` |
+| Atom case | `downcase_atom('ABC', L)` / `upcase_atom('abc', U)` | `abc` / `ABC` |
+| Collapse whitespace | `normalize_space(string(T), "  a   b  ")` | `a b` |
+| Build a string | `format(string(S), "~w/~w", [A, B])` | `a/b` |
+| Number <-> string | `number_string(42, S)` / `atom_number("42", N)` | `"42"` / `42` |
+| Substring test | `sub_string(S, _, _, _, "needle")` | true |
+| Substring test (atom) | `sub_atom(A, _, _, _, needle)` | true |
+| Concat | `string_concat("a", "b", S)` | `ab` |
+| Char list | `string_chars("abc", L)` | `[a,b,c]` |
+| JSON string -> dict | `atom_json_dict('{"a":[1,2]}', D, []), get_dict(a, D, A)` | `[1,2]` |
+
+In `task/`, `output/`, `answer/` description strings, `{Var}` interpolates the
+bound value; in `format/3` use `~w`.
+
+## Regex (SWI PCRE — verified behavior)
+
+| Task | Snippet | Result |
+|---|---|---|
+| Match test | `re_match("^[a-z]+[0-9]+$", S)` | true/false |
+| Match with options | `re_match("(?i)hello", S, [])` | true (case-insensitive) |
+| Capture groups | `re_matchsub("(?<user>[a-z]+)-(?<id>[0-9]+)", S, M, []), get_dict(id, M, Id)` | dict `_{0:..., user:..., id:...}` |
+| Replace (first match) | `re_replace("[0-9]+", "#", "a1b22c333", R)` | `a#b22c333` |
+| Collect every match | `re_foldl([M,Acc,[M|Acc]]>>true, "[0-9]+", "a1b22c333", [], L, []), reverse(L, Ms)` | `[_{0:"1"},_{0:"22"},_{0:"333"}]` |
+
+Notes: `re_replace/4` here replaces only the **first** match — collect all matches
+with `re_foldl/6` (or loop) to replace every one. `re_match/3` takes an options
+list, not a capture variable; use `re_matchsub/4` to capture groups. Prefix a
+pattern with `(?i)` for case-insensitive matching.
+
+## Wildcards (`wildcard_match/2`)
+
+| Pattern | Example | Result |
+|---|---|---|
+| `*` any run | `wildcard_match("*.dml", "skill.dml")` | true |
+| `?` one char | `wildcard_match("a?c", "abc")` | true |
+| `[a-z]` class | `wildcard_match("[a-z]*", "abc")` | true |
+| `{a,b}` alternation | `wildcard_match("{a,b}*", "bzz")` | true |
+
+## Lists
+
+| Task | Snippet | Result |
+|---|---|---|
+| Membership | `member(X, [1,2,3])` | enumerates |
+| Concatenate | `append([1,2], [3], L)` | `[1,2,3]` |
+| Length | `length([a,b,c], N)` | `3` |
+| Enumerate range | `numlist(1, 5, L)` | `[1,2,3,4,5]` |
+| Collect | `findall(X, between(1,3,X), L)` | `[1,2,3]` |
+| Map | `maplist([X,Y]>>(Y is X*X), [1,2,3], L)` | `[1,4,9]` |
+| Filter (keep) | `include([X]>>(0 is X mod 2), [1,2,3,4], L)` | `[2,4]` |
+| Filter (drop) | `exclude([X]>>(0 is X mod 2), [1,2,3,4], L)` | `[1,3]` |
+| Fold | `foldl([X,A0,A]>>(A is A0+X), [1,2,3], 0, S)` | `6` |
+| Sum / min / max | `sum_list([1,2,3], S)` / `min_list/2` / `max_list/2` / `max_member/2` | `6` |
+| Aggregate | `aggregate_all(sum(X), member(X,[1,2,3]), S)` | `6` |
+| Count | `aggregate_all(count, between(1,5,_), N)` | `5` |
+| Sort + dedupe | `sort([3,1,2,1], L)` | `[1,2,3]` |
+| Stable sort | `msort([3,1,2], L)` | `[1,2,3]` |
+| Sort by value (pairs) | `sort(2, @>=, [a-1,b-3,c-2], L)` | `[b-3,c-2,a-1]` |
+| Key sort (stable) | `keysort([b-2,a-1,c-2], L)` | `[a-1,b-2,c-2]` |
+| Dedupe | `list_to_set([a,b,a,c], L)` | `[a,b,c]` |
+| Set difference | `subtract([1,2,3,4], [2], L)` | `[1,3,4]` |
+| Intersection / union | `intersection([1,2,3],[2,3,4],L)` / `union([1,2],[2,3],L)` | `[2,3]` / `[1,2,3]` |
+| Partition | `partition([X]>>(0 is X mod 2), [1,2,3,4], E, O)` | `E=[2,4], O=[1,3]` |
+| Index (0-based) | `nth0(1, [a,b,c], E)` | `b` |
+| Last | `last([a,b,c], E)` | `c` |
+| Group by key | `group_pairs_by_key([a-1,a-2,b-3], G)` | `[a-[1,2], b-[3]]` |
+
+`sort/4`'s first argument is the **argument position** to sort on (here `2` =
+the value in each `Key-Value`), not a sort mode.
+
+## Dicts and data
+
+| Task | Snippet |
+|---|---|
+| Read a field | `D = point{x:1,y:2}, get_dict(x, D, X)` |
+| Keys | `dict_keys(a{x:1,y:2}, K)` → `[x,y]` |
+| Add/replace a field | `put_dict(score, a{name:"n"}, 9, D2)` |
+
+## Numbers and time
+
+| Task | Snippet |
+|---|---|
+| Range (generator) | `between(1, 6, N)` |
+| Random int in range | `random_between(1, 6, N)` |
+| Epoch seconds | `get_time(T)` |
+| Broken-down time | `get_time(T), stamp_date_time(T, DT, local)` |
+| Format a time | `format_time(string(S), "%Y-%m-%d", 1700000000)` → `2023-11-15` |
+
+## Things that bite
+
+- `re_replace/4` replaces only the **first** match (verified); use `re_foldl/6`
+  to collect all matches.
+- `re_match/3` takes an options list; use `re_matchsub/4` for capture groups.
+- `sort/4`'s first argument is the argument position, not a mode.
+- A top-level `:- use_module(library(clpfd)).` is required before `#=`/`ins`.
+- Untrusted data (URLs, file contents, user text) goes through files/stdin,
+  never interpolated into a shell command.
+- `{Var}` interpolates **only** in `task/N`/`prompt/N` descriptions; use
+  `format/3` (`~w`/`~q`/`~s`) everywhere else. A string literal escapes `\n`,
+  `\"`, `\\`; a quoted atom doubles `'` (`'it''s'`).
+- Building a command: single-quote known paths/flags, pass data via files/stdin,
+  never splice untrusted text in. Write foreign code to a file (quoted heredoc
+  `<<'EOF'`) rather than embedding it in a DML string.

package/dist/system/assets/index.d.ts

@@ -1,26 +1,18 @@
-export type SystemSkillAssetName = 'conductor' | 'skill-creator' | 'plan' | 'deep-planner' | 'security-planner';
-export type SystemPromptAssetName = 'conductor' | 'skill-creator' | 'task';
-export type SystemCompactorAssetName = 'default-session-compactor' | 'default-loop-compactor';
-export type WorkspaceDocAssetName = 'tui' | 'dml-reference';
+export type SystemPromptAssetName = 'task';
+export type WorkspaceDocAssetName = 'dml-reference' | 'dml-authoring' | 'harness-examples' | 'harness-patterns' | 'prolog-snippets';
 interface SystemAssetLookupOptions {
     workspaceRoot?: string;
     workspacePath?: string;
 }
-export declare function getSystemSkillAssetPath(name: SystemSkillAssetName): string;
 export declare function getSystemPromptAssetPath(name: SystemPromptAssetName): string;
-export declare function getSystemCompactorAssetPath(name: SystemCompactorAssetName): string;
 export declare function getWorkspaceDocAssetPath(name: WorkspaceDocAssetName): string;
-export declare function getPackagedRecipeAssetsDir(): string;
-export declare function getWorkspaceRecipeAssetsDir(workspaceRoot: string): string;
-export declare function getSystemAssetSourcePaths(workspaceRoot?: string): {
-    conductorDml: string;
-    conductorPrompt: string;
-    planDml: string;
-    skillCreatorDml: string;
-    skillCreatorPrompt: string;
-    taskPrompt: string;
-};
-export declare function readSystemSkillAsset(name: SystemSkillAssetName, options?: SystemAssetLookupOptions): Promise<string>;
+/** Bundled authoring-agent system prompt (`AGENT_PROMPT.md`). */
+export declare function getAgentPromptAssetPath(): string;
+/**
+ * Read the authoring-agent system prompt, preferring a workspace override at
+ * `.deepclause/system/AGENT_PROMPT.md` over the bundled asset.
+ */
+export declare function readAgentPromptAsset(options?: SystemAssetLookupOptions): Promise<string>;
 export declare function readSystemPromptAsset(name: SystemPromptAssetName, options?: SystemAssetLookupOptions): Promise<string>;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/system/assets/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/system/assets/index.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM,GAAG,cAAc,GAAG,kBAAkB,CAAC;AAChH,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM,CAAC;AAC3E,MAAM,MAAM,wBAAwB,GAAG,2BAA2B,GAAG,wBAAwB,CAAC;AAC9F,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,eAAe,CAAC;AAU5D,UAAU,wBAAwB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAqCD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAE1E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE5E;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,CAElF;AAWD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE5E;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEzE;AA8FD,wBAAgB,yBAAyB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB,CASA;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CAEjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/system/assets/index.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC3C,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,CAAC;AAOtB,UAAU,wBAAwB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AASD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE5E;AAkBD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE5E;AAED,iEAAiE;AACjE,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlG;AAkDD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/system/assets/index.js

@@ -4,68 +4,53 @@ import { dirname, join, resolve } from 'path';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-const SKILLS_DIR = join(__dirname, 'skills');
-const COMPACTORS_DIR = join(__dirname, 'compactors');
 const DOCS_DIR = join(__dirname, 'docs');
-const RECIPES_DIR = join(__dirname, 'recipes');
 const SYSTEM_OVERRIDE_DIR = '.deepclause/system';
-function getSystemSkillFileName(name) {
-    switch (name) {
-        case 'conductor':
-            return 'conductor.dml';
-        case 'skill-creator':
-            return 'skill-creator.dml';
-        case 'plan':
-            return 'plan.dml';
-        case 'deep-planner':
-            return 'deep-planner.dml';
-        case 'security-planner':
-            return 'security-planner.dml';
-    }
-}
 function getSystemPromptFileName(name) {
     switch (name) {
-        case 'conductor':
-            return 'CONDUCTOR_PROMPT.md';
-        case 'skill-creator':
-            return 'DML_COMPILER_PROMPT.md';
         case 'task':
             return 'TASK_PROMPT.md';
     }
 }
-function getSystemCompactorFileName(name) {
-    switch (name) {
-        case 'default-session-compactor':
-            return 'default-session-compactor.dml';
-        case 'default-loop-compactor':
-            return 'default-loop-compactor.dml';
-    }
-}
-export function getSystemSkillAssetPath(name) {
-    return join(SKILLS_DIR, getSystemSkillFileName(name));
-}
 export function getSystemPromptAssetPath(name) {
     return join(DOCS_DIR, getSystemPromptFileName(name));
 }
-export function getSystemCompactorAssetPath(name) {
-    return join(COMPACTORS_DIR, getSystemCompactorFileName(name));
-}
 function getWorkspaceDocFileName(name) {
     switch (name) {
-        case 'tui':
-            return 'TUI.md';
         case 'dml-reference':
             return 'DML_REFERENCE.md';
+        case 'dml-authoring':
+            return 'DML_AUTHORING.md';
+        case 'harness-examples':
+            return 'HARNESS_EXAMPLES.md';
+        case 'harness-patterns':
+            return 'HARNESS_PATTERNS.md';
+        case 'prolog-snippets':
+            return 'PROLOG_SNIPPETS.md';
     }
 }
 export function getWorkspaceDocAssetPath(name) {
     return join(DOCS_DIR, getWorkspaceDocFileName(name));
 }
-export function getPackagedRecipeAssetsDir() {
-    return RECIPES_DIR;
+/** Bundled authoring-agent system prompt (`AGENT_PROMPT.md`). */
+export function getAgentPromptAssetPath() {
+    return join(DOCS_DIR, 'AGENT_PROMPT.md');
 }
-export function getWorkspaceRecipeAssetsDir(workspaceRoot) {
-    return join(workspaceRoot, SYSTEM_OVERRIDE_DIR, 'recipes');
+/**
+ * Read the authoring-agent system prompt, preferring a workspace override at
+ * `.deepclause/system/AGENT_PROMPT.md` over the bundled asset.
+ */
+export async function readAgentPromptAsset(options = {}) {
+    const overridePath = findWorkspaceOverridePathSync('AGENT_PROMPT.md', options);
+    if (overridePath) {
+        try {
+            return await readFile(overridePath, 'utf8');
+        }
+        catch {
+            // Fall through to the bundled asset.
+        }
+    }
+    return readFile(getAgentPromptAssetPath(), 'utf8');
 }
 function getWorkspaceOverridePath(workspaceRoot, fileName) {
     return join(workspaceRoot, SYSTEM_OVERRIDE_DIR, fileName);
@@ -91,19 +76,6 @@ function findWorkspaceOverridePathSync(fileName, options = {}) {
     }
     return null;
 }
-async function resolveSystemSkillAssetPath(name, options = {}) {
-    const overridePath = findWorkspaceOverridePathSync(getSystemSkillFileName(name), options);
-    if (overridePath) {
-        try {
-            await access(overridePath);
-            return overridePath;
-        }
-        catch {
-            // Fall back to the packaged asset when no workspace override exists.
-        }
-    }
-    return getSystemSkillAssetPath(name);
-}
 async function resolveSystemPromptAssetPath(name, options = {}) {
     const overridePath = findWorkspaceOverridePathSync(getSystemPromptFileName(name), options);
     if (overridePath) {
@@ -117,37 +89,6 @@ async function resolveSystemPromptAssetPath(name, options = {}) {
     }
     return getSystemPromptAssetPath(name);
 }
-function resolveSystemSkillAssetPathSync(name, workspaceRoot) {
-    if (workspaceRoot) {
-        const overridePath = getWorkspaceOverridePath(workspaceRoot, getSystemSkillFileName(name));
-        if (existsSync(overridePath)) {
-            return overridePath;
-        }
-    }
-    return getSystemSkillAssetPath(name);
-}
-function resolveSystemPromptAssetPathSync(name, workspaceRoot) {
-    if (workspaceRoot) {
-        const overridePath = getWorkspaceOverridePath(workspaceRoot, getSystemPromptFileName(name));
-        if (existsSync(overridePath)) {
-            return overridePath;
-        }
-    }
-    return getSystemPromptAssetPath(name);
-}
-export function getSystemAssetSourcePaths(workspaceRoot) {
-    return {
-        conductorDml: resolveSystemSkillAssetPathSync('conductor', workspaceRoot),
-        conductorPrompt: resolveSystemPromptAssetPathSync('conductor', workspaceRoot),
-        planDml: resolveSystemSkillAssetPathSync('plan', workspaceRoot),
-        skillCreatorDml: resolveSystemSkillAssetPathSync('skill-creator', workspaceRoot),
-        skillCreatorPrompt: resolveSystemPromptAssetPathSync('skill-creator', workspaceRoot),
-        taskPrompt: resolveSystemPromptAssetPathSync('task', workspaceRoot),
-    };
-}
-export async function readSystemSkillAsset(name, options = {}) {
-    return readFile(await resolveSystemSkillAssetPath(name, options), 'utf8');
-}
 export async function readSystemPromptAsset(name, options = {}) {
     return readFile(await resolveSystemPromptAssetPath(name, options), 'utf8');
 }

package/dist/system/assets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/system/assets/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/system/assets/index.ts"],"names":[],"mappings":"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"}

package/dist/system/runtime/agentvm-manager.d.ts

@@ -7,6 +7,12 @@ export interface ShellExecResult {
     pid?: number;
     backend: 'host' | 'sandbox';
     backendLabel?: string;
+    /** Wall-clock duration of the command, in milliseconds. */
+    timeMs: number;
+}
+export interface ShellExecOptions {
+    /** Wall-clock timeout in ms; overrides `DC_HOST_SHELL_TIMEOUT_MS`. 0 disables. */
+    timeoutMs?: number;
 }
 export interface ShellExecStartEvent {
     command: string;
@@ -39,10 +45,11 @@ export interface ShellExecObserver {
 export declare class AgentVMManager {
     private readonly workspacePath;
     private readonly network;
+    private readonly defaultTimeoutMs?;
     private vm;
     readonly kind: "sandbox";
-    constructor(workspacePath: string, network: boolean);
-    exec(command: string, signal?: AbortSignal, observer?: ShellExecObserver): Promise<ShellExecResult>;
+    constructor(workspacePath: string, network: boolean, defaultTimeoutMs?: number | undefined);
+    exec(command: string, signal?: AbortSignal, observer?: ShellExecObserver, options?: ShellExecOptions): Promise<ShellExecResult>;
     dispose(): Promise<void>;
     private getVM;
 }

package/dist/system/runtime/agentvm-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentvm-manager.d.ts","sourceRoot":"","sources":["../../../src/system/runtime/agentvm-manager.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC9C;AAED,qBAAa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,EAAE,CAAwB;IAClC,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;gBAGhB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO;IAG7B,IAAI,CACR,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,eAAe,CAAC;IAoFrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAOhB,KAAK;CAepB"}
+{"version":3,"file":"agentvm-manager.d.ts","sourceRoot":"","sources":["../../../src/system/runtime/agentvm-manager.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC9C;AAED,qBAAa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IANpC,OAAO,CAAC,EAAE,CAAwB;IAClC,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;gBAGhB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,EAChB,gBAAgB,CAAC,EAAE,MAAM,YAAA;IAGtC,IAAI,CACR,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC;IAyGrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAOhB,KAAK;CAepB"}

package/dist/system/runtime/agentvm-manager.js

@@ -1,66 +1,87 @@
+import { resolveShellTimeoutMs } from './shell-limits.js';
 let AgentVMClass = null;
 export class AgentVMManager {
     workspacePath;
     network;
+    defaultTimeoutMs;
     vm = null;
     kind = 'sandbox';
-    constructor(workspacePath, network) {
+    constructor(workspacePath, network, defaultTimeoutMs) {
         this.workspacePath = workspacePath;
         this.network = network;
+        this.defaultTimeoutMs = defaultTimeoutMs;
     }
-    async exec(command, signal, observer) {
+    async exec(command, signal, observer, options) {
         if (signal?.aborted) {
             throw abortError(signal.reason);
         }
+        const startedAt = Date.now();
+        const timeoutMs = resolveShellTimeoutMs(options?.timeoutMs ?? this.defaultTimeoutMs);
         const vm = await this.getVM();
         observer?.onStart?.({ command, backend: this.kind, backendLabel: 'sandbox[agentvm]' });
-        const result = signal
-            ? await new Promise((resolve, reject) => {
-                let settled = false;
-                const finishResolve = (value) => {
-                    if (settled) {
+        let timedOut = false;
+        const result = await new Promise((resolve, reject) => {
+            let settled = false;
+            let timer = null;
+            const cleanup = () => {
+                signal?.removeEventListener('abort', onAbort);
+                if (timer) {
+                    clearTimeout(timer);
+                    timer = null;
+                }
+            };
+            const finishResolve = (value) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                resolve(value);
+            };
+            const finishReject = (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                reject(error);
+            };
+            const onAbort = () => {
+                void this.dispose().catch(() => { });
+                finishReject(abortError(signal?.reason));
+            };
+            signal?.addEventListener('abort', onAbort, { once: true });
+            if (timeoutMs > 0) {
+                timer = setTimeout(() => {
+                    if (settled || signal?.aborted)
                         return;
-                    }
-                    settled = true;
-                    cleanup();
-                    resolve(value);
-                };
-                const finishReject = (error) => {
-                    if (settled) {
-                        return;
-                    }
-                    settled = true;
-                    cleanup();
-                    reject(error);
-                };
-                const cleanup = () => {
-                    signal.removeEventListener('abort', onAbort);
-                };
-                const onAbort = () => {
+                    timedOut = true;
                     void this.dispose().catch(() => { });
+                    finishResolve({
+                        stdout: '',
+                        stderr: `Command timed out after ${timeoutMs}ms`,
+                        exitCode: 124,
+                    });
+                }, timeoutMs);
+                timer.unref?.();
+            }
+            void vm.exec(command)
+                .then((value) => {
+                if (signal?.aborted) {
                     finishReject(abortError(signal.reason));
-                };
-                signal.addEventListener('abort', onAbort, { once: true });
-                void vm.exec(command)
-                    .then((value) => {
-                    if (signal.aborted) {
-                        finishReject(abortError(signal.reason));
-                        return;
-                    }
-                    finishResolve(value);
-                })
-                    .catch((error) => {
-                    if (signal.aborted) {
-                        finishReject(abortError(signal.reason));
-                        return;
-                    }
-                    finishReject(error);
-                });
+                    return;
+                }
+                finishResolve(value);
             })
-            : await vm.exec(command);
+                .catch((error) => {
+                if (signal?.aborted) {
+                    finishReject(abortError(signal.reason));
+                    return;
+                }
+                finishReject(error);
+            });
+        });
         const stdout = result.stdout ?? '';
         const stderr = result.stderr ?? '';
-        const exitCode = result.exitCode ?? 0;
+        const exitCode = timedOut ? 124 : (result.exitCode ?? 0);
         const execResult = {
             success: exitCode === 0,
             stdout,
@@ -68,7 +89,12 @@ export class AgentVMManager {
             exitCode,
             backend: this.kind,
             backendLabel: 'sandbox[agentvm]',
-            summary: exitCode === 0 ? 'Command completed successfully' : (stderr || `Command failed with exit code ${exitCode}`),
+            summary: timedOut
+                ? `Command timed out after ${timeoutMs}ms`
+                : exitCode === 0
+                    ? 'Command completed successfully'
+                    : (stderr || `Command failed with exit code ${exitCode}`),
+            timeMs: Date.now() - startedAt,
         };
         if (stdout) {
             observer?.onStdout?.({ command, chunk: stdout, backend: this.kind, backendLabel: execResult.backendLabel });

package/dist/system/runtime/agentvm-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentvm-manager.js","sourceRoot":"","sources":["../../../src/system/runtime/agentvm-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agentvm-manager.js","sourceRoot":"","sources":["../../../src/system/runtime/agentvm-manager.ts"],"names":[],"mappings":"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"}

package/dist/system/runtime/media.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Media references → resolved bytes.
+ *
+ * Media are workspace files. DML and conversation memory carry only
+ * `media(Path, Mime)`; the host resolves them to base64 when a model call needs
+ * the bytes. See `docs/DML_MEDIA.md`.
+ */
+import type { LLMBackendMedia, MediaRef } from '../../types.js';
+/** Mime types DML may reference (and that pi accepts as image input). */
+export declare const MEDIA_MIME_BY_EXT: Record<string, string>;
+export declare const DEFAULT_MEDIA_MAX_BYTES: number;
+/** Mime for a media path, or undefined when the extension is not allowed. */
+export declare function mimeForMediaPath(file: string): string | undefined;
+/** Resolve a workspace-relative media path, rejecting traversal/absolute paths. */
+export declare function resolveMediaPath(workspacePath: string, relPath: string): string;
+export interface ReadMediaOptions {
+    maxBytes?: number;
+}
+/** Read one media reference into base64, enforcing the size cap. */
+export declare function resolveMediaRef(workspacePath: string, ref: MediaRef, options?: ReadMediaOptions): Promise<LLMBackendMedia>;
+/** Read a list of media references (missing entries resolve to nothing). */
+export declare function resolveMediaRefs(workspacePath: string, refs: MediaRef[] | undefined, options?: ReadMediaOptions): Promise<LLMBackendMedia[]>;
+//# sourceMappingURL=media.d.ts.map

package/dist/system/runtime/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../src/system/runtime/media.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEhE,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMpD,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAmB,CAAC;AAExD,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAU/E;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,oEAAoE;AACpE,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,QAAQ,EACb,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAQ1B;AAED,4EAA4E;AAC5E,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,QAAQ,EAAE,GAAG,SAAS,EAC5B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,EAAE,CAAC,CAO5B"}

package/dist/system/runtime/media.js

@@ -0,0 +1,55 @@
+/**
+ * Media references → resolved bytes.
+ *
+ * Media are workspace files. DML and conversation memory carry only
+ * `media(Path, Mime)`; the host resolves them to base64 when a model call needs
+ * the bytes. See `docs/DML_MEDIA.md`.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/** Mime types DML may reference (and that pi accepts as image input). */
+export const MEDIA_MIME_BY_EXT = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+};
+export const DEFAULT_MEDIA_MAX_BYTES = 10 * 1024 * 1024;
+/** Mime for a media path, or undefined when the extension is not allowed. */
+export function mimeForMediaPath(file) {
+    return MEDIA_MIME_BY_EXT[path.extname(file).toLowerCase()];
+}
+/** Resolve a workspace-relative media path, rejecting traversal/absolute paths. */
+export function resolveMediaPath(workspacePath, relPath) {
+    const workspace = path.resolve(workspacePath);
+    if (path.isAbsolute(relPath)) {
+        throw new Error(`media path must be workspace-relative: ${relPath}`);
+    }
+    const abs = path.resolve(workspace, relPath);
+    if (abs !== workspace && !abs.startsWith(workspace + path.sep)) {
+        throw new Error(`media path escapes the workspace: ${relPath}`);
+    }
+    return abs;
+}
+/** Read one media reference into base64, enforcing the size cap. */
+export async function resolveMediaRef(workspacePath, ref, options = {}) {
+    const maxBytes = options.maxBytes ?? DEFAULT_MEDIA_MAX_BYTES;
+    const abs = resolveMediaPath(workspacePath, ref.path);
+    const data = await fs.readFile(abs);
+    if (data.byteLength > maxBytes) {
+        throw new Error(`media exceeds ${maxBytes} bytes: ${ref.path}`);
+    }
+    return { mimeType: ref.mimeType, data: data.toString('base64') };
+}
+/** Read a list of media references (missing entries resolve to nothing). */
+export async function resolveMediaRefs(workspacePath, refs, options = {}) {
+    if (!refs || refs.length === 0)
+        return [];
+    const out = [];
+    for (const ref of refs) {
+        out.push(await resolveMediaRef(workspacePath, ref, options));
+    }
+    return out;
+}
+//# sourceMappingURL=media.js.map

package/dist/system/runtime/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../../src/system/runtime/media.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAI7B,yEAAyE;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAExD,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,aAAqB,EAAE,OAAe;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,0CAA0C,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAMD,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,aAAqB,EACrB,GAAa,EACb,UAA4B,EAAE;IAE9B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAC7D,MAAM,GAAG,GAAG,gBAAgB,CAAC,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,UAAU,GAAG,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,WAAW,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,aAAqB,EACrB,IAA4B,EAC5B,UAA4B,EAAE;IAE9B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}