@vauban-org/agent-sdk 0.16.0

package/dist/skills/record-outcome.js.map

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

package/dist/skills/run-sql-query.d.ts

@@ -0,0 +1,33 @@
+/**
+ * run_sql_query — read-only SQL on the agent's scoped DB (cc:read scope).
+ *
+ * Pre-check: rejects any query that contains a write keyword
+ * (INSERT/UPDATE/DELETE/DROP/ALTER/TRUNCATE/GRANT/CREATE) outside of
+ * a string literal.
+ *
+ * NOTE: this is a defence-in-depth check; DB-level read-only role is
+ * still required at the host wiring layer.
+ *
+ * @public
+ */
+import { z } from "zod";
+import type { Skill } from "../orchestration/ooda/skills.js";
+declare const inputSchema: z.ZodObject<{
+    sql: z.ZodString;
+    params: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+}, "strict", z.ZodTypeAny, {
+    sql: string;
+    params?: unknown[] | undefined;
+}, {
+    sql: string;
+    params?: unknown[] | undefined;
+}>;
+type RunSqlQueryInput = z.infer<typeof inputSchema>;
+export interface RunSqlQueryOutput {
+    rows: object[];
+    rowCount: number;
+}
+export declare function isReadOnlySql(sql: string): boolean;
+export declare const runSqlQuery: Skill<RunSqlQueryInput, RunSqlQueryOutput>;
+export {};
+//# sourceMappingURL=run-sql-query.d.ts.map

package/dist/skills/run-sql-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-sql-query.d.ts","sourceRoot":"","sources":["../../src/skills/run-sql-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,iCAAiC,CAAC;AAI3E,QAAA,MAAM,WAAW;;;;;;;;;EAKN,CAAC;AACZ,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AA6BD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,gBAAgB,EAAE,iBAAiB,CAoBlE,CAAC"}

package/dist/skills/run-sql-query.js

@@ -0,0 +1,78 @@
+/**
+ * run_sql_query — read-only SQL on the agent's scoped DB (cc:read scope).
+ *
+ * Pre-check: rejects any query that contains a write keyword
+ * (INSERT/UPDATE/DELETE/DROP/ALTER/TRUNCATE/GRANT/CREATE) outside of
+ * a string literal.
+ *
+ * NOTE: this is a defence-in-depth check; DB-level read-only role is
+ * still required at the host wiring layer.
+ *
+ * @public
+ */
+import { z } from "zod";
+import { SqlReadOnlyViolation } from "./errors.js";
+import { withSkillSpan } from "./_otel.js";
+const inputSchema = z
+    .object({
+    sql: z.string().min(1).max(8_000),
+    params: z.array(z.unknown()).max(64).optional(),
+})
+    .strict();
+const WRITE_KEYWORDS = [
+    "INSERT",
+    "UPDATE",
+    "DELETE",
+    "DROP",
+    "ALTER",
+    "TRUNCATE",
+    "GRANT",
+    "REVOKE",
+    "CREATE",
+    "REPLACE",
+    "MERGE",
+    "CALL",
+    "VACUUM",
+    "REINDEX",
+    "COPY",
+];
+/** Strips PostgreSQL string literals + line/block comments before keyword scan. */
+function stripStringsAndComments(sql) {
+    return sql
+        .replace(/--[^\n]*/g, " ")
+        .replace(/\/\*[\s\S]*?\*\//g, " ")
+        .replace(/'(?:''|[^'])*'/g, " ")
+        .replace(/\$\$[\s\S]*?\$\$/g, " ");
+}
+export function isReadOnlySql(sql) {
+    const stripped = stripStringsAndComments(sql).toUpperCase();
+    for (const kw of WRITE_KEYWORDS) {
+        const re = new RegExp(`(^|[^A-Z_])${kw}([^A-Z_]|$)`);
+        if (re.test(stripped))
+            return false;
+    }
+    return true;
+}
+export const runSqlQuery = {
+    name: "run_sql_query",
+    inputSchema,
+    async execute(input, ctx) {
+        if (!isReadOnlySql(input.sql)) {
+            throw new SqlReadOnlyViolation(input.sql);
+        }
+        if (ctx.isReplay) {
+            const mock = ctx.dryRunMocks["run_sql_query"];
+            if (mock)
+                return mock(input);
+            return { rows: [], rowCount: 0 };
+        }
+        return withSkillSpan("run_sql_query", async () => {
+            const result = await ctx.db.query(input.sql, input.params);
+            return {
+                rows: result.rows,
+                rowCount: result.rowCount ?? result.rows.length,
+            };
+        });
+    },
+};
+//# sourceMappingURL=run-sql-query.js.map

package/dist/skills/run-sql-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-sql-query.js","sourceRoot":"","sources":["../../src/skills/run-sql-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC;KACD,MAAM,EAAE,CAAC;AAQZ,MAAM,cAAc,GAAG;IACrB,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,OAAO;IACP,UAAU;IACV,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO;IACP,MAAM;IACN,QAAQ;IACR,SAAS;IACT,MAAM;CACP,CAAC;AAEF,mFAAmF;AACnF,SAAS,uBAAuB,CAAC,GAAW;IAC1C,OAAO,GAAG;SACP,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;SACzB,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC;SACjC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QACrD,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAA+C;IACrE,IAAI,EAAE,eAAe;IACrB,WAAW;IACX,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAiB;QACpC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;YAC9C,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAsB,CAAC;YAClD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,aAAa,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAS,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACnE,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM;aAChD,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * send_email — SMTP via SMTP_URL OR Resend API key (whichever set).
+ *
+ * SDK does NOT pull nodemailer. SMTP_URL takes precedence ONLY if a
+ * dynamically-imported `nodemailer` is available; else falls back to
+ * Resend HTTP API. Choose one path at deploy time.
+ *
+ * @public
+ */
+import { z } from "zod";
+import type { Skill } from "../orchestration/ooda/skills.js";
+declare const inputSchema: z.ZodObject<{
+    to: z.ZodString;
+    from: z.ZodOptional<z.ZodString>;
+    subject: z.ZodString;
+    text: z.ZodString;
+    html: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    text: string;
+    to: string;
+    subject: string;
+    from?: string | undefined;
+    html?: string | undefined;
+}, {
+    text: string;
+    to: string;
+    subject: string;
+    from?: string | undefined;
+    html?: string | undefined;
+}>;
+type SendEmailInput = z.infer<typeof inputSchema>;
+export interface SendEmailOutput {
+    delivered: boolean;
+    provider: "smtp" | "resend" | "replay";
+    message_id: string | null;
+}
+export declare const sendEmail: Skill<SendEmailInput, SendEmailOutput>;
+export {};
+//# sourceMappingURL=send-email.d.ts.map

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

@@ -0,0 +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"}

package/dist/skills/send-email.js

@@ -0,0 +1,100 @@
+/**
+ * send_email — SMTP via SMTP_URL OR Resend API key (whichever set).
+ *
+ * SDK does NOT pull nodemailer. SMTP_URL takes precedence ONLY if a
+ * dynamically-imported `nodemailer` is available; else falls back to
+ * Resend HTTP API. Choose one path at deploy time.
+ *
+ * @public
+ */
+import { z } from "zod";
+import { SkillExecutionError, SkillNotConfiguredError } from "./errors.js";
+import { withSkillSpan } from "./_otel.js";
+const inputSchema = z
+    .object({
+    to: z.string().email(),
+    from: z.string().email().optional(),
+    subject: z.string().min(1).max(998),
+    text: z.string().min(1),
+    html: z.string().optional(),
+})
+    .strict();
+export const sendEmail = {
+    name: "send_email",
+    inputSchema,
+    async execute(input, ctx) {
+        if (ctx.isReplay) {
+            const mock = ctx.dryRunMocks["send_email"];
+            if (mock)
+                return mock(input);
+            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;
+            if (!resendKey && !smtpUrl) {
+                throw new SkillNotConfiguredError("send_email", [
+                    "RESEND_API_KEY",
+                    "SMTP_URL",
+                ]);
+            }
+            if (!defaultFrom) {
+                throw new SkillNotConfiguredError("send_email", [
+                    "EMAIL_FROM (or input.from)",
+                ]);
+            }
+            // Prefer Resend (HTTP) — no native dep.
+            if (resendKey) {
+                const res = await fetch("https://api.resend.com/emails", {
+                    method: "POST",
+                    headers: {
+                        Authorization: `Bearer ${resendKey}`,
+                        "Content-Type": "application/json",
+                    },
+                    body: JSON.stringify({
+                        from: defaultFrom,
+                        to: [input.to],
+                        subject: input.subject,
+                        text: input.text,
+                        html: input.html,
+                    }),
+                });
+                if (!res.ok) {
+                    throw new SkillExecutionError("send_email", `resend ${res.status}`, {
+                        status: res.status,
+                    });
+                }
+                const data = (await res.json());
+                return {
+                    delivered: true,
+                    provider: "resend",
+                    message_id: data.id ?? null,
+                };
+            }
+            // SMTP via dynamic import — host must add nodemailer if used.
+            try {
+                const mod = (await import(/* @vite-ignore */ "nodemailer"));
+                const transport = mod.createTransport(smtpUrl);
+                const info = await transport.sendMail({
+                    from: defaultFrom,
+                    to: input.to,
+                    subject: input.subject,
+                    text: input.text,
+                    html: input.html,
+                });
+                return {
+                    delivered: true,
+                    provider: "smtp",
+                    message_id: info.messageId ?? null,
+                };
+            }
+            catch (err) {
+                throw new SkillExecutionError("send_email", "smtp transport error", {
+                    cause: err,
+                });
+            }
+        });
+    },
+};
+//# sourceMappingURL=send-email.js.map

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

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

package/dist/skills/skill-ledger.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Skill Ledger — types + resolver for persisted winning strategies.
+ *
+ * SkillLedgerEntry mirrors the `skill_ledger` DB schema (migration 028).
+ * resolveSkillsForAgent implements LIFO scope-typed resolution:
+ *   1. Match by agent_id (exact) OR agent_id='*' (cross-agent wildcard)
+ *   2. Match outcome_type
+ *   3. lifecycle_state === 'active'
+ *   4. Sort descending by created_at (LIFO — most recent wins)
+ *
+ * @public
+ * Ref: command-center:sprint-530:quick-4
+ */
+export type SkillLifecycleState = "active" | "archived" | "deprecated";
+export interface SkillLedgerEntry {
+    /** UUID primary key */
+    id: string;
+    /** Human-readable skill name (e.g. "kelly_cap_0.12_conviction_gt_0.8") */
+    skill_name: string;
+    /** SHA-256 of the skill payload — deduplication key */
+    skill_sha256: string;
+    /** Run IDs from which this skill was extracted */
+    source_run_ids: string[];
+    /**
+     * Agent that owns this skill.
+     * '*' means promoted cross-agent (available to all agents with matching outcome_type).
+     */
+    agent_id: string;
+    /** Outcome type this skill applies to (e.g. "trade_signal", "risk_report") */
+    outcome_type: string;
+    /** Brain entry ID where the skill rationale is archived */
+    brain_entry_id: string;
+    /** Arbitrary performance / quality metrics */
+    metrics: Record<string, unknown>;
+    lifecycle_state: SkillLifecycleState;
+    created_at: string;
+}
+export interface ResolveSkillsOptions {
+    /** Agent ID to resolve for (exact match OR '*' wildcard entries). */
+    agentId: string;
+    /** Outcome type filter (exact match). */
+    outcomeType: string;
+    /**
+     * Maximum number of skills to return.
+     * Defaults to all matching entries (LIFO ordered).
+     */
+    limit?: number;
+}
+/**
+ * Resolve skills for a given agent + outcome type.
+ *
+ * LIFO scope-typed algorithm:
+ *   - Include entries where `agent_id === agentId` OR `agent_id === '*'`
+ *   - Include entries where `outcome_type === outcomeType`
+ *   - Include entries where `lifecycle_state === 'active'`
+ *   - Sort descending by `created_at` (most recent first)
+ *   - Apply optional `limit`
+ *
+ * Pure function — no side effects.
+ */
+export declare function resolveSkillsForAgent(skills: readonly SkillLedgerEntry[], opts: ResolveSkillsOptions): SkillLedgerEntry[];
+//# sourceMappingURL=skill-ledger.d.ts.map

package/dist/skills/skill-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-ledger.d.ts","sourceRoot":"","sources":["../../src/skills/skill-ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,eAAe,EAAE,mBAAmB,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,IAAI,EAAE,oBAAoB,GACzB,gBAAgB,EAAE,CAkBpB"}

package/dist/skills/skill-ledger.js

@@ -0,0 +1,40 @@
+/**
+ * Skill Ledger — types + resolver for persisted winning strategies.
+ *
+ * SkillLedgerEntry mirrors the `skill_ledger` DB schema (migration 028).
+ * resolveSkillsForAgent implements LIFO scope-typed resolution:
+ *   1. Match by agent_id (exact) OR agent_id='*' (cross-agent wildcard)
+ *   2. Match outcome_type
+ *   3. lifecycle_state === 'active'
+ *   4. Sort descending by created_at (LIFO — most recent wins)
+ *
+ * @public
+ * Ref: command-center:sprint-530:quick-4
+ */
+// ─── Resolver ─────────────────────────────────────────────────────────────────
+/**
+ * Resolve skills for a given agent + outcome type.
+ *
+ * LIFO scope-typed algorithm:
+ *   - Include entries where `agent_id === agentId` OR `agent_id === '*'`
+ *   - Include entries where `outcome_type === outcomeType`
+ *   - Include entries where `lifecycle_state === 'active'`
+ *   - Sort descending by `created_at` (most recent first)
+ *   - Apply optional `limit`
+ *
+ * Pure function — no side effects.
+ */
+export function resolveSkillsForAgent(skills, opts) {
+    const { agentId, outcomeType, limit } = opts;
+    const filtered = skills.filter((s) => (s.agent_id === agentId || s.agent_id === "*") &&
+        s.outcome_type === outcomeType &&
+        s.lifecycle_state === "active");
+    // LIFO: most recent created_at first
+    filtered.sort((a, b) => {
+        const ta = new Date(a.created_at).getTime();
+        const tb = new Date(b.created_at).getTime();
+        return tb - ta;
+    });
+    return limit !== undefined ? filtered.slice(0, limit) : filtered;
+}
+//# sourceMappingURL=skill-ledger.js.map

package/dist/skills/skill-ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-ledger.js","sourceRoot":"","sources":["../../src/skills/skill-ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4CH,iFAAiF;AAEjF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAmC,EACnC,IAA0B;IAE1B,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAE7C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAC5B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,KAAK,GAAG,CAAC;QAC9C,CAAC,CAAC,YAAY,KAAK,WAAW;QAC9B,CAAC,CAAC,eAAe,KAAK,QAAQ,CACjC,CAAC;IAEF,qCAAqC;IACrC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5C,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnE,CAAC"}

package/dist/skills/skill-registry-builder.d.ts

@@ -0,0 +1,91 @@
+/**
+ * SkillRegistryBuilder — generic skill assembly for OODA agent consumers.
+ *
+ * Promoted from `forge/src/agents/shared/skill-registry-builder.ts` (sprint-616:quick-3).
+ * Replaces 9 quasi-identical `buildXxxSkills()` functions in Forge with a single
+ * `buildSkills({ agentId, domain, extras })` factory.
+ *
+ * Pattern: base skills (universal) + domain extras (least privilege per agent).
+ *
+ * @public @since 0.18.0
+ */
+import { httpFetch } from "./http-fetch.js";
+import type { SkillRegistry } from "../orchestration/ooda/skills.js";
+import type { BrainPort } from "../ports/brain.js";
+import type { LoggerPort } from "../ports/logger.js";
+import type { DomainSkillEntry } from "./base-skills.js";
+/**
+ * Dependencies injected at skill construction time.
+ * Matches Forge's `SkillBuilderDeps` / `SkillDeps` — unified here.
+ */
+export interface SkillBuilderDeps {
+    /** Brain memory port for brain-query / brain-store skills. */
+    readonly brain?: BrainPort;
+    /** Logger for debug / audit trails inside skills. */
+    readonly logger: LoggerPort;
+    /** Slack webhook URL for slack-notify. Optional. */
+    readonly slackWebhookUrl?: string;
+    /** LiteLLM base URL for llm-complete. Optional. */
+    readonly litellmUrl?: string;
+    /** LiteLLM API key for llm-complete. Optional. */
+    readonly litellmApiKey?: string;
+}
+/**
+ * Options for `buildSkills`.
+ */
+export interface BuildSkillsOptions {
+    /** Agent identifier (used for debug traces and schema validation). */
+    readonly agentId: string;
+    /** Resolved dependencies at construction time. */
+    readonly deps: SkillBuilderDeps;
+    /**
+     * Domain name (e.g. "revenue", "ops", "product").
+     * Used for documentation + future audit trail.
+     */
+    readonly domain: string;
+    /**
+     * Extra skills to merge on top of the base registry.
+     * These must be domain-specific (e.g. prometheus-query, telegram-notify).
+     * Duplicates against base skills are rejected at validation time.
+     */
+    readonly extras?: DomainSkillEntry[];
+}
+/**
+ * Assembled skill registry, split for audit + introspection.
+ */
+export interface SkillRegistryBundle {
+    /** The merged SkillRegistry (base + extras), ready for OODA phase injection. */
+    registry: SkillRegistry;
+    /** Names of the base skills always included. */
+    baseNames: readonly string[];
+    /** Names of the domain extras merged in. */
+    extraNames: readonly string[];
+}
+/**
+ * Build a SkillRegistry for an agent.
+ *
+ * Base skills (always included): brain-store, brain-query, slack-notify, llm-complete.
+ * Domain extras are merged on top — Zod validation prevents duplicate IDs.
+ *
+ * @example
+ * ```ts
+ * const { registry } = buildSkills({
+ *   agentId: "forge-revenue",
+ *   deps,
+ *   domain: "revenue",
+ *   extras: [{ name: "http-fetch", skill: httpFetch }],
+ * });
+ * ```
+ *
+ * @throws {z.ZodError} if options fail validation
+ * @throws {Error} if extras contain a skill ID that collides with a base skill name
+ */
+export declare function buildSkills(opts: BuildSkillsOptions): SkillRegistryBundle;
+/**
+ * Convenience: extract just the SkillRegistry from `buildSkills`.
+ * Identical to `buildSkills(opts).registry`.
+ */
+export declare function buildSkillRegistry(opts: BuildSkillsOptions): SkillRegistry;
+export { httpFetch };
+export type { DomainSkillEntry };
+//# sourceMappingURL=skill-registry-builder.d.ts.map

package/dist/skills/skill-registry-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry-builder.d.ts","sourceRoot":"","sources":["../../src/skills/skill-registry-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAS,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIzD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,mDAAmD;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,QAAQ,EAAE,aAAa,CAAC;IACxB,gDAAgD;IAChD,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,4CAA4C;IAC5C,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAuGD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,mBAAmB,CAwDzE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAE1E;AAGD,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/skills/skill-registry-builder.js

@@ -0,0 +1,173 @@
+/**
+ * SkillRegistryBuilder — generic skill assembly for OODA agent consumers.
+ *
+ * Promoted from `forge/src/agents/shared/skill-registry-builder.ts` (sprint-616:quick-3).
+ * Replaces 9 quasi-identical `buildXxxSkills()` functions in Forge with a single
+ * `buildSkills({ agentId, domain, extras })` factory.
+ *
+ * Pattern: base skills (universal) + domain extras (least privilege per agent).
+ *
+ * @public @since 0.18.0
+ */
+import { z } from "zod";
+import { brainStore } from "./brain-store.js";
+import { brainQuery } from "./brain-query.js";
+import { slackNotify } from "./slack-notify.js";
+import { httpFetch } from "./http-fetch.js";
+import { BASE_SKILL_NAMES } from "./base-skills.js";
+// ─── Zod validation schema ────────────────────────────────────────────────────
+// NOTE: `deps` is intentionally excluded from this schema — it contains complex
+// runtime objects (BrainPort, LoggerPort) that are not Zod-serializable.
+// We validate only the primitive + serializable fields.
+const buildSkillsOptionsSchema = z.object({
+    agentId: z.string().min(1),
+    domain: z.string().min(1),
+    extras: z
+        .array(z.object({
+        name: z.string().min(1),
+        skill: z.unknown(),
+    }))
+        .optional(),
+});
+// ─── llm-complete factory ─────────────────────────────────────────────────────
+/**
+ * Build the `llm-complete` skill bound to the provided LiteLLM config.
+ * Produces a Skill that calls the LiteLLM `/v1/chat/completions` endpoint.
+ *
+ * Defined inline rather than a separate file to keep the bound config local.
+ */
+function buildLlmCompleteSkill(deps) {
+    const inputSchema = z
+        .object({
+        systemPrompt: z.string(),
+        userPrompt: z.string(),
+        model: z.string().optional(),
+        maxTokens: z.number().int().positive().optional(),
+    })
+        .strict();
+    return {
+        name: "llm-complete",
+        inputSchema,
+        async execute(input, ctx) {
+            if (ctx.isReplay) {
+                const mock = ctx.dryRunMocks["llm-complete"];
+                if (mock)
+                    return mock(input);
+                return { content: "", raw: { replay: true } };
+            }
+            const litellmUrl = deps.litellmUrl ?? process.env["LITELLM_URL"];
+            const apiKey = deps.litellmApiKey ?? process.env["LITELLM_API_KEY"] ?? "sk-sdk";
+            if (!litellmUrl) {
+                deps.logger.warn?.({ skill: "llm-complete" }, "LITELLM_URL not configured");
+                return { content: "", raw: { error: "LITELLM_URL not configured" } };
+            }
+            try {
+                const res = await fetch(`${litellmUrl}/v1/chat/completions`, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        Authorization: `Bearer ${apiKey}`,
+                    },
+                    body: JSON.stringify({
+                        model: input.model ?? "forge-orient",
+                        messages: [
+                            { role: "system", content: input.systemPrompt },
+                            { role: "user", content: input.userPrompt },
+                        ],
+                        max_tokens: input.maxTokens ?? 1024,
+                        temperature: 0.3,
+                    }),
+                });
+                const data = (await res.json());
+                const content = data.choices?.[0]?.message?.content ?? "";
+                if (!content) {
+                    deps.logger.error?.({ skill: "llm-complete", data }, "empty response content");
+                }
+                return { content, raw: data };
+            }
+            catch (err) {
+                deps.logger.error?.({ skill: "llm-complete", err }, "fetch failed");
+                return { content: "", raw: { error: String(err) } };
+            }
+        },
+    };
+}
+// ─── Main factory ─────────────────────────────────────────────────────────────
+/**
+ * Build a SkillRegistry for an agent.
+ *
+ * Base skills (always included): brain-store, brain-query, slack-notify, llm-complete.
+ * Domain extras are merged on top — Zod validation prevents duplicate IDs.
+ *
+ * @example
+ * ```ts
+ * const { registry } = buildSkills({
+ *   agentId: "forge-revenue",
+ *   deps,
+ *   domain: "revenue",
+ *   extras: [{ name: "http-fetch", skill: httpFetch }],
+ * });
+ * ```
+ *
+ * @throws {z.ZodError} if options fail validation
+ * @throws {Error} if extras contain a skill ID that collides with a base skill name
+ */
+export function buildSkills(opts) {
+    // Validate serializable fields only (deps excluded — contains non-serializable ports)
+    buildSkillsOptionsSchema.parse({
+        agentId: opts.agentId,
+        domain: opts.domain,
+        extras: opts.extras,
+    });
+    const { deps, extras = [] } = opts;
+    // Check for duplicate IDs (extras must not shadow base skills)
+    const baseName = new Set(BASE_SKILL_NAMES);
+    for (const { name } of extras) {
+        if (baseName.has(name)) {
+            throw new Error(`buildSkills: extra skill "${name}" collides with a base skill name. ` +
+                `Base skills: ${[...baseName].join(", ")}. ` +
+                `To override a base skill, use a different name or extend the registry manually.`);
+        }
+    }
+    // Check for duplicate extra names
+    const extraNames = extras.map((e) => e.name);
+    const uniqueExtras = new Set(extraNames);
+    if (uniqueExtras.size !== extraNames.length) {
+        const seen = new Set();
+        const dupes = [];
+        for (const n of extraNames) {
+            if (seen.has(n))
+                dupes.push(n);
+            else
+                seen.add(n);
+        }
+        throw new Error(`buildSkills: duplicate extra skill IDs detected: ${dupes.join(", ")}`);
+    }
+    // Assemble base registry
+    const base = {
+        "brain-store": brainStore,
+        "brain-query": brainQuery,
+        "slack-notify": slackNotify,
+        "llm-complete": buildLlmCompleteSkill(deps),
+    };
+    // Merge extras
+    const registry = { ...base };
+    for (const { name, skill } of extras) {
+        registry[name] = skill;
+    }
+    return {
+        registry,
+        baseNames: [...BASE_SKILL_NAMES],
+        extraNames,
+    };
+}
+/**
+ * Convenience: extract just the SkillRegistry from `buildSkills`.
+ * Identical to `buildSkills(opts).registry`.
+ */
+export function buildSkillRegistry(opts) {
+    return buildSkills(opts).registry;
+}
+// Re-export for convenience
+export { httpFetch };
+//# sourceMappingURL=skill-registry-builder.js.map