@rowan-agent/agent 0.22.1 → 0.24.0

package/dist/index.d.ts

@@ -319,6 +319,8 @@ declare class InMemoryExtensionHost implements ExtensionHost {
  * - Tool registration support
  */
 
+/** The Resource Source an Extension registration lands in: Global (`[]`) is `rowan.extensions`, any other Scope `rowan.extensions:<scopeToKey(scope)>`. */
+declare function extensionSourceId(scope?: ScopeRef): string;
 type ExtensionRunnerOptions = {
     entryPhaseId?: string | null;
     cwd?: string;
@@ -368,10 +370,12 @@ declare class ExtensionRunner {
     private readonly hostUnsubscribers;
     private readonly phases;
     private _phaseCache;
+    private readonly skills;
     private readonly pendingProviders;
     private bound;
     private readonly errorListeners;
     private readonly capabilityListeners;
+    private readonly resourceChangeListeners;
     /** Current agent context — set by the agent before each phase */
     currentContext?: AgentContext;
     constructor(options?: ExtensionRunnerOptions);
@@ -419,7 +423,7 @@ declare class ExtensionRunner {
     /** Dispose all active Extensions in reverse activation order. */
     close(): Promise<void>;
     get extensionHost(): ExtensionHost;
-    notifyConfigChanged(extensionId: string, scope: ScopeRef): void;
+    notifyConfigChanged(extensionId: string, scope: ScopeRef): Promise<void>;
     getRunState(runId: string, extensionId: string, key: string): JsonValue | undefined;
     setRunState(runId: string, extensionId: string, key: string, value: JsonValue): void;
     deleteRunState(runId: string, extensionId: string, key: string): void;
@@ -437,6 +441,12 @@ declare class ExtensionRunner {
      * Returns an unsubscribe function.
      */
     onCapabilitiesChanged(listener: (capabilities: readonly ExtensionCapability[]) => void): () => void;
+    /**
+     * Subscribe to resource changes (tools, phases, skills registered, unregistered, or disposed).
+     * Used by RuntimeBootstrapRegistry to re-commit implicit sources after activation.
+     */
+    onResourceChange(listener: (kind: "tool" | "phase" | "skill") => Promise<void> | void): () => void;
+    private notifyResourceChange;
     triggerUiAction(event: {
         contributionId: string;
         actionId: string;
@@ -444,11 +454,14 @@ declare class ExtensionRunner {
     }): void;
     getPhase(name: string): Phase | undefined;
     getPhases(): Phase[];
+    getRegisteredPhases(): readonly RegisteredPhase[];
     createPhaseRegistry(input?: {
         entryPhaseId?: string | null;
     }): PhaseRegistry;
     /** Adapt an extension RegisteredPhase to the core Phase type. */
-    private adaptToPhase;
+    adaptToPhase(reg: RegisteredPhase): Phase;
+    getSkills(): Skill[];
+    getRegisteredSkills(): readonly RegisteredSkill[];
     /**
      * Bind the runner — flushes pending provider registrations and
      * replaces runtime stubs with real implementations.
@@ -489,6 +502,7 @@ declare class ExtensionRunner {
         agentId?: string;
         toolCallId?: string;
         metadata?: Readonly<Record<string, unknown>>;
+        agentMetadata?: Readonly<Record<string, unknown>>;
         answer?: unknown;
         scope?: ScopeRef;
         turn?: JsonObject;
@@ -515,6 +529,10 @@ declare class ExtensionRunner {
     private registerPhaseDefinition;
     private unregisterPhase;
     private loadRegisteredPhase;
+    private registerSkill;
+    private registerSkillDefinition;
+    private unregisterSkill;
+    private loadRegisteredSkill;
     private registerProvider;
     private unregisterProvider;
     private flushPendingProviders;
@@ -588,16 +606,22 @@ declare class RuntimeExtensionLifetime {
     activate(extensions: readonly LoadedExtension[]): Promise<ExtensionActivationResult>;
     tools(): readonly RegisteredTool[];
     phases(): readonly Phase[];
+    registeredPhases(): readonly RegisteredPhase[];
+    skills(): readonly Skill[];
+    registeredSkills(): readonly RegisteredSkill[];
     get extensionRunner(): ExtensionRunner;
     get extensionHost(): ExtensionHost;
+    onResourceChange(listener: (kind: "tool" | "phase" | "skill") => Promise<void> | void): () => void;
     dropRunState(runId: string): void;
     close(): Promise<void>;
 }
 /** Bootstrap-only Registry facade; its Extension method disappears after init. */
 declare class RuntimeBootstrapRegistry extends ResourceRegistry {
     private readonly extensions;
-    private readonly extensionSourceId;
+    private readonly knownSources;
+    private commitQueue;
     constructor(extensions?: RuntimeExtensionLifetime);
+    private recommit;
     get extensionHost(): ExtensionHost;
     /** Install Rowan-owned implicit resources before any host source is read. */
     ensureCoreResources(): Promise<void>;
@@ -1322,8 +1346,28 @@ interface SourceInfo {
     baseDir?: string;
     displayName?: string;
 }
+/** A loaded directory Bundle used by an extension. */
+type PhaseDefinition = Phase;
 /** Register a Phase by directory path or Phase object; PHASE.md and direct child Skills are loaded atomically when a path is supplied. */
 type PhaseRegistration = string | Phase;
+type RegisteredPhase = {
+    definition: PhaseDefinition;
+    source: {
+        extensionPath: string;
+    };
+    sourceId: string;
+    scope?: ScopeRef;
+};
+/** Register a Skill directory (containing SKILL.md) or a Skill object. Registering an existing name replaces it. */
+type SkillRegistration = string | Skill;
+type RegisteredSkill = {
+    definition: Skill;
+    source: {
+        extensionPath: string;
+    };
+    sourceId: string;
+    scope?: ScopeRef;
+};
 /**
  * Tool definition for registering LLM-callable tools via `api.tools.register()`.
  *
@@ -1381,6 +1425,8 @@ interface ToolDefinition {
 interface RegisteredTool {
     definition: ToolDefinition;
     sourceInfo: SourceInfo;
+    sourceId: string;
+    scope?: ScopeRef;
 }
 /**
  * Structured extension error with attribution.
@@ -1495,9 +1541,9 @@ interface ExtensionAPI {
     /** Tool capabilities — register and unregister custom tools. */
     tools: {
         /** Register a custom LLM-callable tool. */
-        register(tool: ToolDefinition): void;
+        register(tool: ToolDefinition, scope?: ScopeRef): Promise<void>;
         /** Unregister a previously registered tool by name. */
-        unregister(toolName: string): void;
+        unregister(toolName: string, scope?: ScopeRef): Promise<void>;
     };
     /** Capability contributions — advertise tools or features to the host. */
     capabilities: {
@@ -1514,9 +1560,9 @@ interface ExtensionAPI {
     /** Phase execution capabilities — provides Phase In/Out, phase identity, phase routing, and registration. */
     phases: {
         /** Register a Phase directory bundle or Phase object. */
-        register(phase: PhaseRegistration): Promise<void>;
+        register(phase: PhaseRegistration, scope?: ScopeRef): Promise<void>;
         /** Unregister a previously registered phase by name. */
-        unregister(phaseName: string): void;
+        unregister(phaseName: string, scope?: ScopeRef): Promise<void> | void;
         /** Phase In: get payload from previous phase */
         getPayload(): unknown;
         /** Phase Out: set payload for next phase */
@@ -1532,6 +1578,13 @@ interface ExtensionAPI {
         /** Get the message set by setMessage */
         getMessage(): string | undefined;
     };
+    /** Skill capabilities — register and unregister standalone skills. */
+    skills: {
+        /** Register a Skill directory (containing SKILL.md) or a Skill object. Registering an existing name replaces it. */
+        register(skill: SkillRegistration, scope?: ScopeRef): Promise<void>;
+        /** Unregister a previously registered Skill by name. */
+        unregister(skillName: string, scope?: ScopeRef): Promise<void> | void;
+    };
     /** Extension manifest from package.json `rowan` field. */
     manifest?: ExtensionManifest;
     /** Utility functions. */
@@ -1774,6 +1827,8 @@ interface BeforeToolCallEvent {
     readonly agentId?: string;
     readonly toolCallId?: string;
     readonly metadata?: Readonly<Record<string, unknown>>;
+    /** The invoking Agent's metadata, as the Tool's own call context carries it. */
+    readonly agentMetadata?: Readonly<Record<string, unknown>>;
     readonly answer?: unknown;
     readonly scope?: ScopeRef;
     readonly turn?: JsonObject;
@@ -3331,4 +3386,4 @@ declare function parseFrontmatter<T = Record<string, unknown>>(raw: string): Fro
 
 declare function createCoreTools(input?: CoreToolContext): Tool$1[];
 
-export { type AfterToolCall, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, type AgentRun, AgentRuntime, type AgentRuntimeOptions, type AgentSummary, type AnyRuntimeError, type AssistantContent, type AssistantMessage, type BeforeToolCall, COMPACT_PHASE_ID, type ConfigProvider, type ConfigPutResult, type ConfigResolution, type ConfigToken, type ConfigurationSnapshot, type ContextCandidate, type ContextCompactionRecord, type ContextStatus, type CoreToolContext, DEFAULT_PHASE_ID, type DefinitionLayer, type DurableConsumer, type DurableRunEvent, type DurableStore, type DurableToolResult, type EntryPhaseSpec, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionActivationError, type ExtensionActivationResult, type ExtensionCapability, type ExtensionCapabilityContribution, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, type ExtensionHost, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type ExtensionStateStore, type ExtensionToolContribution, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, type HostApiExtension, InMemoryConfigProvider, InMemoryExtensionHost, InMemoryStore, type InteractionRecord, type InvocationCatalogEntry, type InvocationSource, type JsonObject, type JsonPrimitive, type JsonValue, type LiveInteractionEvent, type LoadExtensionsResult, type LoadInput, type LoadResult, type LoadedExtension, type Message, type MessageBase, type MessageCommitted, type MessageContent, type MessageDelta, type MessageId, type MessageRevised, type MessageRevisionResult, type Metadata, type ModelRetry, type OpaqueId, type Outcome$1 as Outcome, type OwnerLease, type OwnerToken, type Page, type Phase, type PhaseContext, type PhaseContribution, type PhaseExecution, type PhaseExecutionIdentity, type PhaseInput, type PhaseInvocation, type PhaseMessageManager, type PhaseOutput, type PhaseRegistry, type PhaseRegistrySelection, type PhaseState, type PhaseStatus, type PhaseStatusState, type ResolvedResourceView, type ResourceDiagnostic, type ResourceKind, type ResourceRef, ResourceRegistry, ResourceRegistryError, type ResourceRegistryErrorCode, type ResourceSourceId, type ResourceView, type RetentionResult, type RunBoundary, type RunClaim, type RunEndEvent, type RunEvent, type RunFailure, type RunId, type RunInteraction, RunInteractionBoundary, RunInteractionCancelledError, type RunInteractionDriver, type RunInteractionKind, type RunInteractionRequest, type RunInteractionState, type RunInteractionStatus, type RunListCursor, type RunRecord, type RunSnapshot, type RunStartEvent, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, STOP_PHASE_ID, type SettingsBadge, type SettingsControl, type SettingsDefinition, type SettingsItem, type SettingsOption, type SettingsSection, type Skill, SqliteStore, type TextContent, type ThinkingContent, type ThinkingDelta, type Tool$1 as Tool, type ToolCallContext, type ToolCallDelta, type ToolCallId, type ToolCallPresentationInput, type ToolCallPresentationOutput, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UserContent, type UserInput, type UserMessage, type WithdrawnUserInput, brandConfigToken, createCompactPhase, createCorePhases, createCoreTools, createDefaultPhase, createStopPhase, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhases, loadSkill, loadSkills, mergeToolCall, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };
+export { type AfterToolCall, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, type AgentRun, AgentRuntime, type AgentRuntimeOptions, type AgentSummary, type AnyRuntimeError, type AssistantContent, type AssistantMessage, type BeforeToolCall, COMPACT_PHASE_ID, type ConfigProvider, type ConfigPutResult, type ConfigResolution, type ConfigToken, type ConfigurationSnapshot, type ContextCandidate, type ContextCompactionRecord, type ContextStatus, type CoreToolContext, DEFAULT_PHASE_ID, type DefinitionLayer, type DurableConsumer, type DurableRunEvent, type DurableStore, type DurableToolResult, type EntryPhaseSpec, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionActivationError, type ExtensionActivationResult, type ExtensionCapability, type ExtensionCapabilityContribution, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, type ExtensionHost, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type ExtensionStateStore, type ExtensionToolContribution, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, type HostApiExtension, InMemoryConfigProvider, InMemoryExtensionHost, InMemoryStore, type InteractionRecord, type InvocationCatalogEntry, type InvocationSource, type JsonObject, type JsonPrimitive, type JsonValue, type LiveInteractionEvent, type LoadExtensionsResult, type LoadInput, type LoadResult, type LoadedExtension, type Message, type MessageBase, type MessageCommitted, type MessageContent, type MessageDelta, type MessageId, type MessageRevised, type MessageRevisionResult, type Metadata, type ModelRetry, type OpaqueId, type Outcome$1 as Outcome, type OwnerLease, type OwnerToken, type Page, type Phase, type PhaseContext, type PhaseContribution, type PhaseExecution, type PhaseExecutionIdentity, type PhaseInput, type PhaseInvocation, type PhaseMessageManager, type PhaseOutput, type PhaseRegistry, type PhaseRegistrySelection, type PhaseState, type PhaseStatus, type PhaseStatusState, type ResolvedResourceView, type ResourceDiagnostic, type ResourceKind, type ResourceRef, ResourceRegistry, ResourceRegistryError, type ResourceRegistryErrorCode, type ResourceSourceId, type ResourceView, type RetentionResult, type RunBoundary, type RunClaim, type RunEndEvent, type RunEvent, type RunFailure, type RunId, type RunInteraction, RunInteractionBoundary, RunInteractionCancelledError, type RunInteractionDriver, type RunInteractionKind, type RunInteractionRequest, type RunInteractionState, type RunInteractionStatus, type RunListCursor, type RunRecord, type RunSnapshot, type RunStartEvent, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, STOP_PHASE_ID, type SettingsBadge, type SettingsControl, type SettingsDefinition, type SettingsItem, type SettingsOption, type SettingsSection, type Skill, type SkillRegistration, SqliteStore, type TextContent, type ThinkingContent, type ThinkingDelta, type Tool$1 as Tool, type ToolCallContext, type ToolCallDelta, type ToolCallId, type ToolCallPresentationInput, type ToolCallPresentationOutput, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UserContent, type UserInput, type UserMessage, type WithdrawnUserInput, brandConfigToken, createCompactPhase, createCorePhases, createCoreTools, createDefaultPhase, createStopPhase, extensionSourceId, isConfigurationSnapshot, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhases, loadSkill, loadSkills, mergeToolCall, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };

package/dist/index.js

@@ -1702,13 +1702,13 @@ function createExtensionAPI(hooks, options, runtime, eventBus) {
       }
     },
     tools: {
-      register: (tool) => {
+      register: (tool, scope) => {
         assertActive();
-        options?.registerTool?.(tool);
+        return Promise.resolve(options?.registerTool?.(tool, scope));
       },
-      unregister: (toolName) => {
+      unregister: (toolName, scope) => {
         assertActive();
-        options?.unregisterTool?.(toolName);
+        return Promise.resolve(options?.unregisterTool?.(toolName, scope));
       }
     },
     capabilities: {
@@ -1762,13 +1762,13 @@ function createExtensionAPI(hooks, options, runtime, eventBus) {
     }, emit: () => {
     }, has: () => false, count: () => 0 },
     phases: {
-      register: async (registration) => {
+      register: async (registration, scope) => {
         assertActive();
-        await options?.registerPhase?.(registration);
+        await options?.registerPhase?.(registration, scope);
       },
-      unregister: (phaseName) => {
+      unregister: (phaseName, scope) => {
         assertActive();
-        options?.unregisterPhase?.(phaseName);
+        return options?.unregisterPhase?.(phaseName, scope);
       },
       getPayload: () => outputPayload,
       setPayload: (p) => {
@@ -1783,6 +1783,16 @@ function createExtensionAPI(hooks, options, runtime, eventBus) {
       },
       getNextPhase: () => nextPhase,
       getMessage: () => outputMessage
+    },
+    skills: {
+      register: async (skill, scope) => {
+        assertActive();
+        await options?.registerSkill?.(skill, scope);
+      },
+      unregister: (skillName, scope) => {
+        assertActive();
+        return options?.unregisterSkill?.(skillName, scope);
+      }
     }
   };
   if (options?.namespaces) {
@@ -3573,6 +3583,12 @@ async function executePhase(ctx) {
     const api = createExtensionAPI(void 0, {
       registerPhase: async () => {
       },
+      unregisterPhase: () => {
+      },
+      registerSkill: async () => {
+      },
+      unregisterSkill: () => {
+      },
       registerProvider: () => {
       },
       unregisterProvider: () => {
@@ -5171,6 +5187,7 @@ function assembleRegisteredExtensions(snapshot, runner, options = {}) {
         agentId: input.context.agentId,
         toolCallId: input.context.toolCallId,
         metadata: input.context.runMetadata,
+        ...input.context.agentMetadata === void 0 ? {} : { agentMetadata: input.context.agentMetadata },
         answer: input.answer,
         scope: input.context.scope,
         turn: input.context.turn
@@ -6023,6 +6040,10 @@ function createEventBus() {
 }
 
 // src/extensions/runner.ts
+function extensionSourceId(scope) {
+  if (!scope || scope.length === 0) return "rowan.extensions";
+  return `rowan.extensions:${scopeToKey(scope)}`;
+}
 async function execCommand(command, args, cwd, options) {
   return new Promise((resolve9, reject) => {
     const child = execFile(
@@ -6105,6 +6126,8 @@ var ExtensionRunner = class {
   // Phase management
   phases = /* @__PURE__ */ new Map();
   _phaseCache = null;
+  // Skill management
+  skills = /* @__PURE__ */ new Map();
   // Provider management
   pendingProviders = [];
   bound = false;
@@ -6112,6 +6135,8 @@ var ExtensionRunner = class {
   errorListeners = /* @__PURE__ */ new Set();
   // Capability change listeners
   capabilityListeners = /* @__PURE__ */ new Set();
+  // Resource change listeners (for Registry live sync)
+  resourceChangeListeners = /* @__PURE__ */ new Set();
   /** Current agent context — set by the agent before each phase */
   currentContext;
   constructor(options) {
@@ -6122,7 +6147,7 @@ var ExtensionRunner = class {
     this.host = options?.host ?? new InMemoryExtensionHost();
     if (this.host.onConfigChanged) {
       const unsub = this.host.onConfigChanged((extensionId, scope) => {
-        this.notifyConfigChanged(extensionId, scope);
+        void this.notifyConfigChanged(extensionId, scope);
       });
       if (typeof unsub === "function") {
         this.hostUnsubscribers.push(unsub);
@@ -6215,6 +6240,7 @@ var ExtensionRunner = class {
         path: ext.path,
         tools: /* @__PURE__ */ new Map(),
         phases: /* @__PURE__ */ new Set(),
+        skills: /* @__PURE__ */ new Set(),
         capabilities: /* @__PURE__ */ new Map(),
         cleanup: [],
         runtime: createExtensionRuntime(),
@@ -6259,19 +6285,22 @@ var ExtensionRunner = class {
     }
     this.extensions.length = 0;
     this.capabilityListeners.clear();
+    this.resourceChangeListeners.clear();
     this.phases.clear();
     this._phaseCache = null;
+    this.skills.clear();
+    this.bound = false;
     this.runtime.invalidate("This Extension Runtime has been closed.");
   }
   get extensionHost() {
     return this.host;
   }
-  notifyConfigChanged(extensionId, scope) {
+  async notifyConfigChanged(extensionId, scope) {
     const listeners = this.configChangeListeners.get(extensionId);
     if (!listeners) return;
     for (const listener of listeners) {
       try {
-        listener(scope);
+        await listener(scope);
       } catch (error) {
         this.emitError({
           extensionPath: "<runtime>",
@@ -6326,8 +6355,9 @@ var ExtensionRunner = class {
    */
   getToolDefinition(toolName) {
     for (const ext of this.extensions) {
-      const tool = ext.tools.get(toolName);
-      if (tool) return tool.definition;
+      for (const tool of ext.tools.values()) {
+        if (tool.definition.name === toolName) return tool.definition;
+      }
     }
     return void 0;
   }
@@ -6357,6 +6387,20 @@ var ExtensionRunner = class {
     this.capabilityListeners.add(listener);
     return () => this.capabilityListeners.delete(listener);
   }
+  /**
+   * Subscribe to resource changes (tools, phases, skills registered, unregistered, or disposed).
+   * Used by RuntimeBootstrapRegistry to re-commit implicit sources after activation.
+   */
+  onResourceChange(listener) {
+    this.resourceChangeListeners.add(listener);
+    return () => this.resourceChangeListeners.delete(listener);
+  }
+  async notifyResourceChange(kind) {
+    if (!this.bound) return;
+    for (const listener of this.resourceChangeListeners) {
+      await listener(kind);
+    }
+  }
   triggerUiAction(event) {
     this.events.emit("ui.action", event);
   }
@@ -6364,20 +6408,24 @@ var ExtensionRunner = class {
   // Phase management
   // ---------------------------------------------------------------------------
   getPhase(name) {
-    const reg = this.getRegisteredPhase(name);
-    if (!reg) return void 0;
-    return this.adaptToPhase(reg);
+    for (const reg of this.collectRegisteredPhases().values()) {
+      if (reg.definition.name === name) return this.adaptToPhase(reg);
+    }
+    return void 0;
   }
   getPhases() {
     return [...this.collectRegisteredPhases().values()].map(
       (p) => this.adaptToPhase(p)
     );
   }
+  getRegisteredPhases() {
+    return [...this.collectRegisteredPhases().values()];
+  }
   createPhaseRegistry(input = {}) {
     const registered = this.collectRegisteredPhases();
     const phases = /* @__PURE__ */ new Map();
-    for (const [name, reg] of registered) {
-      phases.set(name, this.adaptToPhase(reg));
+    for (const reg of registered.values()) {
+      phases.set(reg.definition.name, this.adaptToPhase(reg));
     }
     const entryPhaseId = input.entryPhaseId ?? null;
     return { phases, entryPhaseId };
@@ -6393,6 +6441,15 @@ var ExtensionRunner = class {
     };
   }
   // ---------------------------------------------------------------------------
+  // Skill management
+  // ---------------------------------------------------------------------------
+  getSkills() {
+    return [...this.skills.values()].map((s) => s.definition);
+  }
+  getRegisteredSkills() {
+    return [...this.skills.values()];
+  }
+  // ---------------------------------------------------------------------------
   // Lifecycle
   // ---------------------------------------------------------------------------
   /**
@@ -6487,6 +6544,7 @@ var ExtensionRunner = class {
       ...context?.agentId !== void 0 ? { agentId: context.agentId } : {},
       ...context?.toolCallId !== void 0 ? { toolCallId: context.toolCallId } : {},
       ...context?.metadata !== void 0 ? { metadata: context.metadata } : {},
+      ...context?.agentMetadata !== void 0 ? { agentMetadata: context.agentMetadata } : {},
       ...context?.answer !== void 0 ? { answer: context.answer } : {},
       scope,
       turn
@@ -6567,12 +6625,14 @@ var ExtensionRunner = class {
       }
     };
     return createExtensionAPI(this.hooks, {
-      registerPhase: (registration) => this.registerPhase(extension, registration),
-      unregisterPhase: (phaseName) => this.unregisterPhase(extension, phaseName),
+      registerPhase: (registration, scope) => this.registerPhase(extension, registration, scope),
+      unregisterPhase: (phaseName, scope) => this.unregisterPhase(extension, phaseName, scope),
+      registerSkill: (registration, scope) => this.registerSkill(extension, registration, scope),
+      unregisterSkill: (skillName, scope) => this.unregisterSkill(extension, skillName, scope),
       registerProvider: (config) => this.registerProvider(config),
       unregisterProvider: (name) => this.unregisterProvider(name),
-      registerTool: (tool) => this.registerTool(extension, tool),
-      unregisterTool: (toolName) => this.unregisterTool(extension, toolName),
+      registerTool: (tool, scope) => this.registerTool(extension, tool, scope),
+      unregisterTool: (toolName, scope) => this.unregisterTool(extension, toolName, scope),
       contributeCapability: (contribution) => this.contributeCapability(extension, contribution),
       context: extContext,
       manifest,
@@ -6618,12 +6678,16 @@ var ExtensionRunner = class {
       }
     }, extension.runtime, this.events);
   }
-  registerTool(extension, tool) {
-    if (extension.tools.has(tool.name)) {
+  // Validation stays synchronous so a duplicate throws at the call site even
+  // when the caller does not await the Registry re-commit.
+  registerTool(extension, tool, scope) {
+    const sourceId = extensionSourceId(scope);
+    const regKey = `${sourceId}::${tool.name}`;
+    if (extension.tools.has(regKey)) {
       throw new Error(`Duplicate Tool name "${tool.name}" in extension ${extension.path}.`);
     }
     for (const ext of this.extensions) {
-      if (ext.tools.has(tool.name)) {
+      if (ext.tools.has(regKey)) {
         const message = `Duplicate Tool name "${tool.name}" from extensions ${ext.path} and ${extension.path}.`;
         this.emitError({
           extensionPath: extension.path,
@@ -6634,15 +6698,19 @@ var ExtensionRunner = class {
       }
     }
     const sourceInfo = createSourceInfo(extension.path);
-    extension.tools.set(tool.name, {
+    extension.tools.set(regKey, {
       definition: tool,
-      sourceInfo
+      sourceInfo,
+      sourceId,
+      scope
     });
+    return this.notifyResourceChange("tool");
   }
-  unregisterTool(extension, toolName) {
-    if (extension.tools.has(toolName)) {
-      extension.tools.delete(toolName);
-    }
+  unregisterTool(extension, toolName, scope) {
+    const sourceId = extensionSourceId(scope);
+    const regKey = `${sourceId}::${toolName}`;
+    if (!extension.tools.delete(regKey)) return Promise.resolve();
+    return this.notifyResourceChange("tool");
   }
   contributeCapability(extension, contribution) {
     const key = `${contribution.kind}:${contribution.name}`;
@@ -6684,53 +6752,101 @@ var ExtensionRunner = class {
       }
     }
   }
-  async registerPhase(extension, registration) {
+  async registerPhase(extension, registration, scope) {
     if (typeof registration === "string") {
       if (registration.length === 0) {
         throw new Error(`Phase registration requires a directory path.`);
       }
-      return this.loadRegisteredPhase(extension, registration);
+      return this.loadRegisteredPhase(extension, registration, scope);
     }
     if (typeof registration === "object" && registration !== null && "name" in registration) {
-      return this.registerPhaseDefinition(extension, registration);
+      return this.registerPhaseDefinition(extension, registration, scope);
     }
     throw new Error(`Phase registration requires a directory path or Phase object.`);
   }
-  registerPhaseDefinition(extension, phase) {
+  async registerPhaseDefinition(extension, phase, scope) {
+    const sourceId = extensionSourceId(scope);
     const name = phase.name;
-    if (this.phases.has(name)) {
+    const regKey = `${sourceId}::${name}`;
+    if (this.phases.has(regKey)) {
       throw new Error(`Duplicate phase name: ${name}`);
     }
     const registered = {
       definition: phase,
-      source: { extensionPath: extension.path }
+      source: { extensionPath: extension.path },
+      sourceId,
+      scope
     };
-    this.phases.set(name, registered);
-    extension.phases.add(name);
+    this.phases.set(regKey, registered);
+    extension.phases.add(regKey);
     this._phaseCache = null;
+    await this.notifyResourceChange("phase");
   }
-  unregisterPhase(extension, phaseName) {
-    const registered = this.phases.get(phaseName);
+  async unregisterPhase(extension, phaseName, scope) {
+    const sourceId = extensionSourceId(scope);
+    const regKey = `${sourceId}::${phaseName}`;
+    const registered = this.phases.get(regKey);
     if (registered && registered.source.extensionPath === extension.path) {
-      this.phases.delete(phaseName);
-      extension.phases.delete(phaseName);
+      this.phases.delete(regKey);
+      extension.phases.delete(regKey);
       this._phaseCache = null;
+      await this.notifyResourceChange("phase");
     }
   }
-  async loadRegisteredPhase(extension, registration) {
+  async loadRegisteredPhase(extension, registration, scope) {
     const extensionBase = extension.path.startsWith("<") ? this.cwd : dirname6(extension.path);
     const phase = await loadPhase(resolve5(extensionBase, registration));
-    const name = phase.name;
-    if (this.phases.has(name)) {
-      throw new Error(`Duplicate phase name: ${name}`);
+    await this.registerPhaseDefinition(extension, phase, scope);
+  }
+  async registerSkill(extension, registration, scope) {
+    if (typeof registration === "string") {
+      if (registration.length === 0) {
+        throw new Error(`Skill registration requires a directory path.`);
+      }
+      return this.loadRegisteredSkill(extension, registration, scope);
+    }
+    if (typeof registration === "object" && registration !== null && "name" in registration) {
+      return this.registerSkillDefinition(extension, registration, scope);
+    }
+    throw new Error(`Skill registration requires a directory path or Skill object.`);
+  }
+  async registerSkillDefinition(extension, skill, scope) {
+    const sourceId = extensionSourceId(scope);
+    const name = skill.name;
+    const regKey = `${sourceId}::${name}`;
+    const existing = this.skills.get(regKey);
+    if (existing && existing.source.extensionPath !== extension.path) {
+      for (const ext of this.extensions) {
+        if (ext.path === existing.source.extensionPath) {
+          ext.skills.delete(regKey);
+          break;
+        }
+      }
     }
     const registered = {
-      definition: phase,
-      source: { extensionPath: extension.path }
+      definition: skill,
+      source: { extensionPath: extension.path },
+      sourceId,
+      scope
     };
-    this.phases.set(name, registered);
-    extension.phases.add(name);
-    this._phaseCache = null;
+    this.skills.set(regKey, registered);
+    extension.skills.add(regKey);
+    await this.notifyResourceChange("skill");
+  }
+  async unregisterSkill(extension, skillName, scope) {
+    const sourceId = extensionSourceId(scope);
+    const regKey = `${sourceId}::${skillName}`;
+    const registered = this.skills.get(regKey);
+    if (registered && registered.source.extensionPath === extension.path) {
+      this.skills.delete(regKey);
+      extension.skills.delete(regKey);
+      await this.notifyResourceChange("skill");
+    }
+  }
+  async loadRegisteredSkill(extension, registration, scope) {
+    const extensionBase = extension.path.startsWith("<") ? this.cwd : dirname6(extension.path);
+    const skill = await loadSkill(resolve5(extensionBase, registration));
+    await this.registerSkillDefinition(extension, skill, scope);
   }
   registerProvider(config) {
     if (this.bound) {
@@ -6769,7 +6885,18 @@ var ExtensionRunner = class {
   }
   async disposeExtension(extension, message) {
     extension.runtime.invalidate(message);
+    const hadTools = extension.tools.size > 0;
+    const hadPhases = extension.phases.size > 0;
+    const hadSkills = extension.skills.size > 0;
+    extension.tools.clear();
     for (const name of extension.phases) this.phases.delete(name);
+    extension.phases.clear();
+    for (const name of extension.skills) {
+      if (this.skills.get(name)?.source.extensionPath === extension.path) {
+        this.skills.delete(name);
+      }
+    }
+    extension.skills.clear();
     const hadCapabilities = extension.capabilities.size > 0;
     extension.capabilities.clear();
     for (const cleanup of [...extension.cleanup].reverse()) {
@@ -6787,6 +6914,11 @@ var ExtensionRunner = class {
     if (hadCapabilities) {
       this.notifyCapabilitiesChanged();
     }
+    if (this.bound) {
+      if (hadTools) await this.notifyResourceChange("tool");
+      if (hadPhases) await this.notifyResourceChange("phase");
+      if (hadSkills) await this.notifyResourceChange("skill");
+    }
   }
 };
 function createExtensionRunner(options) {
@@ -6963,7 +7095,7 @@ var ResourceRegistryError = class extends Error {
   }
 };
 var RESOURCE_NAME = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/;
-var SOURCE_ID = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/;
+var SOURCE_ID = /^[A-Za-z0-9][A-Za-z0-9._:/-]*$/;
 var ResourceRegistry = class {
   sources = /* @__PURE__ */ new Map();
   /** Sources registered by the bootstrap boundary (currently Extensions). */
@@ -7056,15 +7188,7 @@ var ResourceRegistry = class {
   }
   withImplicit(kind, sourceIds) {
     const combined = [...sourceIds];
-    let hasCore = false;
-    for (const sourceId of this.implicitSources.get(kind) ?? []) {
-      if (sourceId === "rowan.core") {
-        hasCore = true;
-      } else if (!combined.includes(sourceId)) {
-        combined.push(sourceId);
-      }
-    }
-    if (hasCore && !combined.includes("rowan.core")) {
+    if (this.hasImplicit(kind, "rowan.core") && !combined.includes("rowan.core")) {
       combined.push("rowan.core");
     }
     return combined;
@@ -7139,9 +7263,6 @@ var ResourceRegistry = class {
           if (source.sourceId === "rowan.core") {
             continue;
           }
-          if (source.sourceId === "rowan.extensions" && isCoreResourceName(kind, value.name)) {
-            continue;
-          }
           throw new ResourceRegistryError(
             "resource_collision",
             `Duplicate ${capitalize(kind)} resource "${value.name}" in Resource View.`
@@ -7165,9 +7286,6 @@ var ResourceRegistry = class {
           if (source.sourceId === "rowan.core") {
             continue;
           }
-          if (source.sourceId === "rowan.extensions" && isCoreResourceName(kind, value.name)) {
-            continue;
-          }
           throw new ResourceRegistryError("resource_collision", `Duplicate ${capitalize(kind)} resource "${value.name}" in Resource View.`);
         }
         seenNames.add(value.name);
@@ -7186,10 +7304,7 @@ var ResourceRegistry = class {
       seen.add(sourceId);
       const source = bySource?.get(sourceId);
       if (!source) {
-        throw new ResourceRegistryError(
-          "unknown_resource_source",
-          `Unknown resource source "${sourceId}" for ${kind}.`
-        );
+        continue;
       }
       sources.push(source);
     }
@@ -7241,9 +7356,6 @@ function capitalize(value) {
 function isImplicitCoreName(kind, name) {
   return kind === "tool" && name === "route";
 }
-function isCoreResourceName(kind, name) {
-  return kind === "tool" && CORE_TOOL_NAMES.has(name) || kind === "phase" && CORE_PHASE_NAMES.has(name);
-}
 async function loadDirectoryValues(kind, directory, sourceId) {
   const root = resolve7(directory);
   let rootInfo;
@@ -7407,12 +7519,24 @@ var RuntimeExtensionLifetime = class {
   phases() {
     return this.runner.getPhases();
   }
+  registeredPhases() {
+    return this.runner.getRegisteredPhases();
+  }
+  skills() {
+    return this.runner.getSkills();
+  }
+  registeredSkills() {
+    return this.runner.getRegisteredSkills();
+  }
   get extensionRunner() {
     return this.runner;
   }
   get extensionHost() {
     return this.runner.extensionHost;
   }
+  onResourceChange(listener) {
+    return this.runner.onResourceChange(listener);
+  }
   dropRunState(runId) {
     this.runner.dropRunState(runId);
   }
@@ -7426,9 +7550,33 @@ var RuntimeBootstrapRegistry = class extends ResourceRegistry {
   constructor(extensions = new RuntimeExtensionLifetime()) {
     super();
     this.extensions = extensions;
+    this.extensions.onResourceChange((kind) => this.recommit(kind));
   }
   extensions;
-  extensionSourceId = "rowan.extensions";
+  knownSources = /* @__PURE__ */ new Map();
+  commitQueue = Promise.resolve();
+  recommit(kind) {
+    const next = this.commitQueue.then(async () => {
+      const entries = kind === "tool" ? this.extensions.tools().map((tool) => [tool.sourceId, adaptExtensionTool(tool)]) : kind === "phase" ? this.extensions.registeredPhases().map((reg) => [reg.sourceId, this.extensions.extensionRunner.adaptToPhase(reg)]) : this.extensions.registeredSkills().map((reg) => [reg.sourceId, reg.definition]);
+      const bySource = /* @__PURE__ */ new Map();
+      for (const [sourceId, value] of entries) bySource.set(sourceId, [...bySource.get(sourceId) ?? [], value]);
+      const known = this.knownSources.get(kind) ?? /* @__PURE__ */ new Set();
+      this.knownSources.set(kind, known);
+      for (const [sourceId, values] of bySource) {
+        known.add(sourceId);
+        if (kind === "tool") await this.loadTools({ sourceId, values });
+        else if (kind === "phase") await this.loadPhases({ sourceId, values });
+        else await this.loadSkills({ sourceId, values });
+      }
+      for (const sourceId of [...known]) {
+        if (bySource.has(sourceId)) continue;
+        known.delete(sourceId);
+        await this.unload({ kind, sourceId });
+      }
+    });
+    this.commitQueue = next.catch(() => void 0);
+    return next;
+  }
   get extensionHost() {
     return this.extensions.extensionHost;
   }
@@ -7444,8 +7592,9 @@ var RuntimeBootstrapRegistry = class extends ResourceRegistry {
     })();
     const normalized = await loaded;
     const result = await this.extensions.activate(normalized.extensions);
-    await this.replaceImplicit("tool", this.extensionSourceId, this.extensions.tools().map(adaptExtensionTool));
-    await this.replaceImplicit("phase", this.extensionSourceId, [...this.extensions.phases()]);
+    await this.recommit("tool");
+    await this.recommit("phase");
+    await this.recommit("skill");
     return {
       ...result,
       revision: `extensions:${Date.now()}`,
@@ -12984,6 +13133,7 @@ export {
   createCoreTools2 as createCoreTools,
   createDefaultPhase,
   createStopPhase,
+  extensionSourceId,
   isConfigurationSnapshot,
   isRuntimeError,
   loadExtensionsFromPath as loadExtensions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowan-agent/agent",
-  "version": "0.22.1",
+  "version": "0.24.0",
   "license": "MIT",
   "repository": {
     "type": "git",