@llblab/pi-actors 0.42.3 → 0.43.1

package/dist/lib/runtime-triage.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Pure runtime Control triage policy.
+ * Zones: pending admission, status-age classification, terminal/replacement staleness
+ * Owns Control triage decisions; journal reads and owner filtering stay in adapters, while safe fields come from control-projection.
+ */
+import * as ControlProjection from "./control-projection.ts";
+export declare const RUNTIME_CONTROL_STALE_AFTER_MS: number;
+export interface RuntimeTriageRun {
+    run: string;
+    runInstanceId?: string;
+    status: string;
+}
+export interface RuntimePendingControl extends ControlProjection.ProjectedRunControl {
+    age_ms: number;
+    reason: "age_threshold_reached" | "run_generation_replaced" | "run_generation_unavailable" | "run_terminal" | "within_age_threshold";
+    run: string;
+    status: "queued" | "delivered" | "claimed";
+    status_at: string;
+}
+export interface RuntimeControlDiagnostic {
+    reason: "invalid_action" | "invalid_control_id" | "invalid_generation" | "invalid_record" | "invalid_status" | "invalid_status_timestamp";
+    run: string;
+}
+export interface RuntimeControlClassification {
+    diagnostic?: RuntimeControlDiagnostic;
+    pending?: RuntimePendingControl;
+    stale?: RuntimePendingControl;
+}
+export declare function classifyRuntimeControl(run: RuntimeTriageRun, value: unknown, nowMs: number): RuntimeControlClassification;

package/dist/lib/runtime-triage.js

@@ -0,0 +1,76 @@
+/**
+ * Pure runtime Control triage policy.
+ * Zones: pending admission, status-age classification, terminal/replacement staleness
+ * Owns Control triage decisions; journal reads and owner filtering stay in adapters, while safe fields come from control-projection.
+ */
+import * as ControlProjection from "./control-projection.js";
+export const RUNTIME_CONTROL_STALE_AFTER_MS = 5 * 60 * 1_000;
+const PENDING_STATUSES = new Set([
+    "queued",
+    "delivered",
+    "claimed",
+]);
+const TERMINAL_STATUSES = new Set(["handled", "failed"]);
+function diagnostic(run, reason) {
+    return { diagnostic: { reason, run } };
+}
+function statusTimestamp(record, status) {
+    if (status === "failed")
+        return record.failed_at;
+    if (status === "handled")
+        return record.handled_at;
+    if (status === "claimed")
+        return record.claimed_at;
+    if (status === "delivered")
+        return record.delivered_at;
+    return record.queued_at;
+}
+export function classifyRuntimeControl(run, value, nowMs) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return diagnostic(run.run, "invalid_record");
+    }
+    const record = value;
+    const status = record.status;
+    if (!PENDING_STATUSES.has(status) && !TERMINAL_STATUSES.has(status)) {
+        return diagnostic(run.run, "invalid_status");
+    }
+    if (typeof record.id !== "string" || !record.id) {
+        return diagnostic(run.run, "invalid_control_id");
+    }
+    if (typeof record.action !== "string" || !record.action) {
+        return diagnostic(run.run, "invalid_action");
+    }
+    if (typeof record.run_instance_id !== "string" || !record.run_instance_id) {
+        return diagnostic(run.run, "invalid_generation");
+    }
+    const timestamp = statusTimestamp(record, status);
+    const timestampMs = typeof timestamp === "string" ? Date.parse(timestamp) : Number.NaN;
+    if (!Number.isFinite(timestampMs)) {
+        return diagnostic(run.run, "invalid_status_timestamp");
+    }
+    if (TERMINAL_STATUSES.has(status))
+        return {};
+    const ageMs = Math.max(0, Math.floor(nowMs - timestampMs));
+    const staleReason = !run.runInstanceId
+        ? "run_generation_unavailable"
+        : record.run_instance_id !== run.runInstanceId
+            ? "run_generation_replaced"
+            : run.status !== "running"
+                ? "run_terminal"
+                : ageMs >= RUNTIME_CONTROL_STALE_AFTER_MS
+                    ? "age_threshold_reached"
+                    : undefined;
+    const projected = ControlProjection.projectRunControl(record);
+    const pending = {
+        ...projected,
+        age_ms: ageMs,
+        reason: staleReason ?? "within_age_threshold",
+        run: run.run,
+        status: status,
+        status_at: statusTimestamp(projected, status),
+    };
+    return {
+        pending,
+        ...(staleReason ? { stale: pending } : {}),
+    };
+}

package/dist/lib/tool-review-scheduler.js

@@ -264,7 +264,7 @@ export function applyApprovedToolReviewAtSessionBoundary(options = {}) {
                 ...state,
                 failedStage: "approval_state",
                 lastError: "approved review path is unavailable",
-                nextAction: "message to=tool:pi-actors type=review.retry body={\"scope\":\"tool\"}",
+                nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
                 phase: "processing_failed",
                 updatedAt: (options.now ?? (() => new Date()))().toISOString(),
             };
@@ -287,7 +287,7 @@ export function applyApprovedToolReviewAtSessionBoundary(options = {}) {
                     ...state,
                     failedStage: "transaction",
                     lastError: `tool review transaction remained ${transaction.phase}`,
-                    nextAction: "message to=tool:pi-actors type=review.retry body={\"scope\":\"tool\"}",
+                    nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
                     phase: "processing_failed",
                     updatedAt: (options.now ?? (() => new Date()))().toISOString(),
                 };
@@ -316,7 +316,7 @@ export function applyApprovedToolReviewAtSessionBoundary(options = {}) {
                     ...pending,
                     failedStage: "lineage",
                     lastError: error instanceof Error ? error.message : String(error),
-                    nextAction: "message to=tool:pi-actors type=review.retry body={\"scope\":\"tool\"}",
+                    nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
                 };
                 writeJsonAtomic(statePath, failedPending);
                 return { outcome: "lineage_pending", state: failedPending };
@@ -337,7 +337,7 @@ export function applyApprovedToolReviewAtSessionBoundary(options = {}) {
                 ...state,
                 failedStage: "transaction",
                 lastError: error instanceof Error ? error.message : String(error),
-                nextAction: "message to=tool:pi-actors type=review.retry body={\"scope\":\"tool\"}",
+                nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
                 phase: "processing_failed",
                 updatedAt: (options.now ?? (() => new Date()))().toISOString(),
             };
@@ -401,7 +401,7 @@ export function createToolReviewScheduler(deps) {
                             ...existing,
                             failedStage: processed.stage ?? "review_result",
                             lastError: processed.error ?? "automatic tool reviewer failed",
-                            nextAction: "message to=tool:pi-actors type=review.retry body={\"scope\":\"tool\"}",
+                            nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
                             phase: processed.outcome === "processing_failed"
                                 ? "processing_failed"
                                 : "failed",
@@ -437,7 +437,7 @@ export function createToolReviewScheduler(deps) {
                                 attempts: existing.attempts + 1,
                                 failedStage: "review_launch",
                                 lastError: error instanceof Error ? error.message : String(error),
-                                nextAction: "message to=tool:pi-actors type=review.retry body={\"scope\":\"tool\"}",
+                                nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
                                 phase: "failed",
                                 updatedAt: now().toISOString(),
                             });
@@ -471,7 +471,7 @@ export function createToolReviewScheduler(deps) {
                             failedStage: "review_launch",
                             inputPath: batch.inputPath,
                             lastError: error instanceof Error ? error.message : String(error),
-                            nextAction: "message to=tool:pi-actors type=review.retry body={\"scope\":\"tool\"}",
+                            nextAction: "message target=runtime action=review.retry input={\"scope\":\"tool\"}",
                             phase: "failed",
                             reviewerInputPath: batch.reviewerInputPath,
                             reviewId: batch.reviewId,

package/dist/lib/tools-inspect.d.ts

@@ -1,7 +1,7 @@
 /**
- * Public inspect tool behavior
- * Zones: actor observation, recipe registry inspection, room/session/tool/run views
- * Owns the public inspect execution path and compact observation responses
+ * Public inspect tool behavior.
+ * Zones: Run Recipe/Trace/Control views and runtime/recipe/tool diagnostics
+ * Owns exact inspect target/view dispatch; source projection stays in domain modules.
  */
 export interface InspectToolDeps<TContext = unknown> {
     getRunStatus?: (runOrDir: string) => Record<string, any>;