@ornexus/neocortex 4.60.49 → 4.60.51

package/packages/client/dist/commands/native-agent.d.ts

@@ -0,0 +1 @@
+export declare function nativeAgentCliHandler(args: readonly string[]): Promise<number>;

package/packages/client/dist/commands/native-agent.js

@@ -0,0 +1,2 @@
+import{isNativeDispatchBindingV1 as b,isNativeHostAttestationV1 as A}from"../continuity/native-agent-types.js";import{deriveOpaqueNativeAgentHandle as v,openNativeAgentPrivateStore as m}from"../continuity/native-agent-store.js";const k=64*1024,E=new Set(["requested","spawned","running","completed","failed","interrupted","unknown","lost"]),g=new Set(["native-agent","headless-process","inline"]),N=new Set(["fresh","stale","unknown"]),H=new Set(["host-event","host-list","bounded-poll","local-reservation"]);function l(t,o){const i=t.indexOf(o);return i>=0?t[i+1]:void 0}function h(t,o,i=[]){const n=new Set([...o,...i]);return o.every(a=>Object.prototype.hasOwnProperty.call(t,a))&&Object.keys(t).every(a=>n.has(a))}async function w(){const t=[];let o=0;for await(const n of process.stdin){const a=Buffer.isBuffer(n)?n:Buffer.from(String(n));if(o+=a.length,o>k)throw new Error("native-agent-input-too-large");t.push(a)}const i=JSON.parse(Buffer.concat(t).toString("utf8"));if(!i||typeof i!="object"||Array.isArray(i))throw new Error("native-agent-input-invalid");return i}function r(t){process.stdout.write(`${JSON.stringify(t)}
+`)}function O(t){return t&&typeof t=="object"&&"code"in t&&typeof t.code=="string"?t.code:t instanceof SyntaxError?"native-agent-input-invalid":t instanceof Error&&/^native-agent-[a-z0-9-]+$/.test(t.message)?t.message:"native-agent-operation-failed"}async function C(t){const o=t[0],i=l(t,"--project-root")??process.cwd();let n;try{if(o!=="reserve"&&o!=="observe"&&o!=="status")return r({ok:!1,reasonCode:"native-agent-action-invalid",publicSafe:!0}),1;if(n=await m(i),o==="reserve"){const e=await w();if(!h(e,["directiveKind","supportsTaskDelegation","taskDelegationCapability","binding","hostAttestation"],["requestedAt","topology"]))throw new Error("native-agent-input-invalid");if(e.directiveKind!=="task"||e.supportsTaskDelegation!==!0||e.taskDelegationCapability!=="native_safe"||!b(e.binding)||!A(e.hostAttestation))throw new Error("native-agent-dispatch-not-authorized");const s=e.topology??"native-agent";if(!g.has(s))throw new Error("native-agent-input-invalid");const c=n.store.reserveNativeAgentDispatch({binding:e.binding,hostAttestation:e.hostAttestation,requestedAt:typeof e.requestedAt=="string"?e.requestedAt:new Date().toISOString(),topology:s});return r({ok:!0,authorized:!0,action:c.reserved?"spawn-once":"reconcile-existing",...c,publicSafe:!0}),0}if(o==="observe"){const e=await w();if(!h(e,["dispatchKey","expectedRevision","state","topology","observedAt","freshness","observationSource","reasonCode"],["rawHandle","rawParentHandle","terminalAt"]))throw new Error("native-agent-input-invalid");const s=e.state,c=e.topology,u=e.freshness,d=e.observationSource;if(!E.has(s)||!g.has(c)||!N.has(u)||!H.has(d))throw new Error("native-agent-input-invalid");const p=typeof e.rawHandle=="string"?e.rawHandle:null,f=typeof e.rawParentHandle=="string"?e.rawParentHandle:null,y=n.store.observeNativeAgentDispatch({dispatchKey:String(e.dispatchKey),expectedRevision:Number(e.expectedRevision),state:s,handle:p?v(p,n.paths.handleKeyPath):null,parentHandle:f?v(f,n.paths.handleKeyPath):null,topology:c,observedAt:String(e.observedAt),terminalAt:e.terminalAt===null||typeof e.terminalAt=="string"?e.terminalAt:void 0,freshness:u,observationSource:d,reasonCode:String(e.reasonCode)});return r({ok:!0,...y,publicSafe:!0}),0}const a=l(t,"--dispatch-key"),S=Number(l(t,"--stale-after-ms")??3e4);if(a){const e=n.store.getNativeAgentDispatchStatus(a,{staleAfterMs:S});r({ok:!0,receipt:e,publicSafe:!0})}else{const e=n.store.listRecentNativeAgentDispatches(Number(l(t,"--limit")??20));r({ok:!0,receipts:e,publicSafe:!0})}return 0}catch(a){return r({ok:!1,reasonCode:O(a),publicSafe:!0}),1}finally{n?.store.close()}}export{C as nativeAgentCliHandler};

package/packages/client/dist/continuity/migrations/006-native-agent-dispatches.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Public-safe native-agent dispatch reservation and immutable observations.
+ * Raw runtime handles, prompts and logs are deliberately absent.
+ */
+export declare const NATIVE_AGENT_DISPATCHES_SQLITE_MIGRATION: Readonly<{
+    readonly version: 6;
+    readonly name: "native-agent-dispatches";
+    readonly sql: "\nCREATE TABLE IF NOT EXISTS native_agent_dispatches (\n  dispatch_key TEXT PRIMARY KEY CHECK (dispatch_key GLOB 'sha256:*' AND length(dispatch_key) = 71),\n  story_id TEXT NOT NULL,\n  graph_revision TEXT NOT NULL CHECK (length(graph_revision) = 64),\n  profile TEXT NOT NULL CHECK (profile = 'neocortex'),\n  host_kind TEXT NOT NULL CHECK (host_kind IN ('codex-cli', 'codex-desktop', 'unknown')),\n  host_version TEXT,\n  host_origin TEXT NOT NULL CHECK (host_origin IN ('runtime-attested', 'host-observed', 'environment', 'explicit-override', 'unknown')),\n  host_confidence TEXT NOT NULL CHECK (host_confidence IN ('attested', 'observed', 'inferred', 'unknown')),\n  parent_handle TEXT CHECK (parent_handle IS NULL OR (parent_handle GLOB 'agt_*' AND length(parent_handle) BETWEEN 28 AND 68)),\n  handle TEXT CHECK (handle IS NULL OR (handle GLOB 'agt_*' AND length(handle) BETWEEN 28 AND 68)),\n  topology TEXT NOT NULL CHECK (topology IN ('native-agent', 'headless-process', 'inline')),\n  state TEXT NOT NULL CHECK (state IN ('requested', 'spawned', 'running', 'completed', 'failed', 'interrupted', 'unknown', 'lost')),\n  requested_at TEXT NOT NULL,\n  observed_at TEXT,\n  terminal_at TEXT,\n  freshness TEXT NOT NULL CHECK (freshness IN ('fresh', 'stale', 'unknown')),\n  observation_source TEXT NOT NULL CHECK (observation_source IN ('host-event', 'host-list', 'bounded-poll', 'local-reservation')),\n  reason_code TEXT NOT NULL,\n  revision INTEGER NOT NULL DEFAULT 0 CHECK (revision >= 0),\n  public_safe INTEGER NOT NULL DEFAULT 1 CHECK (public_safe = 1),\n  UNIQUE (story_id, graph_revision)\n);\n\nCREATE INDEX IF NOT EXISTS idx_native_agent_dispatches_state_observed\n  ON native_agent_dispatches(state, observed_at, dispatch_key);\n\nCREATE TABLE IF NOT EXISTS native_agent_observations (\n  dispatch_key TEXT NOT NULL,\n  sequence INTEGER NOT NULL CHECK (sequence > 0),\n  state TEXT NOT NULL CHECK (state IN ('requested', 'spawned', 'running', 'completed', 'failed', 'interrupted', 'unknown', 'lost')),\n  handle TEXT CHECK (handle IS NULL OR (handle GLOB 'agt_*' AND length(handle) BETWEEN 28 AND 68)),\n  parent_handle TEXT CHECK (parent_handle IS NULL OR (parent_handle GLOB 'agt_*' AND length(parent_handle) BETWEEN 28 AND 68)),\n  topology TEXT NOT NULL CHECK (topology IN ('native-agent', 'headless-process', 'inline')),\n  observed_at TEXT NOT NULL,\n  terminal_at TEXT,\n  freshness TEXT NOT NULL CHECK (freshness IN ('fresh', 'stale', 'unknown')),\n  observation_source TEXT NOT NULL CHECK (observation_source IN ('host-event', 'host-list', 'bounded-poll', 'local-reservation')),\n  reason_code TEXT NOT NULL,\n  public_safe INTEGER NOT NULL DEFAULT 1 CHECK (public_safe = 1),\n  PRIMARY KEY (dispatch_key, sequence),\n  FOREIGN KEY (dispatch_key) REFERENCES native_agent_dispatches(dispatch_key) ON DELETE RESTRICT\n);\n\nCREATE INDEX IF NOT EXISTS idx_native_agent_observations_dispatch_observed\n  ON native_agent_observations(dispatch_key, observed_at, sequence);\n";
+}>;

package/packages/client/dist/continuity/migrations/006-native-agent-dispatches.js

@@ -0,0 +1,48 @@
+const e=Object.freeze({version:6,name:"native-agent-dispatches",sql:`
+CREATE TABLE IF NOT EXISTS native_agent_dispatches (
+  dispatch_key TEXT PRIMARY KEY CHECK (dispatch_key GLOB 'sha256:*' AND length(dispatch_key) = 71),
+  story_id TEXT NOT NULL,
+  graph_revision TEXT NOT NULL CHECK (length(graph_revision) = 64),
+  profile TEXT NOT NULL CHECK (profile = 'neocortex'),
+  host_kind TEXT NOT NULL CHECK (host_kind IN ('codex-cli', 'codex-desktop', 'unknown')),
+  host_version TEXT,
+  host_origin TEXT NOT NULL CHECK (host_origin IN ('runtime-attested', 'host-observed', 'environment', 'explicit-override', 'unknown')),
+  host_confidence TEXT NOT NULL CHECK (host_confidence IN ('attested', 'observed', 'inferred', 'unknown')),
+  parent_handle TEXT CHECK (parent_handle IS NULL OR (parent_handle GLOB 'agt_*' AND length(parent_handle) BETWEEN 28 AND 68)),
+  handle TEXT CHECK (handle IS NULL OR (handle GLOB 'agt_*' AND length(handle) BETWEEN 28 AND 68)),
+  topology TEXT NOT NULL CHECK (topology IN ('native-agent', 'headless-process', 'inline')),
+  state TEXT NOT NULL CHECK (state IN ('requested', 'spawned', 'running', 'completed', 'failed', 'interrupted', 'unknown', 'lost')),
+  requested_at TEXT NOT NULL,
+  observed_at TEXT,
+  terminal_at TEXT,
+  freshness TEXT NOT NULL CHECK (freshness IN ('fresh', 'stale', 'unknown')),
+  observation_source TEXT NOT NULL CHECK (observation_source IN ('host-event', 'host-list', 'bounded-poll', 'local-reservation')),
+  reason_code TEXT NOT NULL,
+  revision INTEGER NOT NULL DEFAULT 0 CHECK (revision >= 0),
+  public_safe INTEGER NOT NULL DEFAULT 1 CHECK (public_safe = 1),
+  UNIQUE (story_id, graph_revision)
+);
+
+CREATE INDEX IF NOT EXISTS idx_native_agent_dispatches_state_observed
+  ON native_agent_dispatches(state, observed_at, dispatch_key);
+
+CREATE TABLE IF NOT EXISTS native_agent_observations (
+  dispatch_key TEXT NOT NULL,
+  sequence INTEGER NOT NULL CHECK (sequence > 0),
+  state TEXT NOT NULL CHECK (state IN ('requested', 'spawned', 'running', 'completed', 'failed', 'interrupted', 'unknown', 'lost')),
+  handle TEXT CHECK (handle IS NULL OR (handle GLOB 'agt_*' AND length(handle) BETWEEN 28 AND 68)),
+  parent_handle TEXT CHECK (parent_handle IS NULL OR (parent_handle GLOB 'agt_*' AND length(parent_handle) BETWEEN 28 AND 68)),
+  topology TEXT NOT NULL CHECK (topology IN ('native-agent', 'headless-process', 'inline')),
+  observed_at TEXT NOT NULL,
+  terminal_at TEXT,
+  freshness TEXT NOT NULL CHECK (freshness IN ('fresh', 'stale', 'unknown')),
+  observation_source TEXT NOT NULL CHECK (observation_source IN ('host-event', 'host-list', 'bounded-poll', 'local-reservation')),
+  reason_code TEXT NOT NULL,
+  public_safe INTEGER NOT NULL DEFAULT 1 CHECK (public_safe = 1),
+  PRIMARY KEY (dispatch_key, sequence),
+  FOREIGN KEY (dispatch_key) REFERENCES native_agent_dispatches(dispatch_key) ON DELETE RESTRICT
+);
+
+CREATE INDEX IF NOT EXISTS idx_native_agent_observations_dispatch_observed
+  ON native_agent_observations(dispatch_key, observed_at, sequence);
+`});export{e as NATIVE_AGENT_DISPATCHES_SQLITE_MIGRATION};

package/packages/client/dist/continuity/native-agent-store.d.ts

@@ -0,0 +1,13 @@
+import { type OpenContinuitySqliteStoreOptions } from './sqlite-store.js';
+export interface NativeAgentPrivateRuntimePaths {
+    readonly commonDir: string;
+    readonly runtimeDir: string;
+    readonly databasePath: string;
+    readonly handleKeyPath: string;
+}
+export declare function resolveNativeAgentPrivateRuntimePaths(projectRoot: string): NativeAgentPrivateRuntimePaths;
+export declare function deriveOpaqueNativeAgentHandle(rawHandle: string, handleKeyPath: string): string;
+export declare function openNativeAgentPrivateStore(projectRoot: string, options?: Omit<OpenContinuitySqliteStoreOptions, 'projectRoot' | 'filePath'>): Promise<Readonly<{
+    store: import("./sqlite-store.js").ContinuitySqliteStore;
+    paths: NativeAgentPrivateRuntimePaths;
+}>>;

package/packages/client/dist/continuity/native-agent-store.js

@@ -0,0 +1 @@
+import{createHmac as c,randomBytes as m}from"node:crypto";import{execFileSync as s}from"node:child_process";import{chmodSync as o,existsSync as a,mkdirSync as u,readFileSync as d,writeFileSync as f}from"node:fs";import{isAbsolute as h,join as i,resolve as l}from"node:path";import{openContinuitySqliteStore as y}from"./sqlite-store.js";const v="neocortex-runtime/native-agent",g="continuity.sqlite",P="handle-key",A=/^[^\r\n\0]{1,256}$/;function S(e){const t=s("git",["rev-parse","--path-format=absolute","--git-common-dir"],{cwd:e,encoding:"utf8",timeout:3e3,stdio:["ignore","pipe","ignore"]}).trim();if(!t||/[\r\n\0]/.test(t))throw new Error("native-agent-git-common-dir-unavailable");const n=h(t)?t:l(e,t),r=i(n,v);return Object.freeze({commonDir:n,runtimeDir:r,databasePath:i(r,g),handleKeyPath:i(r,P)})}function w(e){u(e.runtimeDir,{recursive:!0,mode:448});try{o(e.runtimeDir,448)}catch{}if(!a(e.handleKeyPath))try{f(e.handleKeyPath,m(32).toString("hex"),{encoding:"utf8",flag:"wx",mode:384})}catch(t){if(!a(e.handleKeyPath))throw t}try{o(e.handleKeyPath,384)}catch{}}function _(e,t){if(!A.test(e))throw new Error("native-agent-raw-handle-invalid");const n=d(t,"utf8").trim();if(!/^[a-f0-9]{64}$/i.test(n))throw new Error("native-agent-handle-key-invalid");return`agt_${c("sha256",Buffer.from(n,"hex")).update(e,"utf8").digest("hex")}`}async function K(e,t={}){const n=S(e);w(n);const r=await y({...t,projectRoot:e,filePath:n.databasePath});return Object.freeze({store:r,paths:n})}export{_ as deriveOpaqueNativeAgentHandle,K as openNativeAgentPrivateStore,S as resolveNativeAgentPrivateRuntimePaths};

package/packages/client/dist/continuity/native-agent-types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Client SSoT shadow of the public native-agent wire contract.
+ * Keep synchronized with packages/shared/src/yoloop/native-agent-observation.ts;
+ * the published client cannot resolve the private workspace package at runtime.
+ */
+export type NativeHostKind = 'codex-cli' | 'codex-desktop' | 'unknown';
+export type NativeHostAttestationOrigin = 'runtime-attested' | 'host-observed' | 'environment' | 'explicit-override' | 'unknown';
+export type NativeHostAttestationConfidence = 'attested' | 'observed' | 'inferred' | 'unknown';
+export interface NativeHostAttestationV1 {
+    readonly schemaVersion: 1;
+    readonly platformTarget: 'codex';
+    readonly hostKind: NativeHostKind;
+    readonly hostVersion: string | null;
+    readonly origin: NativeHostAttestationOrigin;
+    readonly confidence: NativeHostAttestationConfidence;
+    readonly publicSafe: true;
+}
+export interface NativeDispatchBindingV1 {
+    readonly schemaVersion: 1;
+    readonly storyId: string;
+    readonly graphRevision: string;
+    readonly dispatchKey: string;
+    readonly requiredCapability: 'native_safe';
+    readonly maxDepth: 1;
+    readonly publicSafe: true;
+}
+export type NativeAgentState = 'requested' | 'spawned' | 'running' | 'completed' | 'failed' | 'interrupted' | 'unknown' | 'lost';
+export type NativeAgentTopology = 'native-agent' | 'headless-process' | 'inline';
+export type NativeAgentFreshness = 'fresh' | 'stale' | 'unknown';
+export type NativeAgentObservationSource = 'host-event' | 'host-list' | 'bounded-poll' | 'local-reservation';
+export interface NativeAgentDispatchReceiptV1 {
+    readonly schemaVersion: 1;
+    readonly storyId: string;
+    readonly graphRevision: string;
+    readonly dispatchKey: string;
+    readonly profile: 'neocortex';
+    readonly parentHandle: string | null;
+    readonly handle: string | null;
+    readonly topology: NativeAgentTopology;
+    readonly state: NativeAgentState;
+    readonly requestedAt: string;
+    readonly observedAt: string | null;
+    readonly terminalAt: string | null;
+    readonly freshness: NativeAgentFreshness;
+    readonly observationSource: NativeAgentObservationSource;
+    readonly reasonCode: string;
+    readonly revision: number;
+    readonly publicSafe: true;
+}
+export declare const NATIVE_AGENT_TERMINAL_STATES: ReadonlySet<NativeAgentState>;
+export declare function isNativeHostAttestationV1(value: unknown): value is NativeHostAttestationV1;
+export declare function isNativeDispatchBindingV1(value: unknown): value is NativeDispatchBindingV1;
+export declare function isNativeAgentDispatchReceiptV1(value: unknown): value is NativeAgentDispatchReceiptV1;
+export declare function isNativeAgentStateTransitionAllowed(previous: NativeAgentState, next: NativeAgentState): boolean;

package/packages/client/dist/continuity/native-agent-types.js

@@ -0,0 +1 @@
+const S=["requested","spawned","running","completed","failed","interrupted","unknown","lost"],l=["native-agent","headless-process","inline"],g=["fresh","stale","unknown"],y=["host-event","host-list","bounded-poll","local-reservation"],m=["codex-cli","codex-desktop","unknown"],A=["runtime-attested","host-observed","environment","explicit-override","unknown"],u=["attested","observed","inferred","unknown"],w=new Set(["completed","failed","interrupted"]),d=/^[A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)+$/,c=/^(?:sha256:)?[a-f0-9]{64}$/i,p=/^sha256:[a-f0-9]{64}$/i,f=/^agt_[a-f0-9]{24,64}$/i,b=/^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$/,I=/^[a-z0-9][a-z0-9-]{0,95}$/;function n(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function s(e,t){const o=Object.keys(e).sort(),i=[...t].sort();return o.length===i.length&&o.every((a,h)=>a===i[h])}function r(e){return typeof e=="string"&&e.length>=20&&e.length<=40&&Number.isFinite(Date.parse(e))}function T(e){return!n(e)||!s(e,["schemaVersion","platformTarget","hostKind","hostVersion","origin","confidence","publicSafe"])?!1:e.schemaVersion===1&&e.platformTarget==="codex"&&m.includes(e.hostKind)&&(e.hostVersion===null||typeof e.hostVersion=="string"&&b.test(e.hostVersion))&&A.includes(e.origin)&&u.includes(e.confidence)&&e.publicSafe===!0}function E(e){return!n(e)||!s(e,["schemaVersion","storyId","graphRevision","dispatchKey","requiredCapability","maxDepth","publicSafe"])?!1:e.schemaVersion===1&&typeof e.storyId=="string"&&d.test(e.storyId)&&typeof e.graphRevision=="string"&&c.test(e.graphRevision)&&typeof e.dispatchKey=="string"&&p.test(e.dispatchKey)&&e.requiredCapability==="native_safe"&&e.maxDepth===1&&e.publicSafe===!0}function R(e){if(!n(e)||!s(e,["schemaVersion","storyId","graphRevision","dispatchKey","profile","parentHandle","handle","topology","state","requestedAt","observedAt","terminalAt","freshness","observationSource","reasonCode","revision","publicSafe"]))return!1;const t=e.state;return e.schemaVersion!==1||typeof e.storyId!="string"||!d.test(e.storyId)||typeof e.graphRevision!="string"||!c.test(e.graphRevision)||typeof e.dispatchKey!="string"||!p.test(e.dispatchKey)||e.profile!=="neocortex"||e.parentHandle!==null&&(typeof e.parentHandle!="string"||!f.test(e.parentHandle))||e.handle!==null&&(typeof e.handle!="string"||!f.test(e.handle))||!l.includes(e.topology)||!S.includes(t)||!r(e.requestedAt)||e.observedAt!==null&&!r(e.observedAt)||e.terminalAt!==null&&!r(e.terminalAt)||!g.includes(e.freshness)||!y.includes(e.observationSource)||typeof e.reasonCode!="string"||!I.test(e.reasonCode)||typeof e.revision!="number"||!Number.isSafeInteger(e.revision)||e.revision<0||e.publicSafe!==!0?!1:t==="requested"?e.handle===null&&e.observedAt===null&&e.terminalAt===null&&e.freshness==="unknown"&&e.observationSource==="local-reservation":!(e.observationSource==="local-reservation"||(t==="spawned"||t==="running")&&(e.handle===null||e.freshness!=="fresh")||w.has(t)!==(e.terminalAt!==null))}const N={requested:new Set(["requested","spawned","failed","interrupted","unknown"]),spawned:new Set(["spawned","running","completed","failed","interrupted","unknown","lost"]),running:new Set(["running","completed","failed","interrupted","unknown","lost"]),unknown:new Set(["unknown","spawned","running","completed","failed","interrupted","lost"]),lost:new Set(["lost","running","completed","failed","interrupted"]),completed:new Set(["completed"]),failed:new Set(["failed"]),interrupted:new Set(["interrupted"])};function V(e,t){return N[e].has(t)}export{w as NATIVE_AGENT_TERMINAL_STATES,R as isNativeAgentDispatchReceiptV1,V as isNativeAgentStateTransitionAllowed,E as isNativeDispatchBindingV1,T as isNativeHostAttestationV1};

package/packages/client/dist/continuity/sqlite-store.d.ts

@@ -4,10 +4,11 @@
  *
  * P180.04 -- Local SQLite continuity store, migrations and integrity checks.
  */
+import { type NativeAgentDispatchReceiptV1, type NativeAgentFreshness, type NativeAgentObservationSource, type NativeAgentState, type NativeAgentTopology, type NativeDispatchBindingV1, type NativeHostAttestationV1 } from './native-agent-types.js';
 import { CONTINUITY_RECEIPT_COMPACTION_EVENT_TYPE, CONTINUITY_RECEIPT_RETENTION_REASON_CODES, type ContinuityQueuePolicy, type ContinuityQueueScope, type ContinuityOutboxRetryPolicy, type ContinuityOutboxStatus, type ContinuityRetentionPolicyInput } from './outbox.js';
 export declare const CONTINUITY_SQLITE_RELATIVE_DIR: ".neocortex/continuity";
 export declare const CONTINUITY_SQLITE_FILENAME: "continuity.sqlite";
-export declare const CONTINUITY_SQLITE_SCHEMA_VERSION: 5;
+export declare const CONTINUITY_SQLITE_SCHEMA_VERSION: 6;
 export declare const DEFAULT_CONTINUITY_SQLITE_BUSY_TIMEOUT_MS = 5000;
 export declare const CONTINUITY_PROCESSING_OUTPUT_SUMMARY_EVENT_TYPE: "processing_output_summary";
 export declare const CONTINUITY_PROCESSING_OUTPUT_SUMMARY_MAX_CHARS: 2000;
@@ -96,6 +97,8 @@ export type ContinuitySqliteAdapterLoadResult = {
 export type ContinuitySqliteDynamicImporter = (specifier: string) => Promise<unknown>;
 export interface OpenContinuitySqliteStoreOptions {
     readonly projectRoot: string;
+    /** Optional private runtime path; default remains the compatibility project store. */
+    readonly filePath?: string;
     readonly adapter?: ContinuitySqliteAdapter;
     readonly adapterLoader?: () => Promise<ContinuitySqliteAdapterLoadResult>;
     readonly busyTimeoutMs?: number;
@@ -356,6 +359,36 @@ export interface ContinuitySqliteWriteResult {
     readonly replay: boolean;
     readonly changes: number;
 }
+export interface NativeAgentDispatchReservationInput {
+    readonly binding: NativeDispatchBindingV1;
+    readonly hostAttestation: NativeHostAttestationV1;
+    readonly requestedAt: string;
+    readonly topology?: NativeAgentTopology;
+    readonly reasonCode?: string;
+}
+export interface NativeAgentDispatchReservationResult {
+    readonly receipt: NativeAgentDispatchReceiptV1;
+    readonly reserved: boolean;
+    readonly replay: boolean;
+}
+export interface NativeAgentObservationInput {
+    readonly dispatchKey: string;
+    readonly expectedRevision: number;
+    readonly state: NativeAgentState;
+    readonly handle: string | null;
+    readonly parentHandle?: string | null;
+    readonly topology: NativeAgentTopology;
+    readonly observedAt: string;
+    readonly terminalAt?: string | null;
+    readonly freshness: NativeAgentFreshness;
+    readonly observationSource: NativeAgentObservationSource;
+    readonly reasonCode: string;
+}
+export interface NativeAgentObservationResult {
+    readonly receipt: NativeAgentDispatchReceiptV1;
+    readonly applied: boolean;
+    readonly replay: boolean;
+}
 export interface ContinuityJobStatusUpdateInput {
     readonly jobId: string;
     readonly status: string;
@@ -839,7 +872,7 @@ export interface ContinuityOutboxRetryResult {
     readonly reasonCode: string;
     readonly publicSafe: true;
 }
-declare const CONTINUITY_TABLES: readonly ["continuity_migrations", "jobs", "job_leases", "job_events", "job_receipts", "goal_campaigns", "goal_ledger_items", "goal_verifiers", "goal_review_gates", "loop_jobs", "artifacts", "state_snapshots", "headless_execution_attempts", "runner_config", "outbox"];
+declare const CONTINUITY_TABLES: readonly ["continuity_migrations", "jobs", "job_leases", "job_events", "job_receipts", "goal_campaigns", "goal_ledger_items", "goal_verifiers", "goal_review_gates", "loop_jobs", "artifacts", "state_snapshots", "headless_execution_attempts", "runner_config", "outbox", "native_agent_dispatches", "native_agent_observations"];
 export type ContinuitySqliteTable = (typeof CONTINUITY_TABLES)[number];
 export declare function loadBetterSqlite3Adapter(importer?: ContinuitySqliteDynamicImporter): Promise<ContinuitySqliteAdapterLoadResult>;
 export declare function continuitySqliteStorePath(projectRoot: string): string;
@@ -872,6 +905,14 @@ export declare class ContinuitySqliteStore {
     runIntegrityCheck(): void;
     getSchemaVersion(): number;
     countRows(table: ContinuitySqliteTable): number;
+    reserveNativeAgentDispatch(input: NativeAgentDispatchReservationInput): NativeAgentDispatchReservationResult;
+    observeNativeAgentDispatch(input: NativeAgentObservationInput): NativeAgentObservationResult;
+    getNativeAgentDispatchStatus(dispatchKey: string, options?: {
+        readonly nowIso?: string;
+        readonly staleAfterMs?: number;
+    }): NativeAgentDispatchReceiptV1 | null;
+    listRecentNativeAgentDispatches(limit?: number): readonly NativeAgentDispatchReceiptV1[];
+    private findNativeAgentDispatchRow;
     getLocalConsoleAttachmentState(jobId: string): ContinuityLocalConsoleAttachmentState | null;
     recordJob(input: ContinuityJobWriteInput): ContinuitySqliteWriteResult;
     appendEvent(input: ContinuityEventWriteInput): ContinuitySqliteWriteResult;