@geminilight/mindos 1.1.49 → 1.1.50

package/dist/agent/runtime/detection.js

@@ -72,6 +72,57 @@ export function normalizeRuntimeBridge(value) {
             : {}),
     };
 }
+function sanitizeOptionalString(value, maxLength) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed.slice(0, maxLength) : undefined;
+}
+function normalizePositiveInteger(value, max) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return undefined;
+    const normalized = Math.floor(value);
+    if (normalized <= 0)
+        return undefined;
+    return Math.min(normalized, max);
+}
+function normalizeAdapterMetadata(value) {
+    if (!isRecord(value))
+        return undefined;
+    const metadata = {};
+    if (isRecord(value.healthCheck)) {
+        const command = sanitizeOptionalString(value.healthCheck.command, 240);
+        const summary = sanitizeOptionalString(value.healthCheck.summary, 300);
+        const timeoutMs = normalizePositiveInteger(value.healthCheck.timeoutMs, 60_000);
+        if (command || summary || timeoutMs !== undefined) {
+            metadata.healthCheck = {
+                ...(command ? { command } : {}),
+                ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+                ...(summary ? { summary } : {}),
+            };
+        }
+    }
+    if (Array.isArray(value.commands)) {
+        const commands = value.commands
+            .filter(isRecord)
+            .map((command) => {
+            const name = sanitizeOptionalString(command.name, 80);
+            if (!name)
+                return null;
+            const description = sanitizeOptionalString(command.description, 240);
+            const normalizedCommand = {
+                name,
+                ...(description ? { description } : {}),
+            };
+            return normalizedCommand;
+        })
+            .filter((command) => command !== null)
+            .slice(0, 50);
+        if (commands.length > 0)
+            metadata.commands = commands;
+    }
+    return metadata.healthCheck || metadata.commands ? metadata : undefined;
+}
 export function normalizeInstalled(value) {
     if (!isRecord(value))
         return null;
@@ -80,11 +131,13 @@ export function normalizeInstalled(value) {
     const resolved = normalizeResolvedCommand(value.resolvedCommand);
     const diagnosticHints = normalizeDiagnosticHints(value.diagnosticHints);
     const runtimeBridge = normalizeRuntimeBridge(value.runtimeBridge);
+    const adapterMetadata = normalizeAdapterMetadata(value.adapterMetadata);
     return {
         id: value.id,
         name: value.name,
         binaryPath: value.binaryPath,
         ...(resolved ? { resolvedCommand: resolved } : {}),
+        ...(adapterMetadata ? { adapterMetadata } : {}),
         ...(isInstalledRuntimeStatus(value.status) ? { status: value.status } : {}),
         ...(typeof value.reason === 'string' && value.reason.trim() ? { reason: value.reason } : {}),
         ...(diagnosticHints ? { diagnosticHints } : {}),

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

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

@@ -4,10 +4,12 @@ export * from './capabilities.js';
 export * from './child-process.js';
 export * from './claude-code-cli.js';
 export * from './claude-code-sdk.js';
+export * from './compatibility.js';
 export * from './codex-app-server.js';
 export * from './codex-env.js';
 export * from './descriptors.js';
 export * from './detection.js';
+export * from './lifecycle.js';
 export * from './registry.js';
 export * from './runtime-env.js';
 export * from './runtime-errors.js';

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,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC"}

package/dist/agent/runtime/index.js

@@ -4,10 +4,12 @@ export * from './capabilities.js';
 export * from './child-process.js';
 export * from './claude-code-cli.js';
 export * from './claude-code-sdk.js';
+export * from './compatibility.js';
 export * from './codex-app-server.js';
 export * from './codex-env.js';
 export * from './descriptors.js';
 export * from './detection.js';
+export * from './lifecycle.js';
 export * from './registry.js';
 export * from './runtime-env.js';
 export * from './runtime-errors.js';

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,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC"}

package/dist/agent/runtime/lifecycle.d.ts

@@ -0,0 +1,6 @@
+import type { AgentRuntimeCapabilities, AgentRuntimeLifecycle, AgentRuntimeLifecycleStage, NativeRuntimeId } from './registry.js';
+export declare const agentRuntimeLifecycleStages: AgentRuntimeLifecycleStage[];
+export declare function mindosRuntimeLifecycle(capabilities: AgentRuntimeCapabilities): AgentRuntimeLifecycle;
+export declare function nativeRuntimeLifecycle(runtime: NativeRuntimeId, capabilities: AgentRuntimeCapabilities): AgentRuntimeLifecycle;
+export declare function acpRuntimeLifecycle(capabilities: AgentRuntimeCapabilities): AgentRuntimeLifecycle;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/agent/runtime/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/agent/runtime/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAE1B,eAAe,EAChB,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,2BAA2B,EAAE,0BAA0B,EAYnE,CAAC;AAcF,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,wBAAwB,GAAG,qBAAqB,CAyFpG;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,wBAAwB,GACrC,qBAAqB,CA2GvB;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,wBAAwB,GAAG,qBAAqB,CA6FjG"}

package/dist/agent/runtime/lifecycle.js

@@ -0,0 +1,311 @@
+export const agentRuntimeLifecycleStages = [
+    'detect',
+    'health',
+    'configure',
+    'launch',
+    'session',
+    'context',
+    'execute',
+    'interrupt',
+    'archive',
+    'remote',
+    'coordinate',
+];
+function buildStages(overrides) {
+    return Object.fromEntries(agentRuntimeLifecycleStages.map((stage) => [stage, overrides[stage]]));
+}
+function unsupported(summary) {
+    return { support: 'unsupported', owner: 'mindos', summary };
+}
+export function mindosRuntimeLifecycle(capabilities) {
+    return {
+        schemaVersion: 1,
+        stages: buildStages({
+            detect: {
+                support: 'owned',
+                owner: 'mindos',
+                required: true,
+                sources: ['settings', 'runtime-registry'],
+                summary: 'MindOS Pi is bundled with the MindOS runtime and is always registered by the local server.',
+            },
+            health: {
+                support: 'owned',
+                owner: 'mindos',
+                required: true,
+                sources: ['runtime-registry'],
+                summary: 'MindOS reports the internal Pi lane as available when the product server is running.',
+            },
+            configure: {
+                support: 'owned',
+                owner: 'mindos',
+                required: true,
+                sources: ['settings'],
+                summary: 'Provider, model, MCP, skill, and permission defaults are configured by MindOS.',
+            },
+            launch: {
+                support: 'owned',
+                owner: 'mindos',
+                required: true,
+                sources: ['turn-runner', 'mindos-pi-session'],
+                summary: 'The MindOS Pi lane creates and restores the Pi runtime inside the MindOS server process.',
+            },
+            session: {
+                support: 'owned',
+                owner: 'mindos',
+                required: true,
+                sources: ['mindos-pi-session'],
+                summary: 'Pi SessionManager owns persisted JSONL history and compaction entries; MindOS stores only session metadata and runtime bindings.',
+            },
+            context: {
+                support: 'owned',
+                owner: 'mindos',
+                required: true,
+                sources: ['turn-runner', 'mindos-pi-session', 'run-ledger'],
+                summary: 'MindOS builds turn context and lets the Pi context extension own compaction before provider execution.',
+            },
+            execute: {
+                support: 'owned',
+                owner: 'mindos',
+                required: true,
+                sources: ['turn-runner', 'mindos-pi-session'],
+                summary: 'MindOS streams the internal Pi run through the canonical turn runner.',
+            },
+            interrupt: capabilities.supportsInterrupt
+                ? {
+                    support: 'owned',
+                    owner: 'mindos',
+                    sources: ['turn-runner'],
+                    summary: 'MindOS can interrupt active Pi runs through the product turn lane.',
+                }
+                : unsupported('MindOS Pi interruption is not exposed for this descriptor.'),
+            archive: unsupported('MindOS Pi archive pointers are not exposed as a user-facing archive lifecycle yet.'),
+            remote: {
+                support: 'owned',
+                owner: 'mindos',
+                sources: ['runtime-registry'],
+                summary: 'MindOS Pi can run wherever the MindOS server runs, but 24/7 scheduling still requires a separate scheduler and approval policy.',
+            },
+            coordinate: {
+                support: 'owned',
+                owner: 'mindos',
+                sources: ['runtime-registry'],
+                summary: 'MindOS can act as the primary runtime for shared context; a durable mailbox/task-board substrate is not implemented yet.',
+            },
+        }),
+        remote: {
+            supported: true,
+            mode: 'server-runnable',
+            unattended: capabilities.supportsBackgroundRuns ? 'supported' : 'limited',
+            summary: 'Internal Pi runs are server-runnable, but autonomous 24/7 work is limited until background scheduling, approvals, and wake/resume policy are first-class.',
+        },
+        coordination: {
+            role: 'primary',
+            supportsSharedContext: true,
+            supportsMailbox: false,
+            supportsTaskBoard: false,
+            summary: 'MindOS owns the shared context surface and can later coordinate workers, but it does not yet expose Team Mode mailbox or task-board primitives.',
+        },
+    };
+}
+export function nativeRuntimeLifecycle(runtime, capabilities) {
+    const name = runtime === 'codex' ? 'Codex' : 'Claude Code';
+    const sessionSummary = runtime === 'codex'
+        ? 'Codex owns its thread store; MindOS records only the runtime binding and archive pointer needed to resume.'
+        : 'Claude Code owns its local session semantics; MindOS records only the runtime binding needed to resume.';
+    const bridgeSource = runtime === 'codex' ? 'codex-app-server' : 'claude-bridge';
+    return {
+        schemaVersion: 1,
+        stages: buildStages({
+            detect: {
+                support: 'owned',
+                owner: 'mindos',
+                required: true,
+                sources: ['settings', 'native-health'],
+                summary: `MindOS resolves the local ${name} command from settings, runtime PATH, and platform fallbacks.`,
+            },
+            health: {
+                support: 'owned',
+                owner: 'mindos',
+                required: true,
+                sources: ['native-health'],
+                summary: `MindOS probes ${name} before marking the runtime available, then preserves the native diagnostic state.`,
+            },
+            configure: {
+                support: 'delegated',
+                owner: 'external',
+                required: true,
+                sources: ['settings'],
+                summary: `${name} owns model, auth, and native configuration; MindOS may provide command and environment overrides.`,
+            },
+            launch: {
+                support: 'delegated',
+                owner: 'external',
+                required: true,
+                sources: ['turn-runner', bridgeSource],
+                summary: `MindOS launches or attaches to the ${name} bridge, while the external runtime owns process behavior.`,
+            },
+            session: {
+                support: 'delegated',
+                owner: 'external',
+                required: true,
+                sources: ['turn-runner', bridgeSource, 'run-ledger'],
+                summary: sessionSummary,
+            },
+            context: {
+                support: 'delegated',
+                owner: 'external',
+                required: true,
+                sources: ['turn-runner', bridgeSource],
+                summary: `MindOS prepends active assistant and file context, but ${name} owns native history, compaction, and model-specific context handling.`,
+            },
+            execute: {
+                support: 'delegated',
+                owner: 'external',
+                required: true,
+                sources: ['turn-runner', bridgeSource],
+                summary: `${name} executes the turn through its native CLI/SDK bridge; MindOS normalizes the stream into product events.`,
+            },
+            interrupt: capabilities.supportsInterrupt
+                ? {
+                    support: 'delegated',
+                    owner: 'external',
+                    sources: ['turn-runner', bridgeSource],
+                    summary: `${name} handles cancellation through its native bridge when the MindOS turn lane interrupts the run.`,
+                }
+                : unsupported(`${name} interruption is not exposed through the current bridge.`),
+            archive: capabilities.supportsArchive
+                ? {
+                    support: 'delegated',
+                    owner: 'external',
+                    sources: ['codex-app-server', 'run-ledger'],
+                    summary: `${name} owns archive state; MindOS stores the archive pointer and calls the native archive API.`,
+                }
+                : {
+                    support: 'unsupported',
+                    owner: 'external',
+                    sources: ['run-ledger'],
+                    summary: `${name} archive operations are not exposed through the current MindOS bridge.`,
+                },
+            remote: {
+                support: 'delegated',
+                owner: 'external',
+                sources: ['native-health', 'turn-runner'],
+                summary: `${name} can run remotely only when the MindOS server host has the CLI installed, authenticated, and permission flow reachable.`,
+            },
+            coordinate: {
+                support: 'delegated',
+                owner: 'external',
+                sources: ['turn-runner', 'run-ledger'],
+                summary: `${name} can act as an external worker through prompt/context bridging; MindOS has not added a mailbox contract for it yet.`,
+            },
+        }),
+        remote: {
+            supported: true,
+            mode: 'server-runnable',
+            unattended: capabilities.supportsBackgroundRuns ? 'supported' : 'limited',
+            summary: `${name} is server-runnable through MindOS only on hosts where the native runtime is installed, signed in, and allowed to satisfy approval prompts.`,
+        },
+        coordination: {
+            role: 'external-worker',
+            supportsSharedContext: true,
+            supportsMailbox: false,
+            supportsTaskBoard: false,
+            summary: `${name} can consume shared MindOS context as an external worker, but durable Team Mode mailbox/task-board primitives are not implemented yet.`,
+        },
+    };
+}
+export function acpRuntimeLifecycle(capabilities) {
+    return {
+        schemaVersion: 1,
+        stages: buildStages({
+            detect: {
+                support: 'owned',
+                owner: 'mindos',
+                required: true,
+                sources: ['settings', 'acp-detect', 'acp-registry'],
+                summary: 'MindOS detects ACP agents from built-in registry entries, custom settings, and local command presence.',
+            },
+            health: {
+                support: 'unknown',
+                owner: 'external',
+                sources: ['acp-detect'],
+                summary: 'ACP detection may surface status, but MindOS does not yet have a shared ACP health probe contract.',
+            },
+            configure: {
+                support: 'delegated',
+                owner: 'external',
+                required: true,
+                sources: ['settings', 'acp-registry'],
+                summary: 'The ACP adapter owns its command, arguments, environment, model, and auth setup; MindOS stores launch metadata.',
+            },
+            launch: {
+                support: 'delegated',
+                owner: 'external',
+                required: true,
+                sources: ['turn-runner', 'acp-session'],
+                summary: 'MindOS starts the ACP subprocess/session from descriptor metadata while the adapter owns protocol behavior.',
+            },
+            session: {
+                support: 'delegated',
+                owner: 'external',
+                required: true,
+                sources: ['acp-session', 'run-ledger'],
+                summary: 'ACP session identity belongs to the adapter/protocol; MindOS records only the binding and run index.',
+            },
+            context: {
+                support: 'delegated',
+                owner: 'external',
+                required: true,
+                sources: ['turn-runner', 'acp-session'],
+                summary: 'MindOS provides prompt/context text, while ACP adapters own their native history and context-window behavior.',
+            },
+            execute: {
+                support: 'delegated',
+                owner: 'external',
+                required: true,
+                sources: ['turn-runner', 'acp-session'],
+                summary: 'ACP adapters execute turns through the protocol stream; MindOS normalizes text and tool events.',
+            },
+            interrupt: capabilities.supportsInterrupt
+                ? {
+                    support: 'delegated',
+                    owner: 'external',
+                    sources: ['acp-session'],
+                    summary: 'MindOS can request interruption when the ACP session exposes an interruptible process boundary.',
+                }
+                : unsupported('ACP interruption is not exposed for this descriptor.'),
+            archive: {
+                support: 'unsupported',
+                owner: 'external',
+                sources: ['run-ledger'],
+                summary: 'ACP archive/list/fork lifecycle is not part of the current MindOS ACP adapter contract.',
+            },
+            remote: {
+                support: 'delegated',
+                owner: 'external',
+                sources: ['acp-detect', 'turn-runner'],
+                summary: 'ACP agents can run remotely only when their command and dependencies are available on the MindOS server host.',
+            },
+            coordinate: {
+                support: 'delegated',
+                owner: 'external',
+                sources: ['turn-runner', 'run-ledger'],
+                summary: 'ACP agents can receive shared MindOS context as external workers, but mailbox/task-board coordination is not implemented yet.',
+            },
+        }),
+        remote: {
+            supported: true,
+            mode: 'server-runnable',
+            unattended: capabilities.supportsBackgroundRuns ? 'supported' : 'limited',
+            summary: 'ACP runtimes are server-runnable when installed on the host, but 24/7 operation depends on adapter auth, subprocess health, and approval behavior.',
+        },
+        coordination: {
+            role: 'external-worker',
+            supportsSharedContext: true,
+            supportsMailbox: false,
+            supportsTaskBoard: false,
+            summary: 'ACP runtimes can participate through shared prompt context; MindOS has not promoted them into durable Team Mode participants yet.',
+        },
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/agent/runtime/lifecycle.js.map

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

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

@@ -33,12 +33,115 @@ export type AgentRuntimeHarnessCapabilities = {
 };
 export type AgentRuntimeAdapter = 'mindos' | 'codex-app-server' | 'codex-sdk' | 'claude-cli' | 'claude-sdk' | 'acp';
 export type AgentRuntimeOwner = 'mindos' | 'external';
+export type AgentRuntimeLifecycleStage = 'detect' | 'health' | 'configure' | 'launch' | 'session' | 'context' | 'execute' | 'interrupt' | 'archive' | 'remote' | 'coordinate';
+export type AgentRuntimeLifecycleSupport = 'owned' | 'delegated' | 'unsupported' | 'unknown';
+export type AgentRuntimeLifecycleSource = 'settings' | 'runtime-registry' | 'native-health' | 'acp-detect' | 'acp-registry' | 'turn-runner' | 'runtime-bridge' | 'codex-app-server' | 'claude-bridge' | 'acp-session' | 'mindos-pi-session' | 'run-ledger';
+export type AgentRuntimeLifecycleStageDescriptor = {
+    support: AgentRuntimeLifecycleSupport;
+    owner: AgentRuntimeOwner;
+    summary: string;
+    required?: boolean;
+    sources?: AgentRuntimeLifecycleSource[];
+    diagnosticHints?: string[];
+};
+export type AgentRuntimeRemoteMode = 'local-only' | 'server-runnable' | 'external-runtime' | 'cloud-task' | 'unknown';
+export type AgentRuntimeUnattendedSupport = 'supported' | 'limited' | 'unsupported' | 'unknown';
+export type AgentRuntimeCoordinationRole = 'primary' | 'external-worker' | 'subagent-capable' | 'unknown';
+export type AgentRuntimeLifecycle = {
+    schemaVersion: 1;
+    stages: Record<AgentRuntimeLifecycleStage, AgentRuntimeLifecycleStageDescriptor>;
+    remote: {
+        supported: boolean;
+        mode: AgentRuntimeRemoteMode;
+        unattended: AgentRuntimeUnattendedSupport;
+        summary: string;
+    };
+    coordination: {
+        role: AgentRuntimeCoordinationRole;
+        supportsSharedContext: boolean;
+        supportsMailbox: boolean;
+        supportsTaskBoard: boolean;
+        summary: string;
+    };
+};
+export type AgentRuntimeCompatibilityLevel = 'ready' | 'limited' | 'blocked' | 'unknown';
+export type AgentRuntimeCompatibilityOwner = AgentRuntimeOwner | 'shared';
+export type AgentRuntimeCompatibilityScenario = 'interactive-turn' | 'coding-workflow' | 'session-continuity' | 'context-governance' | 'permission-governance' | 'mcp-tooling' | 'skill-execution' | 'artifact-governance' | 'remote-control' | 'unattended-automation' | 'team-coordination';
+export type AgentRuntimeCompatibilityRequirementStatus = 'satisfied' | 'external' | 'missing' | 'unknown' | 'not-applicable';
+export type AgentRuntimeCompatibilityRequirement = {
+    id: string;
+    status: AgentRuntimeCompatibilityRequirementStatus;
+    owner: AgentRuntimeCompatibilityOwner;
+    summary: string;
+};
+export type AgentRuntimeCompatibilityAssessment = {
+    level: AgentRuntimeCompatibilityLevel;
+    owner: AgentRuntimeCompatibilityOwner;
+    summary: string;
+    requirements: AgentRuntimeCompatibilityRequirement[];
+    blockers?: string[];
+};
+export type AgentRuntimeCompatibilityProfile = {
+    schemaVersion: 1;
+    scenarios: Record<AgentRuntimeCompatibilityScenario, AgentRuntimeCompatibilityAssessment>;
+    summary: string;
+};
 export type AgentRuntimeBridge = {
     kind: 'codex-app-server' | 'claude-sdk' | 'claude-cli';
     label: string;
     fallback?: boolean;
     reason?: string;
 };
+export type AgentRuntimeAdapterConnectionKind = 'internal' | 'stdio' | 'app-server' | 'sdk' | 'cli' | 'unknown';
+export type AgentRuntimeAdapterConfigurationOwner = 'mindos-session' | 'mindos-settings' | 'runtime-native' | 'adapter-declared' | 'unsupported' | 'unknown';
+export type AgentRuntimeAdapterHealthMode = 'mindos-native' | 'runtime-native' | 'adapter-declared' | 'unsupported' | 'unknown';
+export type AgentRuntimeAdapterCommandDiscovery = 'mindos-skills' | 'runtime-event' | 'adapter-declared' | 'unsupported' | 'unknown';
+export type AgentRuntimeAdapterCommandSource = 'mindos' | 'runtime-native' | 'adapter-declared';
+export type AgentRuntimeResolvedCommandSource = 'user-override' | 'descriptor' | 'registry';
+export type AgentRuntimeAdapterDeclaredCommand = {
+    name: string;
+    description?: string;
+    source: AgentRuntimeAdapterCommandSource;
+};
+export type AgentRuntimeAdapterMetadata = {
+    healthCheck?: {
+        command?: string;
+        timeoutMs?: number;
+        summary?: string;
+    };
+    commands?: Array<{
+        name: string;
+        description?: string;
+    }>;
+};
+export type AgentRuntimeAdapterContract = {
+    schemaVersion: 1;
+    connection: {
+        kind: AgentRuntimeAdapterConnectionKind;
+        owner: AgentRuntimeOwner;
+        summary: string;
+        command?: string;
+        commandSource?: AgentRuntimeResolvedCommandSource;
+    };
+    configuration: {
+        modelSelection: AgentRuntimeAdapterConfigurationOwner;
+        credentials: AgentRuntimeAdapterConfigurationOwner;
+        settings: AgentRuntimeAdapterConfigurationOwner;
+        summary: string;
+    };
+    health: {
+        mode: AgentRuntimeAdapterHealthMode;
+        owner: AgentRuntimeOwner;
+        summary: string;
+        command?: string;
+        timeoutMs?: number;
+    };
+    commands: {
+        discovery: AgentRuntimeAdapterCommandDiscovery;
+        commands: AgentRuntimeAdapterDeclaredCommand[];
+        summary: string;
+    };
+};
 export type AgentRuntimeDescriptor = {
     id: string;
     name: string;
@@ -53,6 +156,9 @@ export type AgentRuntimeDescriptor = {
     status: AgentRuntimeStatus;
     capabilities: AgentRuntimeCapabilities;
     harnessCapabilities?: AgentRuntimeHarnessCapabilities;
+    lifecycle: AgentRuntimeLifecycle;
+    compatibility: AgentRuntimeCompatibilityProfile;
+    adapterContract: AgentRuntimeAdapterContract;
     runtimeBridge?: AgentRuntimeBridge;
     description?: string;
     sourceAgentId?: string;
@@ -63,7 +169,7 @@ export type AgentRuntimeDescriptor = {
     resolvedCommand?: {
         cmd: string;
         args: string[];
-        source: 'user-override' | 'descriptor' | 'registry';
+        source: AgentRuntimeResolvedCommandSource;
     };
     installCmd?: string;
     packageName?: string;
@@ -80,6 +186,7 @@ export type DetectedRuntimeAgent = {
     name: string;
     binaryPath: string;
     resolvedCommand?: NonNullable<AgentRuntimeDescriptor['resolvedCommand']>;
+    adapterMetadata?: AgentRuntimeAdapterMetadata;
     status?: Exclude<AgentRuntimeStatus, 'missing'>;
     reason?: string;
     diagnosticHints?: string[];