@cats-inc/cats-platform 0.1.0

package/build/server/platform/supervision/contracts.js

@@ -0,0 +1,141 @@
+export const DEFAULT_SUPERVISION_SCHEMA_VERSION = {
+    major: 1,
+    minor: 0,
+};
+export const SUPERVISION_AUTONOMY_VALUES = [
+    'none',
+    'single_step',
+    'milestone_plan',
+    'outcome_delegation',
+];
+export const SUPERVISION_TASK_GRANULARITY_VALUES = [
+    'tiny',
+    'step',
+    'milestone',
+    'outcome',
+];
+export const SUPERVISION_TOOL_SCOPE_VALUES = [
+    'none',
+    'read_only',
+    'narrow_write',
+    'broad_write',
+];
+export const SUPERVISION_SCAFFOLDING_VALUES = [
+    'none',
+    'few_shot',
+    'grammar_forced',
+    'sop_template',
+];
+export const SUPERVISION_VALIDATION_VALUES = [
+    'best_effort',
+    'schema_required',
+    'semantic_check',
+];
+export const SUPERVISION_CHECKPOINT_CADENCE_VALUES = [
+    'every_step',
+    'milestone',
+    'on_risk',
+    'final',
+];
+export const SUPERVISION_APPROVAL_THRESHOLD_VALUES = [
+    'low',
+    'medium',
+    'high',
+];
+export const SUPERVISION_FALLBACK_POLICY_VALUES = [
+    'retry',
+    'ask_human',
+    'escalate_model',
+    'delegate_other',
+];
+export const CAPABILITY_DIMENSION_VALUES = [
+    'tool_use_accuracy',
+    'json_fidelity',
+    'reasoning_depth',
+    'context_reliability',
+    'recovery_reliability',
+];
+export const CAPABILITY_CONFIDENCE_LEVEL_VALUES = [
+    'unknown',
+    'catalog_only',
+    'evaluated',
+    'observed',
+];
+export const CAPABILITY_SOURCE_VALUES = [
+    'bootstrap_config',
+    'provider_catalog',
+    'operator_override',
+    'eval_suite',
+    'session_history',
+];
+export const CAPABILITY_AGGREGATE_METHOD = 'conservative_per_dimension';
+export const TOOL_RESULT_STATUS_VALUES = [
+    'applied',
+    'pending_approval',
+    'rejected',
+];
+export const ADDRESSABLE_TARGET_KIND_VALUES = [
+    'durable_agent',
+    'execution_target',
+    'temporary_participant',
+    'worker_tool',
+];
+export const SUPERVISED_TOOL_SIDE_EFFECT_VALUES = [
+    'none',
+    'local_state',
+    'external_visible',
+    'destructive',
+    'expensive',
+];
+export const SUPERVISED_TOOL_PREFLIGHT_VALUES = [
+    'required',
+    'available',
+    'not_supported',
+];
+export const SUPERVISED_TOOL_BLOCKING_VALUES = [
+    'blocking',
+    'async',
+];
+export const SUPERVISED_TOOL_CANCELLATION_VALUES = [
+    'cooperative',
+    'best_effort',
+    'not_supported',
+];
+export const SUPERVISED_TOOL_APPROVAL_VALUES = [
+    'never',
+    'policy',
+    'always',
+];
+export const SUPERVISED_TOOL_EVIDENCE_VALUES = [
+    'none',
+    'summary',
+    'pre_post_snapshot',
+    'artifact_reference',
+];
+export const RUN_PRIMARY_STATE_VALUES = [
+    'queued',
+    'running',
+    'waiting_for_approval',
+    'blocked',
+    'completed',
+    'failed',
+    'cancelled',
+];
+export const CANCELLATION_TOOL_CONTEXT_VALUES = [
+    'cooperative_requested',
+    'best_effort_requested',
+    'not_supported',
+];
+export const CANCELLATION_EFFECT_LANDED_VALUES = [
+    'before_cancel_request',
+    'after_cancel_request',
+    'not_applied',
+];
+export const CANCELLATION_REASON_CODE_VALUES = [
+    'operator_decision',
+    'budget_hard_stop',
+    'policy_violation',
+    'external_event',
+    'other',
+];
+//# sourceMappingURL=contracts.js.map

package/build/server/platform/supervision/contracts.js.map

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

package/build/server/platform/supervision/errors.d.ts

@@ -0,0 +1,8 @@
+export declare const SUPERVISION_REJECTION_CODES: readonly ["E_AUDIENCE_LIMIT_EXCEEDED", "E_NOT_AUTHORIZED", "E_BUDGET_EXCEEDED", "E_APPROVAL_REQUIRED", "E_APPROVAL_DENIED", "E_RUN_CANCELLED", "E_PRECHECK_FAILED", "E_TOOL_SCOPE_DENIED", "E_SCHEMA_INVALID"];
+export type SupervisionRejectionCode = (typeof SUPERVISION_REJECTION_CODES)[number];
+export interface SupervisionRejectionError {
+    code: SupervisionRejectionCode;
+    message: string;
+    details?: unknown;
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/server/platform/supervision/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/platform/supervision/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,gNAU9B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpF,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/build/server/platform/supervision/errors.js

@@ -0,0 +1,12 @@
+export const SUPERVISION_REJECTION_CODES = [
+    'E_AUDIENCE_LIMIT_EXCEEDED',
+    'E_NOT_AUTHORIZED',
+    'E_BUDGET_EXCEEDED',
+    'E_APPROVAL_REQUIRED',
+    'E_APPROVAL_DENIED',
+    'E_RUN_CANCELLED',
+    'E_PRECHECK_FAILED',
+    'E_TOOL_SCOPE_DENIED',
+    'E_SCHEMA_INVALID',
+];
+//# sourceMappingURL=errors.js.map

package/build/server/platform/supervision/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/platform/supervision/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,2BAA2B;IAC3B,kBAAkB;IAClB,mBAAmB;IACnB,qBAAqB;IACrB,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,qBAAqB;IACrB,kBAAkB;CACV,CAAC"}

package/build/server/platform/supervision/evidenceSink.d.ts

@@ -0,0 +1,10 @@
+import type { EvidenceEvent } from '../../core/types.js';
+import type { ToolBoundaryEvidenceEvent, ToolBoundaryEvidenceSink } from './toolBoundary.js';
+export interface DurableToolEvidenceSinkOptions {
+    dataDir: string;
+    conversationId: string;
+    sessionId?: string | null;
+}
+export declare function createDurableToolEvidenceSink(options: DurableToolEvidenceSinkOptions): ToolBoundaryEvidenceSink;
+export declare function toEvidenceEvent(event: ToolBoundaryEvidenceEvent, options: DurableToolEvidenceSinkOptions): EvidenceEvent;
+//# sourceMappingURL=evidenceSink.d.ts.map

package/build/server/platform/supervision/evidenceSink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidenceSink.d.ts","sourceRoot":"","sources":["../../../../src/platform/supervision/evidenceSink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,wBAAwB,CAgB1B;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,yBAAyB,EAChC,OAAO,EAAE,8BAA8B,GACtC,aAAa,CAyBf"}

package/build/server/platform/supervision/evidenceSink.js

@@ -0,0 +1,40 @@
+import { appendEvidenceEvent, } from '../persistence/evidence.js';
+export function createDurableToolEvidenceSink(options) {
+    const events = [];
+    return {
+        append(event) {
+            events.push(event);
+            appendEvidenceEvent(options.dataDir, options.conversationId, toEvidenceEvent(event, options));
+        },
+        read() {
+            return [...events];
+        },
+    };
+}
+export function toEvidenceEvent(event, options) {
+    return {
+        id: event.eventId,
+        conversationId: options.conversationId,
+        sessionId: options.sessionId ?? null,
+        layer: 'evidence',
+        actorId: event.actorRef,
+        kind: 'system_event',
+        timestamp: event.occurredAt,
+        payload: {
+            source: 'supervision_tool_boundary',
+            actionId: event.actionId,
+            runId: event.runId,
+            toolName: event.toolName,
+            status: event.status,
+            ...(event.toolManifest ? { toolManifest: event.toolManifest } : {}),
+            ...(event.policySnapshotRef ? { policySnapshotRef: event.policySnapshotRef } : {}),
+            ...(event.rejectionCode ? { rejectionCode: event.rejectionCode } : {}),
+            ...(event.approvalRequestId ? { approvalRequestId: event.approvalRequestId } : {}),
+            ...(event.cancellationContext
+                ? { cancellationContext: event.cancellationContext }
+                : {}),
+            ...(event.summary ? { summary: event.summary } : {}),
+        },
+    };
+}
+//# sourceMappingURL=evidenceSink.js.map

package/build/server/platform/supervision/evidenceSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidenceSink.js","sourceRoot":"","sources":["../../../../src/platform/supervision/evidenceSink.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAYpC,MAAM,UAAU,6BAA6B,CAC3C,OAAuC;IAEvC,MAAM,MAAM,GAAgC,EAAE,CAAC;IAE/C,OAAO;QACL,MAAM,CAAC,KAAK;YACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,mBAAmB,CACjB,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,cAAc,EACtB,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAChC,CAAC;QACJ,CAAC;QACD,IAAI;YACF,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAgC,EAChC,OAAuC;IAEvC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,OAAO;QACjB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;QACpC,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,KAAK,CAAC,QAAQ;QACvB,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,KAAK,CAAC,UAAU;QAC3B,OAAO,EAAE;YACP,MAAM,EAAE,2BAA2B;YACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,GAAG,CAAC,KAAK,CAAC,mBAAmB;gBAC3B,CAAC,CAAC,EAAE,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,EAAE;gBACpD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD;KACF,CAAC;AACJ,CAAC"}

package/build/server/platform/supervision/index.d.ts

@@ -0,0 +1,25 @@
+export * from './approvalRequests.js';
+export * from './capabilityAssessment.js';
+export * from './budget.js';
+export * from './cancellation.js';
+export * from './contracts.js';
+export * from './errors.js';
+export * from './evidenceSink.js';
+export * from './lifecycleTools.js';
+export * from './policyEngine.js';
+export * from './policySnapshots.js';
+export * from './policyVersions.js';
+export * from './providerCapabilityBootstrapConfig.js';
+export * from './providerCapabilityBootstrapDiagnostics.js';
+export * from './providerCapabilityControlKey.js';
+export * from './providerCapabilityProfiles.js';
+export * from './runProjection.js';
+export * from './runLifecycleService.js';
+export * from './runLoopHandoff.js';
+export * from './runState.js';
+export * from './runtimeBoundary.js';
+export * from './toolBoundary.js';
+export * from './toolRegistry.js';
+export * from './transportDeliveryTools.js';
+export * from './workSupervisedTools.js';
+//# sourceMappingURL=index.d.ts.map

package/build/server/platform/supervision/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/supervision/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wCAAwC,CAAC;AACvD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC"}

package/build/server/platform/supervision/index.js

@@ -0,0 +1,25 @@
+export * from './approvalRequests.js';
+export * from './capabilityAssessment.js';
+export * from './budget.js';
+export * from './cancellation.js';
+export * from './contracts.js';
+export * from './errors.js';
+export * from './evidenceSink.js';
+export * from './lifecycleTools.js';
+export * from './policyEngine.js';
+export * from './policySnapshots.js';
+export * from './policyVersions.js';
+export * from './providerCapabilityBootstrapConfig.js';
+export * from './providerCapabilityBootstrapDiagnostics.js';
+export * from './providerCapabilityControlKey.js';
+export * from './providerCapabilityProfiles.js';
+export * from './runProjection.js';
+export * from './runLifecycleService.js';
+export * from './runLoopHandoff.js';
+export * from './runState.js';
+export * from './runtimeBoundary.js';
+export * from './toolBoundary.js';
+export * from './toolRegistry.js';
+export * from './transportDeliveryTools.js';
+export * from './workSupervisedTools.js';
+//# sourceMappingURL=index.js.map

package/build/server/platform/supervision/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/platform/supervision/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wCAAwC,CAAC;AACvD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC"}

package/build/server/platform/supervision/lifecycleTools.d.ts

@@ -0,0 +1,27 @@
+import type { CoreStore } from '../../core/store.js';
+import { type AddressableTarget, type BudgetEnvelope, type LifecycleRequestRef, type RunRef, type SupervisedToolManifest } from './contracts.js';
+import type { SupervisedToolExecutor } from './toolBoundary.js';
+import type { SupervisedToolRegistry } from './toolRegistry.js';
+export declare const SUPERVISED_LIFECYCLE_RUN_SPAWN_TOOL: "cats.lifecycle.run.spawn";
+export interface SupervisedLifecycleRunSpawnInput {
+    title: string;
+    target: AddressableTarget;
+    parentRunId?: string;
+    conversationId?: string | null;
+    taskId?: string | null;
+    requestedBudget?: BudgetEnvelope;
+    summary?: string | null;
+}
+export interface SupervisedLifecycleTools {
+    manifests: SupervisedToolManifest[];
+    executors: {
+        [SUPERVISED_LIFECYCLE_RUN_SPAWN_TOOL]: SupervisedToolExecutor<SupervisedLifecycleRunSpawnInput, RunRef | LifecycleRequestRef>;
+    };
+    register(registry: SupervisedToolRegistry): void;
+}
+export declare function createSupervisedLifecycleTools(input: {
+    coreStore: CoreStore;
+    now?: () => Date;
+}): SupervisedLifecycleTools;
+export declare function createSupervisedLifecycleToolManifests(): SupervisedToolManifest[];
+//# sourceMappingURL=lifecycleTools.d.ts.map

package/build/server/platform/supervision/lifecycleTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleTools.d.ts","sourceRoot":"","sources":["../../../../src/platform/supervision/lifecycleTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAGL,KAAK,iBAAiB,EAEtB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,MAAM,EACX,KAAK,sBAAsB,EAC5B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EACV,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,eAAO,MAAM,mCAAmC,EAAG,0BAAmC,CAAC;AAEvF,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,SAAS,EAAE;QACT,CAAC,mCAAmC,CAAC,EAAE,sBAAsB,CAC3D,gCAAgC,EAChC,MAAM,GAAG,mBAAmB,CAC7B,CAAC;KACH,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAClD;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,SAAS,EAAE,SAAS,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB,GAAG,wBAAwB,CAc3B;AAED,wBAAgB,sCAAsC,IAAI,sBAAsB,EAAE,CA0BjF"}

package/build/server/platform/supervision/lifecycleTools.js

@@ -0,0 +1,205 @@
+import { upsertCoreRun } from '../../core/model/index.js';
+import { ADDRESSABLE_TARGET_KIND_VALUES, DEFAULT_SUPERVISION_SCHEMA_VERSION, } from './contracts.js';
+import { deriveChildBudgetEnvelope } from './budget.js';
+import { deriveRunState, writeRunStateMetadata } from './runState.js';
+export const SUPERVISED_LIFECYCLE_RUN_SPAWN_TOOL = 'cats.lifecycle.run.spawn';
+export function createSupervisedLifecycleTools(input) {
+    const manifests = createSupervisedLifecycleToolManifests();
+    return {
+        manifests,
+        executors: {
+            [SUPERVISED_LIFECYCLE_RUN_SPAWN_TOOL]: createRunSpawnExecutor(input),
+        },
+        register(registry) {
+            for (const manifest of manifests) {
+                registry.register(manifest);
+            }
+        },
+    };
+}
+export function createSupervisedLifecycleToolManifests() {
+    return [
+        {
+            schemaVersion: DEFAULT_SUPERVISION_SCHEMA_VERSION,
+            name: SUPERVISED_LIFECYCLE_RUN_SPAWN_TOOL,
+            manifestVersion: '1.0',
+            description: 'Spawn a managed child run under the supervision lifecycle scheduler.',
+            sideEffect: 'local_state',
+            preflight: 'required',
+            blocking: 'async',
+            cancellation: 'cooperative',
+            approval: 'policy',
+            evidence: 'summary',
+            failureCodes: ['E_TOOL_SCOPE_DENIED', 'E_PRECHECK_FAILED', 'E_BUDGET_EXCEEDED'],
+            inputSchema: {
+                id: `${SUPERVISED_LIFECYCLE_RUN_SPAWN_TOOL}.input`,
+                version: '1.0',
+                format: 'json_schema',
+            },
+            outputSchema: {
+                id: `${SUPERVISED_LIFECYCLE_RUN_SPAWN_TOOL}.output`,
+                version: '1.0',
+                format: 'json_schema',
+            },
+        },
+    ];
+}
+function createRunSpawnExecutor(input) {
+    return async (toolInput, context) => {
+        if (!isRunSpawnInput(toolInput)) {
+            return rejected('E_PRECHECK_FAILED', 'Invalid lifecycle run spawn input.');
+        }
+        const now = input.now?.() ?? new Date();
+        const evaluatedAt = now.toISOString();
+        const core = await input.coreStore.readCore();
+        const parentRunId = toolInput.parentRunId ?? context.runId;
+        const parentRun = core.runs.find((candidate) => candidate.id === parentRunId) ?? null;
+        if (!parentRun) {
+            return rejected('E_PRECHECK_FAILED', `Parent run not found: ${parentRunId}`);
+        }
+        if (!isSameOrDescendantRun(core.runs, parentRun.id, context.runId)) {
+            return rejected('E_PRECHECK_FAILED', `Parent run ${parentRun.id} is outside the delegating run tree: ${context.runId}`);
+        }
+        const ancestry = resolveRunAncestry(core.runs, parentRun.id);
+        if (ancestry.hasCycle) {
+            return rejected('E_PRECHECK_FAILED', `Run delegation cycle detected at parent run: ${parentRun.id}`);
+        }
+        const parentBudget = readRunBudget(parentRun);
+        if (!parentBudget) {
+            return rejected('E_BUDGET_EXCEEDED', `Parent run has no supervision budget: ${parentRunId}`);
+        }
+        const budget = deriveChildBudgetEnvelope({
+            parent: parentBudget,
+            requested: toolInput.requestedBudget,
+            defaults: {
+                hardStop: true,
+            },
+        });
+        const runState = deriveRunState({ lifecycle: 'queued' });
+        const next = upsertCoreRun(core, {
+            title: toolInput.title,
+            status: 'queued',
+            conversationId: toolInput.conversationId ?? parentRun.conversationId,
+            taskId: toolInput.taskId === undefined ? null : toolInput.taskId,
+            parentRunId: parentRun.id,
+            orchestratorActorId: context.actorRef,
+            summary: toolInput.summary ?? 'Queued supervised child run.',
+            createdAt: evaluatedAt,
+            metadata: writeRunStateMetadata({
+                metadata: {
+                    supervision: {
+                        source: 'supervised_lifecycle_run_spawn',
+                        parentRunId: parentRun.id,
+                        parentActionId: context.actionId,
+                        target: toolInput.target,
+                        budget,
+                        budgetSource: 'parent_run_cap',
+                        delegation: {
+                            requestedByRunId: context.runId,
+                            parentRunId: parentRun.id,
+                            ancestryDepth: ancestry.ancestorIds.length,
+                        },
+                        toolScope: {
+                            parentToolScope: context.grant.parentToolScope,
+                            policyToolScope: context.grant.policyToolScope,
+                            effectiveToolScope: context.effectiveToolScope,
+                        },
+                    },
+                },
+                evaluation: runState,
+                evaluatedAt,
+            }),
+        }, now);
+        const persisted = await input.coreStore.writeCore(next.core);
+        const childRun = persisted.runs.find((candidate) => candidate.id === next.run.id) ?? next.run;
+        return {
+            status: 'applied',
+            result: {
+                kind: 'run',
+                runId: childRun.id,
+                parentRunId: parentRun.id,
+            },
+        };
+    };
+}
+function readRunBudget(run) {
+    const metadata = asRecord(run.metadata);
+    const supervision = asRecord(metadata?.supervision);
+    return readBudgetEnvelope(supervision?.budget) ??
+        readBudgetEnvelope(metadata?.supervisionBudget);
+}
+function readBudgetEnvelope(value) {
+    const record = asRecord(value);
+    if (!record) {
+        return undefined;
+    }
+    const budget = {
+        ...readFiniteNumberProperty(record, 'maxCostUsd'),
+        ...readFiniteNumberProperty(record, 'maxTokens'),
+        ...readFiniteNumberProperty(record, 'maxDurationMs'),
+        ...(typeof record.hardStop === 'boolean' ? { hardStop: record.hardStop } : {}),
+    };
+    return Object.keys(budget).length > 0 ? budget : undefined;
+}
+function readFiniteNumberProperty(record, key) {
+    const value = record[key];
+    return typeof value === 'number' && Number.isFinite(value)
+        ? { [key]: value }
+        : {};
+}
+function isRunSpawnInput(value) {
+    const record = asRecord(value);
+    return record !== null &&
+        typeof record.title === 'string' &&
+        record.title.trim() !== '' &&
+        isAddressableTarget(record.target) &&
+        (record.parentRunId === undefined || typeof record.parentRunId === 'string') &&
+        (record.conversationId === undefined ||
+            record.conversationId === null ||
+            typeof record.conversationId === 'string') &&
+        (record.taskId === undefined || record.taskId === null || typeof record.taskId === 'string') &&
+        (record.requestedBudget === undefined || readBudgetEnvelope(record.requestedBudget) !== undefined) &&
+        (record.summary === undefined || record.summary === null || typeof record.summary === 'string');
+}
+function isAddressableTarget(value) {
+    const record = asRecord(value);
+    return record !== null &&
+        typeof record.kind === 'string' &&
+        ADDRESSABLE_TARGET_KIND_VALUES.includes(record.kind);
+}
+function isSameOrDescendantRun(runs, candidateRunId, rootRunId) {
+    if (candidateRunId === rootRunId) {
+        return true;
+    }
+    return resolveRunAncestry(runs, candidateRunId).ancestorIds.includes(rootRunId);
+}
+function resolveRunAncestry(runs, runId) {
+    const runsById = new Map(runs.map((run) => [run.id, run]));
+    const ancestorIds = [];
+    const seen = new Set([runId]);
+    let current = runsById.get(runId)?.parentRunId ?? null;
+    while (current) {
+        if (seen.has(current)) {
+            return { ancestorIds, hasCycle: true };
+        }
+        seen.add(current);
+        ancestorIds.push(current);
+        current = runsById.get(current)?.parentRunId ?? null;
+    }
+    return { ancestorIds, hasCycle: false };
+}
+function rejected(code, message) {
+    return {
+        status: 'rejected',
+        error: {
+            code,
+            message,
+        },
+    };
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+//# sourceMappingURL=lifecycleTools.js.map

package/build/server/platform/supervision/lifecycleTools.js.map

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

package/build/server/platform/supervision/policyEngine.d.ts

@@ -0,0 +1,40 @@
+import type { CapabilityAssessment, SupervisedToolManifest, SupervisedToolSideEffect, SupervisionApprovalThreshold, SupervisionPolicy, SupervisionPolicySnapshot, SupervisionToolScope, ToolResult } from './contracts.js';
+export interface SupervisionPolicyOverride {
+    overrideId: string;
+    operatorRef: string;
+    reason: string;
+    policy: Partial<SupervisionPolicy>;
+}
+export interface SupervisionPolicyContext {
+    actionId: string;
+    runId: string;
+    actorRef: string;
+    targetRef: string;
+    providerRef?: string;
+    actionType: string;
+    evaluatedAt: string;
+    capabilityAssessment: CapabilityAssessment;
+    toolManifest: SupervisedToolManifest;
+    deliveryObservability?: string;
+    budgetState?: string;
+    approvalState?: string;
+    recentReliability?: string;
+    requestedPolicy?: Partial<SupervisionPolicy>;
+    operatorOverride?: SupervisionPolicyOverride;
+    experimentId?: string;
+}
+export interface SupervisionPolicyDecision {
+    policy: SupervisionPolicy;
+    snapshot: SupervisionPolicySnapshot;
+}
+export interface SupervisionPolicyRejectionDetails {
+    snapshot: SupervisionPolicySnapshot;
+}
+export type SupervisionPolicyDecisionResult = ToolResult<SupervisionPolicyDecision>;
+export declare function decideSupervisionPolicy(context: SupervisionPolicyContext): SupervisionPolicyDecisionResult;
+export declare function decideDefaultToolScope(input: {
+    bootstrapTreatment: CapabilityAssessment['bootstrapTreatment'];
+    sideEffect: SupervisedToolSideEffect;
+}): SupervisionToolScope;
+export declare function decideDefaultApprovalThreshold(sideEffect: SupervisedToolSideEffect): SupervisionApprovalThreshold;
+//# sourceMappingURL=policyEngine.d.ts.map

package/build/server/platform/supervision/policyEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policyEngine.d.ts","sourceRoot":"","sources":["../../../../src/platform/supervision/policyEngine.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAI5B,iBAAiB,EACjB,yBAAyB,EAGzB,oBAAoB,EAEpB,UAAU,EACX,MAAM,gBAAgB,CAAC;AAiIxB,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,YAAY,EAAE,sBAAsB,CAAC;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC7C,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,yBAAyB,CAAC;CACrC;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,yBAAyB,CAAC;CACrC;AAED,MAAM,MAAM,+BAA+B,GAAG,UAAU,CAAC,yBAAyB,CAAC,CAAC;AAEpF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,+BAA+B,CA+CjC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,kBAAkB,EAAE,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAC/D,UAAU,EAAE,wBAAwB,CAAC;CACtC,GAAG,oBAAoB,CAQvB;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,wBAAwB,GACnC,4BAA4B,CAe9B"}