@0xmaxma/claude-gateway 2.0.9 → 2.0.11

package/dist/orchestration/live-execution-input.d.ts

@@ -0,0 +1,26 @@
+import { AcceptInput, OrchestrationStore } from './store';
+import { TaskService } from './tasks/service';
+import { ExecutionCapabilities, TaskSnapshot } from './types';
+export interface LiveControlReceipt {
+    inputId: string;
+    taskId?: string;
+    status: 'applied' | 'needs_agent';
+    code?: string;
+    revision?: number;
+}
+export declare function liveControlReceipt(store: OrchestrationStore, inputId: string): LiveControlReceipt | undefined;
+/**
+ * Jev judged the user's applied direct command a question about what is shown
+ * (READ_REQUEST), or gave up on it (AGENT_HANDOFF: BLOCKED or UNCLEAR); nothing
+ * ran. The same input becomes a normal user turn with a needs_agent receipt, so
+ * the agent answers it (or sends one command for it), during user control too,
+ * and history records it. Applies once, only to that task's applied receipt.
+ */
+export type DirectHandoffCode = 'READ_REQUEST' | 'AGENT_HANDOFF';
+export declare function handDirectCommandToAgent(store: OrchestrationStore, task: TaskSnapshot, inputId: string, revision: number, code: DirectHandoffCode): boolean;
+/** Apply explicitly targeted control without conversational inference. */
+export declare function liveExecutionInput(store: OrchestrationStore, tasks: TaskService, input: AcceptInput, capabilities: ExecutionCapabilities, maxPending?: number): (LiveControlReceipt & {
+    task?: TaskSnapshot;
+    reused: boolean;
+}) | undefined;
+//# sourceMappingURL=live-execution-input.d.ts.map

package/dist/orchestration/live-execution-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-execution-input.d.ts","sourceRoot":"","sources":["../../src/orchestration/live-execution-input.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAE,kBAAkB,EAAC,MAAM,SAAS,CAAC;AACxD,OAAO,EAAC,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAC,qBAAqB,EAAsB,YAAY,EAAC,MAAM,SAAS,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IAAE,OAAO,EAAC,MAAM,CAAC;IAAA,MAAM,CAAC,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC,SAAS,GAAC,aAAa,CAAC;IAAA,IAAI,CAAC,EAAC,MAAM,CAAC;IAAA,QAAQ,CAAC,EAAC,MAAM,CAAA;CAAC;AAChI,wBAAgB,kBAAkB,CAAC,KAAK,EAAC,kBAAkB,EAAC,OAAO,EAAC,MAAM,GAAE,kBAAkB,GAAC,SAAS,CAGvG;AACD;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAC,cAAc,GAAC,eAAe,CAAC;AAC7D,wBAAgB,wBAAwB,CAAC,KAAK,EAAC,kBAAkB,EAAC,IAAI,EAAC,YAAY,EAAC,OAAO,EAAC,MAAM,EAAC,QAAQ,EAAC,MAAM,EAAC,IAAI,EAAC,iBAAiB,GAAE,OAAO,CAWjJ;AACD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,KAAK,EAAC,kBAAkB,EAAC,KAAK,EAAC,WAAW,EAAC,KAAK,EAAC,WAAW,EAAC,YAAY,EAAC,qBAAqB,EAAC,UAAU,SAAI,GAAE,CAAC,kBAAkB,GAAG;IAAC,IAAI,CAAC,EAAC,YAAY,CAAC;IAAA,MAAM,EAAC,OAAO,CAAA;CAAC,CAAC,GAAC,SAAS,CAgCtN"}

package/dist/orchestration/live-execution-input.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.liveControlReceipt = liveControlReceipt;
+exports.handDirectCommandToAgent = handDirectCommandToAgent;
+exports.liveExecutionInput = liveExecutionInput;
+const automation_session_1 = require("./tasks/automation-session");
+const types_1 = require("./types");
+function liveControlReceipt(store, inputId) {
+    const row = store.get("SELECT payload_json FROM conversation_events WHERE type='input.execution_control' AND json_extract(payload_json,'$.payload.inputId')=? ORDER BY seq DESC LIMIT 1", inputId);
+    return row ? JSON.parse(String(row.payload_json)).payload : undefined;
+}
+function handDirectCommandToAgent(store, task, inputId, revision, code) {
+    return store.transaction(() => {
+        const input = store.get('SELECT conversation_id,principal_id,status FROM conversation_inputs WHERE id=?', inputId);
+        if (!input || input.conversation_id !== task.conversationId || input.principal_id !== task.ownerPrincipalId || input.status !== 'handled')
+            return false;
+        const receipt = liveControlReceipt(store, inputId);
+        if (receipt?.taskId !== task.taskId || receipt.status !== 'applied' || receipt.code)
+            return false;
+        store.appendEvent(task.conversationId, 'input.execution_control', { inputId, taskId: task.taskId, status: 'needs_agent', code, revision }, task.taskId);
+        store.run("UPDATE conversation_inputs SET status='accepted',store_user_message=1 WHERE id=?", inputId);
+        store.run("UPDATE history_operations SET state='pending',updated_at=? WHERE operation_id=? AND input_id=?", Date.now(), `input:${inputId}`, inputId);
+        return true;
+    });
+}
+/** Apply explicitly targeted control without conversational inference. */
+function liveExecutionInput(store, tasks, input, capabilities, maxPending = 100) {
+    const target = input.metadata?.executionTaskId;
+    if (!target)
+        return undefined;
+    return store.compose(() => {
+        const receipt = store.acceptInput({ ...input, storeUserMessage: false, capabilities }, maxPending);
+        const previous = liveControlReceipt(store, receipt.inputId);
+        if (previous)
+            return { ...previous, reused: true };
+        let task;
+        let control = { inputId: receipt.inputId, status: 'needs_agent' };
+        try {
+            if (!capabilities.execute || input.scope.source !== 'api')
+                throw new types_1.OrchestrationError('ACCESS_DENIED');
+            const current = store.task(target);
+            if (!current || current.agentSessionId !== input.scope.agentSessionId || current.conversationId !== receipt.conversationId || current.ownerPrincipalId !== input.scope.principalId)
+                throw new types_1.OrchestrationError('ACCESS_DENIED');
+            control.taskId = target;
+            const session = (0, automation_session_1.automationSession)(current);
+            if (session?.status === 'closed')
+                throw new types_1.OrchestrationError('AUTOMATION_SESSION_CLOSED');
+            // Explicit task destination resumes the same session with a fresh command.
+            // Unknown mutations remain fenced by controlByUser.
+            if (input.attachmentIds?.length)
+                throw new types_1.OrchestrationError('INVALID_INPUT');
+            task = tasks.controlByUser(receipt.conversationId, input.scope.principalId, target, { id: receipt.inputId, action: 'revise', expectedRevision: current.revision, text: input.text });
+            control = { ...control, status: 'applied', revision: task.revision };
+        }
+        catch (error) {
+            if (!(error instanceof types_1.OrchestrationError))
+                throw error;
+            control.code = error.code;
+        }
+        store.appendEvent(receipt.conversationId, 'input.execution_control', control, control.taskId);
+        // Applied commands are acknowledged by the task state. Anything else stays a
+        // pending user message so the agent gets a turn and history records it.
+        if (control.status === 'applied')
+            store.completeInputReceipt(receipt);
+        else
+            store.run('UPDATE conversation_inputs SET store_user_message=1 WHERE id=?', receipt.inputId);
+        return { ...control, task, reused: false };
+    });
+}
+//# sourceMappingURL=live-execution-input.js.map

package/dist/orchestration/live-execution-input.js.map

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

package/dist/orchestration/notification-mailbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-mailbox.d.ts","sourceRoot":"","sources":["../../src/orchestration/notification-mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;;yDAGyD;AACzD,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,SAAa,2BAuB5I"}
+{"version":3,"file":"notification-mailbox.d.ts","sourceRoot":"","sources":["../../src/orchestration/notification-mailbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG7C;;;yDAGyD;AACzD,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,SAAa,2BAyB5I"}

package/dist/orchestration/notification-mailbox.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pendingReports = pendingReports;
+const control_notification_1 = require("./control-notification");
 /** Retry reports, never task execution. Decisions/inputs retain the retry clock
  * across restarts, including failed reports written before this implementation.
  * Prolonged outages back off to one hour instead of retrying every five minutes.
@@ -11,7 +12,7 @@ function pendingReports(store, activeSessions, scheduled, automatic, now = Date.
       d.state decision_state,d.ended_at,
       (SELECT COUNT(*) FROM conversation_decisions x WHERE x.conversation_id=c.id AND x.state='failed'
         AND EXISTS(SELECT 1 FROM json_each(x.notification_ids_json) WHERE value=n.id)) attempts
-    FROM notifications n JOIN conversations c ON c.id=n.conversation_id
+    FROM notifications n JOIN conversations c ON c.id=n.conversation_id JOIN tasks t ON t.id=n.task_id
     LEFT JOIN conversation_inputs i ON i.id=(SELECT x.id FROM conversation_inputs x
       WHERE x.conversation_id=c.id AND (json_extract(x.ingress_json,'$.ingressKey')='notification:'||n.id
         OR json_extract(x.ingress_json,'$.ingressKey') LIKE 'notification:'||n.id||':retry:%') ORDER BY x.input_seq DESC LIMIT 1)
@@ -19,8 +20,10 @@ function pendingReports(store, activeSessions, scheduled, automatic, now = Date.
       WHERE d2.conversation_id=c.id AND EXISTS(SELECT 1 FROM json_each(d2.notification_ids_json) WHERE value=n.id)
       ORDER BY d2.epoch DESC LIMIT 1)
     WHERE n.status='pending'
+      AND (NOT EXISTS(SELECT 1 FROM tasks newer WHERE newer.id=n.task_id AND json_extract(newer.snapshot_json,'$.gatewayTarget.adapter') IN ('computer','browser') AND newer.state_version!=n.task_state_version) OR ${control_notification_1.CURRENT_CONTROL_ROUND_SQL})
+      AND NOT EXISTS(SELECT 1 FROM tasks controlled WHERE controlled.id=n.task_id AND json_extract(controlled.snapshot_json,'$.automationController')='user' AND NOT(controlled.state='cancelled' AND controlled.state_version=n.task_state_version AND json_extract(controlled.snapshot_json,'$.cancellation.requestedBy')='user'))
       AND c.agent_session_id NOT IN (SELECT value FROM json_each(?))
-      AND (? OR c.id IN (SELECT value FROM json_each(?)) OR EXISTS (SELECT 1 FROM tasks monitored WHERE monitored.id=n.task_id AND monitored.state='running' AND json_extract(monitored.snapshot_json,'$.supervision.id') IS NOT NULL AND monitored.state_version=n.task_state_version))
+      AND (? OR c.id IN (SELECT value FROM json_each(?)) OR ${control_notification_1.CURRENT_CONTROL_ROUND_SQL} OR EXISTS (SELECT 1 FROM tasks monitored WHERE monitored.id=n.task_id AND ((monitored.state='cancelled' AND json_extract(monitored.snapshot_json,'$.automationController')='user' AND json_extract(monitored.snapshot_json,'$.cancellation.requestedBy')='user') OR (monitored.state='running' AND json_extract(monitored.snapshot_json,'$.supervision.id') IS NOT NULL) OR (monitored.state='waiting_input' AND COALESCE(json_extract(monitored.snapshot_json,'$.automationController'),'agent')='agent' AND COALESCE(json_extract(monitored.snapshot_json,'$.browserReport.reason'),json_extract(monitored.snapshot_json,'$.computerReport.reason')) IN ('COMMAND_WAITING_INPUT','THINKING_WAITING_INPUT','COMPLETION_CANDIDATE','VERIFICATION_FAILED'))) AND monitored.state_version=n.task_state_version))
       AND NOT EXISTS(SELECT 1 FROM conversation_inputs queued WHERE queued.conversation_id=c.id AND queued.status IN ('accepted','assigned'))
   ), eligible AS (
     SELECT *,ROW_NUMBER() OVER (PARTITION BY id ORDER BY notification_id) position FROM candidates

package/dist/orchestration/notification-mailbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification-mailbox.js","sourceRoot":"","sources":["../../src/orchestration/notification-mailbox.ts"],"names":[],"mappings":";;AAMA,wCAuBC;AA3BD;;;yDAGyD;AACzD,SAAgB,cAAc,CAAC,KAAyB,EAAE,cAAwB,EAAE,SAAmB,EAAE,SAAkB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC3I,OAAO,KAAK,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;8EAoB2D,EAC5E,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;AACrF,CAAC"}
+{"version":3,"file":"notification-mailbox.js","sourceRoot":"","sources":["../../src/orchestration/notification-mailbox.ts"],"names":[],"mappings":";;AAOA,wCAyBC;AA/BD,iEAAiE;AAEjE;;;yDAGyD;AACzD,SAAgB,cAAc,CAAC,KAAyB,EAAE,cAAwB,EAAE,SAAmB,EAAE,SAAkB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC3I,OAAO,KAAK,CAAC,GAAG,CAAC;;;;;;;;;;;;;uNAaoM,gDAAyB;;;8DAGlL,gDAAyB;;;;;;8EAMT,EAC5E,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;AACrF,CAAC"}

package/dist/orchestration/process-activity.d.ts

@@ -10,13 +10,15 @@ export interface ProcessSample {
     ioAvailable?: boolean;
 }
 /** Read counters only, never argv/env/output. A process identity is PID + start time.
- * Descendants in new process groups are included while still linked to the root.
- * Detached/reparented children outside the original group cannot be proven here. */
+ * On POSIX, descendants in new process groups are included while still linked to
+ * the root; detached/reparented children outside the original group cannot be
+ * proven here. A platform with its own `tree` (Windows) decides ownership itself. */
 export declare class ProcessActivitySampler {
     private readonly pid;
     private readonly enabled;
     private rootStart?;
     private previous?;
+    private known;
     constructor(pid: () => number | undefined, enabled?: boolean);
     sample(): Promise<ProcessSample>;
 }

package/dist/orchestration/process-activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-activity.d.ts","sourceRoot":"","sources":["../../src/orchestration/process-activity.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAGD;;oFAEoF;AACpF,qBAAa,sBAAsB;IAGrB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAA4B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpF,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,CAAsB;gBACV,GAAG,EAAE,MAAM,MAAM,GAAG,SAAS,EAAmB,OAAO,UAAO;IACrF,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;CAyDvC"}
+{"version":3,"file":"process-activity.d.ts","sourceRoot":"","sources":["../../src/orchestration/process-activity.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAGD;;;qFAGqF;AACrF,qBAAa,sBAAsB;IAIrB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAA4B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpF,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,CAAsB;IACvC,OAAO,CAAC,KAAK,CAA6B;gBACb,GAAG,EAAE,MAAM,MAAM,GAAG,SAAS,EAAmB,OAAO,UAAO;IACrF,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;CA+CvC"}

package/dist/orchestration/process-activity.js

@@ -1,68 +1,57 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProcessActivitySampler = void 0;
-const promises_1 = require("fs/promises");
+const process_platform_1 = require("./process-platform");
 /** Read counters only, never argv/env/output. A process identity is PID + start time.
- * Descendants in new process groups are included while still linked to the root.
- * Detached/reparented children outside the original group cannot be proven here. */
+ * On POSIX, descendants in new process groups are included while still linked to
+ * the root; detached/reparented children outside the original group cannot be
+ * proven here. A platform with its own `tree` (Windows) decides ownership itself. */
 class ProcessActivitySampler {
     constructor(pid, enabled = true) {
         this.pid = pid;
         this.enabled = enabled;
+        this.known = new Map();
     }
     async sample() {
         const unavailable = { observedAt: Date.now(), available: false };
         const pid = this.pid();
-        if (!this.enabled || process.platform !== 'linux' || !pid || pid <= 0)
+        const platform = (0, process_platform_1.processPlatform)();
+        if (!this.enabled || !platform || !pid || pid <= 0)
             return unavailable;
         try {
-            const members = new Map();
-            const entries = await (0, promises_1.readdir)('/proc');
-            // Sequential stat reads bound open files and memory on busy shared hosts.
-            for (const entry of entries) {
-                if (!/^\d+$/.test(entry))
-                    continue;
-                try {
-                    const stat = await (0, promises_1.readFile)(`/proc/${entry}/stat`, 'utf8');
-                    const f = stat.slice(stat.lastIndexOf(')') + 2).trim().split(/\s+/);
-                    members.set(Number(entry), { pid: Number(entry), parent: Number(f[1]), group: Number(f[2]), state: f[0], start: f[19], cpu: Number(f[11]) + Number(f[12]) });
-                }
-                catch { /* Processes may exit while being sampled. */ }
-            }
+            const members = await platform.snapshot();
+            if (!members)
+                return unavailable;
             const root = members.get(pid);
-            if (!root || ['Z', 'X'].includes(root.state) || (this.rootStart && this.rootStart !== root.start))
+            if (!root || ['Z', 'X'].includes(root.state[0]) || (this.rootStart && this.rootStart !== root.start))
                 return unavailable;
             this.rootStart = root.start;
-            const owned = new Set([pid]);
-            let changed = true;
-            while (changed) {
-                changed = false;
-                for (const m of members.values())
-                    if (!owned.has(m.pid) && (owned.has(m.parent) || (root.group === pid && m.group === pid))) {
-                        owned.add(m.pid);
-                        changed = true;
-                    }
+            let owned = new Set([pid]);
+            if (platform.tree) {
+                const tree = platform.tree(members, pid, this.known);
+                if (!tree)
+                    return unavailable;
+                this.known = tree;
+                owned = new Set(tree.keys());
+            }
+            else {
+                let changed = true;
+                while (changed) {
+                    changed = false;
+                    for (const m of members.values())
+                        if (!owned.has(m.pid) && (owned.has(m.parent) || (root.group === pid && m.group === pid))) {
+                            owned.add(m.pid);
+                            changed = true;
+                        }
+                }
             }
             const current = new Map();
             for (const id of owned) {
                 const m = members.get(id);
-                if (['Z', 'X'].includes(m.state))
+                if (['Z', 'X'].includes(m.state[0]))
                     continue;
-                try {
-                    const io = await (0, promises_1.readFile)(`/proc/${id}/io`, 'utf8');
-                    // Logical I/O includes pipes/cache, so piped test output is visible.
-                    m.read = Number(/^rchar:\s+(\d+)/m.exec(io)?.[1]);
-                    m.write = Number(/^wchar:\s+(\d+)/m.exec(io)?.[1]);
-                }
-                catch { /* CPU/membership remain usable without I/O permission. */ }
-                try {
-                    const stat = await (0, promises_1.readFile)(`/proc/${id}/stat`, 'utf8');
-                    if (stat.slice(stat.lastIndexOf(')') + 2).trim().split(/\s+/)[19] !== m.start)
-                        continue;
-                }
-                catch {
+                if (platform.refine && !await platform.refine(m))
                     continue;
-                }
                 current.set(`${id}:${m.start}`, m);
             }
             const result = { observedAt: Date.now(), available: true, processCount: current.size, ioAvailable: [...current.values()].every(m => Number.isFinite(m.read) && Number.isFinite(m.write)) };

package/dist/orchestration/process-activity.js.map

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

package/dist/orchestration/process-platform.d.ts

@@ -0,0 +1,72 @@
+/** One process as seen by a platform snapshot. `start` is an opaque per-boot
+ * start identity (Linux start ticks, macOS lstart, Windows creation FILETIME);
+ * `cpu` is user+system time in 10ms ticks. */
+export interface ProcessRecord {
+    pid: number;
+    parent: number;
+    group: number;
+    state: string;
+    start: string;
+    cpu: number;
+    read?: number;
+    write?: number;
+    command?: string;
+}
+export type Fingerprint = {
+    bootId: string;
+    startTicks: string;
+};
+/** Everything the orchestration supervisor needs from the OS. A "group" is the
+ * set of processes the gateway may prove stopped: the POSIX process group led by
+ * a detached worker, or on Windows the process tree rooted at the worker. */
+export interface ProcessPlatform {
+    /** Spawn the worker with `detached` so it leads its own process group. */
+    readonly detachWorkers: boolean;
+    readonly termGraceMs: number;
+    readonly pollMs: number;
+    readonly killSettleMs: number;
+    /** Live, non-zombie members; undefined when membership cannot be proven. */
+    groupMembers(group: number, rootStart?: string): Promise<number[] | undefined>;
+    /** False only when the signal could not be delivered for a reason other than "already gone".
+     * `rootStart` pins the root identity the caller owns (Windows; POSIX ignores it). */
+    signalGroup(group: number, signal: 'SIGTERM' | 'SIGKILL', rootStart?: string): Promise<boolean>;
+    /** Kernel identity that rejects PID reuse; the pid must still lead its group. */
+    fingerprint(pid: number): Promise<Fingerprint | undefined>;
+    /** This boot's identity, as used in `Fingerprint.bootId`; undefined when unreadable. */
+    bootId(): Promise<string | undefined>;
+    /** Counters for every visible process; undefined when unavailable. */
+    snapshot(): Promise<Map<number, ProcessRecord> | undefined>;
+    /** Processes owned by the worker rooted at `root`, when ownership is not the
+     * POSIX parent/process-group link. `known` maps pid->start of members owned
+     * at the previous sample, so orphaned descendants stay owned. */
+    tree?(snapshot: Map<number, ProcessRecord>, root: number, known: Map<number, string>): Map<number, string> | undefined;
+    /** Linux enriches owned members with I/O counters and re-checks start identity. */
+    refine?(member: ProcessRecord): Promise<boolean>;
+    /** Record a just-spawned root's identity while its handle is held (`alive`), so
+     * a later stop can anchor orphans and refuse a reused PID. Resolves to the
+     * recorded start, or undefined when none could be recorded. */
+    adopt?(pid: number, alive: () => boolean): Promise<string | undefined>;
+}
+/** `%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe` from the first of SystemRoot
+ * and windir that is a plain absolute drive path; otherwise the bare name, resolved through PATH. */
+export declare function windowsPowerShell(systemRoot?: string | undefined, windir?: string | undefined): string;
+export declare const linuxPlatform: ProcessPlatform;
+/** BSD ps `time` is [[dd-]hh:]mm:ss.cc of user+system CPU. */
+export declare function parsePsCpuTicks(value: string): number;
+/** `ps -o pid=,ppid=,pgid=,stat=,time=,lstart=[,comm=]`. lstart is always five
+ * fields ("Mon Sep 28 10:00:01 2026"); an optional comm (may hold spaces) follows. */
+export declare function parseDarwinPs(output: string): Map<number, ProcessRecord>;
+export declare const darwinPlatform: ProcessPlatform;
+export declare function parseWindowsSnapshot(output: string): Map<number, ProcessRecord>;
+/** Members of the tree rooted at `root`. `known` holds pid->start of members owned
+ * at the previous snapshot, so a grandchild orphaned by an exited intermediate is
+ * still owned. Undefined when nothing is proven: the root PID now belongs to a
+ * different process (its original tree may still have orphans that cannot be told
+ * apart), or the root is gone and no start identity anchors its orphans. */
+export declare function windowsTree(snapshot: Map<number, ProcessRecord>, root: number, known?: Map<number, string>, rootStart?: string): Map<number, string> | undefined;
+export declare function windowsPlatform(powershell?: string): ProcessPlatform;
+/** The supervisor for this host, or undefined where orchestration cannot prove process lifetime. */
+export declare function processPlatform(): ProcessPlatform | undefined;
+/** Test hook: substitute a platform (e.g. a mocked Windows supervisor on Linux CI). */
+export declare function setProcessPlatform(platform: ProcessPlatform | null | undefined): void;
+//# sourceMappingURL=process-platform.d.ts.map

package/dist/orchestration/process-platform.d.ts.map

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