@a5c-ai/agent-comm-mux 5.0.1-staging.04ca6ab00d21

package/dist/spawn-runtime-hooks.js

@@ -0,0 +1,136 @@
+import { RuntimeHookDispatcher } from './runtime-hook-dispatcher.js';
+function normalizePrompt(prompt) {
+    return Array.isArray(prompt) ? prompt.join('\n') : prompt;
+}
+function getRuntimeHookMode(adapter, kind) {
+    return adapter.capabilities.runtimeHooks?.[kind] ?? 'unsupported';
+}
+export async function createSpawnRuntimeHookBridge(handle, adapter, options) {
+    const abortController = new AbortController();
+    const dispatcher = options.hooks
+        ? new RuntimeHookDispatcher({
+            hooks: options.hooks,
+            runId: handle.runId,
+            agent: handle.agent,
+            emit: (event) => handle.emit({
+                ...event,
+                runId: handle.runId,
+                agent: handle.agent,
+                timestamp: event.timestamp ?? Date.now(),
+                source: 'hook',
+            }),
+        })
+        : null;
+    const setupResult = dispatcher && typeof adapter.setupRuntimeHooks === 'function'
+        ? await adapter.setupRuntimeHooks(options, dispatcher)
+        : undefined;
+    const setup = setupResult ?? undefined;
+    let sessionId = options.sessionId;
+    const preToolSeen = new Set();
+    let eventChain = Promise.resolve();
+    const emitHookDeniedTool = (event, decision) => {
+        handle.emit({
+            type: 'tool_error',
+            runId: handle.runId,
+            agent: handle.agent,
+            timestamp: Date.now(),
+            source: 'hook',
+            toolCallId: event.toolCallId ?? '',
+            toolName: event.toolName ?? '',
+            error: decision.decision === 'deny'
+                ? (decision.reason ?? 'Runtime hook denied tool use')
+                : 'Runtime hook denied tool use',
+        });
+    };
+    const emitRuntimeAware = async (event) => {
+        if (event.type === 'session_start') {
+            sessionId = event.sessionId;
+            const mode = getRuntimeHookMode(adapter, 'sessionStart');
+            if (dispatcher && mode !== 'unsupported') {
+                const decision = await dispatcher.dispatch('sessionStart', {
+                    sessionId,
+                    resumed: event.resumed,
+                    forkedFrom: event.forkedFrom,
+                }, abortController.signal, mode === 'blocking' ? 'blocking' : 'nonblocking');
+                if (mode === 'blocking' && decision && decision.decision === 'deny') {
+                    return;
+                }
+            }
+            handle.emit(event);
+            return;
+        }
+        if (event.type === 'tool_call_start' || event.type === 'tool_call_ready') {
+            const toolCallId = String(event.toolCallId ?? '');
+            const mode = getRuntimeHookMode(adapter, 'preToolUse');
+            if (dispatcher && mode !== 'unsupported' && !preToolSeen.has(toolCallId)) {
+                preToolSeen.add(toolCallId);
+                const decision = await dispatcher.dispatch('preToolUse', {
+                    sessionId,
+                    toolCallId,
+                    toolName: event.toolName ?? '',
+                    input: 'input' in event ? event.input : event.inputAccumulated,
+                }, abortController.signal, mode === 'blocking' ? 'blocking' : 'nonblocking');
+                if (mode === 'blocking' && decision && decision.decision === 'deny') {
+                    emitHookDeniedTool(event, decision);
+                    return;
+                }
+            }
+            handle.emit(event);
+            return;
+        }
+        handle.emit(event);
+        if (event.type === 'tool_result' || event.type === 'tool_error') {
+            const mode = getRuntimeHookMode(adapter, 'postToolUse');
+            if (dispatcher && mode !== 'unsupported') {
+                void dispatcher.dispatch('postToolUse', {
+                    sessionId,
+                    toolCallId: event.toolCallId ?? '',
+                    toolName: event.toolName ?? '',
+                    output: 'output' in event ? event.output : undefined,
+                    error: 'error' in event ? event.error : undefined,
+                    durationMs: event.durationMs ?? 0,
+                }, abortController.signal, mode === 'blocking' ? 'blocking' : 'nonblocking');
+            }
+        }
+    };
+    const awaitIdle = async () => {
+        await eventChain.catch(() => { });
+    };
+    return {
+        get sessionId() {
+            return sessionId;
+        },
+        setup,
+        enqueue(event) {
+            eventChain = eventChain.then(() => emitRuntimeAware(event), () => emitRuntimeAware(event));
+        },
+        dispatchPrompt(promptText) {
+            if (!dispatcher || promptText.length === 0)
+                return;
+            const mode = getRuntimeHookMode(adapter, 'userPromptSubmit');
+            if (mode !== 'nonblocking')
+                return;
+            void dispatcher.dispatch('userPromptSubmit', { prompt: normalizePrompt(promptText), sessionId }, abortController.signal, 'nonblocking');
+        },
+        abort() {
+            abortController.abort();
+        },
+        awaitIdle,
+        async finalize(exitReason, exitCode, signal) {
+            await awaitIdle();
+            if (!dispatcher) {
+                return;
+            }
+            const finalHookSignal = new AbortController().signal;
+            const sessionEndMode = getRuntimeHookMode(adapter, 'sessionEnd');
+            if (sessionId && sessionEndMode !== 'unsupported') {
+                await dispatcher.dispatch('sessionEnd', { sessionId, exitReason, exitCode, signal }, finalHookSignal, sessionEndMode === 'blocking' ? 'blocking' : 'nonblocking');
+            }
+            const stopMode = getRuntimeHookMode(adapter, 'stop');
+            if (stopMode !== 'unsupported') {
+                await dispatcher.dispatch('stop', { sessionId, exitReason, exitCode, signal }, finalHookSignal, stopMode === 'blocking' ? 'blocking' : 'nonblocking');
+            }
+        },
+    };
+}
+//# sourceMappingURL=spawn-runtime-hooks.js.map

package/dist/spawn-runtime-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-runtime-hooks.js","sourceRoot":"","sources":["../src/spawn-runtime-hooks.ts"],"names":[],"mappings":"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"}

package/dist/state-machine.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Run state machine for @a5c-ai/agent-mux.
+ *
+ * Defines the 9 RunState values, valid transition map, terminal state set,
+ * and guard helpers used by RunHandleImpl.
+ */
+/**
+ * All valid states for an agent run.
+ *
+ * States are mutually exclusive; every run is in exactly one state at a time.
+ * Terminal states are absorbing — no transitions out.
+ */
+export type RunState = 'spawned' | 'running' | 'paused' | 'interrupted' | 'aborted' | 'timed-out' | 'completed' | 'crashed' | 'killed';
+/** Set of states from which no further transitions are possible. */
+export declare const TERMINAL_STATES: ReadonlySet<RunState>;
+/**
+ * Map of (fromState -> Set<toState>) defining all legal state transitions.
+ *
+ * Transitions not listed here are invalid and will throw
+ * AgentMuxError('INVALID_STATE_TRANSITION', ...).
+ */
+export declare const VALID_TRANSITIONS: ReadonlyMap<RunState, ReadonlySet<RunState>>;
+/**
+ * Returns true when the state is terminal (no transitions out).
+ */
+export declare function isTerminal(state: RunState): boolean;
+/**
+ * Assert that transitioning from `from` to `to` is valid.
+ *
+ * @throws {AgentMuxError} code `INVALID_STATE_TRANSITION` when the transition
+ *         is not in the VALID_TRANSITIONS map.
+ */
+export declare function assertTransition(from: RunState, to: RunState): void;

package/dist/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,aAAa,GACb,SAAS,GACT,WAAW,GACX,WAAW,GACX,SAAS,GACT,QAAQ,CAAC;AAMb,oEAAoE;AACpE,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,QAAQ,CAMhD,CAAC;AAMH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,CAWzE,CAAC;AAMH;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI,CASnE"}

package/dist/state-machine.js

@@ -0,0 +1,61 @@
+/**
+ * Run state machine for @a5c-ai/agent-mux.
+ *
+ * Defines the 9 RunState values, valid transition map, terminal state set,
+ * and guard helpers used by RunHandleImpl.
+ */
+import { AgentMuxError } from './errors.js';
+// ---------------------------------------------------------------------------
+// Terminal states
+// ---------------------------------------------------------------------------
+/** Set of states from which no further transitions are possible. */
+export const TERMINAL_STATES = new Set([
+    'aborted',
+    'timed-out',
+    'completed',
+    'crashed',
+    'killed',
+]);
+// ---------------------------------------------------------------------------
+// Valid transitions
+// ---------------------------------------------------------------------------
+/**
+ * Map of (fromState -> Set<toState>) defining all legal state transitions.
+ *
+ * Transitions not listed here are invalid and will throw
+ * AgentMuxError('INVALID_STATE_TRANSITION', ...).
+ */
+export const VALID_TRANSITIONS = new Map([
+    ['spawned', new Set(['running', 'crashed', 'timed-out', 'aborted'])],
+    ['running', new Set(['paused', 'interrupted', 'aborted', 'timed-out', 'completed', 'crashed', 'killed'])],
+    ['paused', new Set(['running', 'aborted', 'timed-out'])],
+    ['interrupted', new Set(['running', 'completed', 'crashed', 'aborted'])],
+    // Terminal states — no outgoing transitions
+    ['aborted', new Set()],
+    ['timed-out', new Set()],
+    ['completed', new Set()],
+    ['crashed', new Set()],
+    ['killed', new Set()],
+]);
+// ---------------------------------------------------------------------------
+// Helper functions
+// ---------------------------------------------------------------------------
+/**
+ * Returns true when the state is terminal (no transitions out).
+ */
+export function isTerminal(state) {
+    return TERMINAL_STATES.has(state);
+}
+/**
+ * Assert that transitioning from `from` to `to` is valid.
+ *
+ * @throws {AgentMuxError} code `INVALID_STATE_TRANSITION` when the transition
+ *         is not in the VALID_TRANSITIONS map.
+ */
+export function assertTransition(from, to) {
+    const allowed = VALID_TRANSITIONS.get(from);
+    if (!allowed || !allowed.has(to)) {
+        throw new AgentMuxError('INVALID_STATE_TRANSITION', `Cannot transition run state from '${from}' to '${to}'`, false);
+    }
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuB5C,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,oEAAoE;AACpE,MAAM,CAAC,MAAM,eAAe,GAA0B,IAAI,GAAG,CAAW;IACtE,SAAS;IACT,WAAW;IACX,WAAW;IACX,SAAS;IACT,QAAQ;CACT,CAAC,CAAC;AAEH,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAiD,IAAI,GAAG,CAAkC;IACtH,CAAC,SAAS,EAAE,IAAI,GAAG,CAAW,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9E,CAAC,SAAS,EAAE,IAAI,GAAG,CAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnH,CAAC,QAAQ,EAAG,IAAI,GAAG,CAAW,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;IACnE,CAAC,aAAa,EAAE,IAAI,GAAG,CAAW,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAClF,4CAA4C;IAC5C,CAAC,SAAS,EAAI,IAAI,GAAG,EAAY,CAAC;IAClC,CAAC,WAAW,EAAE,IAAI,GAAG,EAAY,CAAC;IAClC,CAAC,WAAW,EAAE,IAAI,GAAG,EAAY,CAAC;IAClC,CAAC,SAAS,EAAI,IAAI,GAAG,EAAY,CAAC;IAClC,CAAC,QAAQ,EAAK,IAAI,GAAG,EAAY,CAAC;CACnC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAc,EAAE,EAAY;IAC3D,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,aAAa,CACrB,0BAA0B,EAC1B,qCAAqC,IAAI,SAAS,EAAE,GAAG,EACvD,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Storage path resolution for @a5c-ai/agent-mux.
+ *
+ * Resolves the global config directory and project config directory
+ * based on options, environment variables, and filesystem walk-up.
+ */
+/** Resolved paths for both global and project storage directories. */
+export interface StoragePaths {
+    /** Absolute path to the global config directory (e.g., ~/.agent-mux). */
+    readonly configDir: string;
+    /** Absolute path to the project config directory (e.g., .agent-mux). */
+    readonly projectConfigDir: string;
+    /** Absolute path to the global config.json file. */
+    readonly globalConfigFile: string;
+    /** Absolute path to the project config.json file. */
+    readonly projectConfigFile: string;
+    /** Absolute path to the global profiles directory. */
+    readonly globalProfilesDir: string;
+    /** Absolute path to the project profiles directory. */
+    readonly projectProfilesDir: string;
+    /** Absolute path to the auth-hints.json file. */
+    readonly authHintsFile: string;
+    /** Absolute path to the run-index.jsonl file. */
+    readonly runIndexFile: string;
+}
+/** Options that influence storage path resolution. */
+export interface StoragePathOptions {
+    /** Override the global config directory. Must be absolute. */
+    configDir?: string;
+    /** Override the project config directory. Must be absolute. */
+    projectConfigDir?: string;
+}
+/**
+ * Resolve the global and project config directory paths.
+ *
+ * Resolution order for the global config directory:
+ * 1. `options.configDir` if provided.
+ * 2. `AGENT_MUX_CONFIG_DIR` environment variable if set.
+ * 3. `path.join(os.homedir(), '.agent-mux')`.
+ *
+ * Resolution order for the project config directory:
+ * 1. `options.projectConfigDir` if provided.
+ * 2. `AGENT_MUX_PROJECT_DIR` environment variable if set.
+ * 3. Walk up from `process.cwd()` looking for a `.agent-mux/` directory.
+ * 4. If not found, use `path.join(process.cwd(), '.agent-mux')`.
+ */
+export declare function resolveStoragePaths(options?: StoragePathOptions): StoragePaths;

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,oDAAoD;IACpD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,qDAAqD;IACrD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC,sDAAsD;IACtD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC,uDAAuD;IACvD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC,iDAAiD;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAMD,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAc9E"}

package/dist/storage.js

@@ -0,0 +1,90 @@
+/**
+ * Storage path resolution for @a5c-ai/agent-mux.
+ *
+ * Resolves the global config directory and project config directory
+ * based on options, environment variables, and filesystem walk-up.
+ */
+import * as path from 'node:path';
+import * as os from 'node:os';
+import * as fs from 'node:fs';
+// ---------------------------------------------------------------------------
+// resolveStoragePaths()
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the global and project config directory paths.
+ *
+ * Resolution order for the global config directory:
+ * 1. `options.configDir` if provided.
+ * 2. `AGENT_MUX_CONFIG_DIR` environment variable if set.
+ * 3. `path.join(os.homedir(), '.agent-mux')`.
+ *
+ * Resolution order for the project config directory:
+ * 1. `options.projectConfigDir` if provided.
+ * 2. `AGENT_MUX_PROJECT_DIR` environment variable if set.
+ * 3. Walk up from `process.cwd()` looking for a `.agent-mux/` directory.
+ * 4. If not found, use `path.join(process.cwd(), '.agent-mux')`.
+ */
+export function resolveStoragePaths(options) {
+    const configDir = resolveConfigDir(options?.configDir);
+    const projectConfigDir = resolveProjectConfigDir(options?.projectConfigDir);
+    return {
+        configDir,
+        projectConfigDir,
+        globalConfigFile: path.join(configDir, 'config.json'),
+        projectConfigFile: path.join(projectConfigDir, 'config.json'),
+        globalProfilesDir: path.join(configDir, 'profiles'),
+        projectProfilesDir: path.join(projectConfigDir, 'profiles'),
+        authHintsFile: path.join(configDir, 'auth-hints.json'),
+        runIndexFile: path.join(projectConfigDir, 'run-index.jsonl'),
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function resolveConfigDir(override) {
+    if (override) {
+        return path.resolve(override);
+    }
+    const envDir = process.env['AGENT_MUX_CONFIG_DIR'];
+    if (envDir) {
+        return path.resolve(envDir);
+    }
+    return path.join(os.homedir(), '.agent-mux');
+}
+function resolveProjectConfigDir(override) {
+    if (override) {
+        return path.resolve(override);
+    }
+    const envDir = process.env['AGENT_MUX_PROJECT_DIR'];
+    if (envDir) {
+        return path.resolve(envDir);
+    }
+    return walkUpForAgentMux(process.cwd());
+}
+/**
+ * Walk up the directory tree from `startDir` looking for a `.agent-mux/`
+ * directory. If not found, defaults to `startDir/.agent-mux`.
+ */
+function walkUpForAgentMux(startDir) {
+    let current = path.resolve(startDir);
+    while (true) {
+        const candidate = path.join(current, '.agent-mux');
+        try {
+            const stat = fs.statSync(candidate);
+            if (stat.isDirectory()) {
+                return candidate;
+            }
+        }
+        catch {
+            // Directory doesn't exist, keep walking up.
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            // Reached the filesystem root without finding .agent-mux/.
+            // Default to cwd/.agent-mux.
+            return path.join(startDir, '.agent-mux');
+        }
+        current = parent;
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}

package/dist/stream-assembler.d.ts

@@ -0,0 +1,51 @@
+/**
+ * StreamAssembler — stateful utility for reassembling fragmented agent output.
+ *
+ * Operates in two modes:
+ * - Line mode (default): each line is returned as-is from feed().
+ * - Block mode: lines are accumulated until a termination condition is met.
+ *
+ * @see 05-adapter-system.md §6
+ */
+/** Predicate that determines when a block is complete. */
+export type BlockTerminator = (line: string, accumulated: string) => boolean;
+/**
+ * Stateful utility for reassembling fragmented agent output into
+ * complete, parseable units. One instance per run.
+ */
+export declare class StreamAssembler {
+    private _buffer;
+    private _terminator;
+    /**
+     * Feeds a line into the assembler. In line mode, returns the line
+     * unchanged. In block mode, accumulates the line and returns null
+     * until the block is complete, then returns the assembled block.
+     */
+    feed(line: string): string | null;
+    /**
+     * Begins block accumulation mode. Subsequent calls to feed()
+     * will accumulate lines until endBlock() is called or the
+     * termination predicate returns true.
+     */
+    startBlock(terminator: BlockTerminator): void;
+    /**
+     * Forces the current block to end and returns whatever has been
+     * accumulated so far. Returns null if not in block mode.
+     */
+    endBlock(): string | null;
+    /** Whether the assembler is currently in block accumulation mode. */
+    get inBlock(): boolean;
+    /**
+     * Resets the assembler to its initial state.
+     */
+    reset(): void;
+    /**
+     * Returns the number of lines currently accumulated in the buffer.
+     * Zero when not in block mode.
+     */
+    get bufferedLineCount(): number;
+    /**
+     * Returns the raw accumulated content without ending the block.
+     */
+    peek(): string;
+}

package/dist/stream-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-assembler.d.ts","sourceRoot":"","sources":["../src/stream-assembler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;AAE7E;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,WAAW,CAAgC;IAEnD;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAqBjC;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAK7C;;;OAGG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI;IAUzB,qEAAqE;IACrE,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf"}

package/dist/stream-assembler.js

@@ -0,0 +1,86 @@
+/**
+ * StreamAssembler — stateful utility for reassembling fragmented agent output.
+ *
+ * Operates in two modes:
+ * - Line mode (default): each line is returned as-is from feed().
+ * - Block mode: lines are accumulated until a termination condition is met.
+ *
+ * @see 05-adapter-system.md §6
+ */
+/**
+ * Stateful utility for reassembling fragmented agent output into
+ * complete, parseable units. One instance per run.
+ */
+export class StreamAssembler {
+    _buffer = [];
+    _terminator = null;
+    /**
+     * Feeds a line into the assembler. In line mode, returns the line
+     * unchanged. In block mode, accumulates the line and returns null
+     * until the block is complete, then returns the assembled block.
+     */
+    feed(line) {
+        if (this._terminator === null) {
+            // Line mode — pass through
+            return line;
+        }
+        // Block mode — accumulate
+        this._buffer.push(line);
+        const accumulated = this._buffer.join('\n');
+        if (this._terminator(line, accumulated)) {
+            // Block complete
+            this._terminator = null;
+            const result = accumulated;
+            this._buffer = [];
+            return result;
+        }
+        return null;
+    }
+    /**
+     * Begins block accumulation mode. Subsequent calls to feed()
+     * will accumulate lines until endBlock() is called or the
+     * termination predicate returns true.
+     */
+    startBlock(terminator) {
+        this._terminator = terminator;
+        this._buffer = [];
+    }
+    /**
+     * Forces the current block to end and returns whatever has been
+     * accumulated so far. Returns null if not in block mode.
+     */
+    endBlock() {
+        if (this._terminator === null && this._buffer.length === 0) {
+            return null;
+        }
+        const result = this._buffer.length > 0 ? this._buffer.join('\n') : null;
+        this._terminator = null;
+        this._buffer = [];
+        return result;
+    }
+    /** Whether the assembler is currently in block accumulation mode. */
+    get inBlock() {
+        return this._terminator !== null;
+    }
+    /**
+     * Resets the assembler to its initial state.
+     */
+    reset() {
+        this._buffer = [];
+        this._terminator = null;
+    }
+    /**
+     * Returns the number of lines currently accumulated in the buffer.
+     * Zero when not in block mode.
+     */
+    get bufferedLineCount() {
+        return this._buffer.length;
+    }
+    /**
+     * Returns the raw accumulated content without ending the block.
+     */
+    peek() {
+        return this._buffer.join('\n');
+    }
+}
+//# sourceMappingURL=stream-assembler.js.map

package/dist/stream-assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-assembler.js","sourceRoot":"","sources":["../src/stream-assembler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;GAGG;AACH,MAAM,OAAO,eAAe;IAClB,OAAO,GAAa,EAAE,CAAC;IACvB,WAAW,GAA2B,IAAI,CAAC;IAEnD;;;;OAIG;IACH,IAAI,CAAC,IAAY;QACf,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9B,2BAA2B;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC;YACxC,iBAAiB;YACjB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,MAAM,MAAM,GAAG,WAAW,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;YAClB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,UAA2B;QACpC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,qEAAqE;IACrE,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/tools/classify.d.ts

@@ -0,0 +1,9 @@
+import type { AgentName } from '../types.js';
+export interface ToolClassification {
+    destructive: boolean;
+    readOnly: boolean;
+    network: boolean;
+    longRunning: boolean;
+    handlesSecrets: boolean;
+}
+export declare function classifyTool(agent: AgentName, toolName: string, input?: unknown): ToolClassification;

package/dist/tools/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/tools/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;CACzB;AAwED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,OAAO,GACd,kBAAkB,CAapB"}

package/dist/tools/classify.js

@@ -0,0 +1,77 @@
+const DEFAULT_CLASSIFICATION = {
+    destructive: true,
+    readOnly: false,
+    network: false,
+    longRunning: false,
+    handlesSecrets: false,
+};
+const RULES = {
+    '*': [
+        { test: /^(read|cat|view|open_file|read_file|file_read|glob|grep|search_files|file_search|list_dir|ls|find)$/i, value: { destructive: false, readOnly: true } },
+        { test: /^(fetch|web(fetch|search)?|search_query|browser_(navigate|open|visit|search)|open_url|http_request)$/i, value: { destructive: false, readOnly: true, network: true } },
+        { test: /^(bash|shell|exec_command|run_shell_command|terminal|command)$/i, value: { longRunning: true }, inputTest: /\b(rm|del|remove-item|mv|move|cp|copy|chmod|chown|git\s+(commit|push|reset|clean|checkout)|npm\s+publish)\b/i },
+        { test: /^(bash|shell|exec_command|run_shell_command|terminal|command)$/i, value: { destructive: false, readOnly: true, longRunning: true }, inputTest: /\b(ls|dir|cat|type|pwd|echo|grep|rg|find|git\s+(status|diff|log)|npm\s+(test|run\s+lint)|vitest|eslint|tsc)\b/i },
+        { test: /^(write|edit|multi(edit)?|replace|patch|apply_patch|notebook(edit|_write)|file_(write|create|delete|patch)|create|mkdir|delete|remove|rename|move|copy)$/i, value: { destructive: true, readOnly: false } },
+        { test: /^(secret|credential|credentials|auth|login|token|env|keychain|vault)/i, value: { handlesSecrets: true } },
+    ],
+    claude: [
+        { test: /^(Read|Grep|Glob|LS|NotebookRead|TodoRead)$/i, value: { destructive: false, readOnly: true } },
+        { test: /^(Write|Edit|MultiEdit|NotebookEdit|TodoWrite)$/i, value: { destructive: true, readOnly: false } },
+        { test: /^Web(Fetch|Search)$/i, value: { destructive: false, readOnly: true, network: true } },
+        { test: /^Bash$/i, value: { longRunning: true } },
+        { test: /^Task$/i, value: { longRunning: true } },
+    ],
+    codex: [
+        { test: /^(view_image|read_mcp_resource|list_mcp_resources|list_mcp_resource_templates)$/i, value: { destructive: false, readOnly: true } },
+        { test: /^(exec_command|write_stdin)$/i, value: { longRunning: true } },
+        { test: /^apply_patch$/i, value: { destructive: true, readOnly: false } },
+    ],
+    gemini: [
+        { test: /^(read_file|grep_in_files|search_codebase)$/i, value: { destructive: false, readOnly: true } },
+        { test: /^(write_file|replace_file_text|create_file|delete_file)$/i, value: { destructive: true, readOnly: false } },
+        { test: /^google_search$/i, value: { destructive: false, readOnly: true, network: true } },
+        { test: /^run_shell_command$/i, value: { longRunning: true } },
+    ],
+    copilot: [
+        { test: /^(readFile|findTextInFiles|search)$/i, value: { destructive: false, readOnly: true } },
+        { test: /^(createFile|editFile|deleteFile)$/i, value: { destructive: true, readOnly: false } },
+    ],
+    cursor: [
+        { test: /^(read_file|search_files|list_files)$/i, value: { destructive: false, readOnly: true } },
+        { test: /^(edit_file|create_file|delete_file)$/i, value: { destructive: true, readOnly: false } },
+    ],
+    opencode: [
+        { test: /^(read|grep|glob|ls)$/i, value: { destructive: false, readOnly: true } },
+        { test: /^(write|edit|patch)$/i, value: { destructive: true, readOnly: false } },
+    ],
+    openclaw: [
+        { test: /^(channel-plugin|webhook)$/i, value: { network: true, longRunning: true } },
+    ],
+    pi: [
+        { test: /^(read_file|search_files)$/i, value: { destructive: false, readOnly: true } },
+        { test: /^(write_file|edit_file)$/i, value: { destructive: true, readOnly: false } },
+    ],
+    omp: [
+        { test: /^(read|grep|glob)$/i, value: { destructive: false, readOnly: true } },
+        { test: /^(write|edit|patch)$/i, value: { destructive: true, readOnly: false } },
+    ],
+    hermes: [
+        { test: /^(read_file|grep|glob)$/i, value: { destructive: false, readOnly: true } },
+        { test: /^(write_file|edit_file|patch_file)$/i, value: { destructive: true, readOnly: false } },
+    ],
+};
+export function classifyTool(agent, toolName, input) {
+    const normalizedAgent = String(agent).toLowerCase();
+    const normalizedInput = typeof input === 'string' ? input : JSON.stringify(input ?? '');
+    const matches = [...(RULES['*'] ?? []), ...(RULES[normalizedAgent] ?? [])];
+    const resolved = { ...DEFAULT_CLASSIFICATION };
+    for (const rule of matches) {
+        if (!rule.test.test(toolName))
+            continue;
+        if (rule.inputTest && !rule.inputTest.test(normalizedInput))
+            continue;
+        Object.assign(resolved, rule.value);
+    }
+    return resolved;
+}
+//# sourceMappingURL=classify.js.map

package/dist/tools/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/tools/classify.ts"],"names":[],"mappings":"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"}