@geminilight/mindos 1.1.8 → 1.1.10

package/dist/agent-runtime/descriptors.js

@@ -0,0 +1,143 @@
+import { acpCapabilities, acpHarnessCapabilities, claudeCapabilities, claudeHarnessCapabilities, codexCapabilities, codexHarnessCapabilities, mindosCapabilities, mindosHarnessCapabilities, } from './capabilities.js';
+import { compactRuntimeHintsForDescriptor, } from './detection.js';
+import { summarizeRuntimeFailure, } from './runtime-errors.js';
+export function nativeRuntimeDiagnosticHints(input) {
+    if (input.status === 'available')
+        return [];
+    const command = input.id === 'codex' ? 'codex' : 'claude';
+    const hints = [];
+    if (input.status === 'missing') {
+        hints.push(`MindOS checked command "${command}" on the server PATH.`);
+        hints.push(input.installCmd
+            ? `Install it or add it to the PATH used to start MindOS: ${input.installCmd}`
+            : `Install ${input.name} or add it to the PATH used to start MindOS.`);
+        return hints;
+    }
+    if (input.binaryPath) {
+        hints.push(`MindOS detected ${input.name} at ${input.binaryPath}.`);
+    }
+    if (input.status === 'signed-out') {
+        hints.push(input.id === 'codex'
+            ? 'Run "codex login status" from the same environment that starts MindOS.'
+            : 'Run Claude Code once from the same environment that starts MindOS.');
+    }
+    else {
+        hints.push(input.id === 'codex'
+            ? 'Run "codex app-server --help" from the MindOS server environment.'
+            : 'Run "claude --version" from the MindOS server environment.');
+    }
+    if (input.reason && /(environment variable|cannot see|env)/i.test(input.reason)) {
+        hints.push('Restart MindOS after exporting the required environment variable so the server process inherits it.');
+    }
+    return hints;
+}
+export function nativeDescriptor(input) {
+    const status = input.source ? input.source.status ?? 'available' : input.missing?.status ?? 'missing';
+    const runtimeBridge = input.source?.runtimeBridge;
+    const rawReason = input.source?.reason ?? input.missing?.reason;
+    const reasonSummary = rawReason ? summarizeRuntimeFailure(rawReason, { runtime: input.id }) : null;
+    const reason = reasonSummary?.reason;
+    const sourceDiagnosticHints = compactRuntimeHintsForDescriptor(input.source?.diagnosticHints ?? input.missing?.diagnosticHints, input.id, reason);
+    const diagnosticHints = Array.from(new Set([
+        ...sourceDiagnosticHints,
+        ...(reasonSummary?.diagnosticHints ?? []),
+        ...nativeRuntimeDiagnosticHints({
+            id: input.id,
+            name: input.name,
+            status,
+            reason,
+            binaryPath: input.source?.binaryPath,
+            installCmd: input.missing?.installCmd,
+        }),
+    ]));
+    return {
+        id: input.id,
+        runtimeId: input.id,
+        category: 'native',
+        name: input.name,
+        kind: input.id,
+        adapter: input.id === 'codex' ? 'codex-app-server' : runtimeBridge?.kind === 'claude-cli' ? 'claude-cli' : 'claude-sdk',
+        modelOwner: 'external',
+        authOwner: 'external',
+        permissionOwner: 'external',
+        sessionOwner: 'external',
+        status,
+        capabilities: input.id === 'codex' ? codexCapabilities : claudeCapabilities,
+        harnessCapabilities: input.id === 'codex' ? codexHarnessCapabilities : claudeHarnessCapabilities,
+        ...(runtimeBridge ? { runtimeBridge } : {}),
+        description: input.id === 'codex'
+            ? 'Local Codex app-server runtime. Model, approval, and thread behavior are owned by Codex.'
+            : 'Local Claude Code runtime. Model, permission, and session behavior are owned by Claude Code.',
+        aliases: input.id === 'codex' ? ['codex-acp'] : ['claude-code', 'claude'],
+        ...(input.id === 'codex' ? { mcpAgentKey: 'codex' } : { mcpAgentKey: 'claude-code' }),
+        ...(input.source ? {
+            sourceAgentId: input.source.id,
+            canonicalAgentId: input.source.id,
+            binaryPath: input.source.binaryPath,
+            ...(input.source.resolvedCommand ? { resolvedCommand: input.source.resolvedCommand } : {}),
+        } : {}),
+        ...(!input.source && input.missing ? {
+            sourceAgentId: input.missing.id,
+            canonicalAgentId: input.missing.id,
+            installCmd: input.missing.installCmd,
+            ...(input.missing.packageName ? { packageName: input.missing.packageName } : {}),
+        } : {}),
+        availability: {
+            checkedAt: input.checkedAt,
+            sources: ['native-health'],
+            ...(reason
+                ? { reason }
+                : !input.source
+                    ? { reason: `${input.name} executable was not detected.` }
+                    : {}),
+            ...(diagnosticHints.length > 0 ? { diagnosticHints } : {}),
+        },
+    };
+}
+export function mindosRuntimeDescriptor(checkedAt) {
+    return {
+        id: 'mindos',
+        runtimeId: 'mindos',
+        category: 'mindos',
+        name: 'MindOS',
+        kind: 'mindos',
+        adapter: 'mindos',
+        modelOwner: 'mindos',
+        authOwner: 'mindos',
+        permissionOwner: 'mindos',
+        sessionOwner: 'mindos',
+        status: 'available',
+        capabilities: mindosCapabilities,
+        harnessCapabilities: mindosHarnessCapabilities,
+        description: 'MindOS internal agent using the selected provider and model.',
+        availability: { checkedAt, sources: ['settings'] },
+    };
+}
+export function acpRuntimeDescriptor(agent, checkedAt) {
+    return {
+        id: agent.id,
+        runtimeId: agent.id,
+        category: 'acp',
+        name: agent.name,
+        kind: 'acp',
+        adapter: 'acp',
+        modelOwner: 'external',
+        authOwner: 'external',
+        permissionOwner: 'external',
+        sessionOwner: 'external',
+        status: agent.status ?? 'available',
+        capabilities: acpCapabilities,
+        harnessCapabilities: acpHarnessCapabilities,
+        description: 'ACP agent selected as the Chat Panel runtime.',
+        sourceAgentId: agent.id,
+        canonicalAgentId: agent.id,
+        binaryPath: agent.binaryPath,
+        ...(agent.resolvedCommand ? { resolvedCommand: agent.resolvedCommand } : {}),
+        availability: {
+            checkedAt,
+            sources: agent.status && agent.status !== 'available' ? ['acp-detect', 'native-health'] : ['acp-detect'],
+            ...(agent.reason ? { reason: agent.reason } : {}),
+        },
+    };
+}
+//# sourceMappingURL=descriptors.js.map

package/dist/agent-runtime/descriptors.js.map

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

package/dist/agent-runtime/detection.d.ts

@@ -0,0 +1,15 @@
+import type { AgentRuntimeBridge, AgentRuntimeDescriptor, DetectedRuntimeAgent, MissingRuntimeAgent, NativeRuntimeHealthResult, NativeRuntimeId } from './registry.js';
+type RuntimeResolvedCommand = NonNullable<AgentRuntimeDescriptor['resolvedCommand']>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function classifyRuntimeFailure(message: string, runtime?: NativeRuntimeId): NativeRuntimeHealthResult;
+export declare function normalizeResolvedCommand(value: unknown): RuntimeResolvedCommand | null;
+export declare function normalizeDiagnosticHints(value: unknown): string[] | undefined;
+export declare function normalizeRuntimeBridge(value: unknown): AgentRuntimeBridge | undefined;
+export declare function normalizeInstalled(value: unknown): DetectedRuntimeAgent | null;
+export declare function normalizeMissing(value: unknown): MissingRuntimeAgent | null;
+export declare function isCodexAgent(agent: Pick<DetectedRuntimeAgent | MissingRuntimeAgent, 'id' | 'name'>): boolean;
+export declare function isClaudeAgent(agent: Pick<DetectedRuntimeAgent | MissingRuntimeAgent, 'id' | 'name'>): boolean;
+export declare function isNativeRuntimeId(value: string | null): value is NativeRuntimeId;
+export declare function compactRuntimeHintsForDescriptor(hints: string[] | undefined, runtime: NativeRuntimeId, reason?: string): string[];
+export {};
+//# sourceMappingURL=detection.d.ts.map

package/dist/agent-runtime/detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/detection.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EAEtB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EAChB,MAAM,eAAe,CAAC;AAEvB,KAAK,sBAAsB,GAAG,WAAW,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAErF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,yBAAyB,CAsB5G;AAcD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI,CAStF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAM7E;AAMD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAWrF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAgB9E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAa3E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,oBAAoB,GAAG,mBAAmB,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG,OAAO,CAG5G;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,oBAAoB,GAAG,mBAAmB,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG,OAAO,CAG7G;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,IAAI,eAAe,CAEhF;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAC3B,OAAO,EAAE,eAAe,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,EAAE,CAEV"}

package/dist/agent-runtime/detection.js

@@ -0,0 +1,124 @@
+import { compactRuntimeFailureMessage, compactRuntimeDiagnosticHints, summarizeRuntimeFailure, } from './runtime-errors.js';
+export function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+export function classifyRuntimeFailure(message, runtime) {
+    const normalized = message.trim() || 'Runtime failed to start.';
+    const summary = summarizeRuntimeFailure(normalized, { runtime });
+    if (/\b(login|log in|signin|sign in|auth|authentication|unauthori[sz]ed|credential|api key|token)\b/i.test(normalized)) {
+        return {
+            status: 'signed-out',
+            reason: summary.reason,
+            ...(summary.diagnosticHints ? { diagnosticHints: summary.diagnosticHints } : {}),
+        };
+    }
+    if (/missing environment variable/i.test(normalized)) {
+        return {
+            status: 'signed-out',
+            reason: summary.reason,
+            ...(summary.diagnosticHints ? { diagnosticHints: summary.diagnosticHints } : {}),
+        };
+    }
+    return {
+        status: 'error',
+        reason: summary.reason,
+        ...(summary.diagnosticHints ? { diagnosticHints: summary.diagnosticHints } : {}),
+    };
+}
+function isResolvedCommandSource(value) {
+    return value === 'user-override' || value === 'descriptor' || value === 'registry';
+}
+function isInstalledRuntimeStatus(value) {
+    return value === 'available' || value === 'signed-out' || value === 'error';
+}
+function isMissingRuntimeStatus(value) {
+    return value === 'missing' || value === 'error';
+}
+export function normalizeResolvedCommand(value) {
+    if (!isRecord(value))
+        return null;
+    if (typeof value.cmd !== 'string' || !Array.isArray(value.args) || !value.args.every((arg) => typeof arg === 'string'))
+        return null;
+    if (!isResolvedCommandSource(value.source))
+        return null;
+    return {
+        cmd: value.cmd,
+        args: value.args,
+        source: value.source,
+    };
+}
+export function normalizeDiagnosticHints(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const hints = value
+        .filter((hint) => typeof hint === 'string' && hint.trim().length > 0)
+        .map((hint) => hint.trim());
+    return hints.length > 0 ? Array.from(new Set(hints)) : undefined;
+}
+function isRuntimeBridgeKind(value) {
+    return value === 'codex-app-server' || value === 'claude-sdk' || value === 'claude-cli';
+}
+export function normalizeRuntimeBridge(value) {
+    if (!isRecord(value))
+        return undefined;
+    if (!isRuntimeBridgeKind(value.kind) || typeof value.label !== 'string' || !value.label.trim())
+        return undefined;
+    return {
+        kind: value.kind,
+        label: value.label.trim(),
+        ...(typeof value.fallback === 'boolean' ? { fallback: value.fallback } : {}),
+        ...(typeof value.reason === 'string' && value.reason.trim()
+            ? { reason: compactRuntimeFailureMessage(value.reason, { runtime: value.kind === 'claude-cli' || value.kind === 'claude-sdk' ? 'claude' : 'codex' }) }
+            : {}),
+    };
+}
+export function normalizeInstalled(value) {
+    if (!isRecord(value))
+        return null;
+    if (typeof value.id !== 'string' || typeof value.name !== 'string' || typeof value.binaryPath !== 'string')
+        return null;
+    const resolved = normalizeResolvedCommand(value.resolvedCommand);
+    const diagnosticHints = normalizeDiagnosticHints(value.diagnosticHints);
+    const runtimeBridge = normalizeRuntimeBridge(value.runtimeBridge);
+    return {
+        id: value.id,
+        name: value.name,
+        binaryPath: value.binaryPath,
+        ...(resolved ? { resolvedCommand: resolved } : {}),
+        ...(isInstalledRuntimeStatus(value.status) ? { status: value.status } : {}),
+        ...(typeof value.reason === 'string' && value.reason.trim() ? { reason: value.reason } : {}),
+        ...(diagnosticHints ? { diagnosticHints } : {}),
+        ...(runtimeBridge ? { runtimeBridge } : {}),
+    };
+}
+export function normalizeMissing(value) {
+    if (!isRecord(value))
+        return null;
+    if (typeof value.id !== 'string' || typeof value.name !== 'string' || typeof value.installCmd !== 'string')
+        return null;
+    const diagnosticHints = normalizeDiagnosticHints(value.diagnosticHints);
+    return {
+        id: value.id,
+        name: value.name,
+        installCmd: value.installCmd,
+        ...(typeof value.packageName === 'string' ? { packageName: value.packageName } : {}),
+        ...(isMissingRuntimeStatus(value.status) ? { status: value.status } : {}),
+        ...(typeof value.reason === 'string' && value.reason.trim() ? { reason: value.reason } : {}),
+        ...(diagnosticHints ? { diagnosticHints } : {}),
+    };
+}
+export function isCodexAgent(agent) {
+    const name = agent.name.toLowerCase();
+    return agent.id === 'codex' || agent.id === 'codex-acp' || name === 'codex' || name.includes('codex');
+}
+export function isClaudeAgent(agent) {
+    const name = agent.name.toLowerCase();
+    return agent.id === 'claude' || agent.id === 'claude-code' || name.includes('claude');
+}
+export function isNativeRuntimeId(value) {
+    return value === 'codex' || value === 'claude';
+}
+export function compactRuntimeHintsForDescriptor(hints, runtime, reason) {
+    return compactRuntimeDiagnosticHints(hints, { runtime }).filter((hint) => hint !== reason);
+}
+//# sourceMappingURL=detection.js.map

package/dist/agent-runtime/detection.js.map

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

package/dist/agent-runtime/index.d.ts

@@ -1,7 +1,9 @@
+export * from './child-process.js';
 export * from './claude-code-cli.js';
 export * from './claude-code-sdk.js';
 export * from './codex-env.js';
 export * from './runtime-env.js';
+export * from './registry.js';
 export * from './codex-app-server.js';
 export * from './run.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/agent-runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC"}

package/dist/agent-runtime/index.js

@@ -1,7 +1,9 @@
+export * from './child-process.js';
 export * from './claude-code-cli.js';
 export * from './claude-code-sdk.js';
 export * from './codex-env.js';
 export * from './runtime-env.js';
+export * from './registry.js';
 export * from './codex-app-server.js';
 export * from './run.js';
 //# sourceMappingURL=index.js.map

package/dist/agent-runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC"}

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

@@ -0,0 +1,152 @@
+import type { AcpAgentOverride } from '../protocols/acp/index.js';
+import type { AgentRuntimeEnvironmentSettings } from './runtime-env.js';
+export type AgentRuntimeKind = 'mindos' | 'acp' | 'codex' | 'claude';
+export type AgentRuntimeCategory = 'mindos' | 'native' | 'acp' | 'cloud';
+export type NativeRuntimeId = 'codex' | 'claude';
+export type AgentRuntimeStatus = 'available' | 'missing' | 'signed-out' | 'error';
+export type AgentRuntimeCapabilities = {
+    ownsModelSelection: boolean;
+    supportsResume: boolean;
+    supportsFreshSession: boolean;
+    supportsListSessions: boolean;
+    supportsAttachExisting: boolean;
+    supportsFork: boolean;
+    supportsArchive: boolean;
+    supportsInterrupt: boolean;
+    supportsModelList: boolean;
+    supportsApprovals: boolean;
+    supportsUserInput: boolean;
+    supportsToolEvents: boolean;
+    supportsRuntimeStatus: boolean;
+    supportsDiffs: boolean;
+    supportsCheckpoints: boolean;
+    supportsBackgroundRuns: boolean;
+    supportsMcpConfig: boolean;
+};
+export type AgentRuntimeHarnessCapabilities = {
+    session: 'none' | 'local-id' | 'native-thread' | 'cloud-task';
+    eventStream: Array<'text' | 'tool-events' | 'thread-turn-item' | 'runtime-status' | 'permissions' | 'user-input'>;
+    workspace: 'local-cwd' | 'local-worktree' | 'container' | 'cloud-vm';
+    permissions: 'none' | 'mindos-only' | 'runtime-bridged';
+    tools: Array<'shell' | 'file' | 'git' | 'browser' | 'mcp' | 'plugins' | 'skills'>;
+    output: Array<'text' | 'diff' | 'checkpoint' | 'artifact' | 'branch' | 'pr'>;
+};
+export type AgentRuntimeAdapter = 'mindos' | 'codex-app-server' | 'codex-sdk' | 'claude-cli' | 'claude-sdk' | 'acp';
+export type AgentRuntimeOwner = 'mindos' | 'external';
+export type AgentRuntimeBridge = {
+    kind: 'codex-app-server' | 'claude-sdk' | 'claude-cli';
+    label: string;
+    fallback?: boolean;
+    reason?: string;
+};
+export type AgentRuntimeDescriptor = {
+    id: string;
+    name: string;
+    kind: AgentRuntimeKind;
+    category?: AgentRuntimeCategory;
+    runtimeId?: string;
+    adapter: AgentRuntimeAdapter;
+    modelOwner: AgentRuntimeOwner;
+    authOwner: AgentRuntimeOwner;
+    permissionOwner: AgentRuntimeOwner;
+    sessionOwner: AgentRuntimeOwner;
+    status: AgentRuntimeStatus;
+    capabilities: AgentRuntimeCapabilities;
+    harnessCapabilities?: AgentRuntimeHarnessCapabilities;
+    runtimeBridge?: AgentRuntimeBridge;
+    description?: string;
+    sourceAgentId?: string;
+    canonicalAgentId?: string;
+    mcpAgentKey?: string;
+    aliases?: string[];
+    binaryPath?: string;
+    resolvedCommand?: {
+        cmd: string;
+        args: string[];
+        source: 'user-override' | 'descriptor' | 'registry';
+    };
+    installCmd?: string;
+    packageName?: string;
+    availability?: {
+        checkedAt: string;
+        sources: Array<'acp-detect' | 'acp-registry' | 'mcp-agents' | 'native-health' | 'settings'>;
+        reason?: string;
+        diagnosticHints?: string[];
+        stale?: boolean;
+    };
+};
+export type DetectedRuntimeAgent = {
+    id: string;
+    name: string;
+    binaryPath: string;
+    resolvedCommand?: NonNullable<AgentRuntimeDescriptor['resolvedCommand']>;
+    status?: Exclude<AgentRuntimeStatus, 'missing'>;
+    reason?: string;
+    diagnosticHints?: string[];
+    runtimeBridge?: AgentRuntimeBridge;
+};
+export type MissingRuntimeAgent = {
+    id: string;
+    name: string;
+    installCmd: string;
+    packageName?: string;
+    status?: Extract<AgentRuntimeStatus, 'missing' | 'error'>;
+    reason?: string;
+    diagnosticHints?: string[];
+};
+export type AgentRuntimesPayload = {
+    runtimes: AgentRuntimeDescriptor[];
+    installed: DetectedRuntimeAgent[];
+    notInstalled: MissingRuntimeAgent[];
+};
+export type AgentRuntimePayload = {
+    runtime: AgentRuntimeDescriptor;
+};
+export type AgentRuntimesSettings = {
+    acpAgents?: Record<string, AcpAgentOverride>;
+    agentRuntimeEnv?: AgentRuntimeEnvironmentSettings;
+};
+export type NativeRuntimeHealthResult = {
+    status: Exclude<AgentRuntimeStatus, 'missing'>;
+    reason?: string;
+    diagnosticHints?: string[];
+    runtimeBridge?: AgentRuntimeBridge;
+};
+export type NativeRuntimeHealthInput = {
+    runtime: NativeRuntimeId;
+    agent: DetectedRuntimeAgent;
+    timeoutMs?: number;
+};
+export type AgentRuntimesServices = {
+    readSettings?(): AgentRuntimesSettings;
+    detectLocalAcpAgents?(options?: {
+        overrides?: Record<string, AcpAgentOverride>;
+    }): Promise<{
+        installed: unknown[];
+        notInstalled: unknown[];
+    }>;
+    checkNativeRuntimeHealth?(input: NativeRuntimeHealthInput): Promise<NativeRuntimeHealthResult>;
+    resolveRuntimeCommand?(command: string): Promise<string | null>;
+    now?(): number;
+};
+export declare const RUNTIME_DETECTION_TIMEOUT_MS = 5000;
+export declare const NATIVE_HEALTH_TIMEOUT_MS = 20000;
+export declare const nativeRuntimeDefinitions: Array<{
+    id: 'codex-acp' | 'claude';
+    name: string;
+    runtime: NativeRuntimeId;
+    command: string;
+    installCmd: string;
+}>;
+export declare function buildAgentRuntimesPayload(input: {
+    installed: unknown[];
+    notInstalled: unknown[];
+    checkedAt: string;
+}): AgentRuntimesPayload;
+export declare function buildAcpScopedPayload(input: {
+    installed: unknown[];
+    notInstalled: unknown[];
+    checkedAt: string;
+}): AgentRuntimesPayload;
+export declare function applyNativeRuntimeHealth(installed: unknown[], services: AgentRuntimesServices, checkNativeRuntimeHealthFallback: (input: NativeRuntimeHealthInput) => Promise<NativeRuntimeHealthResult>): Promise<unknown[]>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/agent-runtime/registry.d.ts.map

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

package/dist/agent-runtime/registry.js

@@ -0,0 +1,84 @@
+import { acpRuntimeDescriptor, mindosRuntimeDescriptor, nativeDescriptor, } from './descriptors.js';
+import { classifyRuntimeFailure, isClaudeAgent, isCodexAgent, normalizeInstalled, normalizeMissing, } from './detection.js';
+export const RUNTIME_DETECTION_TIMEOUT_MS = 5000;
+export const NATIVE_HEALTH_TIMEOUT_MS = 20000;
+export const nativeRuntimeDefinitions = [
+    { id: 'codex-acp', name: 'Codex', runtime: 'codex', command: 'codex', installCmd: 'npm install -g @openai/codex' },
+    { id: 'claude', name: 'Claude Code', runtime: 'claude', command: 'claude', installCmd: 'npm install -g @anthropic-ai/claude-code' },
+];
+export function buildAgentRuntimesPayload(input) {
+    const installed = input.installed.map(normalizeInstalled).filter((agent) => !!agent);
+    const notInstalled = input.notInstalled.map(normalizeMissing).filter((agent) => !!agent);
+    const codexInstalled = installed.find(isCodexAgent);
+    const claudeInstalled = installed.find(isClaudeAgent);
+    const codexMissing = notInstalled.find(isCodexAgent);
+    const claudeMissing = notInstalled.find(isClaudeAgent);
+    const runtimes = [
+        mindosRuntimeDescriptor(input.checkedAt),
+        nativeDescriptor({
+            id: 'codex',
+            name: 'Codex',
+            checkedAt: input.checkedAt,
+            ...(codexInstalled ? { source: codexInstalled } : {}),
+            ...(codexMissing ? { missing: codexMissing } : {}),
+        }),
+        nativeDescriptor({
+            id: 'claude',
+            name: 'Claude Code',
+            checkedAt: input.checkedAt,
+            ...(claudeInstalled ? { source: claudeInstalled } : {}),
+            ...(claudeMissing ? { missing: claudeMissing } : {}),
+        }),
+        ...installed
+            .filter((agent) => !isCodexAgent(agent) && !isClaudeAgent(agent))
+            .map((agent) => acpRuntimeDescriptor(agent, input.checkedAt)),
+    ];
+    return { runtimes, installed, notInstalled };
+}
+export function buildAcpScopedPayload(input) {
+    const installed = input.installed
+        .map(normalizeInstalled)
+        .filter((agent) => !!agent && !isCodexAgent(agent) && !isClaudeAgent(agent));
+    const notInstalled = input.notInstalled
+        .map(normalizeMissing)
+        .filter((agent) => !!agent && !isCodexAgent(agent) && !isClaudeAgent(agent));
+    const runtimes = installed.map((agent) => acpRuntimeDescriptor(agent, input.checkedAt));
+    return { runtimes, installed, notInstalled };
+}
+export async function applyNativeRuntimeHealth(installed, services, checkNativeRuntimeHealthFallback) {
+    const checkNativeRuntimeHealth = services.checkNativeRuntimeHealth ?? checkNativeRuntimeHealthFallback;
+    const normalized = installed.map((agent) => ({ raw: agent, detected: normalizeInstalled(agent) }));
+    const enriched = await Promise.all(normalized.map(async ({ raw, detected }) => {
+        if (!detected)
+            return raw;
+        const runtime = isCodexAgent(detected) ? 'codex' : isClaudeAgent(detected) ? 'claude' : null;
+        if (!runtime)
+            return raw;
+        if (detected.status)
+            return raw;
+        try {
+            const health = await checkNativeRuntimeHealth({
+                runtime,
+                agent: detected,
+                timeoutMs: NATIVE_HEALTH_TIMEOUT_MS,
+            });
+            return {
+                ...(raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : detected),
+                status: health.status,
+                ...(health.reason ? { reason: health.reason } : {}),
+                ...(health.diagnosticHints ? { diagnosticHints: health.diagnosticHints } : {}),
+                ...(health.runtimeBridge ? { runtimeBridge: health.runtimeBridge } : {}),
+            };
+        }
+        catch (error) {
+            const result = classifyRuntimeFailure(error instanceof Error ? error.message : String(error), runtime);
+            return {
+                ...(raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : detected),
+                status: result.status,
+                ...(result.reason ? { reason: result.reason } : {}),
+            };
+        }
+    }));
+    return enriched;
+}
+//# sourceMappingURL=registry.js.map

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

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

package/dist/agent-runtime/run.d.ts

@@ -49,6 +49,12 @@ export type MindosRuntimePermissionOption = {
     label: string;
     description?: string;
     intent?: 'allow' | 'deny' | 'cancel';
+    scope?: 'once' | 'session' | 'always' | 'turn';
+};
+export type MindosRuntimePermissionRisk = {
+    level: 'low' | 'medium' | 'high';
+    summary: string;
+    reasons?: string[];
 };
 export type MindosRuntimePermissionRequest = {
     runtime: 'codex' | 'claude';
@@ -57,10 +63,16 @@ export type MindosRuntimePermissionRequest = {
     input: unknown;
     options: MindosRuntimePermissionOption[];
     reason?: string;
+    action?: string;
+    resource?: string;
+    risk?: MindosRuntimePermissionRisk;
 };
 export type MindosRuntimePermissionResult = {
     decision: string;
     cancelled?: boolean;
+    decisionLabel?: string;
+    decisionIntent?: 'allow' | 'deny' | 'cancel';
+    decisionScope?: 'once' | 'session' | 'always' | 'turn';
 };
 export type MindosRuntimeUserQuestionOption = {
     label: string;