veryfront 0.1.48 → 0.1.49

package/esm/src/agent/memory/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/memory/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,KAAK,MAAM,EACX,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,cAAc,EACd,KAAK,MAAM,EACX,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,CAAC;AAEF,KAAK,eAAe,GAAG,cAAc,GAAG,QAAQ,CAAC;AAgDjD,uBAAe,gBAAgB,CAAC,CAAC,SAAS,cAAc,CAAE,YAAW,MAAM,CAAC,CAAC,CAAC;IAC5E,SAAS,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAM;IAC7B,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACxD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE/C,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEvC,WAAW,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAI3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;CAGjC;AAED,qBAAa,kBAAkB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CACvE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAIf,OAAO,CAAC,MAAM;IAH1B,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAG,cAAc,CAAU;IACxD,SAAS,CAAC,QAAQ,CAAC,UAAU,+BAA+B;gBAExC,MAAM,EAAE,gBAAgB;IAI5C,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9B,OAAO,CAAC,gBAAgB;CAazB;AAED,qBAAa,YAAY,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAC9F,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAG,QAAQ,CAAU;IAClD,SAAS,CAAC,QAAQ,CAAC,UAAU,yBAAyB;IACtD,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,gBAAgB;IAKpC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAe/B;AAED,qBAAa,aAAa,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,YAAW,MAAM,CAAC,CAAC,CAAC;IAK5E,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,gBAAgB,CAAS;gBAEb,MAAM,EAAE,gBAAgB;IAI5C,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9B,WAAW,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IA0B3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAkBhC,OAAO,CAAC,oBAAoB;CAgB7B;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EACpE,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAAC,CAAC,CAAC,CAUX"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/memory/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAG/B,KAAK,eAAe,GAAG,cAAc,GAAG,QAAQ,CAAC;AAgDjD,uBAAe,gBAAgB,CAAC,CAAC,SAAS,cAAc,CAAE,YAAW,MAAM,CAAC,CAAC,CAAC;IAC5E,SAAS,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAM;IAC7B,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACxD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE/C,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEvC,WAAW,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAI3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;CAGjC;AAED,qBAAa,kBAAkB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CACvE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAIf,OAAO,CAAC,MAAM;IAH1B,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAG,cAAc,CAAU;IACxD,SAAS,CAAC,QAAQ,CAAC,UAAU,+BAA+B;gBAExC,MAAM,EAAE,gBAAgB;IAI5C,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9B,OAAO,CAAC,gBAAgB;CAazB;AAED,qBAAa,YAAY,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAC9F,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAG,QAAQ,CAAU;IAClD,SAAS,CAAC,QAAQ,CAAC,UAAU,yBAAyB;IACtD,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,gBAAgB;IAKpC,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAe/B;AAED,qBAAa,aAAa,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,YAAW,MAAM,CAAC,CAAC,CAAC;IAK5E,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,gBAAgB,CAAS;gBAEb,MAAM,EAAE,gBAAgB;IAI5C,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9B,WAAW,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IA0B3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAkBhC,OAAO,CAAC,oBAAoB;CAgB7B;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EACpE,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAAC,CAAC,CAAC,CAUX"}

package/esm/src/agent/memory/memory.js

@@ -1,6 +1,5 @@
 import { estimateTokens, getTextFromMemoryParts, } from "./memory-interface.js";
 import { withSpan, withSpanSync } from "../../observability/tracing/otlp-setup.js";
-export { estimateTokens, };
 function getMessagesWithTrace(messages, spanName, memoryType) {
     return Promise.resolve(withSpanSync(spanName, () => [...messages], { "memory.type": memoryType, "memory.message_count": messages.length }));
 }

package/esm/src/agent/react/use-chat/types.d.ts

@@ -96,6 +96,8 @@ export interface UseChatResult {
     error: Error | null;
     /** Current model override (undefined = use agent default) */
     model: string | undefined;
+    /** The actual model being used after auto-upgrade (e.g. "anthropic/claude-sonnet-4-20250514") */
+    activeModel: string | undefined;
     /** Where inference is currently happening */
     inferenceMode: InferenceMode;
     /** Browser-side model loading/inference status (null when not using browser fallback) */

package/esm/src/agent/react/use-chat/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/types.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/react/use-chat/use-chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-chat.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/use-chat.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAKV,SAAS,EAET,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,wDAAwD;AACxD,UAAU,MAAM;IACd,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,sEAAsE;AACtE,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,SAAS,EAAE,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,SAAS,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAsf9D"}
+{"version":3,"file":"use-chat.d.ts","sourceRoot":"","sources":["../../../../../src/src/agent/react/use-chat/use-chat.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAKV,SAAS,EAET,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,wDAAwD;AACxD,UAAU,MAAM;IACd,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,sEAAsE;AACtE,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,SAAS,EAAE,CAAC;CAC3B;AAED,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,SAAS,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CA4f9D"}

package/esm/src/agent/react/use-chat/use-chat.js

@@ -38,6 +38,7 @@ export function useChat(options) {
     const [data, setData] = useState(null);
     const [model, setModel] = useState(options.model);
     const [inferenceMode, setInferenceMode] = useState("cloud");
+    const [activeModel, setActiveModel] = useState(undefined);
     const [browserStatus, setBrowserStatus] = useState(null);
     const abortControllerRef = useRef(null);
     const requestIdRef = useRef(0);
@@ -185,9 +186,6 @@ export function useChat(options) {
                 try {
                     const body = await response.json();
                     if (body.code === "NO_AI_AVAILABLE") {
-                        if (body.systemPrompt) {
-                            systemPromptRef.current = body.systemPrompt;
-                        }
                         setInferenceMode("browser");
                         setBrowserStatus("idle");
                         await doBrowserInference(allMessages);
@@ -210,11 +208,14 @@ export function useChat(options) {
             const streamingMessageId = generateClientId("msg");
             let hasAddedStreamingMessage = false;
             const currentMessageIdRef = { current: streamingMessageId };
+            // Mutable local — updated by onData before onMessage/onUpdate use it.
+            let serverModel = model;
+            setActiveModel(undefined);
             await handleStreamingResponse(response.body, {
                 onMessage: (assistantMessage) => {
                     const withMeta = {
                         ...assistantMessage,
-                        metadata: { ...assistantMessage.metadata, model },
+                        metadata: { ...assistantMessage.metadata, model: serverModel },
                     };
                     setMessages((prev) => {
                         if (!hasAddedStreamingMessage)
@@ -227,13 +228,17 @@ export function useChat(options) {
                 },
                 onData: (eventData) => {
                     setData(eventData);
-                    // Detect inference mode from server metadata
+                    // Detect inference mode and resolved model from server metadata
                     if (eventData &&
                         typeof eventData === "object" &&
                         "inferenceMode" in eventData) {
-                        const mode = eventData.inferenceMode;
-                        if (mode === "server-local" || mode === "cloud") {
-                            setInferenceMode(mode);
+                        const d = eventData;
+                        if (d.inferenceMode === "server-local" || d.inferenceMode === "cloud") {
+                            setInferenceMode(d.inferenceMode);
+                        }
+                        if (d.model) {
+                            serverModel = d.model;
+                            setActiveModel(d.model);
                         }
                     }
                 },
@@ -249,7 +254,7 @@ export function useChat(options) {
                     }
                     if (!hasAddedStreamingMessage) {
                         hasAddedStreamingMessage = true;
-                        setMessages((prev) => [...prev, { id, role: "assistant", parts, metadata: { model } }]);
+                        setMessages((prev) => [...prev, { id, role: "assistant", parts, metadata: { model: serverModel } }]);
                         return;
                     }
                     setMessages((prev) => prev.map((m) => (m.id === currentMessageIdRef.current ? { ...m, parts } : m)));
@@ -428,6 +433,7 @@ export function useChat(options) {
         isLoading,
         error,
         model,
+        activeModel,
         inferenceMode,
         browserStatus,
         setInput,

package/esm/src/agent/runtime/index.d.ts

@@ -19,6 +19,24 @@ export { accumulateUsage, getMaxSteps, normalizeInput } from "./input-utils.js";
 export { createStreamState, processStream } from "./ai-stream-handler.js";
 export type { AIStreamCallbacks, AIStreamState, StreamingToolCall } from "./ai-stream-handler.js";
 export { DEFAULT_MAX_STEPS, DEFAULT_MAX_TOKENS, DEFAULT_TEMPERATURE, MAX_STREAM_BUFFER_SIZE, } from "./constants.js";
+/**
+ * Extract and validate the skill policy from a load-skill tool result.
+ * Returns `[]` (no tools allowed) for invalid/missing policies instead of
+ * `undefined` (no restrictions), preventing accidental policy bypass.
+ */
+export declare function extractSkillPolicy(result: unknown): string[] | undefined;
+/** Result of skill policy enforcement for a single tool call */
+type SkillPolicyResult = {
+    allowed: true;
+} | {
+    allowed: false;
+    error: string;
+};
+/**
+ * Enforce skill policy on a single tool call.
+ * Shared between generate() and stream() paths.
+ */
+export declare function enforceSkillPolicy(toolName: string, activeSkillPolicy: string[] | undefined, mustLoadSkillFirst: boolean): SkillPolicyResult;
 export declare class AgentRuntime {
     private id;
     private config;

package/esm/src/agent/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,aAAa,EAGlB,KAAK,OAAO,EAEZ,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAc/D,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AA8BxB,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAuB;gBAEzB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;IAQ3C;;OAEG;IACG,QAAQ,CACZ,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,EACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC;IA+BzB;;;OAGG;IACG,MAAM,CACV,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;QAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;KACnC,EACD,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAqEtC;;OAEG;YACW,gBAAgB;IA2K9B;;;;OAIG;YACW,yBAAyB;IAsLvC;;OAEG;YACW,eAAe;IAqC7B;;OAEG;YACW,mBAAmB;IAOjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC;IAI5B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAIF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAGnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,aAAa,EAGlB,KAAK,OAAO,EAEZ,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAc/D,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAoBxB;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CA4BxE;AAED,gEAAgE;AAChE,KAAK,iBAAiB,GAClB;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EAAE,GAAG,SAAS,EACvC,kBAAkB,EAAE,OAAO,GAC1B,iBAAiB,CAiBnB;AAkCD,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAuB;gBAEzB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;IAQ3C;;OAEG;IACG,QAAQ,CACZ,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,EACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC;IA+BzB;;;OAGG;IACG,MAAM,CACV,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;QAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;KACnC,EACD,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IA+EtC;;OAEG;YACW,gBAAgB;IAwN9B;;;;OAIG;YACW,yBAAyB;IAwNvC;;OAEG;YACW,eAAe;IAqC7B;;OAEG;YACW,mBAAmB;IAOjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC;IAI5B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAIF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAGnC"}

package/esm/src/agent/runtime/index.js

@@ -11,7 +11,7 @@
  * @module ai/agent/runtime
  */
 import { getTextFromParts, } from "../types.js";
-import { ensureModelReady, resolveModel } from "../../provider/index.js";
+import { ensureModelReady, findAvailableCloudModel, resolveModel } from "../../provider/index.js";
 import { executeTool } from "../../tool/index.js";
 import { generateId } from "../../utils/id.js";
 import { detectPlatform, getPlatformCapabilities } from "../../platform/core-platform.js";
@@ -33,23 +33,87 @@ import { DEFAULT_MAX_TOKENS, DEFAULT_TEMPERATURE } from "./constants.js";
 import { generateMessageId, sendSSE } from "./sse-utils.js";
 import { getAvailableTools, isDynamicTool, parseToolArgs } from "./tool-helpers.js";
 import { accumulateUsage, getMaxSteps, normalizeInput } from "./input-utils.js";
+import { filterToolsForSkill, isToolAllowedBySkill, validateAllowedToolPatterns, } from "../../skill/allowed-tools.js";
 const logger = serverLogger.component("agent");
+const LOAD_SKILL_TOOL_ID = "load-skill";
+function getSkillActivationRequiredError(toolName) {
+    return `Tool "${toolName}" cannot run before load-skill succeeds in the same step. ` +
+        `Call "${LOAD_SKILL_TOOL_ID}" first to establish the active skill context.`;
+}
+/**
+ * Extract and validate the skill policy from a load-skill tool result.
+ * Returns `[]` (no tools allowed) for invalid/missing policies instead of
+ * `undefined` (no restrictions), preventing accidental policy bypass.
+ */
+export function extractSkillPolicy(result) {
+    if (!result || typeof result !== "object")
+        return undefined;
+    const skillResult = result;
+    // No allowedTools key means the skill has no restrictions
+    if (!("allowedTools" in skillResult) || skillResult.allowedTools === undefined) {
+        return undefined;
+    }
+    // Validate the shape: must be a string array
+    const raw = skillResult.allowedTools;
+    if (!Array.isArray(raw) || !raw.every((v) => typeof v === "string")) {
+        // Invalid shape — fail closed (empty policy = no tools allowed)
+        logger.warn("load-skill returned invalid allowedTools; falling back to empty policy (no tools)");
+        return [];
+    }
+    // Validate each pattern against the regex
+    try {
+        return validateAllowedToolPatterns(raw);
+    }
+    catch {
+        logger.warn("load-skill returned invalid tool patterns; falling back to empty policy (no tools)");
+        return [];
+    }
+}
 /**
- * Detect whether the resolved model is local inference.
- * Handles both explicit "local/*" requests and cloud->local auto-fallback.
+ * Enforce skill policy on a single tool call.
+ * Shared between generate() and stream() paths.
  */
-function isLocalInferenceModel(model, requestedModel) {
-    if (requestedModel.startsWith("local/"))
-        return true;
-    // LanguageModel is a union that includes string, so we need to narrow first
-    if (typeof model === "string")
-        return model.startsWith("local/");
-    if ("provider" in model && model.provider === "local")
-        return true;
-    if ("modelId" in model && typeof model.modelId === "string" && model.modelId.startsWith("local/")) {
-        return true;
+export function enforceSkillPolicy(toolName, activeSkillPolicy, mustLoadSkillFirst) {
+    // Must load skill before other tools
+    if (mustLoadSkillFirst && toolName !== LOAD_SKILL_TOOL_ID) {
+        return { allowed: false, error: getSkillActivationRequiredError(toolName) };
     }
-    return false;
+    // Check tool allowed by active skill policy (Layer 2: execution-time)
+    if (activeSkillPolicy && !isToolAllowedBySkill(toolName, activeSkillPolicy)) {
+        return {
+            allowed: false,
+            error: `Tool "${toolName}" is not allowed by the active skill policy. Allowed: ${activeSkillPolicy.join(", ")}`,
+        };
+    }
+    return { allowed: true };
+}
+/**
+ * Auto-upgrade a local model string to a cloud provider when API keys are available.
+ *
+ * Returns the upgraded "provider/model" string, or the original string unchanged
+ * if no cloud provider is available. This keeps resolveModel as a pure resolver
+ * while the runtime owns the upgrade policy.
+ */
+function maybeUpgradeLocalModel(modelString) {
+    if (!modelString.startsWith("local/"))
+        return modelString;
+    const cloud = findAvailableCloudModel();
+    if (cloud) {
+        logger.info(`⚡ Cloud AI API key found — using "${cloud}" instead of local model.`);
+        return cloud;
+    }
+    return modelString;
+}
+/**
+ * Check whether a resolved LanguageModel is a local inference model.
+ * Checks the model object properties rather than the requested string,
+ * because resolveModel may internally fall back from cloud to local.
+ */
+function isLocalModel(model) {
+    const m = model;
+    return !!m._isVfLocalModel ||
+        m.provider === "local" ||
+        (typeof m.modelId === "string" && m.modelId.startsWith("local/"));
 }
 export class AgentRuntime {
     id;
@@ -66,11 +130,11 @@ export class AgentRuntime {
      * Generate a response (non-streaming)
      */
     async generate(input, context, modelOverride) {
-        const modelString = modelOverride || this.config.model;
+        const resolvedModelString = maybeUpgradeLocalModel(modelOverride || this.config.model);
         return withSpan("agent.generate", async (span) => {
             setSpanAttributes(span, {
                 "agent.id": this.id,
-                "agent.model": modelString,
+                "agent.model": resolvedModelString,
             });
             const inputMessages = normalizeInput(input);
             for (const msg of inputMessages)
@@ -79,13 +143,13 @@ export class AgentRuntime {
             const systemPrompt = await this.resolveSystemPrompt();
             const agentContext = {
                 agentId: this.id,
-                model: modelString,
+                model: resolvedModelString,
                 input: inputMessages,
                 data: context,
                 platform: detectPlatform(),
             };
             const chain = new MiddlewareChain(this.config.middleware);
-            return chain.execute(agentContext, () => this.executeAgentLoop(systemPrompt, messages, modelString));
+            return chain.execute(agentContext, () => this.executeAgentLoop(systemPrompt, messages, resolvedModelString));
         });
     }
     /**
@@ -93,8 +157,9 @@ export class AgentRuntime {
      * Returns a ReadableStream in the veryfront stream event format.
      */
     async stream(messages, context, callbacks, modelOverride) {
-        const modelString = modelOverride || this.config.model;
-        const requestedModel = modelString || this.config.model;
+        const requestedModel = modelOverride || this.config.model;
+        // Auto-upgrade local/* to a cloud provider when API keys are available.
+        const resolvedModelString = maybeUpgradeLocalModel(requestedModel);
         for (const msg of messages)
             await this.memory.add(msg);
         const memoryMessages = await this.memory.getMessages();
@@ -105,7 +170,10 @@ export class AgentRuntime {
         // Resolve model BEFORE creating the ReadableStream — if this throws
         // (e.g., no_ai_available), the error propagates to the caller who can
         // return a proper error response (503) instead of a 200 with an error event.
-        const languageModel = resolveModel(requestedModel);
+        const languageModel = resolveModel(resolvedModelString);
+        // Determine inference mode from the resolved model object (not the string),
+        // because resolveModel may internally fall back from cloud to local.
+        const isLocal = isLocalModel(languageModel);
         // Eagerly verify the model runtime is available. For local models this
         // checks that @huggingface/transformers can be imported. Must happen
         // BEFORE creating the ReadableStream so no_ai_available errors propagate
@@ -118,16 +186,21 @@ export class AgentRuntime {
                     this.status = "streaming";
                     const messageId = generateMessageId();
                     sendSSE(controller, encoder, { type: "message-start", messageId });
+                    // Report the effective model — when resolveModel falls back from
+                    // cloud to local (e.g. missing API key), use the resolved object's
+                    // modelId so the client avatar matches the actual provider.
+                    const effectiveModel = isLocal && !resolvedModelString.startsWith("local/")
+                        ? `local/${languageModel.modelId ?? "unknown"}`
+                        : resolvedModelString;
                     sendSSE(controller, encoder, {
                         type: "data",
                         data: {
-                            inferenceMode: isLocalInferenceModel(languageModel, requestedModel)
-                                ? "server-local"
-                                : "cloud",
+                            inferenceMode: isLocal ? "server-local" : "cloud",
+                            model: effectiveModel,
                         },
                     });
                     sendSSE(controller, encoder, { type: "text-start", id: textPartId });
-                    await this.executeAgentLoopStreaming(systemPrompt, memoryMessages, controller, encoder, callbacks, textPartId, toolContext, modelString, languageModel);
+                    await this.executeAgentLoopStreaming(systemPrompt, memoryMessages, controller, encoder, callbacks, textPartId, toolContext, resolvedModelString, languageModel);
                     sendSSE(controller, encoder, { type: "text-end", id: textPartId });
                     sendSSE(controller, encoder, { type: "message-finish" });
                     controller.close();
@@ -150,22 +223,30 @@ export class AgentRuntime {
         return withSpan("agent.execution_loop", async (loopSpan) => {
             const { maxAgentSteps } = getPlatformCapabilities();
             const maxSteps = this.computeMaxSteps(maxAgentSteps);
-            const requestedModel = modelString || this.config.model;
-            const languageModel = resolveModel(requestedModel);
+            const effectiveModel = modelString || this.config.model;
+            const languageModel = resolveModel(effectiveModel);
             const toolCalls = [];
             const currentMessages = [...messages];
             const totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
             // Local models can't reliably do function calling — skip tools gracefully.
-            const isLocal = isLocalInferenceModel(languageModel, requestedModel);
+            const isLocal = isLocalModel(languageModel);
             if (isLocal && this.config.tools) {
-                logger.warn(`Agent "${this.id}" has tools configured but is using local model "${requestedModel}". ` +
+                logger.warn(`Agent "${this.id}" has tools configured but is using local model "${effectiveModel}". ` +
                     "Local models don't support tool calling — tools will be skipped. " +
                     "Set OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_API_KEY for full tool support.");
             }
+            // Request-scoped skill policy (not class-level mutable state)
+            let activeSkillPolicy;
             for (let step = 0; step < maxSteps; step++) {
                 this.status = "thinking";
                 addSpanEvent(loopSpan, "step_start", { step });
-                const tools = isLocal ? [] : getAvailableTools(this.config.tools);
+                let tools = isLocal ? [] : getAvailableTools(this.config.tools, {
+                    includeSkillTools: Boolean(this.config.skills),
+                });
+                // Layer 1: Filter tools based on active skill policy (planning-time)
+                if (activeSkillPolicy) {
+                    tools = filterToolsForSkill(tools, activeSkillPolicy);
+                }
                 const response = await withSpan("agent.generate_text", async (span) => {
                     setSpanAttributes(span, {
                         "model.id": modelString || this.config.model,
@@ -222,6 +303,9 @@ export class AgentRuntime {
                 }
                 this.status = "tool_execution";
                 addSpanEvent(loopSpan, "tool_execution_start", { count: response.toolCalls.length });
+                let mustLoadSkillFirst = !activeSkillPolicy &&
+                    Boolean(this.config.skills) &&
+                    response.toolCalls.some((tc) => tc.toolName === LOAD_SKILL_TOOL_ID);
                 for (const tc of response.toolCalls) {
                     const toolCall = {
                         id: tc.toolCallId,
@@ -231,6 +315,26 @@ export class AgentRuntime {
                     };
                     await withSpan("agent.tool_execute", async (toolSpan) => {
                         setSpanAttributes(toolSpan, { "tool.name": tc.toolName, "tool.id": tc.toolCallId });
+                        const policyCheck = enforceSkillPolicy(tc.toolName, activeSkillPolicy, mustLoadSkillFirst);
+                        if (!policyCheck.allowed) {
+                            toolCall.status = "error";
+                            toolCall.error = policyCheck.error;
+                            const errorMessage = {
+                                id: `tool_error_${tc.toolCallId}`,
+                                role: "tool",
+                                parts: [{
+                                        type: "tool-result",
+                                        toolCallId: tc.toolCallId,
+                                        toolName: tc.toolName,
+                                        result: { error: policyCheck.error },
+                                    }],
+                                timestamp: Date.now(),
+                            };
+                            currentMessages.push(errorMessage);
+                            await this.memory.add(errorMessage);
+                            toolCalls.push(toolCall);
+                            return;
+                        }
                         try {
                             toolCall.status = "executing";
                             const startTime = Date.now();
@@ -238,6 +342,11 @@ export class AgentRuntime {
                             toolCall.status = "completed";
                             toolCall.result = result;
                             toolCall.executionTime = Date.now() - startTime;
+                            // Track skill policy from load-skill results
+                            if (tc.toolName === LOAD_SKILL_TOOL_ID) {
+                                activeSkillPolicy = extractSkillPolicy(result);
+                                mustLoadSkillFirst = false;
+                            }
                             const toolResultMessage = {
                                 id: `tool_${tc.toolCallId}`,
                                 role: "tool",
@@ -299,21 +408,29 @@ export class AgentRuntime {
     async executeAgentLoopStreaming(systemPrompt, messages, controller, encoder, callbacks, textPartId, toolContext, modelString, resolvedModel) {
         const { maxAgentSteps } = getPlatformCapabilities();
         const maxSteps = this.computeMaxSteps(maxAgentSteps);
-        const requestedModel = modelString || this.config.model;
-        const languageModel = resolvedModel ?? resolveModel(requestedModel);
+        const effectiveModel = modelString || this.config.model;
+        const languageModel = resolvedModel ?? resolveModel(effectiveModel);
         const toolCalls = [];
         const currentMessages = [...messages];
         const totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
         // Local models can't reliably do function calling — skip tools gracefully.
-        const isLocalStreaming = isLocalInferenceModel(languageModel, requestedModel);
+        const isLocalStreaming = isLocalModel(languageModel);
         if (isLocalStreaming && this.config.tools) {
-            logger.warn(`Agent "${this.id}" has tools configured but is using local model "${requestedModel}". ` +
+            logger.warn(`Agent "${this.id}" has tools configured but is using local model "${effectiveModel}". ` +
                 "Local models don't support tool calling — tools will be skipped. " +
                 "Set OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_API_KEY for full tool support.");
         }
+        // Request-scoped skill policy (not class-level mutable state)
+        let activeSkillPolicy;
         for (let step = 0; step < maxSteps; step++) {
             sendSSE(controller, encoder, { type: "step-start" });
-            const tools = isLocalStreaming ? [] : getAvailableTools(this.config.tools);
+            let tools = isLocalStreaming ? [] : getAvailableTools(this.config.tools, {
+                includeSkillTools: Boolean(this.config.skills),
+            });
+            // Layer 1: Filter tools based on active skill policy (planning-time)
+            if (activeSkillPolicy) {
+                tools = filterToolsForSkill(tools, activeSkillPolicy);
+            }
             const result = streamText({
                 model: languageModel,
                 system: systemPrompt,
@@ -358,7 +475,11 @@ export class AgentRuntime {
                 break;
             }
             this.status = "tool_execution";
-            for (const tc of state.toolCalls.values()) {
+            const streamedToolCalls = Array.from(state.toolCalls.values());
+            let mustLoadSkillFirst = !activeSkillPolicy &&
+                Boolean(this.config.skills) &&
+                streamedToolCalls.some((tc) => tc.name === LOAD_SKILL_TOOL_ID);
+            for (const tc of streamedToolCalls) {
                 const { args, error: argError } = parseToolArgs(tc.arguments);
                 const toolCall = { id: tc.id, name: tc.name, args, status: "pending" };
                 if (argError) {
@@ -376,6 +497,11 @@ export class AgentRuntime {
                     await this.recordToolError(toolCall, `Invalid tool arguments: ${argError}`, controller, encoder, currentMessages, toolCalls);
                     continue;
                 }
+                const policyCheck = enforceSkillPolicy(tc.name, activeSkillPolicy, mustLoadSkillFirst);
+                if (!policyCheck.allowed) {
+                    await this.recordToolError(toolCall, policyCheck.error, controller, encoder, currentMessages, toolCalls);
+                    continue;
+                }
                 try {
                     toolCall.status = "executing";
                     const startTime = Date.now();
@@ -388,6 +514,11 @@ export class AgentRuntime {
                     toolCall.result = result;
                     toolCall.executionTime = Date.now() - startTime;
                     toolCalls.push(toolCall);
+                    // Track skill policy from load-skill results
+                    if (tc.name === LOAD_SKILL_TOOL_ID) {
+                        activeSkillPolicy = extractSkillPolicy(result);
+                        mustLoadSkillFirst = false;
+                    }
                     const dynamic = isDynamicTool(tc.name);
                     sendSSE(controller, encoder, {
                         type: "tool-output-available",

package/esm/src/agent/runtime/tool-helpers.d.ts

@@ -31,6 +31,11 @@ export type ToolConfigEntry = Tool<any, any> | boolean;
  * Get available tools based on agent configuration.
  * When tools === true, loads all tools from registry.
  * Otherwise loads specific tools from config.
+ *
+ * @param toolsConfig - Agent tools configuration
+ * @param options.includeSkillTools - When true, include skill tools for `tools: true` agents
  */
-export declare function getAvailableTools(toolsConfig: true | Record<string, ToolConfigEntry> | undefined): ToolDefinition[];
+export declare function getAvailableTools(toolsConfig: true | Record<string, ToolConfigEntry> | undefined, options?: {
+    includeSkillTools?: boolean;
+}): ToolDefinition[];
 //# sourceMappingURL=tool-helpers.d.ts.map

package/esm/src/agent/runtime/tool-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/tool-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOhE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,cAAc,CAuBhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;AAmBvD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,GAC9D,cAAc,EAAE,CA6BlB"}
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/tool-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQhE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,cAAc,CAuBhB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;AAmBvD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,EAC/D,OAAO,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,GACxC,cAAc,EAAE,CAiClB"}

package/esm/src/agent/runtime/tool-helpers.js

@@ -7,6 +7,7 @@
  */
 import { toolRegistry } from "../../tool/index.js";
 import { toolToProviderDefinition } from "../../tool/registry.js";
+import { SKILL_TOOL_IDS } from "../../skill/types.js";
 import { serverLogger } from "../../utils/index.js";
 const logger = serverLogger.component("agent");
 /**
@@ -53,8 +54,11 @@ function addToolDefinition(tools, name, tool) {
  * Get available tools based on agent configuration.
  * When tools === true, loads all tools from registry.
  * Otherwise loads specific tools from config.
+ *
+ * @param toolsConfig - Agent tools configuration
+ * @param options.includeSkillTools - When true, include skill tools for `tools: true` agents
  */
-export function getAvailableTools(toolsConfig) {
+export function getAvailableTools(toolsConfig, options) {
     if (!toolsConfig)
         return [];
     if (toolsConfig === true) {
@@ -64,6 +68,11 @@ export function getAvailableTools(toolsConfig) {
             const def = toolToProviderDefinition(tool);
             logToolDefinition(name, def);
             return def;
+        }).filter((def) => {
+            // Exclude skill tools unless explicitly included
+            if (SKILL_TOOL_IDS.has(def.name) && !options?.includeSkillTools)
+                return false;
+            return true;
         });
     }
     const tools = [];

package/esm/src/agent/schemas/agent.schema.d.ts

@@ -21,14 +21,14 @@ export declare const EdgeConfigSchema: z.ZodObject<{
     streaming: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     enabled: boolean;
+    timeoutMs?: number | undefined;
     streaming?: boolean | undefined;
     maxSteps?: number | undefined;
-    timeoutMs?: number | undefined;
 }, {
     enabled: boolean;
+    timeoutMs?: number | undefined;
     streaming?: boolean | undefined;
     maxSteps?: number | undefined;
-    timeoutMs?: number | undefined;
 }>;
 export declare const ToolCallPartWithArgsSchema: z.ZodObject<{
     type: z.ZodString;
@@ -768,7 +768,6 @@ export declare const AgentContextSchema: z.ZodObject<{
     platform: z.ZodAny;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    agentId: string;
     input: string | {
         id: string;
         role: "tool" | "user" | "assistant" | "system";
@@ -799,12 +798,12 @@ export declare const AgentContextSchema: z.ZodObject<{
         timestamp?: number | undefined;
         metadata?: Record<string, unknown> | undefined;
     }[];
+    agentId: string;
     model?: string | undefined;
     data?: Record<string, unknown> | undefined;
     platform?: any;
     metadata?: Record<string, unknown> | undefined;
 }, {
-    agentId: string;
     input: string | {
         id: string;
         role: "tool" | "user" | "assistant" | "system";
@@ -835,6 +834,7 @@ export declare const AgentContextSchema: z.ZodObject<{
         timestamp?: number | undefined;
         metadata?: Record<string, unknown> | undefined;
     }[];
+    agentId: string;
     model?: string | undefined;
     data?: Record<string, unknown> | undefined;
     platform?: any;

package/esm/src/agent/types.d.ts

@@ -28,6 +28,16 @@ export interface AgentConfig {
     };
     /** Restrict runtime model overrides to these "provider/model" strings. */
     allowedModels?: ModelString[];
+    /**
+     * Enable skills for this agent.
+     * - true: include all discovered skills from skills/ directory
+     * - string[]: include only specific skill IDs
+     *
+     * Discovery happens at startup via discoverAll().
+     * This controls which skills appear in the agent's prompt
+     * and registers the skill tools.
+     */
+    skills?: true | string[];
 }
 import type { AgentContext, AgentResponse } from "./schemas/index.js";
 export type AgentMiddleware = (context: AgentContext, next: () => Promise<AgentResponse>) => Promise<AgentResponse>;