@deepagents/context 0.35.0 → 0.37.0

package/dist/lib/sandbox/openapi/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../../src/lib/sandbox/openapi/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAO,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAI1B,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAWzB,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,gBAAgB,CAAC,EAAE,CACjB,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,oBAAoB,KAC5B,OAAO,CAAC;CACd;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,gBAAgB,EAAE,YAAY,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AA8BD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CA8J3B"}

package/dist/lib/sandbox/openapi/format.d.ts

@@ -0,0 +1,11 @@
+import type { CommandResult } from 'bash-tool';
+export declare function formatResponse(value: unknown): CommandResult;
+export interface ErrorDetails {
+    group: string;
+    operation?: string;
+    code: string;
+    message: string;
+    extra?: Record<string, unknown>;
+}
+export declare function formatError(details: ErrorDetails): CommandResult;
+//# sourceMappingURL=format.d.ts.map

package/dist/lib/sandbox/openapi/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/lib/sandbox/openapi/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAU5D;AAcD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAYhE"}

package/dist/lib/sandbox/openapi/schema.d.ts

@@ -0,0 +1,9 @@
+import type { Client } from '@sdk-it/rpc';
+import type { SubcommandDefinition } from '../subcommand.ts';
+export interface SchemaEntry {
+    endpoint: string;
+    operationId: string;
+    summary?: string;
+}
+export declare function buildSchemaSubcommand(group: string, client: Client, entries: SchemaEntry[]): SubcommandDefinition;
+//# sourceMappingURL=schema.d.ts.map

package/dist/lib/sandbox/openapi/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/lib/sandbox/openapi/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG7D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EAAE,GACrB,oBAAoB,CAoCtB"}

package/dist/lib/sandbox/openapi/skill/index.d.ts

@@ -0,0 +1,6 @@
+import type { SkillUploadInput } from '../../types.ts';
+export interface OpenAPISkillOptions {
+    sandbox?: string;
+}
+export declare function openapiSkill(options?: OpenAPISkillOptions): SkillUploadInput;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/sandbox/openapi/skill/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/sandbox/openapi/skill/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,YAAY,CAC1B,OAAO,GAAE,mBAAwB,GAChC,gBAAgB,CAKlB"}

package/dist/lib/sandbox/openapi/skill/index.js

@@ -0,0 +1,14 @@
+// packages/context/src/lib/sandbox/openapi/skill/index.ts
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+var here = dirname(fileURLToPath(import.meta.url));
+function openapiSkill(options = {}) {
+  return {
+    host: here,
+    sandbox: options.sandbox ?? "/skills/openapi"
+  };
+}
+export {
+  openapiSkill
+};
+//# sourceMappingURL=index.js.map

package/dist/lib/sandbox/openapi/skill/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/lib/sandbox/openapi/skill/index.ts"],
+  "sourcesContent": ["import { dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { SkillUploadInput } from '../../types.ts';\n\nconst here = dirname(fileURLToPath(import.meta.url));\n\nexport interface OpenAPISkillOptions {\n  sandbox?: string;\n}\n\nexport function openapiSkill(\n  options: OpenAPISkillOptions = {},\n): SkillUploadInput {\n  return {\n    host: here,\n    sandbox: options.sandbox ?? '/skills/openapi',\n  };\n}\n"],
+  "mappings": ";AAAA,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAI9B,IAAM,OAAO,QAAQ,cAAc,YAAY,GAAG,CAAC;AAM5C,SAAS,aACd,UAA+B,CAAC,GACd;AAClB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS,QAAQ,WAAW;AAAA,EAC9B;AACF;",
+  "names": []
+}

package/dist/lib/sandbox/openapi/skill/openapi-cli/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: openapi-cli
+description: Use this skill any time the user asks to list, inspect, call, or use commands/operations of a bash-exposed API extension (e.g. datahub, github, stripe). These extensions are NOT standard CLIs — they do NOT support `--help` or `-h`. Each extension exposes one bash command (the "group") with a `schema` subcommand for discovery and operations invoked as `<group> <operation> '<json>'`. ALWAYS run `<group> schema` as the first action before doing anything else; never run `<group> --help` or `<group> -h` (they will fail).
+---
+
+# Invoking OpenAPI extensions
+
+Each `createOpenAPIExtension` registers one bash command (the **group**) under which every OpenAPI operation becomes a **subcommand**. You invoke operations through the bash tool. There is no separate API surface.
+
+## Always discover first
+
+Before calling any operation, run the `schema` subcommand once per session to learn what's available:
+
+```
+<group> schema
+```
+
+The output is a single JSON document:
+
+```json
+{
+  "group": "<group>",
+  "operations": [
+    {
+      "operationId": "...",
+      "method": "GET|POST|PUT|PATCH|DELETE",
+      "path": "/example/{id}",
+      "summary": "...",
+      "input": {
+        /* JSON Schema 7 */
+      }
+    }
+  ]
+}
+```
+
+Read `input` to learn the exact field names, types, required keys, and enums for that operation. Do not guess fields.
+
+## Invocation shape
+
+```
+<group> <operationId> '<json>'
+```
+
+- **One positional JSON argument.** Wrap it in single quotes so the shell parser treats it as one literal token.
+- **Flat object.** Pass every field at the top level — path params, query params, body fields, headers all live as flat keys in one object. The extension partitions them automatically based on the spec.
+- **No `--flags`.** There are no per-field flags. The whole payload is the JSON.
+
+Example:
+
+```
+github listIssues '{"owner":"acme","repo":"app","state":"open","per_page":10}'
+```
+
+`owner` and `repo` are path params; `state` and `per_page` are query params. You don't manage that split — the extension does.
+
+## Output format
+
+- **Object response** → one line of JSON on stdout.
+- **Array response** → newline-delimited JSON (NDJSON), one item per line. Pipe to `head -n N` to cap before reading the whole list.
+- **Errors** → JSON on stderr, exit code 1.
+
+```bash
+<group> <operation> '<json>' | head -n 5    # cap arrays
+```
+
+## Reading errors
+
+Stderr on failure is always JSON with this shape:
+
+```json
+{
+  "ok": false,
+  "group": "...",
+  "operation": "...",
+  "code": "...",
+  "message": "..."
+}
+```
+
+Branch on `code`:
+
+| Code                | What it means                                     | What to do                                                                  |
+| ------------------- | ------------------------------------------------- | --------------------------------------------------------------------------- |
+| `missing_input`     | No JSON arg passed                                | Add `'<json>'`                                                              |
+| `invalid_json`      | JSON didn't parse                                 | Fix the JSON literal                                                        |
+| `schema_validation` | Fields don't match the schema                     | Re-read `<group> schema` and fix shape; `issues` array lists each violation |
+| `path_param_unsafe` | A path-param value contains a forbidden character | See "Path-param rules" below                                                |
+| `request_failed`    | The upstream API errored or network failed        | Read `message`; surface to the user                                         |
+
+## Path-param rules
+
+Path-param values must be **plain segment identifiers**. The extension rejects, _before_ sending the request:
+
+- `/`, `\`, `?`, `#`, `&` (would change the route or query)
+- `.` and `..` as full values (would normalize away)
+- Control characters (`\x00`–`\x1f`, `\x7f`)
+- Pre-encoded sequences (`%2e`, `%2f`, etc. — they get re-decoded)
+
+If the user gives you something like `abc/def` for a single id, that's two segments — clarify with the user instead of forcing it through.
+
+## Workflow
+
+1. Run `<group> schema` once.
+2. Find the operation that matches the user's intent (`summary`, `path`, `method`).
+3. Build the JSON payload from the `input` schema.
+4. Invoke `<group> <operationId> '<json>'`.
+5. If `code: "schema_validation"`, read `issues[]` and fix exactly what it says.
+6. For list endpoints, prefer `| head -n N` over reading all rows.

package/dist/lib/sandbox/openapi/validate.d.ts

@@ -0,0 +1,7 @@
+export declare function extractPathParams(path: string): string[];
+export interface UnsafePathParam {
+    field: string;
+    reason: string;
+}
+export declare function findUnsafePathParam(input: unknown, names: string[]): UnsafePathParam | null;
+//# sourceMappingURL=validate.d.ts.map

package/dist/lib/sandbox/openapi/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/lib/sandbox/openapi/validate.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQxD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EAAE,GACd,eAAe,GAAG,IAAI,CAsCxB"}

package/dist/lib/sandbox/routing-sandbox.d.ts

@@ -0,0 +1,28 @@
+import type { Sandbox } from 'bash-tool';
+import { type IFileSystem } from 'just-bash';
+import { type MergedSandboxExtension, type SandboxExtension } from './extension.ts';
+export interface InstallableSandbox extends Sandbox {
+    install(ext: MergedSandboxExtension): void | Promise<void>;
+}
+export declare function isInstallable(s: Sandbox): s is InstallableSandbox;
+export interface CreateVirtualSandboxOptions {
+    fs: IFileSystem;
+    cwd?: string;
+    env?: Record<string, string>;
+}
+export declare function createVirtualSandbox(options: CreateVirtualSandboxOptions): Promise<InstallableSandbox>;
+export interface CreateRoutingSandboxOptions {
+    /**
+     * Backend sandbox to wrap. Single-use — the same `InstallableSandbox`
+     * cannot be passed to two routing sandboxes (install() is install-once).
+     */
+    backend: Sandbox;
+    hostExtensions: SandboxExtension[];
+    /**
+     * Working directory surfaced to host handlers via `ctx.cwd` on shallow
+     * dispatch. Defaults to `/`. Deep dispatch uses the backend's own cwd.
+     */
+    cwd?: string;
+}
+export declare function createRoutingSandbox(opts: CreateRoutingSandboxOptions): Promise<Sandbox>;
+//# sourceMappingURL=routing-sandbox.d.ts.map

package/dist/lib/sandbox/routing-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-sandbox.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/routing-sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAIL,KAAK,WAAW,EAGjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IACjD,OAAO,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,kBAAkB,CAEjE;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,WAAW,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,kBAAkB,CAAC,CA6D7B;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,OAAO,CAAC,CASlB"}

package/dist/lib/sandbox/subcommand.d.ts

@@ -0,0 +1,49 @@
+import type { CommandResult } from 'bash-tool';
+import type { ExtensionCommand, ExtensionCommandContext } from './extension.ts';
+/**
+ * Describes one subcommand inside a subcommand group (e.g. `sql run`,
+ * `sql validate`). Each subcommand has usage/description strings used to
+ * generate the group's usage message, an optional arg-repair function that
+ * fixes common LLM over-escaping, and the handler that implements it.
+ */
+export interface SubcommandDefinition {
+    usage: string;
+    description: string;
+    /**
+     * Optional repair pass applied to the subcommand's raw arg string before
+     * the shell parser sees it. Return `null` to leave the raw args unchanged.
+     */
+    repair?: (rawArgs: string) => string | null;
+    handler: (args: string[], ctx: ExtensionCommandContext) => CommandResult | Promise<CommandResult>;
+}
+/**
+ * Creates an {@link ExtensionCommand} that dispatches to one of several
+ * subcommand handlers based on the first positional arg. Unknown or missing
+ * subcommands print an auto-generated usage message to stderr with exit
+ * code 1.
+ *
+ * @example
+ * const sqlCommand = defineSubcommandGroup('sql', {
+ *   run:      { usage: 'run "SELECT ..."',      description: 'Execute query',  handler: ... },
+ *   validate: { usage: 'validate "SELECT ..."', description: 'Validate only', handler: ... },
+ * });
+ */
+export declare function defineSubcommandGroup(name: string, subcommands: Record<string, SubcommandDefinition>): ExtensionCommand;
+/**
+ * Strips a single layer of matching outer `"` or `'` quotes from a string,
+ * trimming surrounding whitespace. If the input is not wrapped in a matching
+ * pair, returns it trimmed but otherwise unchanged.
+ */
+export declare function stripQuoteArtifacts(raw: string): string;
+/**
+ * Pre-parse repair for a subcommand's raw arg string. Fires when the
+ * surrounding command fails to parse (via `buildSubcommandRepair`). Strips
+ * any leading/trailing quote, escapes inner single quotes with the POSIX
+ * `'\''` idiom, and wraps the result in single quotes so the shell parser
+ * will treat the payload as an opaque literal on the next pass.
+ *
+ * Returns `null` when the repaired arg string would be empty.
+ */
+export declare function repairQuotedArg(rawArgs: string): string | null;
+export declare function buildSubcommandRepair(name: string, subcommands: Record<string, SubcommandDefinition>): (raw: string) => string;
+//# sourceMappingURL=subcommand.d.ts.map

package/dist/lib/sandbox/subcommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subcommand.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/subcommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5C,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,uBAAuB,KACzB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAChD,gBAAgB,CAsBlB;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK9D;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,IAO1B,KAAK,MAAM,KAAG,MAAM,CA2B5C"}

package/dist/lib/sandbox/types.d.ts

@@ -0,0 +1,46 @@
+import type { Tool } from 'ai';
+import type { BashToolkit, CommandResult } from 'bash-tool';
+import type { SkillPathMapping } from '../skills/types.ts';
+import type { FileEvent } from './file-events.ts';
+/**
+ * Declarative skill upload: a host directory whose contents are copied into
+ * the sandbox at startup. The factory also parses each skill's frontmatter
+ * and exposes the result on `sandbox.skills`.
+ */
+export interface SkillUploadInput {
+    /** Host directory containing skill subdirectories (each with a SKILL.md). */
+    host: string;
+    /** Destination inside the sandbox (e.g. `/workspace/skills`). */
+    sandbox: string;
+}
+/**
+ * Input schema exposed by the wrapped bash tool — adds a required `reasoning`
+ * field on top of the upstream `{ command }` shape.
+ */
+export interface BashToolInput {
+    command: string;
+    reasoning: string;
+}
+/** The shared wrapper's bash tool type (widened from upstream). */
+export type WrappedBashTool = Tool<BashToolInput, CommandResult>;
+/**
+ * A sandbox that owns its skills. The factory uploads files + parses
+ * frontmatter once; `skills` is then the single source of truth for
+ * the `skills()` fragment. The `bash` tool is widened to require a
+ * `reasoning` input on every call.
+ */
+export interface AgentSandbox extends Omit<BashToolkit, 'bash' | 'tools'> {
+    /** Discovered skills — empty array if none were configured. */
+    skills: SkillPathMapping[];
+    bash: WrappedBashTool;
+    tools: Omit<BashToolkit['tools'], 'bash'> & {
+        bash: WrappedBashTool;
+    };
+    /**
+     * Drain and return file events observed since the last call. Attached by
+     * callers who composed an `ObservedFs` into their backend; omitted
+     * otherwise. The chat pipeline reads this via optional chaining.
+     */
+    drainFileEvents?(): FileEvent[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/sandbox/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACvE,+DAA+D;IAC/D,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,EAAE,eAAe,CAAA;KAAE,CAAC;IACtE;;;;OAIG;IACH,eAAe,CAAC,IAAI,SAAS,EAAE,CAAC;CACjC"}

package/dist/lib/sandbox/upload-skills.d.ts

@@ -0,0 +1,14 @@
+import type { Sandbox } from 'bash-tool';
+import type { SkillPathMapping } from '../skills/types.ts';
+import type { SkillUploadInput } from './types.ts';
+/**
+ * Discover skills under each host directory, write all non-dotfile, non-symlink
+ * files into the sandbox under the mapped path, and return the discovered
+ * skill metadata with sandbox paths.
+ *
+ * Later inputs override earlier ones when the same skill name appears twice.
+ * Files with the same sandbox path are overwritten in order, so the last
+ * writer wins.
+ */
+export declare function uploadSkills(sandbox: Sandbox, inputs: SkillUploadInput[]): Promise<SkillPathMapping[]>;
+//# sourceMappingURL=upload-skills.d.ts.map

package/dist/lib/sandbox/upload-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-skills.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/upload-skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAenD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,gBAAgB,EAAE,GACzB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAqC7B"}

package/dist/lib/sandbox/walk.d.ts

@@ -0,0 +1,17 @@
+export interface WalkedFile {
+    /** Absolute host path of the file. */
+    path: string;
+    /** Relative POSIX path from the walk root (suitable for sandbox targets). */
+    relativePath: string;
+    /** File contents (as Buffer to preserve binary assets). */
+    content: Buffer;
+}
+/**
+ * Recursively list every regular file under `root`. Skips symlinks (to avoid
+ * escaping `root`) and dotfiles / dot-directories (e.g. `.git`, `.DS_Store`,
+ * `.env`). Binary contents are preserved.
+ *
+ * Returns an empty array when `root` does not exist.
+ */
+export declare function walkDirectory(root: string): Promise<WalkedFile[]>;
+//# sourceMappingURL=walk.d.ts.map

package/dist/lib/sandbox/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/walk.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAiCvE"}

package/dist/lib/skills/fragments.d.ts

@@ -1,28 +1,23 @@
 import type { ContextFragment } from '../fragments.ts';
-import type { SkillsFragmentOptions } from './types.ts';
+import type { AgentSandbox } from '../sandbox/types.ts';
 /**
- * Create a context fragment containing available skills metadata.
+ * Create a context fragment containing available skills metadata from a
+ * sandbox.
  *
  * Follows Anthropic's progressive disclosure pattern:
  * - At startup: only skill metadata (name, description, path) is injected
  * - At runtime: LLM reads full SKILL.md using file tools when relevant
  *
- * @param options - Configuration including paths to scan and optional filtering
+ * @param sandbox - An AgentSandbox whose `.skills` has been populated by the
+ * sandbox factory (`createBashTool` / `createContainerTool`).
  *
  * @example
  * ```ts
- * const context = new ContextEngine({ userId: 'demo-user', store, chatId: 'demo' })
- *   .set(
- *     role('You are a helpful assistant.'),
- *     skills({
- *       paths: [
- *         { host: './skills', sandbox: '/skills/skills' }
- *       ]
- *     }),
- *   );
- *
- * // LLM now sees skill metadata with sandbox paths and can read full SKILL.md
+ * const sandbox = await createBashTool({
+ *   skills: [{ host: './skills', sandbox: '/skills/skills' }],
+ * });
+ * context.set(role('You are a helpful assistant.'), skills(sandbox));
  * ```
  */
-export declare function skills(options: SkillsFragmentOptions): ContextFragment;
+export declare function skills(sandbox: AgentSandbox): ContextFragment;
 //# sourceMappingURL=fragments.d.ts.map

package/dist/lib/skills/fragments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fragments.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/fragments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,eAAe,CAmFtE"}
+{"version":3,"file":"fragments.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/fragments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe,CAwB7D"}

package/dist/lib/skills/types.d.ts

@@ -14,8 +14,8 @@ export interface SkillMetadata {
     skillMdPath: string;
 }
 /**
- * Individual skill mount with name.
- * Output from getSkillMounts().
+ * Individual skill mount emitted by sandbox factories and consumed by the
+ * `skills()` fragment.
  */
 export interface SkillPathMapping {
     name: string;
@@ -25,31 +25,6 @@ export interface SkillPathMapping {
     /** Sandbox path to SKILL.md */
     sandbox: string;
 }
-/**
- * Options for the skills() fragment helper.
- */
-export interface SkillsFragmentOptions {
-    /**
-     * Skill directories to scan, with host-to-sandbox path mapping.
-     *
-     * @example
-     * ```ts
-     * skills({
-     *   paths: [
-     *     { host: 'apps/backend/dist/skills', sandbox: '/skills/skills' }
-     *   ]
-     * })
-     * ```
-     */
-    paths: {
-        host: string;
-        sandbox: string;
-    }[];
-    /** Skill names to exclude from the fragment */
-    exclude?: string[];
-    /** Skill names to include (if set, only these are included) */
-    include?: string[];
-}
 /**
  * Result of parsing a SKILL.md file.
  */

package/dist/lib/skills/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;;OAWG;IACH,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/lib/title.d.ts

@@ -1,5 +1,5 @@
 import type { UIMessage } from 'ai';
-import type { AgentModel } from '@deepagents/agent';
+import type { AgentModel } from './advisor.ts';
 export declare function staticChatTitle(message: UIMessage): string;
 export interface GenerateChatTitleOptions {
     message: UIMessage;

package/dist/lib/title.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../../src/lib/title.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAGpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA6BpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAE1D;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAyBjB"}
+{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../../src/lib/title.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAGpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA4B/C,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAE1D;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/lib/tracing/exporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../../src/lib/tracing/exporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAKzC;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,oBAAqB,YAAW,eAAe;;gBAS9C,OAAO,GAAE,2BAAgC;IAY/C,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAgEtE"}
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../../src/lib/tracing/exporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAKV,SAAS,EAEV,MAAM,YAAY,CAAC;AA6CpB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAKzC;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,oBAAqB,YAAW,eAAe;;gBAS9C,OAAO,GAAE,2BAAgC;IAY/C,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAgEtE"}

package/dist/lib/tracing/index.js

@@ -81,6 +81,32 @@ var BatchTraceProcessor = class {
 };
 
 // packages/context/src/lib/tracing/exporter.ts
+var STRINGIFIED_IO_TYPES = {
+  function: true,
+  transcription: true
+};
+function hasStringifiedIO(data) {
+  return data.type in STRINGIFIED_IO_TYPES;
+}
+function encodeField(value) {
+  if (value == null) return void 0;
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+function toWireItem(item) {
+  if (item.object !== "trace.span") return item;
+  const spanData = item.span_data;
+  if (!hasStringifiedIO(spanData)) {
+    return { ...item, span_data: spanData };
+  }
+  return {
+    ...item,
+    span_data: {
+      ...spanData,
+      input: encodeField(spanData.input),
+      output: encodeField(spanData.output)
+    }
+  };
+}
 var OpenAIExportError = class extends Error {
   status;
   constructor(status, body) {
@@ -125,7 +151,7 @@ var OpenAITracesExporter = class {
     if (this.#project) {
       headers["OpenAI-Project"] = this.#project;
     }
-    const body = JSON.stringify({ data: items });
+    const body = JSON.stringify({ data: items.map(toWireItem) });
     await this.#fetchWithRetry(this.#endpoint, {
       method: "POST",
       headers,
@@ -304,7 +330,6 @@ function normalizeUsage(usage) {
   return {
     input_tokens: usage.inputTokens,
     output_tokens: usage.outputTokens,
-    total_tokens: usage.totalTokens,
     ...Object.keys(details).length > 0 ? { details } : {}
   };
 }
@@ -547,8 +572,8 @@ function createOpenAITracesIntegration(options = {}) {
     if (openRuns.length === 1) {
       return openRuns[0];
     }
-    let bestState;
     let bestScore = 0;
+    let bestStates = [];
     const eventMetadataRef = asObjectRef(event.metadata);
     const eventContextRef = asObjectRef(event.experimental_context);
     const eventModelKey = event.model != null ? toModelKey(event.model) : void 0;
@@ -579,10 +604,22 @@ function createOpenAITracesIntegration(options = {}) {
       }
       if (score > bestScore) {
         bestScore = score;
-        bestState = state;
+        bestStates = [state];
+      } else if (score === bestScore && bestScore > 0) {
+        bestStates.push(state);
       }
     }
-    return bestState;
+    if (bestStates.length === 0) return void 0;
+    if (bestStates.length === 1) return bestStates[0];
+    if (event.response?.id != null) {
+      const withOpenStep = bestStates.filter((s) => s.stepSpans.length > 0);
+      if (withOpenStep.length >= 1) return withOpenStep[0];
+    }
+    if (event.toolCall?.toolCallId != null) {
+      const withOpenTool = bestStates.filter((s) => s.toolCallSpans.size > 0);
+      if (withOpenTool.length >= 1) return withOpenTool[0];
+    }
+    return bestStates[0];
   }
   function closeRunState(state) {
     const index = openRuns.indexOf(state);
@@ -628,16 +665,26 @@ function now() {
 function toModelKey(model) {
   return `${model.provider}:${model.modelId}`;
 }
+function canonicalizeMessageContent(content) {
+  if (typeof content === "string") {
+    return [{ type: "text", text: content }];
+  }
+  return content;
+}
+function canonicalizeMessages(messages) {
+  if (!Array.isArray(messages)) return messages;
+  return messages.map((message) => {
+    if (message == null || typeof message !== "object") return message;
+    const record = message;
+    if (!("content" in record)) return record;
+    return { ...record, content: canonicalizeMessageContent(record.content) };
+  });
+}
 function fingerprintInput(input) {
-  const normalizedMessages = input.messages ?? (typeof input.prompt === "string" ? [
-    {
-      role: "user",
-      content: [{ type: "text", text: input.prompt }]
-    }
-  ] : input.prompt);
+  const source = input.messages ?? (typeof input.prompt === "string" ? [{ role: "user", content: input.prompt }] : input.prompt);
   const normalized = normalizeForJson({
     system: input.system,
-    messages: normalizedMessages
+    messages: canonicalizeMessages(source)
   });
   if (normalized == null) {
     return void 0;