@rowan-agent/agent 0.9.8 → 0.9.9

package/dist/index.d.ts

@@ -21,7 +21,12 @@ type Skill = {
     baseDir: string;
     /** Full body content of the SKILL.md (after frontmatter) */
     content: string;
-    disableModelInvocation: boolean;
+    /** Do not automatically inject this Skill into the model Context. */
+    disableAutoInvocation?: boolean;
+    /** Do not expose this Skill to direct user invocation. */
+    disableImplicitInvocation?: boolean;
+    /** @deprecated Use disableAutoInvocation; kept only for old in-memory callers during cutover. */
+    disableModelInvocation?: boolean;
 };
 type Outcome$1 = {
     id: string;
@@ -362,7 +367,15 @@ type ToolProgress = Readonly<{
     toolCallId: ToolCallId;
     progress: JsonValue;
 }>;
-type RunEvent = DurableRunEvent | MessageDelta | ToolProgress;
+type PhaseStatusEvent = Readonly<{
+    kind: "phase_status";
+    durability: "transient";
+    runId: RunId;
+    executionId: ExecutionId;
+    phaseId: string;
+    status: PhaseStatus;
+}>;
+type RunEvent = DurableRunEvent | MessageDelta | ToolProgress | PhaseStatusEvent;
 
 interface BeforePhaseEvent {
     type: "before_phase";
@@ -536,7 +549,10 @@ type PhaseContextSnapshot = {
 type PhaseExecution = {
     snapshot(): PhaseContextSnapshot;
     restore(snapshot: PhaseContextSnapshot): void;
-    invokeModel(context: PhaseContext): Promise<ModelInvokeOutput>;
+    invokeModel(context: PhaseContext, options?: {
+        output?: "reply" | "internal";
+    }): Promise<ModelInvokeOutput>;
+    reportStatus(status: PhaseStatus): Promise<void>;
     executeTool(context: AgentContext, toolCall: ToolCall): Promise<ToolResult>;
     executeTools(context: AgentContext, toolCalls: readonly ToolCall[]): Promise<readonly ToolResult[]>;
     interaction: PhaseInteractionDriver;
@@ -851,9 +867,23 @@ type ExtensionDisposer = () => void | Promise<void>;
 type ExtensionFactoryResult = void | ExtensionDisposer;
 type ExtensionFactory = (api: ExtensionAPI) => ExtensionFactoryResult | Promise<ExtensionFactoryResult>;
 
+type PhaseStatusState = "running" | "completed";
+/** Normalized status event exposed to Runtime consumers. */
+type PhaseStatus = Readonly<{
+    state: PhaseStatusState;
+    /** Stable consumer-facing status identifier, e.g. `compacting`. */
+    kind: string;
+    /** Optional human-readable detail for UI/status consumers. */
+    message?: string;
+    /** Structured status payload. */
+    payload?: unknown;
+}>;
 /** Unified phase output — model-driven routing is optional; programmatic phases may normalize omission to stop. */
 type PhaseOutput = {
-    message: string;
+    /** User-visible assistant message. */
+    message?: string;
+    /** Final status update for non-conversational consumers. */
+    status?: PhaseStatus;
     /** Route to next phase, or "continue" to re-execute current phase, or "stop" to end. Undefined means no model route. */
     route?: string;
     /** Phase name that produced this output */
@@ -921,6 +951,8 @@ interface PhaseContext {
 interface Phase {
     /** Unique phase identity and display name. */
     name: string;
+    /** Rowan-owned built-in Phase; built-ins are never filtered or disabled. */
+    core?: boolean;
     /** Description */
     description: string;
     /** Restricted tools (undefined = all tools available) */
@@ -941,6 +973,10 @@ interface Phase {
     content: string;
     /** Model override for this phase (resolved from frontmatter) */
     model?: ModelRef;
+    /** Do not automatically inject this Phase into the model route catalog/context. */
+    disableAutoInvocation?: boolean;
+    /** Do not expose this Phase to direct user invocation. */
+    disableImplicitInvocation?: boolean;
     /** ExtensionAPI factory function (default export pattern) */
     factory?: (api: ExtensionAPI) => Promise<void>;
     /** Direct run function */
@@ -962,6 +998,8 @@ type ToolContext = Pick<AgentContext, "skills"> & {
 type ToolExecutionMode = "sequential" | "parallel";
 type Tool$1<TArgs = unknown> = {
     name: string;
+    /** Rowan-owned Core Tool; Core Tools bypass Phase filtering. */
+    core?: boolean;
     description: string;
     parameters: Type.TSchema;
     /** One-line snippet shown in the system prompt tool list. */
@@ -992,7 +1030,10 @@ type AgentContext = {
  */
 type CoreToolContext = {
     root?: string;
+    /** Directory for complete Tool Result spill files. */
+    archiveDir?: string;
     maxReadBytes?: number;
+    maxReadLines?: number;
     bashTimeoutMs?: number;
     maxBashOutputBytes?: number;
 };
@@ -1361,6 +1402,28 @@ type UserInput = string | Readonly<{
     metadata?: Metadata;
 }>;
 type HistorySeed = readonly Message[];
+type ContextStatus = Readonly<{
+    tokens: number;
+    contextWindow: number;
+    percent: number;
+    thresholdTokens: number;
+    estimated: boolean;
+    coveredThrough?: Readonly<{
+        messageId: MessageId;
+        sequence: number;
+    }>;
+}>;
+type ContextCompactionRecord = Readonly<{
+    id: string;
+    agentId: AgentId;
+    summary: string;
+    coveredThrough?: Readonly<{
+        messageId: MessageId;
+        sequence: number;
+    }>;
+    instructions?: string;
+    createdAt: string;
+}>;
 type ToolInvocationContext = Readonly<{
     agentId: AgentId;
     runId: RunId;
@@ -1373,6 +1436,8 @@ type ToolInvocationContext = Readonly<{
 }>;
 type Tool = Readonly<{
     name: string;
+    /** Rowan-owned Core Tool; Core Tools bypass Definition/Phase filtering. */
+    core?: boolean;
     description: string;
     parameters: Type.TSchema;
     execute(args: JsonValue, context: ToolInvocationContext, signal: AbortSignal): Promise<ToolExecutionResult$1>;
@@ -1413,6 +1478,16 @@ type AgentResources = Readonly<{
     resourceRefs?: readonly ResourceRef[];
     resourceRevisions?: Readonly<Record<ResourceKind, readonly string[]>>;
 }>;
+type InvocationSource = "auto" | "implicit" | "external";
+type InvocationCatalogEntry = Readonly<{
+    kind: "phase" | "skill";
+    name: string;
+    description: string;
+    core?: boolean;
+    disableAutoInvocation: boolean;
+    disableImplicitInvocation: boolean;
+    filePath: string;
+}>;
 type AgentConfig = Readonly<{
     identity: string;
     definition: AgentDefinition;
@@ -1666,6 +1741,9 @@ interface OwnedStore {
         now?: string;
         retentionMs?: number;
     }): Promise<RetentionResult>;
+    contextStatus(agentId: AgentId, contextWindow: number): Promise<ContextStatus>;
+    contextMessages(agentId: AgentId, recentTokenBudget?: number): Promise<readonly Message[]>;
+    commitContextCompaction(record: ContextCompactionRecord): Promise<ContextCompactionRecord>;
     createRun(input: {
         agentId: AgentId;
         input: UserInput;
@@ -1846,6 +1924,16 @@ interface AgentRuntime$1 {
         metadata?: Metadata;
     }): Promise<AgentRun>;
     run(runId: RunId): AgentRun;
+    contextStatus(agentId: AgentId, options?: {
+        contextWindow?: number;
+    }): Promise<ContextStatus>;
+    compactContext(agentId: AgentId, options?: {
+        instructions?: string;
+        idempotencyKey?: string;
+    }): Promise<AgentRun>;
+    listInvocations(agentId: AgentId, options: {
+        source: InvocationSource;
+    }): Promise<readonly InvocationCatalogEntry[]>;
     history(agentId: AgentId): Promise<readonly Message[]>;
     listAgents(input?: {
         after?: AgentListCursor;
@@ -1881,6 +1969,7 @@ declare class AgentRuntime implements AgentRuntime$1 {
     private readonly executionDone;
     private readonly cancellationRequested;
     private readonly cancellationReasons;
+    private readonly autoCompactionRuns;
     private readonly consumers;
     private readonly transientEvents;
     private readonly resources;
@@ -1926,6 +2015,13 @@ declare class AgentRuntime implements AgentRuntime$1 {
         retentionFloor: EventCursor;
         skipped?: "active_consumers" | "no_eligible_events";
     }>>;
+    contextStatus(agentId: AgentId, options?: {
+        contextWindow?: number;
+    }): Promise<ContextStatus>;
+    compactContext(agentId: AgentId, options?: {
+        instructions?: string;
+        idempotencyKey?: string;
+    }): Promise<AgentRun>;
     start(agentId: AgentId, input: UserInput, options: {
         idempotencyKey: string;
         metadata?: Metadata;
@@ -1941,6 +2037,9 @@ declare class AgentRuntime implements AgentRuntime$1 {
         after?: RunListCursor;
         limit?: number;
     }): Promise<Page<RunSummary, RunListCursor>>;
+    listInvocations(agentId: AgentId, options: {
+        source: InvocationSource;
+    }): Promise<readonly InvocationCatalogEntry[]>;
     consume(input: {
         consumerId: string;
         signal: AbortSignal;
@@ -1963,10 +2062,12 @@ declare class AgentRuntime implements AgentRuntime$1 {
     private pump;
     private execute;
     private failQueued;
+    private resolveContextWindow;
     private executeTool;
     private executeToolBatch;
     private executeReservedTool;
     private requireAgent;
+    private archiveDirFor;
     private runConsumer;
     observe(runId: RunId, options?: {
         after?: EventCursor;
@@ -1999,6 +2100,7 @@ type InMemoryStoreState = Readonly<{
     nextAgentSequence: readonly (readonly [AgentId, number])[];
     nextReadySequence: readonly (readonly [AgentId, number])[];
     eventSequence: number;
+    contextCompactions?: readonly (readonly [AgentId, ContextCompactionRecord])[];
 }>;
 declare class InMemoryStore implements DurableStore {
     private readonly incarnation;
@@ -2017,6 +2119,7 @@ declare class InMemoryStore implements DurableStore {
     private ownerEpoch;
     private eventSequence;
     private retentionFloor;
+    private readonly contextCompactions;
     constructor(options?: {
         incarnation?: string;
     });
@@ -2183,6 +2286,9 @@ declare class InMemoryStore implements DurableStore {
     private nextMessageSequence;
     private messagesForRun;
     history(lease: OwnerLease, agentId: AgentId): readonly Message[];
+    contextStatus(lease: OwnerLease, agentId: AgentId, contextWindow: number): ContextStatus;
+    contextMessages(lease: OwnerLease, agentId: AgentId, recentTokenBudget?: number): readonly Message[];
+    commitContextCompaction(lease: OwnerLease, record: ContextCompactionRecord): ContextCompactionRecord;
     private activeHistory;
     private appendMessage;
     private appendTransition;
@@ -2194,6 +2300,10 @@ declare class InMemoryStore implements DurableStore {
 
 declare class SqliteStore implements DurableStore {
     private readonly database;
+    private readonly archiveRoot;
+    private readonly mirroredEventIds;
+    private readonly mirroredCompactionIds;
+    private mirroredAgents;
     private closed;
     private configured;
     constructor(filename?: string);
@@ -2202,6 +2312,8 @@ declare class SqliteStore implements DurableStore {
         leaseMs: number;
     }): Promise<OwnedStore>;
     close(): void;
+    /** Filesystem location owned by this Store for one Agent's readable archive. */
+    contextArchiveDir(agentId: AgentId): string;
     reserveAgent(lease: OwnerLease, input: {
         idempotencyKey: string;
         metadata?: Metadata;
@@ -2224,6 +2336,9 @@ declare class SqliteStore implements DurableStore {
         operationId: string;
         effectDigestConfirmation?: string;
     }): Promise<MessageRevisionResult>;
+    contextStatus(lease: OwnerLease, agentId: AgentId, contextWindow: number): Promise<ContextStatus>;
+    contextMessages(lease: OwnerLease, agentId: AgentId, recentTokenBudget?: number): Promise<readonly Message[]>;
+    commitContextCompaction(lease: OwnerLease, record: ContextCompactionRecord): Promise<ContextCompactionRecord>;
     createRun(lease: OwnerLease, input: {
         agentId: AgentId;
         input: UserInput;
@@ -2350,6 +2465,8 @@ declare class SqliteStore implements DurableStore {
     private readState;
     private writeState;
     private persistState;
+    /** Append the semantic durable event mirror and remove deleted Agent sidecars. */
+    private mirrorState;
     private requireMatchingOwner;
     private immediateTransaction;
     private readTransaction;
@@ -2376,7 +2493,7 @@ declare class InMemoryConfigProvider implements ConfigProvider {
 }
 declare function brandConfigToken(raw: unknown): ConfigToken;
 
-type RuntimeErrorCode = "invalid_argument" | "runtime_closed" | "runtime_already_owned" | "runtime_ownership_lost" | "agent_not_found" | "run_not_found" | "run_state_conflict" | "message_revision_conflict" | "tool_effect_confirmation_required" | "input_request_conflict" | "idempotency_conflict" | "configuration_unavailable" | "checkpoint_incompatible" | "consumer_already_active" | "invalid_cursor" | "store_unavailable" | "unsupported_store_version";
+type RuntimeErrorCode = "invalid_argument" | "runtime_closed" | "runtime_already_owned" | "runtime_ownership_lost" | "agent_not_found" | "run_not_found" | "run_state_conflict" | "context_busy" | "message_history_compacted" | "message_revision_conflict" | "tool_effect_confirmation_required" | "input_request_conflict" | "idempotency_conflict" | "configuration_unavailable" | "checkpoint_incompatible" | "consumer_already_active" | "invalid_cursor" | "store_unavailable" | "unsupported_store_version";
 type RuntimeErrorDetails = {
     invalid_argument: Readonly<{
         argument: string;
@@ -2404,6 +2521,15 @@ type RuntimeErrorDetails = {
         expected: readonly RunState[];
         actual: RunState;
     }>;
+    context_busy: Readonly<{
+        agentId: AgentId;
+        runId?: RunId;
+        actual: RunState;
+    }>;
+    message_history_compacted: Readonly<{
+        agentId: AgentId;
+        messageId: MessageId;
+    }>;
     message_revision_conflict: Readonly<{
         agentId: AgentId;
         messageId: MessageId;
@@ -2490,6 +2616,14 @@ declare function loadPhase(targetPath: string): Promise<Phase>;
  */
 declare function loadPhases(targetPath: string): Promise<PhaseRegistry>;
 
+declare const DEFAULT_PHASE_ID = "default";
+declare const STOP_PHASE_ID = "stop";
+declare const COMPACT_PHASE_ID = "compact";
+declare function createDefaultPhase(): Phase;
+declare function createStopPhase(): Phase;
+declare function createCompactPhase(): Phase;
+declare function createCorePhases(): Phase[];
+
 /**
  * Extension loader — discovers and loads extensions from the filesystem.
  *
@@ -2523,4 +2657,4 @@ declare function parseFrontmatter<T = Record<string, unknown>>(raw: string): Fro
 
 declare function createCoreTools(input?: CoreToolContext): Tool[];
 
-export { type AfterToolCall, type AgentConfig, type AgentConfigRequest, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, type AgentResources, type AgentRun, AgentRuntime, type AgentRuntimeOptions, type AgentSummary, type AnyRuntimeError, type AssistantContent, type AssistantMessage, type BeforeToolCall, type ConfigProvider, type ConfigPutResult, type ConfigResolution, type ConfigToken, type ConfigurationSnapshot, type ContextCandidate, type CoreToolContext, type DefinitionLayer, type DurableConsumer, type DurableRunEvent, type DurableStore, type DurableToolResult, type EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionActivationError, type ExtensionActivationResult, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, InMemoryConfigProvider, InMemoryStore, type InputRequest, type InputRequestId, type InputRequiredCommit, type JsonObject, type JsonPrimitive, type JsonValue, 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 OpaqueId, type Outcome, type OwnerLease, type OwnerToken, type Page, type Phase, type PhaseContext, type PhaseContribution, type PhaseExecution, type PhaseExecutionIdentity, type PhaseInteraction, PhaseInteractionBoundary, PhaseInteractionCancelledError, type PhaseInteractionDriver, type PhaseInteractionKind, type PhaseInteractionState, type PhaseInteractionStatus, type PhaseInvocation, type PhaseOutput, type PhaseRegistry, type PhaseRegistrySelection, type PhaseState, type ResolvedResourceView, type ResourceDiagnostic, type ResourceKind, type ResourceRef, ResourceRegistry, ResourceRegistryError, type ResourceRegistryErrorCode, type ResourceSourceId, type ResourceView, type RetentionResult, type RunBoundary, type RunClaim, type RunEvent, type RunFailure, type RunId, type RunListCursor, type RunRecord, type RunSnapshot, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, type Skill, SqliteStore, type TextContent, type ThinkingContent, type Tool, type ToolCallId, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult$1 as ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolProgress, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UserContent, type UserInput, type UserMessage, brandConfigToken, createCoreTools, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhases, loadSkill, loadSkills, materializeConfigurationSnapshot, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };
+export { type AfterToolCall, type AgentConfig, type AgentConfigRequest, type AgentConfiguration, type AgentDefinition, type AgentId, type AgentListCursor, type AgentRecord, type AgentResources, 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 EventCursor, type EventId, type ExecutionCheckpoint, type ExecutionId, type ExecutionToken, type ExtensionAPI, type ExtensionActivationError, type ExtensionActivationResult, type ExtensionContribution, type ExtensionDisposer, type ExtensionFactory, type ExtensionFactoryResult, ExtensionLifetimeError, type ExtensionLifetimeErrorCode, type ExtensionLoadInput, type FrontmatterResult, type HistorySeed, type HookEvent, type HookEventType, type HookHandler, InMemoryConfigProvider, InMemoryStore, type InputRequest, type InputRequestId, type InputRequiredCommit, type InvocationCatalogEntry, type InvocationSource, type JsonObject, type JsonPrimitive, type JsonValue, 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 OpaqueId, type Outcome, type OwnerLease, type OwnerToken, type Page, type Phase, type PhaseContext, type PhaseContribution, type PhaseExecution, type PhaseExecutionIdentity, type PhaseInteraction, PhaseInteractionBoundary, PhaseInteractionCancelledError, type PhaseInteractionDriver, type PhaseInteractionKind, type PhaseInteractionState, type PhaseInteractionStatus, type PhaseInvocation, 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 RunEvent, type RunFailure, type RunId, type RunListCursor, type RunRecord, type RunSnapshot, type RunState, type RunStateChanged, type RunSummary, RuntimeBootstrapRegistry, RuntimeError, type RuntimeErrorCode, type RuntimeErrorDetails, RuntimeExtensionLifetime, STOP_PHASE_ID, type Skill, SqliteStore, type TextContent, type ThinkingContent, type Tool, type ToolCallId, type ToolCallSnapshot, type ToolCallState, type ToolContribution, type ToolDefinition, type ToolExecutionResult$1 as ToolExecutionResult, type ToolInvocationContext, type ToolMessage, type ToolMessageContent, type ToolProgress, type ToolResultContent, type ToolStateChanged, type ToolUseContent, type UserContent, type UserInput, type UserMessage, brandConfigToken, createCompactPhase, createCorePhases, createCoreTools, createDefaultPhase, createStopPhase, isRuntimeError, loadExtensionsFromPath as loadExtensions, loadPhase, loadPhases, loadSkill, loadSkills, materializeConfigurationSnapshot, parseAgentDefinition, parseFrontmatter, resolveConfigurationSnapshot };