@inixiative/agent-session 0.7.0 → 0.9.0

package/src/pool.ts

@@ -217,7 +217,12 @@ export class SubscriptionPool {
       if (!config.id || this._instances.has(config.id))
         throw Error(`Duplicate or empty instance id "${config.id}"`);
       const descriptor = TRANSPORTS[config.transport];
-      if (descriptor?.status !== 'implemented' || descriptor.runtime === 'external')
+      // Muse keeps its login and sessions under two XDG homes, not one profile variable; not pooled yet.
+      if (
+        descriptor?.status !== 'implemented' ||
+        descriptor.runtime === 'external' ||
+        descriptor.runtime === 'muse'
+      )
         throw Error(`Instance ${config.id}: transport "${config.transport}" cannot be pooled`);
       const runtime = descriptor.runtime;
       const variable = PROFILE_VARIABLE[runtime];

package/src/transport.ts

@@ -13,9 +13,15 @@
 // is declared absent, with a note.
 // ---------------------------------------------------------------------------
 
-export type TransportKind = 'claude-cli' | 'codex-app-server' | 'claude-agent-sdk' | 'acp' | 'api';
+export type TransportKind =
+  | 'claude-cli'
+  | 'codex-app-server'
+  | 'muse-serve'
+  | 'claude-agent-sdk'
+  | 'acp'
+  | 'api';
 
-export type TransportRuntime = 'claude' | 'codex' | 'external';
+export type TransportRuntime = 'claude' | 'codex' | 'muse' | 'external';
 
 export interface TransportCapabilities {
   /** Continue a thread by native ID in a new process. */
@@ -67,7 +73,7 @@ export const TRANSPORTS: Readonly<Record<TransportKind, TransportDescriptor>> =
       fork: 'native',
       rollback: 'none',
       interrupt: 'acknowledged',
-      push: 'none',
+      push: 'steer',
       approvals: 'callback',
       usage: true,
       limits: { stream: true, poll: true },
@@ -81,6 +87,7 @@ export const TRANSPORTS: Readonly<Record<TransportKind, TransportDescriptor>> =
       'textOnly launches with no tools, MCP servers, slash commands or user settings.',
       'Primed decisions (ClaudePrimedSessions) fork a persisted primed session per cycle with a pre-spawned spare.',
       "interruptNative() and readLimits() use the CLI's stdio control protocol (`interrupt`, `get_usage`).",
+      'push() steers: a stream-json user message with `priority: "next"` and a `uuid`, tracked by its `command_lifecycle` frames; one the turn had not taken in when its result came runs as a follow-on result of the same turn, and a stop withdraws it (`cancel_async_message`). Live-verified on claude 2.1.316.',
       'toolGate: true launches with `--permission-prompt-tool stdio` and registers a PreToolUse callback over the control protocol: onToolRequest() gates see every call (`pre-use`, any mode, bypass included; only a deny counts) and the asks the permission mode raises (`permission`, final).',
       'Rollback (`--resume-session-at`) exists natively but is not wired here.',
       'Images ride in the same stream-json user message as base64 `image` content blocks, before the text.',
@@ -115,6 +122,35 @@ export const TRANSPORTS: Readonly<Record<TransportKind, TransportDescriptor>> =
       'Images go to turn/start as `image` inputs with a `data:` URL, after the text.',
     ],
   },
+  'muse-serve': {
+    kind: 'muse-serve',
+    runtime: 'muse',
+    status: 'implemented',
+    verified: 'live',
+    capabilities: {
+      resume: 'native',
+      fork: 'native',
+      rollback: 'none',
+      interrupt: 'acknowledged',
+      push: 'steer',
+      approvals: 'callback',
+      usage: true,
+      limits: { stream: true, poll: true },
+      textOnly: false,
+      images: true,
+      primed: 'none',
+      billing: 'subscription',
+    },
+    notes: [
+      "`muse serve --trust-workspace` (plus `--disable-sandbox` under bypassPermissions) driven through Meta's `@muse-code/sdk` MuseClient, pinned to the installed CLI's version.",
+      'Billing is the saved Muse Code login: metered keys and endpoints (META_, LLM_, MODEL_, LLAMA_, OPENROUTER_, ANTHROPIC_, OPENAI_), Meta auth endpoints (TBH_) and the MUSE_ model, experiment, contributor, approval-judge and fail-open switches are removed from the child environment; a resumed or forked session must report provider `meta`.',
+      'Approvals use an explicit permission profile (`:ask-me` supervised, `:read-only` plan, `:unrestricted` bypass), never the host default `:auto-review`, whose AI reviewer would decide instead of the gates; the committed profile, approval mode and (gated) a human reviewer are read back before any turn.',
+      "Work Muse starts itself (cron firings, monitor and background-terminal wakes, goals, reminder agents, workflows, another client's messages) is folded like a turn's and emitted with `unattributedReason: 'task'`, plus a `task` lifecycle typed `muse-cron`, `muse-monitor`, `muse-goal`, `muse-reminder`, `muse-workflow` or `muse-turn`; it is seen only while this host has the session loaded.",
+      "interruptNative() sends turn/interrupt; push() sends turn/steer; fork() runs session/fork on the new session's own host; readLimits() sends usage/read.",
+      'userInput/request questions go to onUserInput(); without an answer they are cancelled with a reason, so a turn never waits on them.',
+      'Live-verified (muse 1.4.14): start, profile read-back, multi-stage shell and network approvals, text and tool events, token usage, usage/changed and usage/read (recorded in fixtures/muse); fork, resume with setApprovalMode and sessionNotFound were checked live without a model turn (not recorded). A steer (`turn/steer` into a running shell turn, answered in that turn) was checked live 2026-11-02 (not recorded). Images, interrupt, questions and Muse-initiated turns follow the SDK wire types without a live run.',
+    ],
+  },
   'claude-agent-sdk': {
     kind: 'claude-agent-sdk',
     runtime: 'claude',
@@ -137,6 +173,7 @@ export const TRANSPORTS: Readonly<Record<TransportKind, TransportDescriptor>> =
     notes: [
       'Drives `@anthropic-ai/claude-agent-sdk` query() supplied by the caller; this package keeps zero dependencies.',
       "Reuses ClaudeCodeSession's event classification and admission evidence over the SDK message stream.",
+      'push() is not wired: whether the SDK stream surfaces `command_lifecycle` (which a steer is tracked by) is unverified.',
     ],
   },
   acp: {

package/src/transports.ts

@@ -8,6 +8,7 @@ import {
 import { ClaudeCodeSession, type ClaudeCodeSessionConfig } from './claude-code-session';
 import { CodexAppServerSession, type CodexSessionConfig } from './codex-session';
 import type { HarnessSession } from './harness-session';
+import { MuseSession, type MuseSessionConfig } from './muse-session';
 import {
   TRANSPORTS,
   type TransportDescriptor,
@@ -37,6 +38,7 @@ export interface ApiSessionConfig {
 export interface TransportConfigs {
   'claude-cli': ClaudeCodeSessionConfig;
   'codex-app-server': CodexSessionConfig;
+  'muse-serve': MuseSessionConfig;
   'claude-agent-sdk': ClaudeAgentSdkSessionConfig;
   acp: AcpSessionConfig;
   api: ApiSessionConfig;
@@ -47,7 +49,7 @@ export class AcpSession {
   constructor(_config: AcpSessionConfig) {
     throw new TransportUnavailableError(
       'acp',
-      'no ACP client is implemented in this package; use claude-cli, claude-agent-sdk or codex-app-server',
+      'no ACP client is implemented in this package; use claude-cli, claude-agent-sdk, codex-app-server or muse-serve',
     );
   }
 }
@@ -82,6 +84,8 @@ export function createSession<K extends TransportKind>(
       return new ClaudeCodeSession(config as ClaudeCodeSessionConfig);
     case 'codex-app-server':
       return new CodexAppServerSession(config as CodexSessionConfig);
+    case 'muse-serve':
+      return new MuseSession(config as MuseSessionConfig);
     case 'claude-agent-sdk':
       return new ClaudeAgentSdkSession(config as ClaudeAgentSdkSessionConfig);
     case 'acp':