@vauban-org/agent-sdk 1.0.0 → 1.2.0

package/dist/skills/poc-md-loader/markdown-loader.js

@@ -0,0 +1,125 @@
+/**
+ * markdown-loader — prototype SKILL.md parser.
+ *
+ * Parses frontmatter (YAML-subset, no external dep) + markdown body.
+ * Returns a typed SkillManifest validated against a Zod schema.
+ *
+ * Constraint: no new npm deps — uses only node:fs/promises + zod (already in pkg).
+ *
+ * @poc-jetable
+ */
+import { readFile } from "node:fs/promises";
+import { z } from "zod";
+// ── Zod schema for SKILL.md frontmatter ──────────────────────────────────────
+const MetadataSchema = z
+    .object({
+    version: z.string().default("1.0.0"),
+    category: z.string().optional(),
+    tags: z.string().optional(),
+    "model-hint": z.string().optional(),
+    "env-required": z.string().optional(),
+    "env-mode": z.enum(["all", "at-least-one"]).default("all"),
+})
+    .strict();
+export const SkillManifestSchema = z
+    .object({
+    /** kebab-case, 1-64 chars */
+    name: z
+        .string()
+        .min(1)
+        .max(64)
+        .regex(/^[a-z0-9-]+$/, "name must be kebab-case"),
+    /** 1-1024 chars */
+    description: z.string().min(1).max(1024),
+    /** Space-separated tool grant list, e.g. "Bash(curl:*) Read" */
+    "allowed-tools": z.string().optional(),
+    metadata: MetadataSchema.optional(),
+})
+    .strict();
+// ── Minimal YAML-subset parser (no external dep) ─────────────────────────────
+// Supports: string scalars, nested objects (2-space indent), multi-line > strings.
+function parseYamlSubset(raw) {
+    const lines = raw.split("\n");
+    const result = {};
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (!line.trim() || line.trim().startsWith("#")) {
+            i++;
+            continue;
+        }
+        const colonIdx = line.indexOf(":");
+        if (colonIdx === -1) {
+            i++;
+            continue;
+        }
+        const indent = line.match(/^(\s*)/)?.[1].length ?? 0;
+        if (indent > 0) {
+            // nested key — handled by parent
+            i++;
+            continue;
+        }
+        const key = line.slice(0, colonIdx).trim();
+        const rest = line.slice(colonIdx + 1).trim();
+        // Multi-line folded scalar (>) — collect continuation lines
+        if (rest === ">") {
+            const parts = [];
+            i++;
+            while (i < lines.length &&
+                (lines[i].startsWith("  ") || lines[i].trim() === "")) {
+                parts.push(lines[i].trim());
+                i++;
+            }
+            result[key] = parts.filter(Boolean).join(" ");
+            continue;
+        }
+        // Nested object — collect child lines with 2-space indent
+        if (rest === "") {
+            const childLines = [];
+            i++;
+            while (i < lines.length && lines[i].startsWith("  ")) {
+                childLines.push(lines[i].slice(2)); // strip 2-space indent
+                i++;
+            }
+            if (childLines.length > 0) {
+                result[key] = parseYamlSubset(childLines.join("\n"));
+            }
+            continue;
+        }
+        // Quoted string
+        if ((rest.startsWith('"') && rest.endsWith('"')) ||
+            (rest.startsWith("'") && rest.endsWith("'"))) {
+            result[key] = rest.slice(1, -1);
+            i++;
+            continue;
+        }
+        // Plain scalar
+        result[key] = rest;
+        i++;
+    }
+    return result;
+}
+/**
+ * Parse a SKILL.md file at `filePath`.
+ * Extracts frontmatter (between --- delimiters) and validates with Zod.
+ * Returns typed manifest + raw markdown body.
+ */
+export async function loadSkillMd(filePath) {
+    const raw = await readFile(filePath, "utf-8");
+    // Extract frontmatter block
+    const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+    if (!fmMatch) {
+        throw new Error(`SKILL.md at ${filePath}: missing or malformed frontmatter (expected --- delimiters)`);
+    }
+    const [, frontmatter, body] = fmMatch;
+    const rawParsed = parseYamlSubset(frontmatter);
+    // Validate with Zod
+    const result = SkillManifestSchema.safeParse(rawParsed);
+    if (!result.success) {
+        throw new Error(`SKILL.md at ${filePath}: invalid frontmatter — ${result.error.issues
+            .map((i) => `${i.path.join(".")}: ${i.message}`)
+            .join("; ")}`);
+    }
+    return { manifest: result.data, body: body.trim() };
+}
+//# sourceMappingURL=markdown-loader.js.map

package/dist/skills/poc-md-loader/markdown-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-loader.js","sourceRoot":"","sources":["../../../src/skills/poc-md-loader/markdown-loader.ts"],"names":[],"mappings":"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"}

package/dist/skills/poc-md-loader/runner.d.ts

@@ -0,0 +1,24 @@
+/**
+ * runner — prototype SKILL.md execution harness.
+ *
+ * Loads a SKILL.md manifest, validates env requirements,
+ * dynamically imports the companion script.ts, and executes it.
+ *
+ * No integration with SkillRegistry — standalone POC harness only.
+ *
+ * @poc-jetable
+ */
+import { type SkillManifest } from "./markdown-loader.js";
+export interface RunnerResult<T = unknown> {
+    output: T;
+    manifest: SkillManifest;
+    coldStartMs: number;
+}
+/**
+ * Run a SKILL.md skill by directory path.
+ *
+ * @param skillDir  Absolute path to directory containing SKILL.md + script.ts
+ * @param input     Raw input object passed to script.execute()
+ */
+export declare function runSkillMd<T = unknown>(skillDir: string, input: unknown): Promise<RunnerResult<T>>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/skills/poc-md-loader/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/skills/poc-md-loader/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAoD1B"}

package/dist/skills/poc-md-loader/runner.js

@@ -0,0 +1,57 @@
+/**
+ * runner — prototype SKILL.md execution harness.
+ *
+ * Loads a SKILL.md manifest, validates env requirements,
+ * dynamically imports the companion script.ts, and executes it.
+ *
+ * No integration with SkillRegistry — standalone POC harness only.
+ *
+ * @poc-jetable
+ */
+import { join } from "node:path";
+import { loadSkillMd } from "./markdown-loader.js";
+/**
+ * Run a SKILL.md skill by directory path.
+ *
+ * @param skillDir  Absolute path to directory containing SKILL.md + script.ts
+ * @param input     Raw input object passed to script.execute()
+ */
+export async function runSkillMd(skillDir, input) {
+    const t0 = performance.now();
+    // Step 1: Load + validate SKILL.md
+    const skillMdPath = join(skillDir, "SKILL.md");
+    const { manifest } = await loadSkillMd(skillMdPath);
+    // Step 2: Check env requirements
+    const envRequired = manifest.metadata?.["env-required"];
+    const envMode = manifest.metadata?.["env-mode"] ?? "all";
+    if (envRequired) {
+        const keys = envRequired.split(" ").filter(Boolean);
+        const missing = keys.filter((k) => !process.env[k]);
+        if (envMode === "all" && missing.length > 0) {
+            throw new Error(`Skill '${manifest.name}': missing required env vars: ${missing.join(", ")}`);
+        }
+        if (envMode === "at-least-one" && missing.length === keys.length) {
+            throw new Error(`Skill '${manifest.name}': at least one of ${keys.join(", ")} must be set`);
+        }
+    }
+    // Step 3: Dynamic import of companion script
+    const scriptPath = join(skillDir, "script.js");
+    // In test context (tsx/ts-node), import .ts directly; in compiled, import .js
+    let scriptModule;
+    try {
+        scriptModule = (await import(scriptPath));
+    }
+    catch {
+        // Fallback: try .ts extension (tsx / ts-node context)
+        const scriptTsPath = join(skillDir, "script.ts");
+        scriptModule = (await import(scriptTsPath));
+    }
+    if (typeof scriptModule.execute !== "function") {
+        throw new Error(`Skill '${manifest.name}': script must export an execute() function`);
+    }
+    // Step 4: Execute
+    const output = await scriptModule.execute(input);
+    const coldStartMs = performance.now() - t0;
+    return { output, manifest, coldStartMs };
+}
+//# sourceMappingURL=runner.js.map

package/dist/skills/poc-md-loader/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/skills/poc-md-loader/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAsB,MAAM,sBAAsB,CAAC;AAQvE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,KAAc;IAEd,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAE7B,mCAAmC;IACnC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAEpD,iCAAiC;IACjC,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;IACzD,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,CAAC,IAAI,iCAAiC,OAAO,CAAC,IAAI,CAClE,IAAI,CACL,EAAE,CACJ,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,KAAK,cAAc,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,CAAC,IAAI,sBAAsB,IAAI,CAAC,IAAI,CACpD,IAAI,CACL,cAAc,CAChB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC/C,8EAA8E;IAC9E,IAAI,YAAyD,CAAC;IAC9D,IAAI,CAAC;QACH,YAAY,GAAG,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAwB,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;QACtD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjD,YAAY,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAwB,CAAC;IACrE,CAAC;IAED,IAAI,OAAO,YAAY,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,UAAU,QAAQ,CAAC,IAAI,6CAA6C,CACrE,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAE3C,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAC3C,CAAC"}

package/dist/skills/poc-md-loader/vitest.poc.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vite").UserConfig;
+export default _default;
+//# sourceMappingURL=vitest.poc.config.d.ts.map

package/dist/skills/poc-md-loader/vitest.poc.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.poc.config.d.ts","sourceRoot":"","sources":["../../../src/skills/poc-md-loader/vitest.poc.config.ts"],"names":[],"mappings":";AAMA,wBAMG"}

package/dist/skills/poc-md-loader/vitest.poc.config.js

@@ -0,0 +1,13 @@
+/**
+ * Vitest config for POC-B tests only — not part of production test suite.
+ * @poc-jetable
+ */
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+    test: {
+        environment: "node",
+        include: ["src/skills/poc-md-loader/**/*.test.ts"],
+        globals: false,
+    },
+});
+//# sourceMappingURL=vitest.poc.config.js.map

package/dist/skills/poc-md-loader/vitest.poc.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.poc.config.js","sourceRoot":"","sources":["../../../src/skills/poc-md-loader/vitest.poc.config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,CAAC,uCAAuC,CAAC;QAClD,OAAO,EAAE,KAAK;KACf;CACF,CAAC,CAAC"}

package/dist/skills/poc-md-loader/web-search/script.d.ts

@@ -0,0 +1,33 @@
+/**
+ * web-search execution script — POC MD loader variant.
+ *
+ * Identical logic to web-search.ts but as a standalone function
+ * with no SDK imports (no Skill<> interface, no withSkillSpan, no errors.ts).
+ * This measures the "pure script" execution path of the SKILL.md pattern.
+ *
+ * @poc-jetable
+ */
+export interface WebSearchInput {
+    query: string;
+    limit?: number;
+}
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+export interface WebSearchOutput {
+    results: WebSearchResult[];
+    provider: "brave" | "tavily" | "replay";
+}
+export declare class SkillNotConfiguredError extends Error {
+    constructor(missing: string[]);
+}
+export declare class SkillExecutionError extends Error {
+    constructor(message: string);
+}
+/**
+ * Execute web search. Same logic as web-search.ts#webSearch.execute().
+ */
+export declare function execute(input: WebSearchInput): Promise<WebSearchOutput>;
+//# sourceMappingURL=script.d.ts.map

package/dist/skills/poc-md-loader/web-search/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../../../src/skills/poc-md-loader/web-search/script.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACzC;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM,EAAE;CAI9B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAiE7E"}

package/dist/skills/poc-md-loader/web-search/script.js

@@ -0,0 +1,75 @@
+/**
+ * web-search execution script — POC MD loader variant.
+ *
+ * Identical logic to web-search.ts but as a standalone function
+ * with no SDK imports (no Skill<> interface, no withSkillSpan, no errors.ts).
+ * This measures the "pure script" execution path of the SKILL.md pattern.
+ *
+ * @poc-jetable
+ */
+export class SkillNotConfiguredError extends Error {
+    constructor(missing) {
+        super(`web-search not configured: missing env ${missing.join(", ")}`);
+        this.name = "SkillNotConfiguredError";
+    }
+}
+export class SkillExecutionError extends Error {
+    constructor(message) {
+        super(`web-search failed: ${message}`);
+        this.name = "SkillExecutionError";
+    }
+}
+/**
+ * Execute web search. Same logic as web-search.ts#webSearch.execute().
+ */
+export async function execute(input) {
+    const query = input.query;
+    const limit = input.limit ?? 5;
+    const braveKey = process.env.BRAVE_SEARCH_KEY;
+    const tavilyKey = process.env.TAVILY_API_KEY;
+    if (!braveKey && !tavilyKey) {
+        throw new SkillNotConfiguredError(["BRAVE_SEARCH_KEY", "TAVILY_API_KEY"]);
+    }
+    if (braveKey) {
+        const url = `https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(query)}&count=${limit}`;
+        const res = await fetch(url, {
+            headers: {
+                Accept: "application/json",
+                "X-Subscription-Token": braveKey,
+            },
+        });
+        if (res.ok) {
+            const data = (await res.json());
+            const results = (data.web?.results ?? []).map((r) => ({
+                title: r.title ?? "",
+                url: r.url ?? "",
+                snippet: r.description ?? "",
+            }));
+            return { results, provider: "brave" };
+        }
+        if (!tavilyKey) {
+            throw new SkillExecutionError(`brave ${res.status}`);
+        }
+    }
+    // Tavily fallback
+    const res = await fetch("https://api.tavily.com/search", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            api_key: tavilyKey,
+            query,
+            max_results: limit,
+        }),
+    });
+    if (!res.ok) {
+        throw new SkillExecutionError(`tavily ${res.status}`);
+    }
+    const data = (await res.json());
+    const results = (data.results ?? []).map((r) => ({
+        title: r.title ?? "",
+        url: r.url ?? "",
+        snippet: r.content ?? "",
+    }));
+    return { results, provider: "tavily" };
+}
+//# sourceMappingURL=script.js.map

package/dist/skills/poc-md-loader/web-search/script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.js","sourceRoot":"","sources":["../../../../src/skills/poc-md-loader/web-search/script.ts"],"names":[],"mappings":"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"}

package/dist/skills/record-outcome.d.ts

@@ -21,18 +21,18 @@ declare const inputSchema: z.ZodObject<{
     occurred_at: z.ZodDefault<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strict", z.ZodTypeAny, {
-    value_cents: number;
-    agent_id: string;
     outcome_type: string;
     agent_run_id: string | null;
+    agent_id: string;
+    value_cents: number;
     currency: string;
     occurred_at: string;
     metadata?: Record<string, unknown> | undefined;
 }, {
-    value_cents: number;
-    agent_id: string;
     outcome_type: string;
     agent_run_id: string | null;
+    agent_id: string;
+    value_cents: number;
     metadata?: Record<string, unknown> | undefined;
     currency?: string | undefined;
     occurred_at?: string | undefined;

package/dist/skills/send-email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"send-email.d.ts","sourceRoot":"","sources":["../../src/skills/send-email.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,iCAAiC,CAAC;AAI3E,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;EAQN,CAAC;AACZ,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,cAAc,EAAE,eAAe,CA+E5D,CAAC"}
+{"version":3,"file":"send-email.d.ts","sourceRoot":"","sources":["../../src/skills/send-email.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,iCAAiC,CAAC;AAI3E,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;EAQN,CAAC;AACZ,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAcD,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,cAAc,EAAE,eAAe,CA+E5D,CAAC"}

package/dist/skills/send-email.js

@@ -19,6 +19,18 @@ const inputSchema = z
     html: z.string().optional(),
 })
     .strict();
+/**
+ * Prefer ctx.secrets (audit-trail-bearing) over process.env. When no secrets
+ * accessor is configured, falls back to env so legacy callers see no behavior
+ * change. When the secret is absent in both, returns undefined.
+ */
+function readSecret(ctx, name) {
+    if (ctx.secrets) {
+        if (ctx.secrets.has(name))
+            return ctx.secrets.get(name);
+    }
+    return process.env[name];
+}
 export const sendEmail = {
     name: "send_email",
     inputSchema,
@@ -30,9 +42,9 @@ export const sendEmail = {
             return { delivered: false, provider: "replay", message_id: null };
         }
         return withSkillSpan("send_email", async () => {
-            const resendKey = process.env.RESEND_API_KEY;
-            const smtpUrl = process.env.SMTP_URL;
-            const defaultFrom = process.env.EMAIL_FROM ?? input.from;
+            const resendKey = readSecret(ctx, "RESEND_API_KEY");
+            const smtpUrl = readSecret(ctx, "SMTP_URL");
+            const defaultFrom = readSecret(ctx, "EMAIL_FROM") ?? input.from;
             if (!resendKey && !smtpUrl) {
                 throw new SkillNotConfiguredError("send_email", [
                     "RESEND_API_KEY",

package/dist/skills/send-email.js.map

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

package/dist/skills/slack-notify.d.ts

@@ -14,23 +14,23 @@ declare const inputSchema: z.ZodEffects<z.ZodObject<{
     blocks: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">>;
 }, "strict", z.ZodTypeAny, {
     text: string;
-    binding_user_id?: string | undefined;
     channel?: string | undefined;
+    binding_user_id?: string | undefined;
     blocks?: Record<string, unknown>[] | undefined;
 }, {
     text: string;
-    binding_user_id?: string | undefined;
     channel?: string | undefined;
+    binding_user_id?: string | undefined;
     blocks?: Record<string, unknown>[] | undefined;
 }>, {
     text: string;
-    binding_user_id?: string | undefined;
     channel?: string | undefined;
+    binding_user_id?: string | undefined;
     blocks?: Record<string, unknown>[] | undefined;
 }, {
     text: string;
-    binding_user_id?: string | undefined;
     channel?: string | undefined;
+    binding_user_id?: string | undefined;
     blocks?: Record<string, unknown>[] | undefined;
 }>;
 type SlackNotifyInput = z.infer<typeof inputSchema>;

package/dist/skills/starknet-balance.d.ts

@@ -14,8 +14,8 @@ declare const inputSchema: z.ZodObject<{
     /** Override token contract for "VAULT" or custom tokens. */
     contract: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    token: "STRK" | "ETH" | "VAULT";
     address: string;
+    token: "STRK" | "ETH" | "VAULT";
     contract?: string | undefined;
 }, {
     address: string;

package/dist/skills/telegram-notify.d.ts

@@ -15,23 +15,23 @@ declare const inputSchema: z.ZodEffects<z.ZodObject<{
     parse_mode: z.ZodOptional<z.ZodEnum<["MarkdownV2", "HTML"]>>;
 }, "strict", z.ZodTypeAny, {
     text: string;
-    chat_id?: string | undefined;
     binding_user_id?: string | undefined;
+    chat_id?: string | undefined;
     parse_mode?: "MarkdownV2" | "HTML" | undefined;
 }, {
     text: string;
-    chat_id?: string | undefined;
     binding_user_id?: string | undefined;
+    chat_id?: string | undefined;
     parse_mode?: "MarkdownV2" | "HTML" | undefined;
 }>, {
     text: string;
-    chat_id?: string | undefined;
     binding_user_id?: string | undefined;
+    chat_id?: string | undefined;
     parse_mode?: "MarkdownV2" | "HTML" | undefined;
 }, {
     text: string;
-    chat_id?: string | undefined;
     binding_user_id?: string | undefined;
+    chat_id?: string | undefined;
     parse_mode?: "MarkdownV2" | "HTML" | undefined;
 }>;
 type TelegramNotifyInput = z.infer<typeof inputSchema>;

package/dist/skills/web-search.d.ts

@@ -11,8 +11,8 @@ declare const inputSchema: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
-    limit: number;
     query: string;
+    limit: number;
 }, {
     query: string;
     limit?: number | undefined;

package/dist/testing/index.d.ts

@@ -22,6 +22,9 @@ export { outcomePortConformance } from "./outcome-conformance.js";
 export { loggerPortConformance } from "./logger-conformance.js";
 export { dbPortConformance } from "./db-conformance.js";
 export type { ConformanceRunner } from "./runner.js";
+export { brainPortContract } from "./contracts/brain-port.contract.js";
+export { eventBusContract } from "./contracts/event-bus.contract.js";
+export { economicObserverContract } from "./contracts/economic-observer.contract.js";
 export { TestEventBus } from "./test-event-bus.js";
 export { TestBrainPort } from "./test-brain-port.js";
 export { TestChildAgentPort } from "./test-child-agent.js";

package/dist/testing/test-brain-port.d.ts

@@ -5,6 +5,10 @@
  * Maps. Use for agent unit tests that need to archive/query without
  * external infrastructure.
  *
+ * OTel spans are emitted on archiveKnowledge and queryKnowledge via
+ * @opentelemetry/api. Gracefully degrades to noop spans when no OTel SDK
+ * is installed.
+ *
  * @public
  */
 import type { BrainPort, BrainEntry, BrainEntryInput, BrainQueryFilters } from "../ports/brain.js";

package/dist/testing/test-brain-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-brain-port.d.ts","sourceRoot":"","sources":["../../src/testing/test-brain-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAOnG,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzH,qBAAa,aAAc,YAAW,SAAS;IAC7C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAE1C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,MAAM,CAAK;;IASb,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAcpE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAcvF,yBAAyB;IACzB,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"test-brain-port.d.ts","sourceRoot":"","sources":["../../src/testing/test-brain-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAI3B,qBAAa,aAAc,YAAW,SAAS;IAC7C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAE1C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,MAAM,CAAK;;IASb,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAuCpE,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,UAAU,EAAE,CAAC;IA0CxB,yBAAyB;IACzB,KAAK,IAAI,IAAI;CAId"}