@vauban-org/agent-sdk 0.16.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry-builder.js","sourceRoot":"","sources":["../../src/skills/skill-registry-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAuDpD,iFAAiF;AACjF,gFAAgF;AAChF,yEAAyE;AACzE,wDAAwD;AAExD,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC;SACN,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACvB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;KACnB,CAAC,CACH;SACA,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,iFAAiF;AAEjF;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,IAAsB;IASnD,MAAM,WAAW,GAAG,CAAC;SAClB,MAAM,CAAC;QACN,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KAClD,CAAC;SACD,MAAM,EAAE,CAAC;IAEZ,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW;QACX,KAAK,CAAC,OAAO,CAAC,KAAe,EAAE,GAAG;YAChC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;gBAC7C,IAAI,IAAI;oBAAE,OAAO,IAAI,CAAC,KAAK,CAAc,CAAC;gBAC1C,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YAChD,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACjE,MAAM,MAAM,GACV,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,QAAQ,CAAC;YACnE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAChB,EAAE,KAAK,EAAE,cAAc,EAAE,EACzB,4BAA4B,CAC7B,CAAC;gBACF,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,4BAA4B,EAAE,EAAE,CAAC;YACvE,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,UAAU,sBAAsB,EAAE;oBAC3D,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,aAAa,EAAE,UAAU,MAAM,EAAE;qBAClC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,cAAc;wBACpC,QAAQ,EAAE;4BACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE;4BAC/C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE;yBAC5C;wBACD,UAAU,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;wBACnC,WAAW,EAAE,GAAG;qBACjB,CAAC;iBACH,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAE7B,CAAC;gBACF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;gBAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CACjB,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,EAC/B,wBAAwB,CACzB,CAAC;gBACJ,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;gBACpE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACtD,CAAC;QACH,CAAC;KACc,CAAC;AACpB,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,sFAAsF;IACtF,wBAAwB,CAAC,KAAK,CAAC;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IAEnC,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAAC;IACnD,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QAC9B,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,qCAAqC;gBACpE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBAC5C,iFAAiF,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,YAAY,CAAC,IAAI,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;gBAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,oDAAoD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvE,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,MAAM,IAAI,GAAkB;QAC1B,aAAa,EAAE,UAAU;QACzB,aAAa,EAAE,UAAU;QACzB,cAAc,EAAE,WAAW;QAC3B,cAAc,EAAE,qBAAqB,CAAC,IAAI,CAAC;KAC5C,CAAC;IAEF,eAAe;IACf,MAAM,QAAQ,GAAkB,EAAE,GAAG,IAAI,EAAE,CAAC;IAC5C,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,OAAO;QACL,QAAQ;QACR,SAAS,EAAE,CAAC,GAAG,gBAAgB,CAAC;QAChC,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAwB;IACzD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;AACpC,CAAC;AAED,4BAA4B;AAC5B,OAAO,EAAE,SAAS,EAAE,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * slack_notify — Slack chat.postMessage.
+ *
+ * Resolves channel from messaging_user_binding when binding_user_id provided.
+ *
+ * @public
+ */
+import { z } from "zod";
+import type { Skill } from "../orchestration/ooda/skills.js";
+declare const inputSchema: z.ZodEffects<z.ZodObject<{
+    text: z.ZodString;
+    channel: z.ZodOptional<z.ZodString>;
+    binding_user_id: z.ZodOptional<z.ZodString>;
+    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;
+    blocks?: Record<string, unknown>[] | undefined;
+}, {
+    text: string;
+    binding_user_id?: string | undefined;
+    channel?: string | undefined;
+    blocks?: Record<string, unknown>[] | undefined;
+}>, {
+    text: string;
+    binding_user_id?: string | undefined;
+    channel?: string | undefined;
+    blocks?: Record<string, unknown>[] | undefined;
+}, {
+    text: string;
+    binding_user_id?: string | undefined;
+    channel?: string | undefined;
+    blocks?: Record<string, unknown>[] | undefined;
+}>;
+type SlackNotifyInput = z.infer<typeof inputSchema>;
+export interface SlackNotifyOutput {
+    delivered: boolean;
+    ts: string | null;
+}
+export declare const slackNotify: Skill<SlackNotifyInput, SlackNotifyOutput>;
+export {};
+//# sourceMappingURL=slack-notify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slack-notify.d.ts","sourceRoot":"","sources":["../../src/skills/slack-notify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,iCAAiC,CAAC;AAI3E,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;EAUb,CAAC;AACL,KAAK,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB;AAED,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,gBAAgB,EAAE,iBAAiB,CA2DlE,CAAC"}

package/dist/skills/slack-notify.js

@@ -0,0 +1,70 @@
+/**
+ * slack_notify — Slack chat.postMessage.
+ *
+ * Resolves channel from messaging_user_binding when binding_user_id provided.
+ *
+ * @public
+ */
+import { z } from "zod";
+import { SkillExecutionError, SkillNotConfiguredError } from "./errors.js";
+import { withSkillSpan } from "./_otel.js";
+const inputSchema = z
+    .object({
+    text: z.string().min(1).max(40_000),
+    channel: z.string().optional(),
+    binding_user_id: z.string().uuid().optional(),
+    blocks: z.array(z.record(z.string(), z.unknown())).optional(),
+})
+    .strict()
+    .refine((v) => v.channel || v.binding_user_id, {
+    message: "channel or binding_user_id required",
+});
+export const slackNotify = {
+    name: "slack_notify",
+    inputSchema,
+    async execute(input, ctx) {
+        if (ctx.isReplay) {
+            const mock = ctx.dryRunMocks["slack_notify"];
+            if (mock)
+                return mock(input);
+            return { delivered: false, ts: null };
+        }
+        return withSkillSpan("slack_notify", async () => {
+            const token = process.env.SLACK_BOT_TOKEN;
+            if (!token) {
+                throw new SkillNotConfiguredError("slack_notify", ["SLACK_BOT_TOKEN"]);
+            }
+            let channel = input.channel;
+            if (!channel && input.binding_user_id) {
+                const { rows } = await ctx.db.query("SELECT chat_id FROM messaging_user_binding WHERE user_id = $1 AND channel = 'slack' LIMIT 1", [input.binding_user_id]);
+                channel = rows[0]?.chat_id;
+                if (!channel) {
+                    throw new SkillExecutionError("slack_notify", `no slack binding for user ${input.binding_user_id}`);
+                }
+            }
+            const res = await fetch("https://slack.com/api/chat.postMessage", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json; charset=utf-8",
+                    Authorization: `Bearer ${token}`,
+                },
+                body: JSON.stringify({
+                    channel,
+                    text: input.text,
+                    blocks: input.blocks,
+                }),
+            });
+            if (!res.ok) {
+                throw new SkillExecutionError("slack_notify", `${res.status}`, {
+                    status: res.status,
+                });
+            }
+            const data = (await res.json());
+            if (!data.ok) {
+                throw new SkillExecutionError("slack_notify", data.error ?? "unknown slack error");
+            }
+            return { delivered: true, ts: data.ts ?? null };
+        });
+    },
+};
+//# sourceMappingURL=slack-notify.js.map

package/dist/skills/slack-notify.js.map

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

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

@@ -0,0 +1,34 @@
+/**
+ * starknet_balance — read STRK / ETH / vault balance via starknet.js (peer dep).
+ *
+ * starknet.js stays peerDependency. We dynamic-import — if absent, throw
+ * SkillNotConfiguredError. RPC URL via STARKNET_RPC_URL env.
+ *
+ * @public
+ */
+import { z } from "zod";
+import type { Skill } from "../orchestration/ooda/skills.js";
+declare const inputSchema: z.ZodObject<{
+    address: z.ZodString;
+    token: z.ZodDefault<z.ZodEnum<["STRK", "ETH", "VAULT"]>>;
+    /** Override token contract for "VAULT" or custom tokens. */
+    contract: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    token: "STRK" | "ETH" | "VAULT";
+    address: string;
+    contract?: string | undefined;
+}, {
+    address: string;
+    token?: "STRK" | "ETH" | "VAULT" | undefined;
+    contract?: string | undefined;
+}>;
+type StarknetBalanceInput = z.infer<typeof inputSchema>;
+export interface StarknetBalanceOutput {
+    address: string;
+    token: "STRK" | "ETH" | "VAULT";
+    /** Raw u256 as decimal string (avoid float64 — see core/security-boundaries). */
+    balance_wei: string;
+}
+export declare const starknetBalance: Skill<StarknetBalanceInput, StarknetBalanceOutput>;
+export {};
+//# sourceMappingURL=starknet-balance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"starknet-balance.d.ts","sourceRoot":"","sources":["../../src/skills/starknet-balance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,iCAAiC,CAAC;AAI3E,QAAA,MAAM,WAAW;;;IAMb,4DAA4D;;;;;;;;;;EAMrD,CAAC;AACZ,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAChC,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD,eAAO,MAAM,eAAe,EAAE,KAAK,CACjC,oBAAoB,EACpB,qBAAqB,CAiEtB,CAAC"}

package/dist/skills/starknet-balance.js

@@ -0,0 +1,91 @@
+/**
+ * starknet_balance — read STRK / ETH / vault balance via starknet.js (peer dep).
+ *
+ * starknet.js stays peerDependency. We dynamic-import — if absent, throw
+ * SkillNotConfiguredError. RPC URL via STARKNET_RPC_URL env.
+ *
+ * @public
+ */
+import { z } from "zod";
+import { SkillExecutionError, SkillNotConfiguredError } from "./errors.js";
+import { withSkillSpan } from "./_otel.js";
+const inputSchema = z
+    .object({
+    address: z
+        .string()
+        .regex(/^0x[0-9a-fA-F]{1,64}$/),
+    token: z.enum(["STRK", "ETH", "VAULT"]).default("STRK"),
+    /** Override token contract for "VAULT" or custom tokens. */
+    contract: z
+        .string()
+        .regex(/^0x[0-9a-fA-F]{1,64}$/)
+        .optional(),
+})
+    .strict();
+const STRK = "0x04718f5a0fc34cc1af16a1cdee98ffb20c31f5cd61d6ab07201858f4287c938d";
+const ETH = "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7";
+export const starknetBalance = {
+    name: "starknet_balance",
+    inputSchema,
+    async execute(input, ctx) {
+        if (ctx.isReplay) {
+            const mock = ctx.dryRunMocks["starknet_balance"];
+            if (mock)
+                return mock(input);
+            return {
+                address: input.address,
+                token: input.token,
+                balance_wei: "0",
+            };
+        }
+        return withSkillSpan("starknet_balance", async () => {
+            const rpcUrl = process.env.STARKNET_RPC_URL;
+            if (!rpcUrl) {
+                throw new SkillNotConfiguredError("starknet_balance", [
+                    "STARKNET_RPC_URL",
+                ]);
+            }
+            let starknet;
+            try {
+                starknet = await import(/* @vite-ignore */ "starknet");
+            }
+            catch (_err) {
+                throw new SkillNotConfiguredError("starknet_balance", [
+                    "starknet (peer dependency)",
+                ]);
+            }
+            const provider = new starknet.RpcProvider({ nodeUrl: rpcUrl });
+            const tokenContract = input.contract ??
+                (input.token === "STRK"
+                    ? STRK
+                    : input.token === "ETH"
+                        ? ETH
+                        : undefined);
+            if (!tokenContract) {
+                throw new SkillExecutionError("starknet_balance", "VAULT requires explicit `contract` override");
+            }
+            try {
+                const result = await provider.callContract({
+                    contractAddress: tokenContract,
+                    entrypoint: "balanceOf",
+                    calldata: [input.address],
+                });
+                // u256 returned as 2 felts (low, high). Combine.
+                const low = BigInt(result[0] ?? "0");
+                const high = BigInt(result[1] ?? "0");
+                const total = low + (high << 128n);
+                return {
+                    address: input.address,
+                    token: input.token,
+                    balance_wei: total.toString(),
+                };
+            }
+            catch (err) {
+                throw new SkillExecutionError("starknet_balance", "RPC error", {
+                    cause: err,
+                });
+            }
+        });
+    },
+};
+//# sourceMappingURL=starknet-balance.js.map

package/dist/skills/starknet-balance.js.map

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

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

@@ -0,0 +1,44 @@
+/**
+ * telegram_notify — POST Telegram bot sendMessage.
+ *
+ * Resolves chat_id from messaging_user_binding when `binding_user_id`
+ * is provided; else uses `chat_id` directly.
+ *
+ * @public
+ */
+import { z } from "zod";
+import type { Skill } from "../orchestration/ooda/skills.js";
+declare const inputSchema: z.ZodEffects<z.ZodObject<{
+    text: z.ZodString;
+    chat_id: z.ZodOptional<z.ZodString>;
+    binding_user_id: z.ZodOptional<z.ZodString>;
+    parse_mode: z.ZodOptional<z.ZodEnum<["MarkdownV2", "HTML"]>>;
+}, "strict", z.ZodTypeAny, {
+    text: string;
+    chat_id?: string | undefined;
+    binding_user_id?: string | undefined;
+    parse_mode?: "MarkdownV2" | "HTML" | undefined;
+}, {
+    text: string;
+    chat_id?: string | undefined;
+    binding_user_id?: string | undefined;
+    parse_mode?: "MarkdownV2" | "HTML" | undefined;
+}>, {
+    text: string;
+    chat_id?: string | undefined;
+    binding_user_id?: string | undefined;
+    parse_mode?: "MarkdownV2" | "HTML" | undefined;
+}, {
+    text: string;
+    chat_id?: string | undefined;
+    binding_user_id?: string | undefined;
+    parse_mode?: "MarkdownV2" | "HTML" | undefined;
+}>;
+type TelegramNotifyInput = z.infer<typeof inputSchema>;
+export interface TelegramNotifyOutput {
+    delivered: boolean;
+    message_id: number | null;
+}
+export declare const telegramNotify: Skill<TelegramNotifyInput, TelegramNotifyOutput>;
+export {};
+//# sourceMappingURL=telegram-notify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-notify.d.ts","sourceRoot":"","sources":["../../src/skills/telegram-notify.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,iCAAiC,CAAC;AAI3E,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;EAUb,CAAC;AACL,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,mBAAmB,EAAE,oBAAoB,CAwDzE,CAAC"}

package/dist/skills/telegram-notify.js

@@ -0,0 +1,71 @@
+/**
+ * telegram_notify — POST Telegram bot sendMessage.
+ *
+ * Resolves chat_id from messaging_user_binding when `binding_user_id`
+ * is provided; else uses `chat_id` directly.
+ *
+ * @public
+ */
+import { z } from "zod";
+import { SkillExecutionError, SkillNotConfiguredError } from "./errors.js";
+import { withSkillSpan } from "./_otel.js";
+const inputSchema = z
+    .object({
+    text: z.string().min(1).max(4096),
+    chat_id: z.string().optional(),
+    binding_user_id: z.string().uuid().optional(),
+    parse_mode: z.enum(["MarkdownV2", "HTML"]).optional(),
+})
+    .strict()
+    .refine((v) => v.chat_id || v.binding_user_id, {
+    message: "chat_id or binding_user_id required",
+});
+export const telegramNotify = {
+    name: "telegram_notify",
+    inputSchema,
+    async execute(input, ctx) {
+        if (ctx.isReplay) {
+            const mock = ctx.dryRunMocks["telegram_notify"];
+            if (mock)
+                return mock(input);
+            return { delivered: false, message_id: null };
+        }
+        return withSkillSpan("telegram_notify", async () => {
+            const token = process.env.TELEGRAM_BOT_TOKEN;
+            if (!token) {
+                throw new SkillNotConfiguredError("telegram_notify", [
+                    "TELEGRAM_BOT_TOKEN",
+                ]);
+            }
+            let chatId = input.chat_id;
+            if (!chatId && input.binding_user_id) {
+                const { rows } = await ctx.db.query("SELECT chat_id FROM messaging_user_binding WHERE user_id = $1 AND channel = 'telegram' LIMIT 1", [input.binding_user_id]);
+                chatId = rows[0]?.chat_id;
+                if (!chatId) {
+                    throw new SkillExecutionError("telegram_notify", `no telegram binding for user ${input.binding_user_id}`);
+                }
+            }
+            const url = `https://api.telegram.org/bot${token}/sendMessage`;
+            const res = await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    chat_id: chatId,
+                    text: input.text,
+                    parse_mode: input.parse_mode,
+                }),
+            });
+            if (!res.ok) {
+                throw new SkillExecutionError("telegram_notify", `${res.status}`, {
+                    status: res.status,
+                });
+            }
+            const data = (await res.json());
+            return {
+                delivered: data.ok === true,
+                message_id: data.result?.message_id ?? null,
+            };
+        });
+    },
+};
+//# sourceMappingURL=telegram-notify.js.map

package/dist/skills/telegram-notify.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * web_search — Brave Search API + Tavily fallback.
+ *
+ * V8-2: isReplay short-circuits BEFORE any network I/O.
+ *
+ * @public
+ */
+import { z } from "zod";
+import type { Skill } from "../orchestration/ooda/skills.js";
+declare const inputSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    limit: number;
+    query: string;
+}, {
+    query: string;
+    limit?: number | undefined;
+}>;
+type WebSearchInput = z.infer<typeof inputSchema>;
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+export interface WebSearchOutput {
+    results: WebSearchResult[];
+    provider: "brave" | "tavily" | "replay";
+}
+export declare const webSearch: Skill<WebSearchInput, WebSearchOutput>;
+export {};
+//# sourceMappingURL=web-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/skills/web-search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;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,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACzC;AAED,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,cAAc,EAAE,eAAe,CA6E5D,CAAC"}

package/dist/skills/web-search.js

@@ -0,0 +1,84 @@
+/**
+ * web_search — Brave Search API + Tavily fallback.
+ *
+ * V8-2: isReplay short-circuits BEFORE any network I/O.
+ *
+ * @public
+ */
+import { z } from "zod";
+import { SkillExecutionError, SkillNotConfiguredError } from "./errors.js";
+import { withSkillSpan } from "./_otel.js";
+const inputSchema = z
+    .object({
+    query: z.string().min(1).max(512),
+    limit: z.number().int().min(1).max(20).default(5),
+})
+    .strict();
+export const webSearch = {
+    name: "web_search",
+    inputSchema,
+    async execute(input, ctx) {
+        if (ctx.isReplay) {
+            const mock = ctx.dryRunMocks["web_search"];
+            if (mock)
+                return mock(input);
+            return { results: [], provider: "replay" };
+        }
+        return withSkillSpan("web_search", async () => {
+            const braveKey = process.env.BRAVE_SEARCH_KEY;
+            const tavilyKey = process.env.TAVILY_API_KEY;
+            if (!braveKey && !tavilyKey) {
+                throw new SkillNotConfiguredError("web_search", [
+                    "BRAVE_SEARCH_KEY",
+                    "TAVILY_API_KEY",
+                ]);
+            }
+            if (braveKey) {
+                const url = `https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(input.query)}&count=${input.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("web_search", `brave ${res.status}`, {
+                        status: 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: input.query,
+                    max_results: input.limit,
+                }),
+            });
+            if (!res.ok) {
+                throw new SkillExecutionError("web_search", `tavily ${res.status}`, {
+                    status: 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=web-search.js.map

package/dist/skills/web-search.js.map

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

package/dist/templates/complex-agent.d.ts

@@ -0,0 +1,105 @@
+/**
+ * ComplexAgent Template — Tier 3 (Supervisor-Worker + Plan-and-Execute + Debate).
+ *
+ * Promoted from forge/src/agents/shared/templates/complex-agent.ts (Vague 1.B.7).
+ *
+ * For agents that need multi-agent coordination, step-by-step planning,
+ * and adversarial debate:
+ *   - Orchestrateur Central, Treasury Agent, DevOps Agent, Security Auditor,
+ *     Contract Reviewer.
+ *
+ * Pattern: observe → orient (LLM + Debate) → decide (Plan decomposition) →
+ *          act (execute steps) → reflect (self-critique, optional) → feedback.
+ *
+ * Differences from Forge template:
+ * - AgentDependencies removed — uses AgentFactoryDeps (SDK-native)
+ * - buildSkills / createForgeAgent replaced by createAgentFromConfig (SDK)
+ * - Forge-specific couplings (slackWebhookUrl, litellmUrl) removed
+ * - hitlEscalationLevel wired to AgentFactoryConfig (not Forge-specific gate)
+ *
+ * @public @since 0.20.0
+ */
+import type { AgentFactoryDeps } from "../factory/agent-factory.js";
+import type { OODAAgent, OODAContext } from "../orchestration/ooda/types.js";
+import type { SessionGuard, RiskGuard, OutcomeRecord } from "../orchestration/ooda/types.js";
+/**
+ * ComplexAgentOptions — typed configuration for Tier 3 agents.
+ *
+ * Type parameters chain OODA phase I/O:
+ * - `TObs`      — observation output
+ * - `TOrient`   — orientation output (after LLM + Debate)
+ * - `TDecision` — decision output (plan decomposition)
+ * - `TAction`   — action output (step execution result)
+ * - `TFeedback` — feedback output
+ *
+ * @public
+ */
+export interface ComplexAgentOptions<TObs, TOrient, TDecision, TAction, TFeedback> {
+    /** Agent identifier (e.g. "treasury-agent"). */
+    agentId: string;
+    /** Agent semver string. */
+    agentVersion?: string;
+    /** Cycle interval in milliseconds. */
+    intervalMs: number;
+    /** Observe phase: read data from Brain/APIs (readOnly). */
+    observe: (_: void, ctx: OODAContext) => Promise<TObs>;
+    /** Orient phase: LLM analysis + optional Multi-Agent Debate (readOnly). */
+    orient: (obs: TObs, ctx: OODAContext) => Promise<TOrient>;
+    /** Decide phase: plan decomposition + LLM routing. */
+    decide: (orient: TOrient, ctx: OODAContext) => Promise<TDecision>;
+    /**
+     * Act phase: executeSteps with optional ReactLoop for tool-calling.
+     * Set `hitlEscalationLevel` to gate this phase on HITL approval.
+     */
+    act: (decision: TDecision, ctx: OODAContext) => Promise<TAction>;
+    /**
+     * Optional reflect phase: self-critique with Reflexion memory.
+     * When provided, runs between act and feedback.
+     */
+    reflect?: (input: TAction & {
+        decision: TDecision;
+    }, ctx: OODAContext) => Promise<TFeedback>;
+    /** Feedback phase: log outcome, archive to Brain. */
+    feedback: (input: TAction & {
+        decision?: TDecision;
+    }, ctx: OODAContext) => Promise<TFeedback>;
+    /**
+     * HITL escalation level for the act phase.
+     * - "L2": async review before irreversible effects.
+     * - "L3": synchronous HITL approval required (default).
+     */
+    hitlEscalationLevel?: "L2" | "L3";
+    /** Optional session guards (e.g. market hours). Defaults to alwaysOn. */
+    sessionGuards?: SessionGuard[];
+    /** Optional risk guards (e.g. circuit breaker, budget). */
+    riskGuards?: RiskGuard[];
+    /** Optional outcome mapping for Economic Observer. */
+    outcomeMapping?: (feedback: TFeedback) => OutcomeRecord | null;
+}
+/**
+ * Create a Tier 3 (complex, supervisor-worker, debate-capable) OODA agent.
+ *
+ * Boilerplate reduction vs. raw `createAgentFromConfig`:
+ * - HITL wiring handled automatically when `hitlEscalationLevel` is set
+ * - Optional `reflect` phase wired correctly between act and feedback
+ * - Phase `type` codes and `readOnly` flags set automatically
+ *
+ * @example
+ * ```ts
+ * const agent = await createComplexAgent<Obs, Orient, Plan, ExecResult, Feedback>(deps, {
+ *   agentId: "treasury-agent",
+ *   intervalMs: 3_600_000,
+ *   observe: async () => ({ balance: 1000, pendingTx: [] }),
+ *   orient: async (obs) => ({ recommendation: "hold", risk: "low" }),
+ *   decide: async (orient) => ({ steps: [{ action: "record", data: orient }] }),
+ *   act: async (plan) => ({ stepsExecuted: plan.steps.length }),
+ *   feedback: async (result) => ({ success: result.stepsExecuted > 0 }),
+ *   hitlEscalationLevel: "L3",
+ * });
+ * await agent.start();
+ * ```
+ *
+ * @public
+ */
+export declare function createComplexAgent<TObs, TOrient, TDecision, TAction, TFeedback>(deps: AgentFactoryDeps, opts: ComplexAgentOptions<TObs, TOrient, TDecision, TAction, TFeedback>): Promise<OODAAgent>;
+//# sourceMappingURL=complex-agent.d.ts.map

package/dist/templates/complex-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complex-agent.d.ts","sourceRoot":"","sources":["../../src/templates/complex-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACd,MAAM,gCAAgC,CAAC;AAIxC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB,CAClC,IAAI,EACJ,OAAO,EACP,SAAS,EACT,OAAO,EACP,SAAS;IAET,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,2EAA2E;IAC3E,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,sDAAsD;IACtD,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAClE;;;OAGG;IACH,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE;;;OAGG;IACH,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,OAAO,GAAG;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE,EACxC,GAAG,EAAE,WAAW,KACb,OAAO,CAAC,SAAS,CAAC,CAAC;IACxB,qDAAqD;IACrD,QAAQ,EAAE,CACR,KAAK,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;KAAE,EACzC,GAAG,EAAE,WAAW,KACb,OAAO,CAAC,SAAS,CAAC,CAAC;IACxB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAClC,yEAAyE;IACzE,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,sDAAsD;IACtD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,aAAa,GAAG,IAAI,CAAC;CAChE;AAID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EACJ,OAAO,EACP,SAAS,EACT,OAAO,EACP,SAAS,EAET,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,GACtE,OAAO,CAAC,SAAS,CAAC,CAsDpB"}