@rowan-agent/agent 0.21.0 → 0.22.0

package/dist/index.d.ts

@@ -289,10 +289,12 @@ declare class InMemoryExtensionHost implements ExtensionHost {
     private readonly agentState;
     private readonly globalState;
     private readonly listeners;
+    extendApi?(extensionId: string): HostApiExtension | undefined;
     constructor(options?: {
         configs?: Record<string, Record<string, JsonObject>>;
         agentState?: Record<string, Record<string, Record<string, JsonValue>>>;
         globalState?: Record<string, Record<string, JsonValue>>;
+        extendApi?: (extensionId: string) => HostApiExtension | undefined;
     });
     setConfig(extensionId: string, config: JsonObject | null, scope?: ScopeRef): void;
     getConfig(extensionId: string, scope?: ScopeRef): JsonObject | null;
@@ -370,7 +372,6 @@ declare class ExtensionRunner {
     private bound;
     private readonly errorListeners;
     private readonly capabilityListeners;
-    private readonly hostContributionListeners;
     /** Current agent context — set by the agent before each phase */
     currentContext?: AgentContext;
     constructor(options?: ExtensionRunnerOptions);
@@ -436,13 +437,6 @@ declare class ExtensionRunner {
      * Returns an unsubscribe function.
      */
     onCapabilitiesChanged(listener: (capabilities: readonly ExtensionCapability[]) => void): () => void;
-    /** Get all contributed host elements across all extensions. */
-    getHostContributions(): readonly HostContribution[];
-    /**
-     * Subscribe to host contribution changes (contributions added, removed, or extensions disposed).
-     * Returns an unsubscribe function.
-     */
-    onHostContributionsChanged(listener: (contributions: readonly HostContribution[]) => void): () => void;
     triggerUiAction(event: {
         contributionId: string;
         actionId: string;
@@ -517,8 +511,6 @@ declare class ExtensionRunner {
     private unregisterTool;
     private contributeCapability;
     private notifyCapabilitiesChanged;
-    private contributeToHost;
-    private notifyHostContributionsChanged;
     private registerPhase;
     private registerPhaseDefinition;
     private unregisterPhase;
@@ -1276,8 +1268,6 @@ interface AgentRuntime$1 {
     }): Promise<DurableConsumer>;
     listCapabilities(): readonly ExtensionCapability[];
     onCapabilitiesChanged(listener: (capabilities: readonly ExtensionCapability[]) => void): () => void;
-    listHostContributions(): readonly HostContribution[];
-    onHostContributionsChanged(listener: (contributions: readonly HostContribution[]) => void): () => void;
     triggerUiAction(event: {
         contributionId: string;
         actionId: string;
@@ -1290,12 +1280,6 @@ type ConsumerRegistration = Readonly<{
     waterline: EventCursor;
 }>;
 
-type HostContribution = {
-    readonly kind: string;
-    readonly id: string;
-} & {
-    readonly [key: string]: JsonValue;
-};
 interface ExtensionStateStore {
     get(key: string): Promise<JsonValue | undefined>;
     set(key: string, value: JsonValue): Promise<void>;
@@ -1310,6 +1294,16 @@ interface ExtensionHost {
     getGlobalState(extensionId: string, key: string): Promise<JsonValue | undefined> | JsonValue | undefined;
     setGlobalState(extensionId: string, key: string, value: JsonValue): Promise<void> | void;
     deleteGlobalState(extensionId: string, key: string): Promise<void> | void;
+    /**
+     * Called once per extension load. The returned namespaces are merged into that extension's `api`
+     * (a name already used by Rowan's own API is an error). `dispose` runs when the extension is
+     * unloaded, reloaded or fails activation, so the host can drop everything that extension registered.
+     */
+    extendApi?(extensionId: string): HostApiExtension | undefined;
+}
+interface HostApiExtension {
+    readonly namespaces: Readonly<Record<string, unknown>>;
+    dispose?(): void;
 }
 type ExtensionToolContribution = {
     kind: "tool";
@@ -1538,11 +1532,6 @@ interface ExtensionAPI {
         /** Get the message set by setMessage */
         getMessage(): string | undefined;
     };
-    /** Declarative host contributions. */
-    host: {
-        /** Contribute a declarative declaration to the host. Returns a disposer to remove the contribution. */
-        contribute<T extends HostContribution>(contribution: T): () => void;
-    };
     /** Extension manifest from package.json `rowan` field. */
     manifest?: ExtensionManifest;
     /** Utility functions. */
@@ -2524,8 +2513,6 @@ declare class AgentRuntime implements AgentRuntime$1 {
     }): Promise<DurableConsumer>;
     listCapabilities(): readonly ExtensionCapability[];
     onCapabilitiesChanged(listener: (capabilities: readonly ExtensionCapability[]) => void): () => void;
-    listHostContributions(): readonly HostContribution[];
-    onHostContributionsChanged(listener: (contributions: readonly HostContribution[]) => void): () => void;
     triggerUiAction(event: {
         contributionId: string;
         actionId: string;
@@ -3344,4 +3331,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 HostContribution, 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, 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 };

package/dist/index.js

@@ -1620,7 +1620,7 @@ function createExtensionAPI(hooks, options, runtime, eventBus) {
   let outputPayload = phaseIn?.state?.payload;
   let nextPhase;
   let outputMessage;
-  return {
+  const api = {
     hooks: {
       on: (eventType, handler) => {
         assertActive();
@@ -1783,27 +1783,17 @@ function createExtensionAPI(hooks, options, runtime, eventBus) {
       },
       getNextPhase: () => nextPhase,
       getMessage: () => outputMessage
-    },
-    host: {
-      contribute: (contribution) => {
-        assertActive();
-        if (!contribution || typeof contribution !== "object" || Array.isArray(contribution)) {
-          throw new TypeError("Host contribution must be an object.");
-        }
-        if (typeof contribution.kind !== "string" || contribution.kind.trim() === "") {
-          throw new TypeError("Host contribution requires a non-empty kind.");
-        }
-        if (typeof contribution.id !== "string" || contribution.id.trim() === "") {
-          throw new TypeError("Host contribution requires a non-empty id.");
-        }
-        assertJsonValue(contribution, "Host contribution");
-        const dispose = options?.contributeToHost ? options.contributeToHost(contribution) : () => {
-        };
-        trackCleanup?.(dispose);
-        return dispose;
-      }
     }
   };
+  if (options?.namespaces) {
+    for (const [key, value] of Object.entries(options.namespaces)) {
+      if (key in api) {
+        throw new Error(`Host API namespace collision: "${key}" is a built-in API key.`);
+      }
+      Object.defineProperty(api, key, { value, enumerable: true });
+    }
+  }
+  return api;
 }
 
 // src/harness/phases/interactions.ts
@@ -5836,6 +5826,9 @@ var InMemoryExtensionHost = class {
   globalState = /* @__PURE__ */ new Map();
   listeners = /* @__PURE__ */ new Set();
   constructor(options = {}) {
+    if (options.extendApi) {
+      this.extendApi = options.extendApi;
+    }
     if (options.configs) {
       for (const [scopeKey, extMap] of Object.entries(options.configs)) {
         const map = /* @__PURE__ */ new Map();
@@ -6121,8 +6114,6 @@ var ExtensionRunner = class {
   errorListeners = /* @__PURE__ */ new Set();
   // Capability change listeners
   capabilityListeners = /* @__PURE__ */ new Set();
-  // Host contribution change listeners
-  hostContributionListeners = /* @__PURE__ */ new Set();
   /** Current agent context — set by the agent before each phase */
   currentContext;
   constructor(options) {
@@ -6220,18 +6211,19 @@ var ExtensionRunner = class {
   async loadExtensions(extensions) {
     for (const ext of extensions) {
       const extensionId = ext.id ?? ext.manifest?.id ?? ext.name;
+      const hostApi = this.host.extendApi?.(extensionId);
       const extension = {
         id: extensionId,
         path: ext.path,
         tools: /* @__PURE__ */ new Map(),
         phases: /* @__PURE__ */ new Set(),
         capabilities: /* @__PURE__ */ new Map(),
-        hostContributions: /* @__PURE__ */ new Map(),
         cleanup: [],
-        runtime: createExtensionRuntime()
+        runtime: createExtensionRuntime(),
+        hostApi
       };
       try {
-        const api = this.createExtensionAPI(extension, ext.manifest);
+        const api = this.createExtensionAPI(extension, ext.manifest, hostApi?.namespaces);
         const disposer = await ext.factory(api);
         if (typeof disposer === "function") extension.disposer = disposer;
         this.extensions.push(extension);
@@ -6239,9 +6231,6 @@ var ExtensionRunner = class {
         if (extension.capabilities.size > 0) {
           this.notifyCapabilitiesChanged();
         }
-        if (extension.hostContributions.size > 0) {
-          this.notifyHostContributionsChanged();
-        }
       } catch (error) {
         await this.rollbackExtension(extension);
         const message = error instanceof Error ? error.message : String(error);
@@ -6370,24 +6359,6 @@ var ExtensionRunner = class {
     this.capabilityListeners.add(listener);
     return () => this.capabilityListeners.delete(listener);
   }
-  /** Get all contributed host elements across all extensions. */
-  getHostContributions() {
-    const result = [];
-    for (const ext of this.extensions) {
-      for (const contrib of ext.hostContributions.values()) {
-        result.push(contrib);
-      }
-    }
-    return Object.freeze(result);
-  }
-  /**
-   * Subscribe to host contribution changes (contributions added, removed, or extensions disposed).
-   * Returns an unsubscribe function.
-   */
-  onHostContributionsChanged(listener) {
-    this.hostContributionListeners.add(listener);
-    return () => this.hostContributionListeners.delete(listener);
-  }
   triggerUiAction(event) {
     this.events.emit("ui.action", event);
   }
@@ -6548,7 +6519,7 @@ var ExtensionRunner = class {
    * Registration methods write to the extension tracking object.
    * Action methods delegate to the shared runtime.
    */
-  createExtensionAPI(extension, manifest) {
+  createExtensionAPI(extension, manifest, namespaces) {
     const runner = this;
     const extContext = {
       get cwd() {
@@ -6605,9 +6576,9 @@ var ExtensionRunner = class {
       registerTool: (tool) => this.registerTool(extension, tool),
       unregisterTool: (toolName) => this.unregisterTool(extension, toolName),
       contributeCapability: (contribution) => this.contributeCapability(extension, contribution),
-      contributeToHost: (contribution) => this.contributeToHost(extension, contribution),
       context: extContext,
       manifest,
+      namespaces,
       trackCleanup: (cleanup) => extension.cleanup.push(cleanup),
       config: {
         get: async (scope) => {
@@ -6715,44 +6686,6 @@ var ExtensionRunner = class {
       }
     }
   }
-  contributeToHost(extension, contribution) {
-    const key = `${contribution.kind}:${contribution.id}`;
-    const entry = {
-      ...contribution
-    };
-    extension.hostContributions.set(key, entry);
-    if (this.extensions.includes(extension)) {
-      this.notifyHostContributionsChanged();
-    }
-    let disposed = false;
-    const dispose = () => {
-      if (disposed) return;
-      disposed = true;
-      if (extension.hostContributions.get(key) === entry) {
-        extension.hostContributions.delete(key);
-        if (this.extensions.includes(extension)) {
-          this.notifyHostContributionsChanged();
-        }
-      }
-    };
-    extension.cleanup.push(dispose);
-    return dispose;
-  }
-  notifyHostContributionsChanged() {
-    const contributions = this.getHostContributions();
-    for (const listener of this.hostContributionListeners) {
-      try {
-        listener(contributions);
-      } catch (error) {
-        this.emitError({
-          extensionPath: "<runtime>",
-          event: "host_contributions_changed",
-          error: error instanceof Error ? error.message : String(error),
-          stack: error instanceof Error ? error.stack : void 0
-        });
-      }
-    }
-  }
   async registerPhase(extension, registration) {
     if (typeof registration === "string") {
       if (registration.length === 0) {
@@ -6841,21 +6774,21 @@ var ExtensionRunner = class {
     for (const name of extension.phases) this.phases.delete(name);
     const hadCapabilities = extension.capabilities.size > 0;
     extension.capabilities.clear();
-    const hadHostContributions = extension.hostContributions.size > 0;
-    extension.hostContributions.clear();
     for (const cleanup of [...extension.cleanup].reverse()) {
       await Promise.resolve().then(() => cleanup()).catch(() => void 0);
     }
     if (extension.disposer) {
       await Promise.resolve().then(() => extension.disposer()).catch(() => void 0);
     }
+    if (extension.hostApi?.dispose) {
+      const hostDispose = extension.hostApi.dispose;
+      extension.hostApi = { ...extension.hostApi, dispose: void 0 };
+      await Promise.resolve().then(() => hostDispose()).catch(() => void 0);
+    }
     this._phaseCache = null;
     if (hadCapabilities) {
       this.notifyCapabilitiesChanged();
     }
-    if (hadHostContributions) {
-      this.notifyHostContributionsChanged();
-    }
   }
 };
 function createExtensionRunner(options) {
@@ -7978,14 +7911,6 @@ var AgentRuntime = class _AgentRuntime {
     this.assertOpen();
     return this.resources.extensionRunner.onCapabilitiesChanged(listener);
   }
-  listHostContributions() {
-    this.assertOpen();
-    return this.resources.extensionRunner.getHostContributions();
-  }
-  onHostContributionsChanged(listener) {
-    this.assertOpen();
-    return this.resources.extensionRunner.onHostContributionsChanged(listener);
-  }
   triggerUiAction(event) {
     this.assertOpen();
     this.resources.extensionRunner.triggerUiAction(event);

package/package.json

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