@myagentroam/agent 0.11.33 → 0.11.35

package/dist/sdk/session-composition.d.ts

@@ -0,0 +1,54 @@
+import type { AgentHost, HostDescription } from '../host/contracts.js';
+import type { ExtensionManager } from '../extensions/manager.js';
+import type { ExtensionOperationContext } from '../extensions/operation.js';
+import type { AgentReasoningEffort } from '../model/configuration.js';
+import type { ModelAdapter } from '../model/contracts.js';
+import type { SessionStore } from '../session/store/contracts.js';
+import type { SubagentMailboxMessage, SubagentMessageDelivery, SubagentTurnHandle } from '../subagent/session-controller.js';
+import type { ResolvedModelConfiguration } from './model-runtime.js';
+import type { SessionRegistry } from './session-registry.js';
+import type { SessionRuntime } from './session-runtime.js';
+import type { AgentSession, CreateAgentOptions } from './types.js';
+export interface InternalAgentSession extends AgentSession {
+    startSubagentTurn(input: {
+        readonly permissionMode?: import('../tools/permissions.js').PermissionMode;
+        readonly prompt: string;
+        readonly modelId: string;
+        readonly reasoningEffort: AgentReasoningEffort;
+        readonly role: 'general-purpose' | 'explore';
+        readonly initialMailbox: readonly SubagentMailboxMessage[];
+        readonly turnId: string;
+        readonly delivery?: SubagentMessageDelivery;
+        readonly mcpExecutionScopeId?: string;
+        readonly origin?: ExtensionOperationContext;
+    }): SubagentTurnHandle;
+}
+/** Agent-owned resources and identities shared with Session orchestration. */
+export interface AgentSessionComposition {
+    readonly activeExecutionAdapters: {
+        add(adapter: ModelAdapter): void;
+        delete(adapter: ModelAdapter): void;
+    };
+    readonly sessionRuntimes: SessionRegistry<SessionRuntime>;
+    readonly sessionWriterOwner: object;
+}
+export interface SessionServices {
+    readonly host: AgentHost;
+    readonly description: HostDescription;
+    readonly settings: Pick<CreateAgentOptions, 'workspaceMapping' | 'systemInstruction'>;
+    readonly store: SessionStore;
+    readonly extensions: ExtensionManager;
+    readonly agentResources: AgentSessionComposition;
+    readonly hasCustomAdapters: boolean;
+    readonly modelState: () => {
+        readonly models: ReadonlyMap<string, ResolvedModelConfiguration>;
+        readonly defaultModelId: string;
+        readonly generation: number;
+    };
+    readonly createAdapter: (modelId: string, models: ReadonlyMap<string, ResolvedModelConfiguration>) => ModelAdapter;
+    readonly activeAdaptersExcept: (sessionId: string) => ReadonlySet<ModelAdapter>;
+    readonly assertCanStart: (sessionId?: string) => void;
+    readonly assertSessionAdmission: (sessionId?: string) => void;
+    readonly openEpoch: (sessionId: string) => number;
+    readonly canPublishSession: (sessionId: string, epoch: number) => boolean;
+}

package/dist/sdk/session-composition.js

@@ -0,0 +1 @@
+export {};

package/dist/sdk/session-execution-factory.d.ts

@@ -0,0 +1,43 @@
+import type { SessionStore } from '../session/store/contracts.js';
+import type { ClientToolDefinition } from '../tools/contracts.js';
+import type { ResolvedModelConfiguration } from './model-runtime.js';
+import type { ExtensionOperationContext } from '../extensions/operation.js';
+import { SessionInputCoordinator, type ExtensionSessionActionResult, type ExtensionSessionRequest, type SessionInputEntry } from '../extensions/session-input.js';
+import type { HostDescription, AgentHost } from '../host/contracts.js';
+import type { ModelAdapter } from '../model/contracts.js';
+import type { EnvironmentContextState } from '../prompts/core.js';
+import { buildSystemPromptSections } from '../prompts/index.js';
+import type { ToolHost } from '../tools/runtime-context.js';
+import { type InternalExecutionHandle, type InternalExecutionOptions } from './session-execution.js';
+import { SessionRuntime } from './session-runtime.js';
+import type { CreateAgentOptions, ExecutionMode, RunInput } from './types.js';
+import type { AgentSessionComposition, InternalAgentSession, SessionServices } from './session-composition.js';
+/** Composes the execution-owned workflow from Session capabilities. */
+export declare function createSessionExecutionFactory(ports: {
+    assertCanStart: SessionServices['assertCanStart'];
+    extensions: Pick<SessionServices['extensions'], 'operations' | 'prepare' | 'session'>;
+    baseTools: SessionServices['extensions']['options']['baseTools'];
+    hasCustomAdapters: boolean;
+    modelState: SessionServices['modelState'];
+    host: ToolHost & Pick<AgentHost, 'emit' | 'requestToolApproval' | 'listSessionResources' | 'modelUsage' | 'listMcpToolCatalog' | 'listMcpTools' | 'listExecutionExtensions'>;
+    store: Pick<SessionStore, 'acquireSessionLease' | 'append' | 'readExecutionState' | 'readContextualWorldState' | 'hasRetainedSessionLease' | 'readResource' | 'writeContextualWorldState' | 'persistInputImages' | 'readInputImages' | 'persistResource' | 'setResourceUrl' | 'writeToolResultResource' | 'readCodeModeState' | 'retainSessionLease' | 'commitCodeModeState' | 'commitContextGc' | 'readPage' | 'compact'>;
+    description: HostDescription;
+    settings: Pick<CreateAgentOptions, 'workspaceMapping' | 'systemInstruction'>;
+    sessionWriterOwner: object;
+    activeExecutionAdapters: AgentSessionComposition['activeExecutionAdapters'];
+    sessionId: string;
+    sessionRuntime: Pick<SessionRuntime, 'assertCanExecute' | 'bindExecutionContext' | 'deactivateExecution' | 'joinRecordProjection' | 'registerExecution' | 'restoreExecutionState' | 'scheduleTool' | 'sessionBackend' | 'subagents' | 'unbindExecutionContext' | 'unregisterExecution' | 'updateContextualWorldState' | 'recordRequest' | 'completeRequest'>;
+    sessionSource: Awaited<ReturnType<SessionStore['getSession']>>['source'];
+    logicalWorkspace: string;
+    instructionWorkspace: string;
+    currentEnvironment: EnvironmentContextState;
+    buildSessionPromptSections: (tools: readonly ClientToolDefinition[], mode: ExecutionMode, model: ResolvedModelConfiguration, instruction: string | undefined, skills: string | undefined) => ReturnType<typeof buildSystemPromptSections>;
+    sessionAdapter(modelId: string, models: ReadonlyMap<string, ResolvedModelConfiguration>): ModelAdapter;
+    refreshSessionAdapters(generation: number): Promise<void>;
+    sessionInputs(): SessionInputCoordinator;
+    withRecordProjection<T>(action: () => Promise<T>): Promise<T>;
+    appendExtensionMessage(entry: SessionInputEntry, request: Extract<ExtensionSessionRequest, {
+        kind: 'append';
+    }>, call: ExtensionOperationContext): Promise<ExtensionSessionActionResult>;
+    startSubagentTurn(id: string, input: Parameters<InternalAgentSession['startSubagentTurn']>[0]): Promise<ReturnType<InternalAgentSession['startSubagentTurn']>>;
+}): (mode: ExecutionMode, input: RunInput, internal?: InternalExecutionOptions) => InternalExecutionHandle;