@inixiative/agent-session 0.7.0 → 0.8.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. */
@@ -115,6 +121,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). Images, steer, interrupt, questions and Muse-initiated turns follow the SDK wire types without a live run.',
+    ],
+  },
   'claude-agent-sdk': {
     kind: 'claude-agent-sdk',
     runtime: 'claude',

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':