@ours.network/fleet 0.9.3 → 0.9.5

package/dist/session/types.d.ts

@@ -0,0 +1,47 @@
+import type { SessionBackendId } from '../config.js';
+export type SessionReadiness = 'starting' | 'idle' | 'running' | 'awaiting_permission' | 'failed';
+export interface TurnResult {
+    accepted: boolean;
+    outcome: 'completed' | 'refused' | 'cancelled' | 'failed' | 'inconclusive';
+    detail?: string;
+}
+export interface SessionSnapshot {
+    backend: SessionBackendId;
+    alive: boolean;
+    readiness: SessionReadiness;
+    sessionId?: string;
+    lastError?: string;
+    pendingPermissionId?: string;
+}
+export type SessionEventKind = 'state' | 'agent_text' | 'thought' | 'tool_call' | 'tool_update' | 'permission' | 'turn_stop' | 'error';
+export interface SessionEvent {
+    version: 1;
+    seq: number;
+    at: string;
+    kind: SessionEventKind;
+    turnId?: string;
+    toolCallId?: string;
+    permissionId?: string;
+    text?: string;
+    title?: string;
+    status?: string;
+    stopReason?: string;
+    options?: Array<{
+        optionId: string;
+        name: string;
+        kind: string;
+    }>;
+}
+export interface SessionHandle {
+    readonly backend: SessionBackendId;
+    readonly pid: number;
+    isAlive(): boolean;
+    snapshot(): SessionSnapshot;
+    submitPrompt(text: string): Promise<TurnResult>;
+    interrupt(): Promise<void>;
+    respondPermission(permissionId: string, optionId: string): boolean;
+    eventsSince(seq: number): SessionEvent[];
+    subscribe(listener: (event: SessionEvent) => void): () => void;
+    setControllerAttached(attached: boolean): void;
+    close(): Promise<void>;
+}

package/dist/session/types.js

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

package/dist/spawn.d.ts

@@ -1,14 +1,19 @@
+import { type ApprovalMode, type FilesystemMode, type SessionBackendId, type UnattendedMode } from './config.js';
 import { type OpsDeps } from './ops.js';
 export interface SpawnOpts {
     name: string;
     temp?: boolean;
     harness?: string;
+    session?: SessionBackendId;
     mission?: string;
     identity?: string;
     cwd?: string;
     coordinator?: string;
     model?: string;
     permissionMode?: string;
+    approval?: ApprovalMode;
+    filesystem?: FilesystemMode;
+    unattended?: UnattendedMode;
     sandbox?: string;
     profile?: string;
     launcher?: string;

package/dist/spawn.js

@@ -3,13 +3,15 @@ import { existsSync, mkdirSync, openSync, readFileSync, writeFileSync } from 'no
 import { join } from 'node:path';
 import { stringify } from 'yaml';
 import { agentDir, fleetDDir } from './paths.js';
-import { loadConfig, resolveMonitorConfig } from './config.js';
+import { loadConfig, resolveMonitorConfig, resolvePermissions, } from './config.js';
 import { applyRole, up } from './ops.js';
 import { START_STAGGER_FILE } from './runner.js';
 function roleFromOpts(o, defaultHarness) {
     const r = {};
     if (o.harness)
         r.harness = o.harness;
+    if (o.session)
+        r.session = o.session;
     if (o.identity)
         r.identity = o.identity;
     if (o.cwd)
@@ -40,12 +42,29 @@ function roleFromOpts(o, defaultHarness) {
         harnessOptions.monitor = true;
     if (Object.keys(harnessOptions).length)
         r.harness_options = harnessOptions;
+    if (o.approval || o.filesystem || o.unattended) {
+        r.permissions = {
+            ...(o.approval ? { approval: o.approval } : {}),
+            ...(o.filesystem ? { filesystem: o.filesystem } : {}),
+            ...(o.unattended ? { unattended: o.unattended } : {}),
+        };
+    }
     if (o.bioFile)
         r.bio = readFileSync(o.bioFile, 'utf8').trim();
     if (o.personaFile)
         r.persona = readFileSync(o.personaFile, 'utf8').trim();
     return r;
 }
+function validateSpawnOpts(o) {
+    if (o.session && !['tmux', 'acp'].includes(o.session))
+        throw new Error(`invalid --session '${o.session}'; allowed: tmux, acp`);
+    if (o.approval && !['ask', 'allow', 'deny'].includes(o.approval))
+        throw new Error(`invalid --approval '${o.approval}'; allowed: ask, allow, deny`);
+    if (o.filesystem && !['read-only', 'workspace', 'unrestricted'].includes(o.filesystem))
+        throw new Error(`invalid --filesystem '${o.filesystem}'; allowed: read-only, workspace, unrestricted`);
+    if (o.unattended && !['deny', 'wait'].includes(o.unattended))
+        throw new Error(`invalid --unattended '${o.unattended}'; allowed: deny, wait`);
+}
 function assertNameFree(o) {
     const cfg = loadConfig(o.configPath);
     if (cfg.roles.some(r => r.name === o.name))
@@ -55,6 +74,7 @@ function assertNameFree(o) {
 }
 /** Permanent spawn: persist to ~/fleet.d/<Name>.yaml, then bring it up. */
 export async function spawnPermanent(o, deps) {
+    validateSpawnOpts(o);
     assertNameFree(o);
     const cfg = loadConfig(o.configPath);
     mkdirSync(fleetDDir(), { recursive: true });
@@ -76,6 +96,7 @@ const detachedSupervisor = (binPath, args, dir) => {
 };
 /** Temp spawn: state under ~/.ours-fleet/tmp, plain tmux, auto-clean on exit. */
 export async function spawnTemp(o, binPath, launch = detachedSupervisor) {
+    validateSpawnOpts(o);
     assertNameFree(o);
     const cfg = loadConfig(o.configPath);
     const defaultHarness = cfg.defaults.harness;
@@ -88,9 +109,11 @@ export async function spawnTemp(o, binPath, launch = detachedSupervisor) {
         ...fromOpts,
         name: o.name,
         harness: o.harness ?? defaultHarness ?? 'claude-code',
+        session: o.session ?? cfg.defaults.session ?? 'tmux',
         identity: o.identity ?? o.name,
         model: o.model?.trim() || cfg.defaults.model,
         harness_options: Object.keys(mergedHarnessOptions).length ? mergedHarnessOptions : undefined,
+        permissions: resolvePermissions(cfg.defaults.permissions, fromOpts.permissions),
         // Temp agents inherit the fleet-wide monitor defaults via the snapshot (design §2).
         monitor: resolveMonitorConfig(cfg.defaults.monitor, fromOpts.monitor),
         sourceFile: '(temp)',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ours.network/fleet",
-  "version": "0.9.3",
-  "description": "Harness-agnostic fleet of persistent, identity-bound AI agents. Declarative fleet.yaml, tmux consoles, systemd/launchd supervision, ours.network messaging.",
+  "version": "0.9.5",
+  "description": "Harness-agnostic fleet of persistent, identity-bound AI agents. Declarative fleet.yaml, tmux or ACP sessions, supervision, and ours.network messaging.",
   "type": "module",
   "license": "FSL-1.1-Apache-2.0",
   "repository": {
@@ -26,9 +26,14 @@
     "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
+    "@agentclientprotocol/sdk": "^1.3.0",
     "commander": "^12.1.0",
     "yaml": "^2.5.0"
   },
+  "optionalDependencies": {
+    "@agentclientprotocol/claude-agent-acp": "^0.63.0",
+    "@agentclientprotocol/codex-acp": "^1.1.7"
+  },
   "devDependencies": {
     "@types/node": "^20.14.0",
     "typescript": "^5.5.0",