veryfront 0.1.759 → 0.1.761

package/esm/src/agent/project/steering-mutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"steering-mutation.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/project/steering-mutation.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,eAAO,MAAM,8BAA8B;;;CAGjC,CAAC;AAEX,8DAA8D;AAC9D,eAAO,MAAM,yCAAyC,qEAK5C,CAAC;AAEX,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,mDAAmD;AACnD,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,6BAA6B,GAAG;IAC1C,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAgDF,wCAAwC;AACxC,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,4BAA4B,GAClC,6BAA6B,CA8B/B;AAMD,oEAAoE;AACpE,wBAAgB,yCAAyC,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAWlF"}
+{"version":3,"file":"steering-mutation.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/project/steering-mutation.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,eAAO,MAAM,8BAA8B;;;CAGjC,CAAC;AAEX,8DAA8D;AAC9D,eAAO,MAAM,yCAAyC,qEAK5C,CAAC;AAEX,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,mDAAmD;AACnD,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,6BAA6B,GAAG;IAC1C,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAyDF,wCAAwC;AACxC,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,4BAA4B,GAClC,6BAA6B,CA8B/B;AAMD,oEAAoE;AACpE,wBAAgB,yCAAyC,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAWlF"}

package/esm/src/agent/project/steering-mutation.js

@@ -17,9 +17,15 @@ const NO_MUTATION = {
 function getPathMutationFlags(path, steeringPaths) {
     return {
         instructionsChanged: steeringPaths.instructions.includes(path),
-        skillsChanged: steeringPaths.skills.some((prefix) => path === prefix || path.startsWith(`${prefix}/`)),
+        skillsChanged: isProjectSkillMutationPath(path, steeringPaths),
     };
 }
+function isProjectSkillMutationPath(path, steeringPaths) {
+    if (steeringPaths.skills.some((prefix) => path === prefix || path.startsWith(`${prefix}/`))) {
+        return true;
+    }
+    return /^agents\/[^/]+\/(?:SKILL\.md|references\/|skills\/[^/]+\/)/.test(path);
+}
 function mergeMutationFlags(flags) {
     return {
         instructionsChanged: flags.some((flag) => flag.instructionsChanged),

package/esm/src/agent/runtime/agent-definition.d.ts

@@ -29,6 +29,9 @@ export declare const getRuntimeAgentMarkdownDefinitionSchema: () => import("../.
     temperature: import("../../internal-agents/schema.js").Schema<number | undefined>;
     maxSteps: import("../../internal-agents/schema.js").Schema<number | undefined>;
     providerTools: import("../../internal-agents/schema.js").Schema<string[] | undefined>;
+    skills: import("../../internal-agents/schema.js").Schema<true | string[] | undefined>;
+    tools: import("../../internal-agents/schema.js").Schema<true | string[] | undefined>;
+    delegates: import("../../internal-agents/schema.js").Schema<string[] | undefined>;
 }>>;
 /** Default value for runtime agent context marker. */
 export declare const DEFAULT_RUNTIME_AGENT_CONTEXT_MARKER = "<!-- veryfront-runtime-context -->";
@@ -48,6 +51,9 @@ export declare const runtimeAgentMarkdownDefinitionSchema: import("../../interna
     temperature: import("../../internal-agents/schema.js").Schema<number | undefined>;
     maxSteps: import("../../internal-agents/schema.js").Schema<number | undefined>;
     providerTools: import("../../internal-agents/schema.js").Schema<string[] | undefined>;
+    skills: import("../../internal-agents/schema.js").Schema<true | string[] | undefined>;
+    tools: import("../../internal-agents/schema.js").Schema<true | string[] | undefined>;
+    delegates: import("../../internal-agents/schema.js").Schema<string[] | undefined>;
 }>>;
 /** Definition for runtime agent markdown. */
 export type RuntimeAgentMarkdownDefinition = InferSchema<ReturnType<typeof getRuntimeAgentMarkdownDefinitionSchema>>;

package/esm/src/agent/runtime/agent-definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-definition.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/agent-definition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,wDAAwD;AACxD,eAAO,MAAM,mCAAmC;;;GAK/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;GAAkD,CAAC;AAEhG,oDAAoD;AACpD,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAClD,UAAU,CAAC,OAAO,mCAAmC,CAAC,CACvD,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;GAYnD,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,oCAAoC,uCAAuC,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;GAEhD,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,8BAA8B,GAAG,WAAW,CACtD,UAAU,CAAC,OAAO,uCAAuC,CAAC,CAC3D,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,iDAAiD;;;GAK7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8CAA8C;;;GAE1D,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,wCAAwC,GAAG,WAAW,CAChE,UAAU,CAAC,OAAO,iDAAiD,CAAC,CACrE,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,qCAAqC,GAAG;IAClD,KAAK,EAAE,8BAA8B,CAAC;IACtC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAuBF,mDAAmD;AACnD,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,wCAAwC,GAC9C,8BAA8B,CAsBhC;AAkBD,4CAA4C;AAC5C,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,qCAAqC,GAC3C,iBAAiB,EAAE,CA2CrB"}
+{"version":3,"file":"agent-definition.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/agent-definition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGlE,wDAAwD;AACxD,eAAO,MAAM,mCAAmC;;;GAK/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;GAAkD,CAAC;AAEhG,oDAAoD;AACpD,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAClD,UAAU,CAAC,OAAO,mCAAmC,CAAC,CACvD,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;GAenD,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,oCAAoC,uCAAuC,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;GAEhD,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,8BAA8B,GAAG,WAAW,CACtD,UAAU,CAAC,OAAO,uCAAuC,CAAC,CAC3D,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,iDAAiD;;;GAK7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8CAA8C;;;GAE1D,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,wCAAwC,GAAG,WAAW,CAChE,UAAU,CAAC,OAAO,iDAAiD,CAAC,CACrE,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,qCAAqC,GAAG;IAClD,KAAK,EAAE,8BAA8B,CAAC;IACtC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AA+DF,mDAAmD;AACnD,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,wCAAwC,GAC9C,8BAA8B,CA6BhC;AAkBD,4CAA4C;AAC5C,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,qCAAqC,GAC3C,iBAAiB,EAAE,CA2CrB"}

package/esm/src/agent/runtime/agent-definition.js

@@ -2,6 +2,7 @@ import { extract } from "../../platform/compat/std/front-matter-yaml.js";
 import { defineSchema, lazySchema } from "../../schemas/index.js";
 import { createRuntimePromptBlock } from "./prompt-block.js";
 import { buildRuntimeAvailableSkillsPromptBlock } from "./skill-prompt.js";
+import { AGENT_DELEGATE_TOOL_PREFIX, isProviderSafeDelegateId } from "./agent-delegation-names.js";
 /** Zod schema for get runtime agent thinking config. */
 export const getRuntimeAgentThinkingConfigSchema = defineSchema((v) => v.object({
     enabled: v.boolean(),
@@ -22,6 +23,9 @@ export const getRuntimeAgentMarkdownDefinitionSchema = defineSchema((v) => v.obj
     temperature: v.number().min(0).max(2).optional(),
     maxSteps: v.number().optional(),
     providerTools: v.array(v.string().min(1)).optional(),
+    skills: v.union([v.literal(true), v.array(v.string().min(1))]).optional(),
+    tools: v.union([v.literal(true), v.array(v.string().min(1))]).optional(),
+    delegates: v.array(v.string().min(1)).optional(),
 }));
 /** Default value for runtime agent context marker. */
 export const DEFAULT_RUNTIME_AGENT_CONTEXT_MARKER = "<!-- veryfront-runtime-context -->";
@@ -56,6 +60,41 @@ function parseProviderTools(value) {
     }
     return value;
 }
+function parseCapabilitySelector(value) {
+    if (value === true) {
+        return true;
+    }
+    if (Array.isArray(value)) {
+        const ids = value
+            .filter((entry) => typeof entry === "string" && entry.trim().length > 0)
+            .map((entry) => entry.trim());
+        return ids.length > 0 ? ids : undefined;
+    }
+    return undefined;
+}
+function parseDelegates(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const ids = value
+        .filter((entry) => typeof entry === "string" && entry.trim().length > 0)
+        .map((entry) => entry.trim());
+    return ids.length > 0 ? ids : undefined;
+}
+function validateDelegates(agentId, delegates) {
+    if (!delegates) {
+        return;
+    }
+    for (const delegateId of delegates) {
+        if (delegateId === agentId) {
+            throw new Error(`Agent "${agentId}" cannot delegate to itself.`);
+        }
+        if (!isProviderSafeDelegateId(delegateId)) {
+            throw new Error(`Delegate id "${delegateId}" for agent "${agentId}" produces an invalid tool name ` +
+                `"${AGENT_DELEGATE_TOOL_PREFIX}${delegateId}" (must match [A-Za-z0-9_-], max 64 chars).`);
+        }
+    }
+}
 /** Definition for parse runtime agent markdown. */
 export function parseRuntimeAgentMarkdownDefinition(input) {
     const parsedInput = getParseRuntimeAgentMarkdownDefinitionInputSchema().parse(input);
@@ -67,6 +106,10 @@ export function parseRuntimeAgentMarkdownDefinition(input) {
     const temperature = typeof attrs.temperature === "number" ? attrs.temperature : undefined;
     const maxSteps = typeof attrs["max-steps"] === "number" ? attrs["max-steps"] : undefined;
     const providerTools = parseProviderTools(attrs["provider-tools"]);
+    const skills = parseCapabilitySelector(attrs.skills);
+    const tools = parseCapabilitySelector(attrs.tools);
+    const delegates = parseDelegates(attrs.delegates);
+    validateDelegates(parsedInput.id, delegates);
     return getRuntimeAgentMarkdownDefinitionSchema().parse({
         id: parsedInput.id,
         name,
@@ -77,6 +120,9 @@ export function parseRuntimeAgentMarkdownDefinition(input) {
         ...(temperature === undefined ? {} : { temperature }),
         ...(maxSteps === undefined ? {} : { maxSteps }),
         ...(providerTools ? { providerTools } : {}),
+        ...(skills === undefined ? {} : { skills }),
+        ...(tools === undefined ? {} : { tools }),
+        ...(delegates === undefined ? {} : { delegates }),
     });
 }
 function splitRuntimeAgentInstructions(input) {

package/esm/src/agent/runtime/agent-delegation-names.d.ts

@@ -0,0 +1,5 @@
+/** Prefix used for the delegate tool exposed to the coordinator agent. */
+export declare const AGENT_DELEGATE_TOOL_PREFIX = "agent_";
+/** Whether a delegate id produces a provider-safe `agent_{id}` tool name. */
+export declare function isProviderSafeDelegateId(delegateId: string): boolean;
+//# sourceMappingURL=agent-delegation-names.d.ts.map

package/esm/src/agent/runtime/agent-delegation-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-delegation-names.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/agent-delegation-names.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,WAAW,CAAC;AAKnD,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEpE"}

package/esm/src/agent/runtime/agent-delegation-names.js

@@ -0,0 +1,8 @@
+/** Prefix used for the delegate tool exposed to the coordinator agent. */
+export const AGENT_DELEGATE_TOOL_PREFIX = "agent_";
+/** Provider tool-call names allow only this charset, max 64 chars. */
+const PROVIDER_TOOL_NAME_REGEX = /^[A-Za-z0-9_-]{1,64}$/;
+/** Whether a delegate id produces a provider-safe `agent_{id}` tool name. */
+export function isProviderSafeDelegateId(delegateId) {
+    return PROVIDER_TOOL_NAME_REGEX.test(`${AGENT_DELEGATE_TOOL_PREFIX}${delegateId}`);
+}

package/esm/src/agent/runtime/agent-delegation.d.ts

@@ -0,0 +1,32 @@
+import type { Tool } from "../../tool/types.js";
+import type { Agent } from "../types.js";
+import { AGENT_DELEGATE_TOOL_PREFIX, isProviderSafeDelegateId } from "./agent-delegation-names.js";
+export { AGENT_DELEGATE_TOOL_PREFIX, isProviderSafeDelegateId };
+/** Resolves a registered agent by id (defaults to the global registry). */
+export type DelegateAgentResolver = (id: string) => Agent | undefined;
+/** Input payload for build agent delegate tools. */
+export type BuildAgentDelegateToolsInput = {
+    /** Specialist agent ids this coordinator is allowed to delegate to. */
+    delegates: readonly string[];
+    /** Id of the delegating agent, excluded to prevent self-delegation. */
+    selfId?: string;
+    /** Override the agent resolver (testing / custom registries). */
+    resolveAgent?: DelegateAgentResolver;
+};
+/**
+ * Builds the opt-in delegate tools for a coordinator agent.
+ *
+ * Each entry in `delegates` becomes an `agent_{id}` tool that runs the named
+ * specialist agent. Agents are resolved lazily at execution time so discovery
+ * order does not matter. Self-delegation, duplicates, and ids that would
+ * produce a provider-unsafe tool name are skipped defensively here; markdown
+ * parsing rejects the latter two cases up front with an explicit diagnostic.
+ * Returns an empty map when `delegates` is empty — i.e. an agent with no
+ * `delegates` runs with no orchestration.
+ *
+ * Delegation chains are intentionally not cycle-detected here. Each delegated
+ * call is a separate agent run with its own maxSteps budget; keep delegate
+ * graphs acyclic until a runtime chain-depth cap exists.
+ */
+export declare function buildAgentDelegateTools(input: BuildAgentDelegateToolsInput): Record<string, Tool>;
+//# sourceMappingURL=agent-delegation.d.ts.map

package/esm/src/agent/runtime/agent-delegation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-delegation.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/agent-delegation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAGnG,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,CAAC;AAEhE,2EAA2E;AAC3E,MAAM,MAAM,qBAAqB,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,KAAK,GAAG,SAAS,CAAC;AAEtE,oDAAoD;AACpD,MAAM,MAAM,4BAA4B,GAAG;IACzC,uEAAuE;IACvE,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC,CAAC;AA2BF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,GAClC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAkBtB"}

package/esm/src/agent/runtime/agent-delegation.js

@@ -0,0 +1,57 @@
+import { agentAsTool, getAgent } from "../composition/index.js";
+import { getAgentToolInputSchema } from "../schemas/index.js";
+import { AGENT_DELEGATE_TOOL_PREFIX, isProviderSafeDelegateId } from "./agent-delegation-names.js";
+import { markRuntimeLocalTool } from "./local-tool.js";
+export { AGENT_DELEGATE_TOOL_PREFIX, isProviderSafeDelegateId };
+function createLazyDelegateTool(delegateId, resolveAgent) {
+    return markRuntimeLocalTool({
+        id: `${AGENT_DELEGATE_TOOL_PREFIX}${delegateId}`,
+        type: "function",
+        description: `Delegate a self-contained subtask to the "${delegateId}" specialist agent, ` +
+            `which runs with its own settings and skills. Provide a complete, standalone instruction.`,
+        inputSchema: getAgentToolInputSchema(),
+        execute(input, context) {
+            const target = resolveAgent(delegateId);
+            if (!target) {
+                return Promise.resolve({
+                    text: `Delegate agent "${delegateId}" is not available.`,
+                    toolCalls: 0,
+                    status: "error",
+                });
+            }
+            return agentAsTool(target, `Delegate to ${delegateId}`).execute(input, context);
+        },
+    });
+}
+/**
+ * Builds the opt-in delegate tools for a coordinator agent.
+ *
+ * Each entry in `delegates` becomes an `agent_{id}` tool that runs the named
+ * specialist agent. Agents are resolved lazily at execution time so discovery
+ * order does not matter. Self-delegation, duplicates, and ids that would
+ * produce a provider-unsafe tool name are skipped defensively here; markdown
+ * parsing rejects the latter two cases up front with an explicit diagnostic.
+ * Returns an empty map when `delegates` is empty — i.e. an agent with no
+ * `delegates` runs with no orchestration.
+ *
+ * Delegation chains are intentionally not cycle-detected here. Each delegated
+ * call is a separate agent run with its own maxSteps budget; keep delegate
+ * graphs acyclic until a runtime chain-depth cap exists.
+ */
+export function buildAgentDelegateTools(input) {
+    const resolveAgent = input.resolveAgent ?? getAgent;
+    const tools = {};
+    const seen = new Set();
+    for (const delegateId of input.delegates) {
+        const id = delegateId.trim();
+        if (id.length === 0 || id === input.selfId || seen.has(id)) {
+            continue;
+        }
+        if (!isProviderSafeDelegateId(id)) {
+            continue;
+        }
+        seen.add(id);
+        tools[`${AGENT_DELEGATE_TOOL_PREFIX}${id}`] = createLazyDelegateTool(id, resolveAgent);
+    }
+    return tools;
+}

package/esm/src/agent/runtime/agent-markdown-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-markdown-adapter.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/agent-markdown-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAI5E,yDAAyD;AACzD,wBAAgB,wCAAwC,CACtD,UAAU,EAAE,8BAA8B,GACzC,KAAK,CAcP;AAED,iDAAiD;AACjD,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,KAAK,GAClB,8BAA8B,GAAG,IAAI,CAEvC;AAED,iEAAiE;AACjE,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,KAAK,GAAG,OAAO,CAExE"}
+{"version":3,"file":"agent-markdown-adapter.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/agent-markdown-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAK5E,yDAAyD;AACzD,wBAAgB,wCAAwC,CACtD,UAAU,EAAE,8BAA8B,GACzC,KAAK,CAuCP;AAED,iDAAiD;AACjD,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,KAAK,GAClB,8BAA8B,GAAG,IAAI,CAEvC;AAED,iEAAiE;AACjE,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,KAAK,GAAG,OAAO,CAExE"}

package/esm/src/agent/runtime/agent-markdown-adapter.js

@@ -1,7 +1,26 @@
 import { agent } from "../factory.js";
+import { buildAgentDelegateTools } from "./agent-delegation.js";
 const markdownDefinitionByAgent = new WeakMap();
 /** Definition for create runtime agent from markdown. */
 export function createRuntimeAgentFromMarkdownDefinition(definition) {
+    const delegateTools = definition.delegates && definition.delegates.length > 0
+        ? buildAgentDelegateTools({ delegates: definition.delegates, selfId: definition.id })
+        : undefined;
+    // `tools:` is a binding selector resolved at invocation time by the
+    // owner-aware resolver: `true` binds all visible tools; a list binds each
+    // entry (own short name first, then exact global id). Delegate tools merge
+    // on top; on key collision the delegate tool wins (keys never overlap in
+    // practice: selectors use tool ids, delegates use `agent_{id}`).
+    const selectedTools = definition.tools === true
+        ? true
+        : definition.tools
+            ? Object.fromEntries(definition.tools.map((name) => [name, true]))
+            : undefined;
+    const mergedTools = selectedTools === true
+        ? true
+        : selectedTools || delegateTools
+            ? { ...(selectedTools ?? {}), ...(delegateTools ?? {}) }
+            : undefined;
     const runtimeAgent = agent({
         id: definition.id,
         name: definition.name,
@@ -11,6 +30,11 @@ export function createRuntimeAgentFromMarkdownDefinition(definition) {
         ...(definition.temperature === undefined ? {} : { temperature: definition.temperature }),
         ...(definition.maxSteps === undefined ? {} : { maxSteps: definition.maxSteps }),
         ...(definition.providerTools ? { providerTools: definition.providerTools } : {}),
+        ...(definition.skills === undefined ? {} : { skills: definition.skills }),
+        ...(mergedTools !== undefined &&
+            (mergedTools === true || Object.keys(mergedTools).length > 0)
+            ? { tools: mergedTools }
+            : {}),
     });
     markdownDefinitionByAgent.set(runtimeAgent, definition);
     return runtimeAgent;

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

@@ -321,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,
@@ -457,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({
@@ -544,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,
@@ -755,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);

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. */