awb-agent-manager 1.6.76 → 1.6.78

package/dist/lib/runtime/hermes/hermes-session-store.js

@@ -0,0 +1,96 @@
+import { promises as fsp } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+export class HermesSessionOwnershipError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'HermesSessionOwnershipError';
+        this.code = code;
+    }
+}
+export class HermesSessionStore {
+    #path;
+    #records = new Map();
+    #loaded = false;
+    #writeQueue = Promise.resolve();
+    constructor(path) {
+        this.#path = path;
+    }
+    async load() {
+        if (this.#loaded)
+            return;
+        this.#loaded = true;
+        try {
+            const parsed = JSON.parse(await fsp.readFile(this.#path, 'utf8'));
+            if (!Array.isArray(parsed))
+                return;
+            for (const value of parsed) {
+                if (value
+                    && typeof value === 'object'
+                    && typeof value.runId === 'string'
+                    && typeof value.agentId === 'string'
+                    && typeof value.sessionId === 'string'
+                    && typeof value.leaseId === 'string'
+                    && typeof value.cwd === 'string') {
+                    this.#records.set(value.runId, {
+                        ...value,
+                        cwd: resolve(value.cwd),
+                    });
+                }
+            }
+        }
+        catch (error) {
+            if (error?.code !== 'ENOENT')
+                throw error;
+        }
+    }
+    get(runId) {
+        return this.#records.get(runId) ?? null;
+    }
+    require(identity) {
+        const record = this.#records.get(identity.runId);
+        if (!record) {
+            throw new HermesSessionOwnershipError('hermes_session_not_found', `No Hermes session is recorded for run ${identity.runId}`);
+        }
+        if (record.agentId !== identity.agentId) {
+            throw new HermesSessionOwnershipError('hermes_session_owner_mismatch', `Hermes session for run ${identity.runId} belongs to another Agent`);
+        }
+        if (record.leaseId !== identity.leaseId) {
+            throw new HermesSessionOwnershipError('hermes_session_lease_mismatch', `Hermes session for run ${identity.runId} belongs to another worktree lease`);
+        }
+        if (resolve(record.cwd) !== resolve(identity.cwd)) {
+            throw new HermesSessionOwnershipError('hermes_session_cwd_mismatch', `Hermes session for run ${identity.runId} belongs to another working directory`);
+        }
+        return record;
+    }
+    async set(identity, sessionId) {
+        const now = new Date().toISOString();
+        const existing = this.#records.get(identity.runId);
+        const record = {
+            ...identity,
+            cwd: resolve(identity.cwd),
+            sessionId,
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+        };
+        this.#records.set(identity.runId, record);
+        await this.#persist();
+        return record;
+    }
+    async delete(runId) {
+        const deleted = this.#records.delete(runId);
+        if (deleted)
+            await this.#persist();
+        return deleted;
+    }
+    #persist() {
+        this.#writeQueue = this.#writeQueue.then(async () => {
+            await fsp.mkdir(dirname(this.#path), { recursive: true, mode: 0o700 });
+            const temp = `${this.#path}.${process.pid}.tmp`;
+            await fsp.writeFile(temp, JSON.stringify(Array.from(this.#records.values()), null, 2), { mode: 0o600 });
+            await fsp.rename(temp, this.#path);
+        });
+        return this.#writeQueue;
+    }
+}
+//# sourceMappingURL=hermes-session-store.js.map

package/dist/lib/runtime/hermes/hermes-session-store.js.map

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

package/dist/lib/runtime/runtime-events.d.ts

@@ -0,0 +1,48 @@
+export type RuntimeEvent = {
+    type: 'message_delta';
+    sessionId: string;
+    text: string;
+} | {
+    type: 'reasoning_delta';
+    sessionId: string;
+    text: string;
+} | {
+    type: 'tool_started';
+    sessionId: string;
+    toolCallId: string;
+    title: string;
+    kind?: string;
+    input?: unknown;
+} | {
+    type: 'tool_updated' | 'tool_completed';
+    sessionId: string;
+    toolCallId: string;
+    status?: string;
+    output?: unknown;
+} | {
+    type: 'usage';
+    sessionId: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cachedReadTokens?: number;
+    thoughtTokens?: number;
+} | {
+    type: 'diagnostic';
+    method: string;
+    sessionId?: string;
+    data?: unknown;
+} | {
+    type: 'child_started';
+    sessionId: string;
+    childRunId: string;
+    title: string;
+    kind?: string;
+    input?: unknown;
+} | {
+    type: 'child_finished';
+    sessionId: string;
+    childRunId: string;
+    status: 'completed' | 'failed' | 'cancelled';
+    output?: unknown;
+};

package/dist/lib/runtime/runtime-events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-events.js.map

package/dist/lib/runtime/runtime-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-events.js","sourceRoot":"","sources":["../../../src/lib/runtime/runtime-events.ts"],"names":[],"mappings":""}

package/dist/lib/runtime/runtime-health.d.ts

@@ -0,0 +1,22 @@
+import type { RuntimeCapabilities } from './runtime-types.js';
+export interface RuntimeProbeResult {
+    installed: boolean;
+    healthy: boolean;
+    version: string | null;
+    reason: string | null;
+}
+export interface RuntimeHealth extends RuntimeProbeResult {
+    capabilities: RuntimeCapabilities;
+}
+export type RuntimeCapabilityReport = Record<string, RuntimeHealth>;
+export interface RuntimeProbeCommand {
+    command: string;
+    args: string[];
+}
+export interface RuntimeDiscoveryOptions {
+    resolveCommand?: (runtimeId: string) => RuntimeProbeCommand;
+    probe?: (command: string, args: string[]) => Promise<RuntimeProbeResult>;
+}
+export declare function resolveRuntimeProbeCommand(runtimeId: string): RuntimeProbeCommand;
+export declare function probeRuntimeCommand(command: string, args: string[]): Promise<RuntimeProbeResult>;
+export declare function discoverRuntimeCapabilities(options?: RuntimeDiscoveryOptions): Promise<RuntimeCapabilityReport>;

package/dist/lib/runtime/runtime-health.js

@@ -0,0 +1,105 @@
+import crossSpawn from 'cross-spawn';
+import { createAdapter } from '../cli-adapters/index.js';
+import { getRuntimeDescriptor, KNOWN_RUNTIME_IDS, } from './runtime-registry.js';
+const PROBE_TIMEOUT_MS = 2_500;
+const MAX_PROBE_OUTPUT = 16 * 1024;
+function firstVersionLine(output) {
+    const line = output
+        .split(/\r?\n/)
+        .map((value) => value.trim())
+        .find(Boolean);
+    return line ? line.slice(0, 160) : null;
+}
+export function resolveRuntimeProbeCommand(runtimeId) {
+    if (runtimeId === 'hermes') {
+        return {
+            command: process.env.HERMES_ACP_COMMAND?.trim() || 'hermes-acp',
+            args: ['--help'],
+        };
+    }
+    return {
+        command: createAdapter(runtimeId).resolveBin(),
+        args: ['--version'],
+    };
+}
+export async function probeRuntimeCommand(command, args) {
+    return new Promise((resolve) => {
+        let settled = false;
+        let output = '';
+        let started = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(result);
+        };
+        const child = crossSpawn(command, args, {
+            windowsHide: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        child.once('spawn', () => {
+            started = true;
+        });
+        const append = (chunk) => {
+            if (output.length >= MAX_PROBE_OUTPUT)
+                return;
+            output += String(chunk).slice(0, MAX_PROBE_OUTPUT - output.length);
+        };
+        child.stdout?.on('data', append);
+        child.stderr?.on('data', append);
+        child.once('error', (error) => {
+            finish({
+                installed: false,
+                healthy: false,
+                version: null,
+                reason: error.code === 'ENOENT' ? 'not_found' : 'not_executable',
+            });
+        });
+        child.once('close', (code) => {
+            finish({
+                installed: true,
+                healthy: code === 0,
+                version: firstVersionLine(output),
+                reason: code === 0 ? null : 'probe_failed',
+            });
+        });
+        const timer = setTimeout(() => {
+            if (started)
+                child.kill();
+            finish({
+                installed: started,
+                healthy: false,
+                version: firstVersionLine(output),
+                reason: 'probe_timeout',
+            });
+        }, PROBE_TIMEOUT_MS);
+        timer.unref?.();
+    });
+}
+export async function discoverRuntimeCapabilities(options = {}) {
+    const resolveCommand = options.resolveCommand ?? resolveRuntimeProbeCommand;
+    const probe = options.probe ?? probeRuntimeCommand;
+    const rows = await Promise.all(KNOWN_RUNTIME_IDS.map(async (runtimeId) => {
+        const capabilities = getRuntimeDescriptor(runtimeId).capabilities;
+        try {
+            const { command, args } = resolveCommand(runtimeId);
+            const result = await probe(command, args);
+            return [runtimeId, { ...result, capabilities }];
+        }
+        catch {
+            return [
+                runtimeId,
+                {
+                    installed: false,
+                    healthy: false,
+                    version: null,
+                    reason: 'probe_unavailable',
+                    capabilities,
+                },
+            ];
+        }
+    }));
+    return Object.fromEntries(rows);
+}
+//# sourceMappingURL=runtime-health.js.map

package/dist/lib/runtime/runtime-health.js.map

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

package/dist/lib/runtime/runtime-registry.d.ts

@@ -0,0 +1,7 @@
+import { type AgentRuntimeConfig, type RuntimeDescriptor } from './runtime-types.js';
+import { HermesRuntime, type HermesRuntimeOptions } from './hermes/hermes-runtime.js';
+export declare const KNOWN_RUNTIME_IDS: readonly string[];
+export type RuntimeOwner = HermesRuntime;
+export declare function createRuntimeOwner(runtimeId: string, options: HermesRuntimeOptions): RuntimeOwner;
+export declare function getRuntimeDescriptor(runtimeId: string | null | undefined): RuntimeDescriptor;
+export declare function validateRuntimeConfig(runtimeId: string, input: unknown): AgentRuntimeConfig;

package/dist/lib/runtime/runtime-registry.js

@@ -0,0 +1,142 @@
+import { RuntimeSelectionError, } from './runtime-types.js';
+import { HermesRuntime, } from './hermes/hermes-runtime.js';
+const CLI_NATIVE_MCP = {
+    protocol: 'stream-json',
+    session: 'persistent',
+    native_mcp: true,
+    native_approvals: false,
+    steering: true,
+    cancellation: true,
+    usage: 'tokens-and-cost',
+    collaboration: [],
+    skill_delivery: ['prompt', 'filesystem'],
+};
+const DESCRIPTORS = new Map([
+    ['claude', { id: 'claude', capabilities: CLI_NATIVE_MCP }],
+    ['deepseek', { id: 'deepseek', capabilities: { ...CLI_NATIVE_MCP } }],
+    ['codex', {
+            id: 'codex',
+            capabilities: {
+                protocol: 'jsonl',
+                session: 'oneshot',
+                native_mcp: true,
+                native_approvals: false,
+                steering: false,
+                cancellation: true,
+                usage: 'tokens',
+                collaboration: [],
+                skill_delivery: ['prompt', 'filesystem'],
+            },
+        }],
+    ['antigravity', {
+            id: 'antigravity',
+            capabilities: {
+                protocol: 'jsonl',
+                session: 'oneshot',
+                native_mcp: false,
+                native_approvals: false,
+                steering: false,
+                cancellation: true,
+                usage: 'none',
+                collaboration: [],
+                skill_delivery: ['prompt'],
+            },
+        }],
+    ['pi', {
+            id: 'pi',
+            capabilities: {
+                protocol: 'jsonl',
+                session: 'oneshot',
+                native_mcp: true,
+                native_approvals: false,
+                steering: false,
+                cancellation: true,
+                usage: 'tokens',
+                collaboration: [],
+                skill_delivery: ['prompt', 'filesystem'],
+            },
+        }],
+    ['hermes', {
+            id: 'hermes',
+            capabilities: {
+                protocol: 'acp',
+                session: 'resumable',
+                native_mcp: true,
+                native_approvals: true,
+                steering: true,
+                cancellation: true,
+                usage: 'tokens',
+                collaboration: ['delegated', 'swarm'],
+                skill_delivery: ['filesystem', 'native'],
+            },
+        }],
+]);
+export const KNOWN_RUNTIME_IDS = Object.freeze(Array.from(DESCRIPTORS.keys()));
+export function createRuntimeOwner(runtimeId, options) {
+    const descriptor = getRuntimeDescriptor(runtimeId);
+    if (descriptor.id === 'hermes')
+        return new HermesRuntime(options);
+    throw new RuntimeSelectionError('runtime_unavailable', descriptor.id, `Runtime ${descriptor.id} does not use a protocol process owner`);
+}
+export function getRuntimeDescriptor(runtimeId) {
+    const normalized = String(runtimeId ?? '').trim().toLowerCase();
+    if (!normalized) {
+        throw new RuntimeSelectionError('runtime_not_configured', null, 'Agent runtime is not configured');
+    }
+    const descriptor = DESCRIPTORS.get(normalized);
+    if (!descriptor) {
+        throw new RuntimeSelectionError('runtime_unknown', normalized, `Unknown agent runtime: ${normalized}`);
+    }
+    return descriptor;
+}
+function invalid(runtimeId, message) {
+    throw new RuntimeSelectionError('runtime_config_invalid', runtimeId, message);
+}
+export function validateRuntimeConfig(runtimeId, input) {
+    const descriptor = getRuntimeDescriptor(runtimeId);
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        return invalid(descriptor.id, 'Runtime configuration must be an object');
+    }
+    const raw = input;
+    const strategy = raw.strategy;
+    if (strategy !== 'single' && strategy !== 'delegated' && strategy !== 'swarm') {
+        return invalid(descriptor.id, 'Runtime strategy must be explicitly configured');
+    }
+    if (strategy !== 'single'
+        && !descriptor.capabilities.collaboration.includes(strategy)) {
+        return invalid(descriptor.id, `Runtime ${descriptor.id} does not support ${strategy} collaboration`);
+    }
+    const permissionMode = raw.permission_mode;
+    if (permissionMode !== 'strict'
+        && permissionMode !== 'approve'
+        && permissionMode !== 'trusted') {
+        return invalid(descriptor.id, 'Runtime permission mode must be explicitly configured');
+    }
+    const config = {
+        strategy,
+        permission_mode: permissionMode,
+    };
+    if (raw.profile !== undefined) {
+        if (typeof raw.profile !== 'string' || !raw.profile.trim()) {
+            return invalid(descriptor.id, 'Runtime profile must be a non-empty string');
+        }
+        config.profile = raw.profile.trim();
+    }
+    for (const field of ['max_children', 'max_iterations']) {
+        const value = raw[field];
+        if (value === undefined)
+            continue;
+        if (!Number.isInteger(value) || Number(value) < 1 || Number(value) > 1_000) {
+            return invalid(descriptor.id, `${field} must be an integer between 1 and 1000`);
+        }
+        config[field] = Number(value);
+    }
+    if (raw.extra !== undefined) {
+        if (!raw.extra || typeof raw.extra !== 'object' || Array.isArray(raw.extra)) {
+            return invalid(descriptor.id, 'Runtime extra configuration must be an object');
+        }
+        config.extra = raw.extra;
+    }
+    return config;
+}
+//# sourceMappingURL=runtime-registry.js.map

package/dist/lib/runtime/runtime-registry.js.map

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

package/dist/lib/runtime/runtime-supervisor.d.ts

@@ -0,0 +1,54 @@
+import type { AcpPermissionOutcome, AcpPermissionRequest, AcpPromptResponse, AcpUsage } from './acp/acp-types.js';
+import { type HermesRuntimeOptions } from './hermes/hermes-runtime.js';
+import type { HermesSessionRecord } from './hermes/hermes-session-store.js';
+import type { AgentRuntimeConfig, RuntimeErrorCode } from './runtime-types.js';
+import type { RuntimeEvent } from './runtime-events.js';
+export type RuntimeDispatchErrorCode = RuntimeErrorCode | 'runtime_not_supported' | 'runtime_collaboration_denied';
+export declare class RuntimeDispatchError extends Error {
+    readonly code: RuntimeDispatchErrorCode;
+    readonly runtimeId: string | null;
+    constructor(code: RuntimeDispatchErrorCode, runtimeId: string | null, message: string);
+}
+export interface RuntimeDispatchRequest {
+    agentId: string;
+    runId: string;
+    leaseId: string;
+    cwd: string;
+    apiKey: string;
+    runtimeId: string;
+    runtimeConfig: AgentRuntimeConfig | null | undefined;
+    systemContext?: string;
+    task: string;
+    model?: string | null;
+}
+export interface RuntimeDispatchContext {
+    agentId: string;
+    runId: string;
+    sessionId: string;
+    strategy: AgentRuntimeConfig['strategy'];
+}
+export interface RuntimeDispatchResult {
+    sessionId: string;
+    stopReason: string;
+    usage: Required<Pick<AcpUsage, 'inputTokens' | 'outputTokens' | 'totalTokens'>> & AcpUsage;
+}
+export interface RuntimeSupervisorOptions extends Pick<HermesRuntimeOptions, 'rootDir' | 'command' | 'args' | 'requestTimeoutMs' | 'env'> {
+    awbUrl: string;
+    onEvent?: (context: RuntimeDispatchContext, event: RuntimeEvent) => void;
+    requestApproval?: (context: RuntimeDispatchContext, request: AcpPermissionRequest) => AcpPermissionOutcome | Promise<AcpPermissionOutcome>;
+    onStderr?: (agentId: string, line: string) => void;
+}
+export declare class RuntimeSupervisor {
+    #private;
+    constructor(options: RuntimeSupervisorOptions);
+    dispatch(request: RuntimeDispatchRequest): Promise<RuntimeDispatchResult>;
+    steer(agentId: string, runId: string, instruction: string): Promise<AcpPromptResponse>;
+    cancel(agentId: string, runId: string): Promise<void>;
+    close(agentId: string, runId: string): Promise<void>;
+    getSession(agentId: string, runId: string): HermesSessionRecord | null;
+    stopForAgent(agentId: string): Promise<{
+        count: number;
+        inflight: [];
+    }>;
+    stopAll(): Promise<void>;
+}