veryfront 0.1.758 → 0.1.761

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

@@ -2,8 +2,6 @@ export declare const AGENT_DEFAULTS: {
     readonly maxTokens: 4096;
     readonly temperature: 0;
     readonly maxSteps: 20;
-    readonly memoryType: "conversation";
-    readonly memoryMaxTokens: 4000;
 };
 export declare const STREAMING_DEFAULTS: {
     readonly maxBufferSize: number;

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

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC"}

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

@@ -2,8 +2,6 @@ export const AGENT_DEFAULTS = {
     maxTokens: 4_096,
     temperature: 0,
     maxSteps: 20,
-    memoryType: "conversation",
-    memoryMaxTokens: 4_000,
 };
 export const STREAMING_DEFAULTS = {
     maxBufferSize: 1_024 * 1_024, // 1 MB

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

@@ -31,6 +31,15 @@ export declare class AgentRuntime {
     private memory;
     private status;
     constructor(id: string, config: AgentConfig);
+    /**
+     * Persist this turn's input, then resolve the messages to run on. Configured
+     * memory returns the full persisted conversation (this turn + history); the
+     * stateless default persists nothing and returns empty, so we fall back to
+     * this turn's input. That fallback is what keeps concurrent stream()/
+     * generate() calls on a shared instance isolated instead of interleaving into
+     * one conversation.
+     */
+    private prepareTurnMessages;
     private resolveModelTransport;
     private resolveRuntimeState;
     private notifyToolResult;

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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/index.ts"],"names":[],"mappings":"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"}

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

@@ -14,7 +14,7 @@ import { getTextFromParts, } from "../types.js";
 import { ensureModelReady, resolveModel } from "../../provider/index.js";
 import { generateId } from "../../utils/id.js";
 import { detectPlatform, getPlatformCapabilities } from "../../platform/core-platform.js";
-import { createMemory } from "../memory/index.js";
+import { createAgentMemory } from "../memory/index.js";
 import { serverLogger } from "../../utils/index.js";
 import { addSpanEvent, setSpanAttributes, withSpan, } from "../../observability/tracing/index.js";
 import { convertToTextGenerationRuntimeMessages } from "./text-generation-runtime-message-converter.js";
@@ -24,7 +24,6 @@ import { getRuntimeRemoteToolSources } from "./mcp-server-tool-sources.js";
 import { createStreamState, processStream, } from "./chat-stream-handler.js";
 import { repairToolCall } from "./repair-tool-call.js";
 import { MiddlewareChain } from "../middleware/chain.js";
-import { AGENT_DEFAULTS } from "./defaults.js";
 import { tryGetCacheKeyContext } from "../../cache/cache-key-builder.js";
 import { isLocalModelRuntime } from "../../provider/runtime-inspection.js";
 import { generateText, streamText } from "../../runtime/runtime-bridge.js";
@@ -59,7 +58,7 @@ function isAbortError(error, abortSignal) {
 }
 function warnLocalToolSkipping(agentId, modelId) {
     logger.warn(`Agent "${agentId}" has tools configured but is using local model "${modelId}". ` +
-        "Local models don't support tool calling — tools will be skipped. " +
+        "Local models don't support tool calling. Tools will be skipped. " +
         "Set VERYFRONT_API_TOKEN and VERYFRONT_PROJECT_SLUG, or configure " +
         "OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_API_KEY for full tool support.");
 }
@@ -72,9 +71,25 @@ export class AgentRuntime {
     constructor(id, config) {
         this.id = id;
         this.config = config;
-        const memoryConfig = config.memory ||
-            { type: "conversation", maxTokens: AGENT_DEFAULTS.memoryMaxTokens };
-        this.memory = createMemory(memoryConfig);
+        // Agents are stateless by default (see docs/guides/memory-and-streaming.md):
+        // with no `memory` config, calls never share conversation history, so
+        // concurrent stream()/generate() on a shared instance stay isolated.
+        // Providing `memory` opts in to cross-call persistence.
+        this.memory = createAgentMemory(config.memory);
+    }
+    /**
+     * Persist this turn's input, then resolve the messages to run on. Configured
+     * memory returns the full persisted conversation (this turn + history); the
+     * stateless default persists nothing and returns empty, so we fall back to
+     * this turn's input. That fallback is what keeps concurrent stream()/
+     * generate() calls on a shared instance isolated instead of interleaving into
+     * one conversation.
+     */
+    async prepareTurnMessages(inputMessages) {
+        for (const msg of inputMessages)
+            await this.memory.add(msg);
+        const persisted = await this.memory.getMessages();
+        return persisted.length > 0 ? persisted : inputMessages;
     }
     async resolveModelTransport(context, modelOverride, mode) {
         const requestedModel = resolveConfiguredAgentModel(modelOverride || this.config.model);
@@ -130,9 +145,7 @@ export class AgentRuntime {
                 "agent.model": resolvedModelString,
             });
             const inputMessages = normalizeInput(input);
-            for (const msg of inputMessages)
-                await this.memory.add(msg);
-            const messages = await this.memory.getMessages();
+            const messages = await this.prepareTurnMessages(inputMessages);
             const systemPrompt = await this.resolveSystemPrompt();
             const agentContext = {
                 agentId: this.id,
@@ -159,9 +172,7 @@ export class AgentRuntime {
         if (resolvedModelString !== requestedModel) {
             logger.info(`⚡ Using runtime model "${resolvedModelString}" instead of "${requestedModel}".`);
         }
-        for (const msg of messages)
-            await this.memory.add(msg);
-        const memoryMessages = await this.memory.getMessages();
+        const memoryMessages = await this.prepareTurnMessages(messages);
         const systemPrompt = await this.resolveSystemPrompt();
         const encoder = new TextEncoder();
         const streamAbortController = new AbortController();
@@ -185,7 +196,7 @@ export class AgentRuntime {
             ...context,
         };
         const textPartId = generateId("text");
-        // Resolve model BEFORE creating the ReadableStream — if this throws
+        // 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 = transport.languageModel;
@@ -210,7 +221,7 @@ export class AgentRuntime {
         // no-op rejection handler. When the client cancels, we abort the shared
         // signal; the loop (model fetch / tool execution) then rejects with an
         // AbortError. The `start` body awaits it, but cancellation can land after
-        // that await settles, leaving the rejection without a consumer — fatal as
+        // that await settles, leaving the rejection without a consumer, fatal as
         // an unhandled rejection under Deno (#2334).
         let inFlight;
         return new ReadableStream({
@@ -220,7 +231,7 @@ 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
+                    // 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/")
@@ -287,7 +298,7 @@ export class AgentRuntime {
             const toolCalls = [];
             const currentMessages = [...messages];
             const totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
-            // Local models can't reliably do function calling — skip tools gracefully.
+            // Local models can't reliably do function calling, so skip tools gracefully.
             const isLocal = isLocalModelRuntime(languageModel);
             if (isLocal && this.config.tools) {
                 warnLocalToolSkipping(this.id, effectiveModel);
@@ -310,6 +321,7 @@ export class AgentRuntime {
                 currentRuntimeContext = runtimeState.context;
                 const toolContext = { ...toolContextBase, ...currentRuntimeContext };
                 let tools = isLocal ? [] : await getAvailableTools(this.config.tools, {
+                    callerAgentId: this.id,
                     includeSkillTools: Boolean(this.config.skills),
                     allowedRemoteToolNames,
                     forwardedRemoteToolDefinitions,
@@ -446,6 +458,9 @@ export class AgentRuntime {
                                 toolCallId: tc.toolCallId,
                                 ...toolContext,
                                 projectId: cacheCtx?.projectId ?? toolContext?.projectId,
+                                // Caller identity for capability scoping. Stamped after the
+                                // spreads so caller-supplied context cannot spoof it.
+                                agentId: this.id,
                             };
                             const result = await executeConfiguredTool(tc.toolName, toolCall.args, this.config.tools, executionContext, allowedRemoteToolNames, remoteToolSources);
                             await this.notifyToolResult({
@@ -507,7 +522,7 @@ export class AgentRuntime {
         const toolCalls = [];
         const currentMessages = [...messages];
         const totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
-        // Local models can't reliably do function calling — skip tools gracefully.
+        // Local models can't reliably do function calling, so skip tools gracefully.
         const isLocalStreaming = isLocalModelRuntime(languageModel);
         if (isLocalStreaming && this.config.tools) {
             warnLocalToolSkipping(this.id, effectiveModel);
@@ -533,6 +548,7 @@ export class AgentRuntime {
             currentRuntimeContext = runtimeState.context;
             const toolContext = { ...toolContextBase, ...currentRuntimeContext };
             let tools = isLocalStreaming ? [] : await getAvailableTools(this.config.tools, {
+                callerAgentId: this.id,
                 includeSkillTools: Boolean(this.config.skills),
                 allowedRemoteToolNames,
                 forwardedRemoteToolDefinitions,
@@ -662,13 +678,13 @@ export class AgentRuntime {
                 if (isRecoverablePlaceholderToolCall(tc)) {
                     // Provisional empty-object placeholder that never finalized. The
                     // model never committed arguments, so we neither execute it nor
-                    // surface a stream-termination error — the loop continues and the
+                    // surface a stream-termination error, so the loop continues and the
                     // next model call recovers the real tool call.
                     continue;
                 }
                 if (isStreamedToolCallIncomplete(tc)) {
                     // Stream ended before the provider finalized this tool call. We
-                    // cannot execute it — record a distinct stream-termination error
+                    // cannot execute it, so record a distinct stream-termination error
                     // (not a tool-argument parse error) so the parent step and any
                     // upstream orchestrator (e.g. the child-fork watchdog) see a
                     // completed step with a clearly-labelled failure and can recover.
@@ -744,6 +760,9 @@ export class AgentRuntime {
                     const executionContext = {
                         toolCallId: tc.id,
                         ...toolContext,
+                        // Caller identity for capability scoping. Stamped after the
+                        // spread so caller-supplied context cannot spoof it.
+                        agentId: this.id,
                     };
                     const result = await executeConfiguredTool(tc.name, toolCall.args, this.config.tools, executionContext, allowedRemoteToolNames, remoteToolSources);
                     throwIfAborted(abortSignal);
@@ -850,7 +869,13 @@ export class AgentRuntime {
             maxOutputTokensOverride > 0) {
             return Math.floor(maxOutputTokensOverride);
         }
-        return this.config.memory?.maxTokens ??
+        // A disabled memory config contributes nothing, exactly like omitting
+        // `memory`, so its maxTokens (a conversation-window size) must not cap
+        // model output.
+        const memoryMaxTokens = this.config.memory?.enabled === false
+            ? undefined
+            : this.config.memory?.maxTokens;
+        return memoryMaxTokens ??
             (modelString ? getModelMaxOutputTokens(modelString) : undefined) ??
             DEFAULT_MAX_TOKENS;
     }

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

@@ -0,0 +1,6 @@
+import type { Tool } from "../../tool/index.js";
+/** Mark a framework-created tool as local to one agent runtime. */
+export declare function markRuntimeLocalTool(tool: Tool): Tool;
+/** Check whether a tool must stay out of the project-wide tool registry. */
+export declare function isRuntimeLocalTool(value: unknown): boolean;
+//# sourceMappingURL=local-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-tool.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/local-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAQhD,mEAAmE;AACnE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAMrD;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM1D"}

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

@@ -0,0 +1,15 @@
+const AGENT_RUNTIME_LOCAL_TOOL = Symbol("veryfront.agent.runtimeLocalTool");
+/** Mark a framework-created tool as local to one agent runtime. */
+export function markRuntimeLocalTool(tool) {
+    Object.defineProperty(tool, AGENT_RUNTIME_LOCAL_TOOL, {
+        value: true,
+        enumerable: false,
+    });
+    return tool;
+}
+/** Check whether a tool must stay out of the project-wide tool registry. */
+export function isRuntimeLocalTool(value) {
+    return Boolean(value &&
+        typeof value === "object" &&
+        value[AGENT_RUNTIME_LOCAL_TOOL] === true);
+}

package/esm/src/agent/runtime/project-skill-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-skill-catalog.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/project-skill-catalog.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,6BAA6B,EAC9B,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAChC,MAAM,qBAAqB,CAAC;AAE7B,+DAA+D;AAC/D,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,iCAAiC,GAAG;IAC9C,cAAc,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC9F,eAAe,EAAE,CACf,OAAO,EAAE,6BAA6B,KACnC,OAAO,CAAC,SAAS,0BAA0B,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3D,aAAa,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACjD,aAAa,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,iCAAiC,GAAG;IAC9C,cAAc,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC9F,aAAa,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;CAC5D,CAAC;AAcF,2CAA2C;AAC3C,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC,GAAG,sBAAsB,EAAE,CA+C3B;AAED,2CAA2C;AAC3C,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,4BAA4B,GAAG,iCAAiC,GACtE,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,4CAA4C;AAC5C,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,4BAA4B,GAAG,iCAAiC,GACtE,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAgFnC"}
+{"version":3,"file":"project-skill-catalog.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/project-skill-catalog.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,6BAA6B,EAC9B,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAChC,MAAM,qBAAqB,CAAC;AAE7B,+DAA+D;AAC/D,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,iCAAiC,GAAG;IAC9C,cAAc,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC9F,eAAe,EAAE,CACf,OAAO,EAAE,6BAA6B,KACnC,OAAO,CAAC,SAAS,0BAA0B,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3D,aAAa,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACjD,aAAa,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,iCAAiC,GAAG;IAC9C,cAAc,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC9F,aAAa,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;CAC5D,CAAC;AAcF,2CAA2C;AAC3C,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC,GAAG,sBAAsB,EAAE,CA+C3B;AAED,2CAA2C;AAC3C,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,4BAA4B,GAAG,iCAAiC,GACtE,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,4CAA4C;AAC5C,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,4BAA4B,GAAG,iCAAiC,GACtE,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA+HnC"}

package/esm/src/agent/runtime/project-skill-catalog.js

@@ -114,6 +114,44 @@ export async function getRuntimeProjectSkillCatalog(input) {
                 id,
                 content: file.content,
                 references: getProjectSkillReferences({ allFiles, file, isFlat }),
+                sourcePath: file.path,
+                logger: input.logger,
+            });
+            if (definition && !projectSkillsById.has(definition.id)) {
+                projectSkillsById.set(definition.id, definition);
+            }
+        }
+    }
+    // Colocated (agent-owned) skills: agents/{id}/SKILL.md (the agent's own
+    // skill) and agents/{id}/skills/{sub}/SKILL.md. Registered with owner
+    // metadata so per-run filtering and the source-path loader can apply the
+    // one owner-aware rule; ids match framework/control-plane discovery.
+    const colocatedPaths = allFiles
+        .map((file) => file.path)
+        .filter((path) => getColocatedSkillIdentity(path) !== null)
+        .sort();
+    if (colocatedPaths.length > 0) {
+        const colocatedFiles = await Promise.all(colocatedPaths.map((path) => input.getProjectFile({
+            projectId: input.projectId,
+            authToken: input.authToken,
+            branchId: input.branchId,
+            path,
+        })));
+        for (const file of colocatedFiles) {
+            if (!file?.content) {
+                continue;
+            }
+            const identity = getColocatedSkillIdentity(file.path);
+            if (!identity) {
+                continue;
+            }
+            const definition = buildRuntimeSkillDefinition({
+                id: identity.id,
+                content: file.content,
+                references: getProjectSkillReferences({ allFiles, file, isFlat: false }),
+                ownerAgentId: identity.ownerAgentId,
+                shortName: identity.shortName,
+                sourcePath: file.path,
                 logger: input.logger,
             });
             if (definition && !projectSkillsById.has(definition.id)) {
@@ -130,6 +168,35 @@ export async function getRuntimeProjectSkillCatalog(input) {
     }
     return sortSkillsById(mergedSkillsById.values());
 }
+/**
+ * Owned-capability namespace rule. Mirrors discovery
+ * (src/discovery/agent-scoped-capabilities.ts) and the control plane's skill
+ * source derivation; duplicated locally because the runtime layer must not
+ * import from discovery.
+ */
+const AGENT_CAPABILITY_NAMESPACE_SEPARATOR = "--";
+function sanitizeCapabilityNamespace(agentId) {
+    return agentId.replace(/[^A-Za-z0-9_-]/g, "_");
+}
+const COLOCATED_OWN_SKILL_REGEX = /^agents\/([^/]+)\/SKILL\.md$/;
+const COLOCATED_NESTED_SKILL_REGEX = /^agents\/([^/]+)\/skills\/([^/]+)\/SKILL\.md$/;
+function getColocatedSkillIdentity(path) {
+    const nested = path.match(COLOCATED_NESTED_SKILL_REGEX);
+    const nestedAgentId = nested?.[1];
+    const nestedShortName = nested?.[2];
+    if (nestedAgentId && nestedShortName) {
+        return {
+            id: `${sanitizeCapabilityNamespace(nestedAgentId)}${AGENT_CAPABILITY_NAMESPACE_SEPARATOR}${nestedShortName}`,
+            ownerAgentId: nestedAgentId,
+            shortName: nestedShortName,
+        };
+    }
+    const ownAgentId = path.match(COLOCATED_OWN_SKILL_REGEX)?.[1];
+    if (ownAgentId) {
+        return { id: ownAgentId, ownerAgentId: ownAgentId, shortName: ownAgentId };
+    }
+    return null;
+}
 function getProjectSkillId(path, isFlat) {
     const pathParts = path.split("/");
     const fileName = pathParts.at(-1);

package/esm/src/agent/runtime/project-skill-loader.d.ts

@@ -5,6 +5,15 @@ export type RuntimeProjectSkillContext = {
     projectId?: string | null;
     authToken: string;
     branchId?: string | null;
+    /**
+     * Per-run map of skill id to its discovered SKILL.md source path (from the
+     * owner-aware catalog). When present for an id, the loader resolves the
+     * skill and its references at that real path instead of probing
+     * `{skillsPath}/{skillId}/...` — required for colocated skills whose
+     * namespaced ids (e.g. `researcher--cite`) do not correspond to a
+     * `skills/{id}/` directory.
+     */
+    skillSourcePaths?: Readonly<Record<string, string>>;
 };
 /** Public API contract for runtime loaded project skill. */
 export type RuntimeLoadedProjectSkill = {

package/esm/src/agent/runtime/project-skill-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-skill-loader.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/project-skill-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,6BAA6B,EAC9B,MAAM,2BAA2B,CAAC;AAGnC,yCAAyC;AACzC,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACtE,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,gCAAgC,GAAG;IAC7C,cAAc,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC9F,eAAe,EAAE,CACf,OAAO,EAAE,6BAA6B,KACnC,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IACrD,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAClD,MAAM,CAAC,EAAE,+BAA+B,CAAC;CAC1C,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,yBAAyB,GAAG;IACtC,0BAA0B,EAAE,CAC1B,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvB,gBAAgB,EAAE,CAChB,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;IAC/C,yBAAyB,EAAE,CACzB,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7B,CAAC;AAuNF,2CAA2C;AAC3C,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,yBAAyB,CAQ3B"}
+{"version":3,"file":"project-skill-loader.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/project-skill-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,6BAA6B,EAC9B,MAAM,2BAA2B,CAAC;AAGnC,yCAAyC;AACzC,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACtE,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,gCAAgC,GAAG;IAC7C,cAAc,EAAE,CAAC,OAAO,EAAE,4BAA4B,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC9F,eAAe,EAAE,CACf,OAAO,EAAE,6BAA6B,KACnC,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IACrD,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAClD,MAAM,CAAC,EAAE,+BAA+B,CAAC;CAC1C,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,yBAAyB,GAAG;IACtC,0BAA0B,EAAE,CAC1B,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvB,gBAAgB,EAAE,CAChB,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;IAC/C,yBAAyB,EAAE,CACzB,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7B,CAAC;AAoQF,2CAA2C;AAC3C,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,yBAAyB,CAQ3B"}

package/esm/src/agent/runtime/project-skill-loader.js

@@ -6,11 +6,33 @@ function getSkillPaths(options) {
 function isAccessDeniedError(error, options) {
     return options.isAccessDeniedError?.(error) ?? false;
 }
+/** Directory containing the skill's files, per source kind. */
+function getSkillDir(source, skillId) {
+    if (source.kind === "explicit") {
+        return source.skillDir;
+    }
+    if (source.kind === "directory") {
+        return `${source.skillsPath}/${skillId}`;
+    }
+    return null;
+}
+/** Resolves a skill's directory from the per-run catalog source path, if any. */
+function resolveCatalogSkillDir(context, skillId) {
+    const sourcePath = context.skillSourcePaths?.[skillId];
+    if (!sourcePath || !sourcePath.endsWith("/SKILL.md")) {
+        return null;
+    }
+    return sourcePath.slice(0, -"/SKILL.md".length);
+}
 async function findProjectSkillSource(input) {
     const projectId = input.context.projectId;
     if (!projectId) {
         return null;
     }
+    const catalogSkillDir = resolveCatalogSkillDir(input.context, input.skillId);
+    if (catalogSkillDir) {
+        return { kind: "explicit", skillDir: catalogSkillDir };
+    }
     for (const skillsPath of getSkillPaths(input.options)) {
         const directorySkill = await input.options.getProjectFile({
             projectId,
@@ -34,7 +56,7 @@ async function findProjectSkillSource(input) {
     return null;
 }
 function collectProjectSkillReferences(input) {
-    const skillPrefix = `${input.skillsPath}/${input.skillId}/`;
+    const skillPrefix = `${input.skillDir}/`;
     const refsPrefix = `${skillPrefix}references/`;
     const references = new Set();
     for (const file of input.allFiles) {
@@ -60,7 +82,8 @@ async function listProjectSkillReferences(input) {
     const source = input.skillsPath
         ? { kind: "directory", skillsPath: input.skillsPath }
         : await findProjectSkillSource(input);
-    if (source?.kind !== "directory") {
+    const skillDir = source ? getSkillDir(source, input.skillId) : null;
+    if (!skillDir) {
         return [];
     }
     const allFiles = await input.options.getProjectFiles({
@@ -70,8 +93,7 @@ async function listProjectSkillReferences(input) {
     });
     return collectProjectSkillReferences({
         allFiles,
-        skillsPath: source.skillsPath,
-        skillId: input.skillId,
+        skillDir,
     });
 }
 async function loadProjectSkill(input) {
@@ -80,6 +102,21 @@ async function loadProjectSkill(input) {
         return null;
     }
     try {
+        const catalogSkillDir = resolveCatalogSkillDir(input.context, input.skillId);
+        if (catalogSkillDir) {
+            const catalogSkill = await input.options.getProjectFile({
+                projectId,
+                authToken: input.context.authToken,
+                branchId: input.context.branchId,
+                path: `${catalogSkillDir}/SKILL.md`,
+            });
+            if (catalogSkill?.content) {
+                return {
+                    instructions: catalogSkill.content,
+                    references: await listProjectSkillReferences(input),
+                };
+            }
+        }
         for (const skillsPath of getSkillPaths(input.options)) {
             const directorySkill = await input.options.getProjectFile({
                 projectId,
@@ -127,14 +164,15 @@ async function loadProjectSkillReference(input) {
     }
     try {
         const source = await findProjectSkillSource(input);
-        if (source?.kind !== "directory") {
+        const skillDir = source ? getSkillDir(source, input.skillId) : null;
+        if (!skillDir) {
             return null;
         }
         const projectFile = await input.options.getProjectFile({
             projectId,
             authToken: input.context.authToken,
             branchId: input.context.branchId,
-            path: `${source.skillsPath}/${input.skillId}/${input.normalizedFile}`,
+            path: `${skillDir}/${input.normalizedFile}`,
         });
         if (projectFile?.content) {
             return projectFile.content;

package/esm/src/agent/runtime/skill-metadata.d.ts

@@ -23,7 +23,27 @@ export type RuntimeSkillDefinition = {
     thinking?: false | number;
     maxSteps?: number;
     references?: string[];
+    /**
+     * Owning agent id for agent-scoped (colocated) skills. Unowned (undefined)
+     * skills are project-global; owned skills are visible only to their owner.
+     */
+    ownerAgentId?: string;
+    /** Short name used by the owning agent's `skills:` selector (e.g. "cite"). */
+    shortName?: string;
+    /**
+     * Actual discovered source path of the skill's SKILL.md. Consumers must use
+     * this instead of reconstructing paths from (possibly namespaced) ids.
+     */
+    sourcePath?: string;
 };
+/**
+ * Whether a runtime skill definition is visible to the caller identified by
+ * the scope — the same owner-aware rule as the local skill registry: unowned
+ * skills plus the caller's own.
+ */
+export declare function isRuntimeSkillVisibleTo(definition: Pick<RuntimeSkillDefinition, "ownerAgentId">, scope?: {
+    agentId?: string;
+}): boolean;
 /** Public API contract for runtime loaded skill response messages. */
 export type RuntimeLoadedSkillResponseMessages = {
     allowedToolsNote: string;
@@ -71,6 +91,9 @@ export declare function buildRuntimeSkillDefinition(input: {
     id: string;
     content: string;
     references?: readonly string[];
+    ownerAgentId?: string;
+    shortName?: string;
+    sourcePath?: string;
     logger?: RuntimeSkillMetadataLogger;
 }): RuntimeSkillDefinition | null;
 /** Normalizes runtime skill reference path. */

package/esm/src/agent/runtime/skill-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-metadata.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/skill-metadata.ts"],"names":[],"mappings":"AAmBA,yDAAyD;AACzD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,eAAO,MAAM,gCAAgC,iFAuB5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B,2EAA+C,CAAC;AAE1F,oCAAoC;AACpC,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,kCAAkC,GAAG;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wCAAwC,EAAE,MAAM,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACvE,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAwBF,qCAAqC;AACrC,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,0BAA0B,CAAA;CAAO,GACpD,0BAA0B,GAAG,IAAI,CAsBnC;AAED,qCAAqC;AACrC,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,0BAA0B,CAAA;CAAO,GACpD,uBAAuB,GAAG,IAAI,CAEhC;AAED,0CAA0C;AAC1C,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC,GAAG,sBAAsB,GAAG,IAAI,CAqBhC;AAED,+CAA+C;AAC/C,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa9E;AAED,uDAAuD;AACvD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,kCAAkC,CAAC;IAC7C,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC,GAAG,0BAA0B,CAkD7B"}
+{"version":3,"file":"skill-metadata.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/skill-metadata.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/runtime/skill-metadata.js

@@ -37,6 +37,14 @@ export const getRuntimeSkillFrontmatterSchema = defineSchema((v) => v
  * @deprecated Use getRuntimeSkillFrontmatterSchema()
  */
 export const RuntimeSkillFrontmatterSchema = lazySchema(getRuntimeSkillFrontmatterSchema);
+/**
+ * Whether a runtime skill definition is visible to the caller identified by
+ * the scope — the same owner-aware rule as the local skill registry: unowned
+ * skills plus the caller's own.
+ */
+export function isRuntimeSkillVisibleTo(definition, scope) {
+    return definition.ownerAgentId === undefined || definition.ownerAgentId === scope?.agentId;
+}
 function extractDescriptionFromMarkdown(content, fallback) {
     const lines = content.split("\n");
     for (const line of lines) {
@@ -99,6 +107,9 @@ export function buildRuntimeSkillDefinition(input) {
         ...(input.references && input.references.length > 0
             ? { references: [...input.references] }
             : {}),
+        ...(input.ownerAgentId === undefined ? {} : { ownerAgentId: input.ownerAgentId }),
+        ...(input.shortName === undefined ? {} : { shortName: input.shortName }),
+        ...(input.sourcePath === undefined ? {} : { sourcePath: input.sourcePath }),
     };
 }
 /** Normalizes runtime skill reference path. */

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

@@ -27,7 +27,7 @@ export declare function isDynamicTool(name: string): boolean;
  * Can be a boolean (true to enable from registry) or a Tool instance.
  */
 export type ToolConfigEntry = Tool<any, any> | boolean;
-export declare function resolveConfiguredTool(toolsConfig: true | Record<string, ToolConfigEntry> | undefined, toolName: string): Tool | null;
+export declare function resolveConfiguredTool(toolsConfig: true | Record<string, ToolConfigEntry> | undefined, toolName: string, context?: ToolExecutionContext): Tool | null;
 export declare function executeConfiguredTool(toolName: string, input: Record<string, unknown>, toolsConfig: true | Record<string, ToolConfigEntry> | undefined, context?: ToolExecutionContext, allowedRemoteToolNames?: string[], remoteToolSources?: RemoteToolSource[]): Promise<unknown>;
 /**
  * Get available tools based on agent configuration.
@@ -44,5 +44,7 @@ export declare function getAvailableTools(toolsConfig: true | Record<string, Too
     forwardedRemoteToolDefinitions?: ToolDefinition[];
     remoteToolSources?: RemoteToolSource[];
     remoteToolContext?: ToolExecutionContext;
+    /** Calling agent id for owner-aware tool visibility. */
+    callerAgentId?: string;
 }): Promise<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,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAaxG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuBD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,cAAc,CAyBhB;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;AAqHvD,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,EAC/D,QAAQ,EAAE,MAAM,GACf,IAAI,GAAG,IAAI,CAmBb;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,EAC/D,OAAO,CAAC,EAAE,oBAAoB,EAC9B,sBAAsB,CAAC,EAAE,MAAM,EAAE,EACjC,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,GACrC,OAAO,CAAC,OAAO,CAAC,CAgClB;AAyCD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,EAC/D,OAAO,CAAC,EAAE;IACR,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,8BAA8B,CAAC,EAAE,cAAc,EAAE,CAAC;IAClD,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;CAC1C,GACA,OAAO,CAAC,cAAc,EAAE,CAAC,CAyF3B"}
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/tool-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAaxG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuBD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,cAAc,CAyBhB;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;AA0IvD,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,EAC/D,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,IAAI,GAAG,IAAI,CAyBb;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,EAC/D,OAAO,CAAC,EAAE,oBAAoB,EAC9B,sBAAsB,CAAC,EAAE,MAAM,EAAE,EACjC,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,GACrC,OAAO,CAAC,OAAO,CAAC,CAkClB;AAyCD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,EAC/D,OAAO,CAAC,EAAE;IACR,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,8BAA8B,CAAC,EAAE,cAAc,EAAE,CAAC;IAClD,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;IACzC,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,OAAO,CAAC,cAAc,EAAE,CAAC,CAqG3B"}