@vauban-org/agent-sdk 1.2.0 → 1.3.0

package/dist/skills/send-email.js

@@ -10,6 +10,7 @@
 import { z } from "zod";
 import { SkillExecutionError, SkillNotConfiguredError } from "./errors.js";
 import { withSkillSpan } from "./_otel.js";
+import { readSecret } from "./_secrets.js";
 const inputSchema = z
     .object({
     to: z.string().email(),
@@ -19,18 +20,6 @@ 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,

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":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC;KACD,MAAM,EAAE,CAAC;AASZ,MAAM,CAAC,MAAM,SAAS,GAA2C;IAC/D,IAAI,EAAE,YAAY;IAClB,WAAW;IACX,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAiB;QACpC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAC3C,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAoB,CAAC;YAChD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACpE,CAAC;QACD,OAAO,aAAa,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;YACpD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YAC5C,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;YAChE,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM,IAAI,uBAAuB,CAAC,YAAY,EAAE;oBAC9C,gBAAgB;oBAChB,UAAU;iBACX,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,uBAAuB,CAAC,YAAY,EAAE;oBAC9C,4BAA4B;iBAC7B,CAAC,CAAC;YACL,CAAC;YACD,wCAAwC;YACxC,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+BAA+B,EAAE;oBACvD,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,aAAa,EAAE,UAAU,SAAS,EAAE;wBACpC,cAAc,EAAE,kBAAkB;qBACnC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,IAAI,EAAE,WAAW;wBACjB,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;wBACd,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;qBACjB,CAAC;iBACH,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,EAAE;wBAClE,MAAM,EAAE,GAAG,CAAC,MAAM;qBACnB,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoB,CAAC;gBACnD,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,QAAQ,EAAE,QAAQ;oBAClB,UAAU,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI;iBAC5B,CAAC;YACJ,CAAC;YACD,8DAA8D;YAC9D,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAIzD,CAAC;gBACF,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,OAAiB,CAAC,CAAC;gBACzD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC;oBACpC,IAAI,EAAE,WAAW;oBACjB,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;iBACjB,CAAC,CAAC;gBACH,OAAO;oBACL,SAAS,EAAE,IAAI;oBACf,QAAQ,EAAE,MAAM;oBAChB,UAAU,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;iBACnC,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,mBAAmB,CAAC,YAAY,EAAE,sBAAsB,EAAE;oBAClE,KAAK,EAAE,GAAG;iBACX,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

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

@@ -1 +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"}
+{"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;AAQxB,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,iCAAiC,CAAC;AAmB3E,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,CAgFlE,CAAC"}

package/dist/skills/slack-notify.js

@@ -6,8 +6,24 @@
  * @public
  */
 import { z } from "zod";
+import { retry, RETRY_TRANSIENT, RetryExhaustedError, } from "../retry/index.js";
 import { SkillExecutionError, SkillNotConfiguredError } from "./errors.js";
 import { withSkillSpan } from "./_otel.js";
+import { readSecret } from "./_secrets.js";
+class RetryableHttpError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`HTTP ${status}: ${body.slice(0, 200)}`);
+        this.status = status;
+        this.body = body;
+        this.name = "RetryableHttpError";
+    }
+}
+const SLACK_RETRY = {
+    ...RETRY_TRANSIENT,
+    retryIf: (err) => err instanceof RetryableHttpError || err instanceof TypeError,
+};
 const inputSchema = z
     .object({
     text: z.string().min(1).max(40_000),
@@ -30,7 +46,7 @@ export const slackNotify = {
             return { delivered: false, ts: null };
         }
         return withSkillSpan("slack_notify", async () => {
-            const token = process.env.SLACK_BOT_TOKEN;
+            const token = readSecret(ctx, "SLACK_BOT_TOKEN");
             if (!token) {
                 throw new SkillNotConfiguredError("slack_notify", ["SLACK_BOT_TOKEN"]);
             }
@@ -42,28 +58,43 @@ export const slackNotify = {
                     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,
-                });
+            try {
+                return await retry(async () => {
+                    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) {
+                        const body = await res.text().catch(() => "");
+                        if (res.status >= 500 || res.status === 429) {
+                            throw new RetryableHttpError(res.status, body);
+                        }
+                        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 };
+                }, { config: SLACK_RETRY });
             }
-            const data = (await res.json());
-            if (!data.ok) {
-                throw new SkillExecutionError("slack_notify", data.error ?? "unknown slack error");
+            catch (err) {
+                const cause = err instanceof RetryExhaustedError ? err.lastError : err;
+                if (cause instanceof RetryableHttpError) {
+                    throw new SkillExecutionError("slack_notify", `${cause.status} after retries`, { status: cause.status });
+                }
+                throw cause;
             }
-            return { delivered: true, ts: data.ts ?? null };
         });
     },
 };

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

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

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

@@ -1 +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"}
+{"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;AAQxB,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,iCAAiC,CAAC;AAmB3E,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,CAgFzE,CAAC"}

package/dist/skills/telegram-notify.js

@@ -7,8 +7,24 @@
  * @public
  */
 import { z } from "zod";
+import { retry, RETRY_TRANSIENT, RetryExhaustedError, } from "../retry/index.js";
 import { SkillExecutionError, SkillNotConfiguredError } from "./errors.js";
 import { withSkillSpan } from "./_otel.js";
+import { readSecret } from "./_secrets.js";
+class RetryableHttpError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`HTTP ${status}: ${body.slice(0, 200)}`);
+        this.status = status;
+        this.body = body;
+        this.name = "RetryableHttpError";
+    }
+}
+const TELEGRAM_RETRY = {
+    ...RETRY_TRANSIENT,
+    retryIf: (err) => err instanceof RetryableHttpError || err instanceof TypeError,
+};
 const inputSchema = z
     .object({
     text: z.string().min(1).max(4096),
@@ -31,7 +47,7 @@ export const telegramNotify = {
             return { delivered: false, message_id: null };
         }
         return withSkillSpan("telegram_notify", async () => {
-            const token = process.env.TELEGRAM_BOT_TOKEN;
+            const token = readSecret(ctx, "TELEGRAM_BOT_TOKEN");
             if (!token) {
                 throw new SkillNotConfiguredError("telegram_notify", [
                     "TELEGRAM_BOT_TOKEN",
@@ -46,25 +62,38 @@ export const telegramNotify = {
                 }
             }
             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,
-                });
+            try {
+                return await retry(async () => {
+                    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) {
+                        const body = await res.text().catch(() => "");
+                        if (res.status >= 500 || res.status === 429) {
+                            throw new RetryableHttpError(res.status, body);
+                        }
+                        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,
+                    };
+                }, { config: TELEGRAM_RETRY });
+            }
+            catch (err) {
+                const cause = err instanceof RetryExhaustedError ? err.lastError : err;
+                if (cause instanceof RetryableHttpError) {
+                    throw new SkillExecutionError("telegram_notify", `${cause.status} after retries`, { status: cause.status });
+                }
+                throw cause;
             }
-            const data = (await res.json());
-            return {
-                delivered: data.ok === true,
-                message_id: data.result?.message_id ?? null,
-            };
         });
     },
 };

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

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

@@ -1 +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"}
+{"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;AAQxB,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,iCAAiC,CAAC;AAmB3E,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,CAyI5D,CAAC"}

package/dist/skills/web-search.js

@@ -6,8 +6,24 @@
  * @public
  */
 import { z } from "zod";
+import { retry, RETRY_TRANSIENT, RetryExhaustedError, } from "../retry/index.js";
 import { SkillExecutionError, SkillNotConfiguredError } from "./errors.js";
 import { withSkillSpan } from "./_otel.js";
+import { readSecret } from "./_secrets.js";
+class RetryableHttpError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`HTTP ${status}: ${body.slice(0, 200)}`);
+        this.status = status;
+        this.body = body;
+        this.name = "RetryableHttpError";
+    }
+}
+const SEARCH_RETRY = {
+    ...RETRY_TRANSIENT,
+    retryIf: (err) => err instanceof RetryableHttpError || err instanceof TypeError,
+};
 const inputSchema = z
     .object({
     query: z.string().min(1).max(512),
@@ -25,59 +41,88 @@ export const webSearch = {
             return { results: [], provider: "replay" };
         }
         return withSkillSpan("web_search", async () => {
-            const braveKey = process.env.BRAVE_SEARCH_KEY;
-            const tavilyKey = process.env.TAVILY_API_KEY;
+            const braveKey = readSecret(ctx, "BRAVE_SEARCH_KEY");
+            const tavilyKey = readSecret(ctx, "TAVILY_API_KEY");
             if (!braveKey && !tavilyKey) {
                 throw new SkillNotConfiguredError("web_search", [
                     "BRAVE_SEARCH_KEY",
                     "TAVILY_API_KEY",
                 ]);
             }
+            // Try Brave first when configured. Retry on 5xx/429. Fall back to
+            // Tavily on any final non-OK (4xx other than 429 short-circuits).
             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) {
+                try {
+                    return await retry(async () => {
+                        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 body = await res.text().catch(() => "");
+                            if (res.status >= 500 || res.status === 429) {
+                                throw new RetryableHttpError(res.status, body);
+                            }
+                            throw new SkillExecutionError("web_search", `brave ${res.status}`, { status: res.status });
+                        }
+                        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" };
+                    }, { config: SEARCH_RETRY });
+                }
+                catch (err) {
+                    if (!tavilyKey) {
+                        const cause = err instanceof RetryExhaustedError ? err.lastError : err;
+                        if (cause instanceof RetryableHttpError) {
+                            throw new SkillExecutionError("web_search", `brave ${cause.status} after retries`, { status: cause.status });
+                        }
+                        throw cause;
+                    }
+                    // Brave failed — fall through to Tavily.
+                }
+            }
+            // Tavily (primary if no Brave key, else fallback)
+            try {
+                return await retry(async () => {
+                    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) {
+                        const body = await res.text().catch(() => "");
+                        if (res.status >= 500 || res.status === 429) {
+                            throw new RetryableHttpError(res.status, body);
+                        }
+                        throw new SkillExecutionError("web_search", `tavily ${res.status}`, { status: res.status });
+                    }
                     const data = (await res.json());
-                    const results = (data.web?.results ?? []).map((r) => ({
+                    const results = (data.results ?? []).map((r) => ({
                         title: r.title ?? "",
                         url: r.url ?? "",
-                        snippet: r.description ?? "",
+                        snippet: r.content ?? "",
                     }));
-                    return { results, provider: "brave" };
-                }
-                if (!tavilyKey) {
-                    throw new SkillExecutionError("web_search", `brave ${res.status}`, {
-                        status: res.status,
-                    });
-                }
+                    return { results, provider: "tavily" };
+                }, { config: SEARCH_RETRY });
             }
-            // 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,
-                });
+            catch (err) {
+                const cause = err instanceof RetryExhaustedError ? err.lastError : err;
+                if (cause instanceof RetryableHttpError) {
+                    throw new SkillExecutionError("web_search", `tavily ${cause.status} after retries`, { status: cause.status });
+                }
+                throw cause;
             }
-            const data = (await res.json());
-            const results = (data.results ?? []).map((r) => ({
-                title: r.title ?? "",
-                url: r.url ?? "",
-                snippet: r.content ?? "",
-            }));
-            return { results, provider: "tavily" };
         });
     },
 };

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

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

package/dist/telemetry/bus.d.ts

@@ -0,0 +1,54 @@
+/**
+ * TelemetryBus — fanout to multiple {@link TelemetrySink}s, non-blocking.
+ *
+ * Invariants :
+ *   1. Sink failures are ISOLATED — one sink throwing never affects the others
+ *      nor the host agent loop. Failures are logged via the bus logger.
+ *   2. The bus itself implements {@link TelemetrySink}, so it can be passed
+ *      transparently to consumers expecting a single sink (composition).
+ *   3. When `nonBlocking: true` (default), `start`/`step`/`finish` return
+ *      immediately and dispatch in background. Errors surface via the logger.
+ *   4. Backpressure : if internal queue > `maxQueueDepth`, oldest events are
+ *      dropped and counted.
+ *
+ * Ref: command-center:sprint-693:telemetry-bus
+ */
+import { type TelemetrySink } from "./port.js";
+export interface TelemetryLogger {
+    warn(obj: Record<string, unknown>, msg?: string): void;
+    error(obj: Record<string, unknown>, msg?: string): void;
+}
+export interface TelemetryBusOptions {
+    sinks: readonly TelemetrySink[];
+    /** Pino-compatible logger. Defaults to no-op. */
+    logger?: TelemetryLogger;
+    /**
+     * When true (default), `start/step/finish` resolve immediately and dispatch
+     * in background. Set false in tests for deterministic assertions.
+     */
+    nonBlocking?: boolean;
+    /**
+     * Max number of in-flight events per sink before dropping oldest.
+     * Defaults to 1000.
+     */
+    maxQueueDepth?: number;
+}
+export interface TelemetryCounters {
+    /** Events dropped due to queue overflow. */
+    readonly dropped: number;
+    /** Sink errors caught and isolated. */
+    readonly sinkErrors: number;
+    /** Events successfully dispatched. */
+    readonly dispatched: number;
+}
+/**
+ * Build a TelemetryBus that fans events to all sinks non-blockingly.
+ *
+ * If `sinks` is empty, returns {@link NOOP_TELEMETRY_SINK} so callers never
+ * need to null-check.
+ */
+export declare function createTelemetryBus(opts: TelemetryBusOptions): TelemetrySink & {
+    counters: TelemetryCounters;
+    flush(): Promise<void>;
+};
+//# sourceMappingURL=bus.d.ts.map

package/dist/telemetry/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/telemetry/bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,WAAW,CAAC;AAInB,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzD;AAaD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,iDAAiD;IACjD,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAmJD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,mBAAmB,GACxB,aAAa,GAAG;IAAE,QAAQ,EAAE,iBAAiB,CAAC;IAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAYzE"}