pulseed 0.5.4 → 0.6.0

package/dist/runtime/control/daemon-runtime-control-executor.js

@@ -1,7 +1,10 @@
 import { DaemonClient, isDaemonRunning } from "../daemon/client.js";
 export function createDaemonRuntimeControlExecutor(options) {
     return async (operation) => {
-        if (operation.kind !== "restart_daemon" && operation.kind !== "restart_gateway") {
+        if (operation.kind !== "restart_daemon"
+            && operation.kind !== "restart_gateway"
+            && operation.kind !== "pause_run"
+            && operation.kind !== "resume_run") {
             return {
                 ok: false,
                 state: "failed",
@@ -22,6 +25,33 @@ export function createDaemonRuntimeControlExecutor(options) {
             authToken: daemonInfo.authToken,
             baseDir: options.baseDir,
         });
+        if (operation.kind === "pause_run" || operation.kind === "resume_run") {
+            const goalId = operation.target?.goal_id;
+            if (!goalId) {
+                return {
+                    ok: false,
+                    state: "blocked",
+                    message: `Runtime control operation ${operation.kind} is blocked because no goal bridge was resolved.`,
+                };
+            }
+            const response = operation.kind === "pause_run"
+                ? await client.pauseGoal(goalId)
+                : await client.resumeGoal(goalId);
+            if (!response.ok) {
+                return {
+                    ok: false,
+                    state: "failed",
+                    message: `PulSeed daemon rejected ${operation.kind} for goal ${goalId}.`,
+                };
+            }
+            return {
+                ok: true,
+                state: "running",
+                message: operation.kind === "pause_run"
+                    ? `Safe-pause request for ${operation.target?.run_id ?? goalId} was sent through the typed daemon API.`
+                    : `Resume request for ${operation.target?.run_id ?? goalId} was sent through the typed daemon API.`,
+            };
+        }
         const response = await client.requestRuntimeControl({
             operationId: operation.operation_id,
             kind: operation.kind,

package/dist/runtime/control/daemon-runtime-control-executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"daemon-runtime-control-executor.js","sourceRoot":"","sources":["../../../src/runtime/control/daemon-runtime-control-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAkBpE,MAAM,UAAU,kCAAkC,CAChD,OAA4C;IAE5C,OAAO,KAAK,EAAE,SAAS,EAAyC,EAAE;QAChE,IAAI,SAAS,CAAC,IAAI,KAAK,gBAAgB,IAAI,SAAS,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAChF,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,6BAA6B,SAAS,CAAC,IAAI,0BAA0B;aAC/E,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,2DAA2D;aACrE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;YAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,WAAW;YACjC,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC;YAClD,WAAW,EAAE,SAAS,CAAC,YAAY;YACnC,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,MAAM,EAAE,SAAS,CAAC,MAAM;SACzB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,sDAAsD;aAChE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,SAAS;YAChB,OAAO,EACL,SAAS,CAAC,IAAI,KAAK,iBAAiB;gBAClC,CAAC,CAAC,0DAA0D;gBAC5D,CAAC,CAAC,oDAAoD;SAC3D,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"daemon-runtime-control-executor.js","sourceRoot":"","sources":["../../../src/runtime/control/daemon-runtime-control-executor.ts"],"names":[],"mappings":"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"}

package/dist/runtime/control/runtime-control-intent.d.ts

@@ -1,7 +1,15 @@
+import type { ILLMClient } from "../../base/llm/llm-client.js";
 import type { RuntimeControlOperationKind } from "../store/runtime-operation-schemas.js";
 export interface RuntimeControlIntent {
     kind: RuntimeControlOperationKind;
     reason: string;
+    target?: RuntimeControlTargetHint;
+    externalActions?: string[];
+    irreversible?: boolean;
 }
-export declare function recognizeRuntimeControlIntent(input: string): RuntimeControlIntent | null;
+export interface RuntimeControlTargetHint {
+    runId?: string;
+    sessionId?: string;
+}
+export declare function recognizeRuntimeControlIntent(input: string, llmClient?: Pick<ILLMClient, "sendMessage" | "parseJSON">): Promise<RuntimeControlIntent | null>;
 //# sourceMappingURL=runtime-control-intent.d.ts.map

package/dist/runtime/control/runtime-control-intent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-control-intent.d.ts","sourceRoot":"","sources":["../../../src/runtime/control/runtime-control-intent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAEzF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,2BAA2B,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAUD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAcxF"}
+{"version":3,"file":"runtime-control-intent.d.ts","sourceRoot":"","sources":["../../../src/runtime/control/runtime-control-intent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAEzF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,2BAA2B,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsDD,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,WAAW,CAAC,GACxD,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAetC"}

package/dist/runtime/control/runtime-control-intent.js

@@ -1,23 +1,89 @@
-const RESTART_TERMS = [/再起動/, /リスタート/i, /\brestart\b/i];
-const RUNTIME_TERMS = [/pulseed/i, /daemon/i, /gateway/i, /runtime/i, /自身/, /自分/];
-const EXPLANATION_TERMS = [/設計/, /説明/, /教えて/, /どう/, /\bexplain\b/i, /\bhow\b/i, /\bwhy\b/i];
-function anyMatch(input, patterns) {
-    return patterns.some((pattern) => pattern.test(input));
+import { z } from "zod";
+const RuntimeControlIntentDecisionSchema = z.object({
+    intent: z.enum([
+        "none",
+        "inspect_run",
+        "pause_run",
+        "resume_run",
+        "finalize_run",
+        "restart_daemon",
+        "restart_gateway",
+    ]),
+    reason: z.string().min(1).optional(),
+    target: z.object({
+        runId: z.string().min(1).optional(),
+        sessionId: z.string().min(1).optional(),
+    }).optional(),
+    externalActions: z.array(z.enum([
+        "submit",
+        "publish",
+        "secret",
+        "production_mutation",
+        "destructive_cleanup",
+    ])).optional(),
+    irreversible: z.boolean().optional(),
+});
+function buildRuntimeControlIntentSystemPrompt() {
+    return `You classify one operator chat message for PulSeed runtime control routing.
+
+Decide whether the user's primary intent is to operate on an existing active or recent long-running runtime session, or on the PulSeed daemon/gateway itself.
+
+Return only JSON matching:
+{
+  "intent": "none" | "inspect_run" | "pause_run" | "resume_run" | "finalize_run" | "restart_daemon" | "restart_gateway",
+  "reason": "short reason using the user's words",
+  "target": { "runId": "optional exact run id", "sessionId": "optional exact session id" },
+  "externalActions": ["submit" | "publish" | "secret" | "production_mutation" | "destructive_cleanup"],
+  "irreversible": true | false
 }
-export function recognizeRuntimeControlIntent(input) {
+
+Classification rules:
+- Choose inspect_run, pause_run, resume_run, or finalize_run only when the user is asking to inspect/control/finalize an existing runtime run/session/execution.
+- Choose none for ordinary project work, coding requests, implementation continuation, evidence/progress Q&A, status questions, explanations, help, or requests to create/start new work.
+- Choose none for broad follow-ups like "continue", "finish the implementation", or "続けて" unless the message itself clearly refers to resuming/finalizing a runtime run/session/execution.
+- Choose finalize_run for closing/finalizing a run. Mark irreversible true.
+- If finalize would involve external submit/publish, secrets, production mutation, or destructive cleanup, include the matching externalActions. Do not assume these actions should execute.
+- If the user names a run id or session id, copy it exactly into target. Otherwise omit target.
+- Use restart_daemon/restart_gateway only when the user is asking to restart the PulSeed daemon or gateway, not for run/session pause/resume/finalize.
+- When uncertain, choose none.`;
+}
+export async function recognizeRuntimeControlIntent(input, llmClient) {
     const trimmed = input.trim();
-    if (!trimmed)
+    if (!trimmed || !llmClient)
         return null;
-    if (anyMatch(trimmed, EXPLANATION_TERMS))
+    const response = await llmClient.sendMessage([{ role: "user", content: trimmed }], {
+        system: buildRuntimeControlIntentSystemPrompt(),
+        max_tokens: 512,
+        temperature: 0,
+        model_tier: "light",
+    });
+    const decision = llmClient.parseJSON(response.content, RuntimeControlIntentDecisionSchema);
+    return toRuntimeControlIntent(trimmed, decision);
+}
+function toRuntimeControlIntent(input, decision) {
+    if (decision.intent === "none")
         return null;
-    if (!anyMatch(trimmed, RUNTIME_TERMS))
+    const target = normalizeTarget(decision.target);
+    return {
+        kind: decision.intent,
+        reason: decision.reason?.trim() || input,
+        ...(target ? { target } : {}),
+        ...(decision.externalActions && decision.externalActions.length > 0
+            ? { externalActions: [...new Set(decision.externalActions)] }
+            : {}),
+        ...(decision.intent === "finalize_run" || decision.irreversible
+            ? { irreversible: true }
+            : {}),
+    };
+}
+function normalizeTarget(target) {
+    const runId = target?.runId?.trim();
+    const sessionId = target?.sessionId?.trim();
+    if (!runId && !sessionId)
         return null;
-    if (anyMatch(trimmed, RESTART_TERMS)) {
-        if (/gateway/i.test(trimmed)) {
-            return { kind: "restart_gateway", reason: trimmed };
-        }
-        return { kind: "restart_daemon", reason: trimmed };
-    }
-    return null;
+    return {
+        ...(runId ? { runId } : {}),
+        ...(sessionId ? { sessionId } : {}),
+    };
 }
 //# sourceMappingURL=runtime-control-intent.js.map

package/dist/runtime/control/runtime-control-intent.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-control-intent.js","sourceRoot":"","sources":["../../../src/runtime/control/runtime-control-intent.ts"],"names":[],"mappings":"AAOA,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AACxD,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAClF,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAE5F,SAAS,QAAQ,CAAC,KAAa,EAAE,QAAkB;IACjD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAa;IACzD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnD,IAAI,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACrD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"runtime-control-intent.js","sourceRoot":"","sources":["../../../src/runtime/control/runtime-control-intent.ts"],"names":[],"mappings":"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"}

package/dist/runtime/control/runtime-control-service.d.ts

@@ -1,4 +1,8 @@
+import type { StateManager } from "../../base/state/state-manager.js";
+import { createRuntimeSessionRegistry } from "../session-registry/index.js";
+import { type RuntimeEvidenceLedgerPort } from "../store/evidence-ledger.js";
 import { RuntimeOperationStore } from "../store/runtime-operation-store.js";
+import { RuntimeOperatorHandoffStore } from "../store/operator-handoff-store.js";
 import type { RuntimeControlActor, RuntimeControlOperation, RuntimeControlOperationKind, RuntimeControlOperationState, RuntimeControlReplyTarget } from "../store/runtime-operation-schemas.js";
 import type { RuntimeControlIntent } from "./runtime-control-intent.js";
 export interface RuntimeControlRequest {
@@ -8,6 +12,19 @@ export interface RuntimeControlRequest {
     replyTarget?: RuntimeControlReplyTarget;
     approvalFn?: (reason: string) => Promise<boolean>;
 }
+export interface RuntimeRunControlRequestBase {
+    runId?: string;
+    sessionId?: string;
+    reason: string;
+    cwd: string;
+    requestedBy?: RuntimeControlActor;
+    replyTarget?: RuntimeControlReplyTarget;
+    approvalFn?: (reason: string) => Promise<boolean>;
+}
+export interface RuntimeFinalizeRunRequest extends RuntimeRunControlRequestBase {
+    externalActions?: string[];
+    irreversible?: boolean;
+}
 export interface RuntimeControlResult {
     success: boolean;
     message: string;
@@ -23,16 +40,33 @@ export type RuntimeControlExecutor = (operation: RuntimeControlOperation, reques
 export interface RuntimeControlServiceOptions {
     operationStore?: RuntimeOperationStore;
     runtimeRoot?: string;
+    stateManager?: StateManager;
+    sessionRegistry?: Pick<ReturnType<typeof createRuntimeSessionRegistry>, "snapshot">;
+    evidenceLedger?: RuntimeEvidenceLedgerPort;
+    operatorHandoffStore?: Pick<RuntimeOperatorHandoffStore, "create">;
     executor?: RuntimeControlExecutor;
     now?: () => Date;
 }
 export declare class RuntimeControlService {
     private readonly operationStore;
+    private readonly sessionRegistry?;
+    private readonly evidenceLedger?;
+    private readonly operatorHandoffStore?;
     private readonly executor?;
     private readonly now;
     constructor(options?: RuntimeControlServiceOptions);
     request(request: RuntimeControlRequest): Promise<RuntimeControlResult>;
+    inspectRun(request: RuntimeRunControlRequestBase): Promise<RuntimeControlResult>;
+    pauseRun(request: RuntimeRunControlRequestBase): Promise<RuntimeControlResult>;
+    resumeRun(request: RuntimeRunControlRequestBase): Promise<RuntimeControlResult>;
+    finalizeRun(request: RuntimeFinalizeRunRequest): Promise<RuntimeControlResult>;
+    private handleRunControl;
     private createInitialOperation;
+    private createBlockedOperation;
+    private resolveTarget;
+    private proposeFinalize;
+    private formatInspection;
+    private appendControlEvidence;
     private approveIfRequired;
     private acknowledge;
     private executeAcknowledgedOperation;
@@ -41,5 +75,5 @@ export declare class RuntimeControlService {
     private update;
     private nowIso;
 }
-export declare function isExecutableRuntimeControlKind(kind: RuntimeControlOperationKind): kind is Extract<RuntimeControlOperationKind, "restart_daemon" | "restart_gateway">;
+export declare function isExecutableRuntimeControlKind(kind: RuntimeControlOperationKind): kind is Extract<RuntimeControlOperationKind, "restart_daemon" | "restart_gateway" | "pause_run" | "resume_run">;
 //# sourceMappingURL=runtime-control-service.d.ts.map

package/dist/runtime/control/runtime-control-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-control-service.d.ts","sourceRoot":"","sources":["../../../src/runtime/control/runtime-control-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACxC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,4BAA4B,CAAC;CACtC;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,4BAA4B,CAAC;CACtC;AAED,MAAM,MAAM,sBAAsB,GAAG,CACnC,SAAS,EAAE,uBAAuB,EAClC,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,4BAA4B,CAAC,CAAC;AAE3C,MAAM,WAAW,4BAA4B;IAC3C,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAMD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAErB,OAAO,GAAE,4BAAiC;IAMhD,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAiB9D,sBAAsB;YAiBtB,iBAAiB;IAuC/B,OAAO,CAAC,WAAW;YAOL,4BAA4B;YA+B5B,QAAQ;IAYtB,OAAO,CAAC,QAAQ;YASF,MAAM;IAcpB,OAAO,CAAC,MAAM;CAGf;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,2BAA2B,GAChC,IAAI,IAAI,OAAO,CAAC,2BAA2B,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,CAEpF"}
+{"version":3,"file":"runtime-control-service.d.ts","sourceRoot":"","sources":["../../../src/runtime/control/runtime-control-service.ts"],"names":[],"mappings":"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"}

package/dist/runtime/control/runtime-control-service.js

@@ -1,15 +1,31 @@
 import { randomUUID } from "node:crypto";
+import { createRuntimeSessionRegistry, } from "../session-registry/index.js";
+import { RuntimeEvidenceLedger } from "../store/evidence-ledger.js";
 import { RuntimeOperationStore } from "../store/runtime-operation-store.js";
+import { RuntimeOperatorHandoffStore } from "../store/operator-handoff-store.js";
+const ACTIVE_RUN_STATUSES = new Set(["queued", "running"]);
+const ATTENTION_RUN_STATUSES = new Set(["failed", "timed_out", "lost"]);
 export class RuntimeControlService {
     operationStore;
+    sessionRegistry;
+    evidenceLedger;
+    operatorHandoffStore;
     executor;
     now;
     constructor(options = {}) {
         this.operationStore = options.operationStore ?? new RuntimeOperationStore(options.runtimeRoot);
+        this.sessionRegistry = options.sessionRegistry ?? (options.stateManager
+            ? createRuntimeSessionRegistry({ stateManager: options.stateManager })
+            : undefined);
+        this.evidenceLedger = options.evidenceLedger ?? (options.runtimeRoot ? new RuntimeEvidenceLedger(options.runtimeRoot) : undefined);
+        this.operatorHandoffStore = options.operatorHandoffStore ?? (options.runtimeRoot ? new RuntimeOperatorHandoffStore(options.runtimeRoot) : undefined);
         this.executor = options.executor;
         this.now = options.now ?? (() => new Date());
     }
     async request(request) {
+        if (isRunControlKind(request.intent.kind)) {
+            return this.handleRunControl(request);
+        }
         if (!isExecutableRuntimeControlKind(request.intent.kind)) {
             return {
                 success: false,
@@ -24,8 +40,71 @@ export class RuntimeControlService {
         const acknowledged = await this.acknowledge(approved.operation);
         return this.executeAcknowledgedOperation(acknowledged, request);
     }
+    inspectRun(request) {
+        return this.request({ ...request, intent: { kind: "inspect_run", reason: request.reason, target: targetFromRunRequest(request) } });
+    }
+    pauseRun(request) {
+        return this.request({ ...request, intent: { kind: "pause_run", reason: request.reason, target: targetFromRunRequest(request) } });
+    }
+    resumeRun(request) {
+        return this.request({ ...request, intent: { kind: "resume_run", reason: request.reason, target: targetFromRunRequest(request) } });
+    }
+    finalizeRun(request) {
+        return this.request({
+            ...request,
+            intent: {
+                kind: "finalize_run",
+                reason: request.reason,
+                target: targetFromRunRequest(request),
+                externalActions: request.externalActions,
+                irreversible: request.irreversible ?? true,
+            },
+        });
+    }
+    async handleRunControl(request) {
+        const initial = await this.createInitialOperation(request);
+        if (initial.state === "blocked")
+            return this.toResult(initial);
+        if (request.intent.kind === "inspect_run") {
+            const inspected = await this.update(initial, "verified", {
+                ok: true,
+                message: await this.formatInspection(initial),
+            });
+            await this.appendControlEvidence(inspected);
+            return this.toResult(inspected);
+        }
+        if (request.intent.kind === "finalize_run") {
+            const proposed = await this.proposeFinalize(initial, request);
+            await this.appendControlEvidence(proposed);
+            return this.toResult(proposed);
+        }
+        if (!initial.target?.goal_id) {
+            const blocked = await this.update(initial, "blocked", {
+                ok: false,
+                message: `Runtime control ${request.intent.kind} is blocked: selected run ${initial.target?.run_id ?? "unknown"} has no typed goal/runtime bridge yet.`,
+            });
+            await this.appendControlEvidence(blocked);
+            return this.toResult(blocked);
+        }
+        const approved = await this.approveIfRequired(initial, request.approvalFn);
+        if (!approved.ok)
+            return approved.result;
+        const acknowledged = await this.acknowledge(approved.operation);
+        const result = await this.executeAcknowledgedOperation(acknowledged, request);
+        if (result.operationId) {
+            const operation = await this.operationStore.load(result.operationId);
+            if (operation)
+                await this.appendControlEvidence(operation);
+        }
+        return result;
+    }
     async createInitialOperation(request) {
+        const target = await this.resolveTarget(request);
+        if (!target.ok) {
+            return this.createBlockedOperation(request, target.result.message);
+        }
         const requestedAt = this.nowIso();
+        const risk = riskForIntent(request.intent);
         const operation = {
             operation_id: randomUUID(),
             kind: request.intent.kind,
@@ -36,9 +115,134 @@ export class RuntimeControlService {
             reply_target: normalizeReplyTarget(request.replyTarget ?? { surface: "chat" }),
             reason: request.intent.reason,
             expected_health: expectedHealthFor(request.intent.kind),
+            ...(target.run
+                ? {
+                    target: {
+                        run_id: target.run.id,
+                        ...(target.run.child_session_id ? { session_id: target.run.child_session_id } : {}),
+                        ...(target.goalId ? { goal_id: target.goalId } : {}),
+                    },
+                }
+                : {}),
+            ...(risk ? { risk } : {}),
         };
         return this.operationStore.save(operation);
     }
+    async createBlockedOperation(request, message) {
+        const now = this.nowIso();
+        return this.operationStore.save({
+            operation_id: randomUUID(),
+            kind: request.intent.kind,
+            state: "blocked",
+            requested_at: now,
+            updated_at: now,
+            requested_by: request.requestedBy ?? { surface: "chat" },
+            reply_target: normalizeReplyTarget(request.replyTarget ?? { surface: "chat" }),
+            reason: request.intent.reason,
+            expected_health: expectedHealthFor(request.intent.kind),
+            result: { ok: false, message },
+        });
+    }
+    async resolveTarget(request) {
+        if (!isRunControlKind(request.intent.kind))
+            return { ok: true };
+        if (!this.sessionRegistry) {
+            return blocked("Runtime session catalog is not available for run control.");
+        }
+        const snapshot = await this.sessionRegistry.snapshot();
+        const explicitRunId = request.intent.target?.runId;
+        const explicitSessionId = request.intent.target?.sessionId;
+        const run = explicitRunId
+            ? snapshot.background_runs.find((candidate) => candidate.id === explicitRunId)
+            : explicitSessionId
+                ? snapshot.background_runs.find((candidate) => candidate.child_session_id === explicitSessionId)
+                : selectImplicitTarget(snapshot, request);
+        if (!run) {
+            const candidates = selectableRuns(snapshot);
+            if (!explicitRunId && !explicitSessionId && candidates.length > 1) {
+                return blocked(`Multiple active/recent runtime runs match this request. Specify one run id: ${candidates.map((candidate) => candidate.id).join(", ")}`);
+            }
+            return blocked("No active or recent long-running runtime run matched this request.");
+        }
+        if (!isCurrentRunForControl(run, request.intent.kind)) {
+            return blocked(`Runtime run ${run.id} is stale or terminal for ${request.intent.kind}; refusing to reuse previous-session state.`);
+        }
+        return { ok: true, run, goalId: resolveGoalId(run, snapshot) };
+    }
+    async proposeFinalize(operation, request) {
+        const approved = await this.approveIfRequired(operation, request.approvalFn);
+        if (!approved.ok)
+            return this.operationStore.load(operation.operation_id).then((saved) => saved ?? operation);
+        const handoff = await this.operatorHandoffStore?.create({
+            handoff_id: `handoff:${operation.target?.run_id ?? operation.operation_id}:runtime-finalize`,
+            ...(operation.target?.goal_id ? { goal_id: operation.target.goal_id } : {}),
+            ...(operation.target?.run_id ? { run_id: operation.target.run_id } : {}),
+            triggers: [
+                "finalization",
+                ...(operation.risk?.irreversible ? ["irreversible_action"] : []),
+                ...((operation.risk?.external_actions.length ?? 0) > 0 ? ["external_action"] : []),
+            ],
+            title: "Runtime finalization approval required",
+            summary: operation.reason,
+            current_status: `Run ${operation.target?.run_id ?? "unknown"} is awaiting operator finalization approval.`,
+            recommended_action: "Review the proposed finalization. External submit/publish/secret/production/destructive actions remain blocked until explicit approval.",
+            candidate_options: [
+                { id: "approve_finalize", label: "Approve finalization", tradeoff: "Allows the runtime to finalize without external submission." },
+                { id: "keep_running", label: "Keep running", tradeoff: "Leaves the background run unchanged." },
+            ],
+            risks: [
+                "Finalization may be irreversible.",
+                ...((operation.risk?.external_actions ?? []).map((action) => `External action requested but not executed: ${action}`)),
+            ],
+            required_approvals: ["operator_finalization"],
+            next_action: {
+                label: "approve runtime finalization",
+                approval_required: true,
+            },
+            gate: {
+                autonomous_task_generation: "pause",
+                external_action_requires_approval: true,
+            },
+        });
+        return this.update(approved.operation, "blocked", {
+            ok: true,
+            message: [
+                `Finalization proposal recorded for ${operation.target?.run_id ?? "the selected run"}.`,
+                handoff ? `Operator handoff: ${handoff.handoff_id}.` : "Operator handoff store is not configured.",
+                "No external submit/publish/secret/production/destructive action was executed.",
+            ].join(" "),
+        });
+    }
+    async formatInspection(operation) {
+        if (!this.sessionRegistry || !operation.target?.run_id)
+            return "Runtime run inspection is unavailable.";
+        const snapshot = await this.sessionRegistry.snapshot();
+        const run = snapshot.background_runs.find((candidate) => candidate.id === operation.target?.run_id);
+        if (!run)
+            return `Runtime run ${operation.target.run_id} was not found.`;
+        return [
+            `Runtime run ${run.id}: ${run.status}.`,
+            run.title ? `Title: ${run.title}.` : null,
+            run.summary ? `Summary: ${run.summary}.` : null,
+            run.error ? `Error: ${run.error}.` : null,
+            `Updated: ${run.updated_at ?? "unknown"}.`,
+        ].filter((line) => Boolean(line)).join(" ");
+    }
+    async appendControlEvidence(operation) {
+        if (!this.evidenceLedger || !operation.target?.run_id)
+            return;
+        await this.evidenceLedger.append({
+            kind: operation.state === "failed" || operation.state === "blocked" ? "decision" : "execution",
+            scope: { run_id: operation.target.run_id },
+            outcome: operation.result?.ok ? "continued" : "blocked",
+            summary: operation.result?.message ?? ackMessage(operation.kind),
+            result: {
+                status: operation.state,
+                summary: operation.result?.message ?? ackMessage(operation.kind),
+            },
+            raw_refs: [{ kind: "runtime_control_operation", id: operation.operation_id }],
+        });
+    }
     async approveIfRequired(operation, approvalFn) {
         if (!requiresApproval(operation.kind)) {
             return { ok: true, operation };
@@ -48,7 +252,7 @@ export class RuntimeControlService {
         }
         let approved;
         try {
-            approved = await approvalFn(approvalReason(operation.kind, operation.reason));
+            approved = await approvalFn(approvalReason(operation));
         }
         catch (err) {
             return this.failStep(operation, "failed", err instanceof Error ? err.message : String(err));
@@ -124,10 +328,13 @@ export class RuntimeControlService {
     }
 }
 export function isExecutableRuntimeControlKind(kind) {
-    return kind === "restart_daemon" || kind === "restart_gateway";
+    return kind === "restart_daemon" || kind === "restart_gateway" || kind === "pause_run" || kind === "resume_run";
+}
+function isRunControlKind(kind) {
+    return kind === "inspect_run" || kind === "pause_run" || kind === "resume_run" || kind === "finalize_run";
 }
 function requiresApproval(kind) {
-    return isExecutableRuntimeControlKind(kind);
+    return kind === "restart_daemon" || kind === "restart_gateway" || kind === "pause_run" || kind === "resume_run" || kind === "finalize_run";
 }
 function normalizeReplyTarget(target) {
     return {
@@ -153,8 +360,9 @@ function expectedHealthFor(kind) {
         gateway_acceptance: isExecutableRuntimeControlKind(kind),
     };
 }
-function approvalReason(kind, reason) {
-    return `Runtime control ${kind}: ${reason}`;
+function approvalReason(operation) {
+    const target = operation.target?.run_id ? ` for ${operation.target.run_id}` : "";
+    return `Runtime control ${operation.kind}${target}: ${operation.reason}`;
 }
 function ackMessage(kind) {
     switch (kind) {
@@ -166,6 +374,78 @@ function ackMessage(kind) {
             return "runtime 設定の再読み込みを開始します。";
         case "self_update":
             return "PulSeed 自身の更新準備を開始します。実行前に内容を確認します。";
+        case "inspect_run":
+            return "runtime run の状況を確認しました。";
+        case "pause_run":
+            return "runtime run の safe pause を要求します。";
+        case "resume_run":
+            return "runtime run の再開を要求します。";
+        case "finalize_run":
+            return "runtime run の最終化 proposal を作成します。";
     }
 }
+function targetFromRunRequest(request) {
+    if (!request.runId && !request.sessionId)
+        return undefined;
+    return {
+        ...(request.runId ? { runId: request.runId } : {}),
+        ...(request.sessionId ? { sessionId: request.sessionId } : {}),
+    };
+}
+function riskForIntent(intent) {
+    if (intent.kind !== "finalize_run")
+        return null;
+    return {
+        requires_approval: true,
+        irreversible: intent.irreversible ?? true,
+        external_actions: intent.externalActions ?? [],
+    };
+}
+function selectableRuns(snapshot) {
+    return [...snapshot.background_runs]
+        .filter((run) => ACTIVE_RUN_STATUSES.has(run.status) || ATTENTION_RUN_STATUSES.has(run.status))
+        .sort((left, right) => compareUpdated(right, left));
+}
+function selectImplicitTarget(snapshot, request) {
+    const candidates = selectableRuns(snapshot);
+    const conversationId = request.replyTarget?.conversation_id ?? request.requestedBy?.conversation_id;
+    const currentSessionId = conversationId ? `session:conversation:${conversationId}` : null;
+    const scoped = currentSessionId
+        ? candidates.filter((run) => run.parent_session_id === currentSessionId)
+        : [];
+    if (scoped.length === 1)
+        return scoped[0];
+    if (scoped.length > 1)
+        return null;
+    return candidates.length === 1 ? candidates[0] : null;
+}
+function isCurrentRunForControl(run, kind) {
+    if (kind === "inspect_run")
+        return ACTIVE_RUN_STATUSES.has(run.status) || ATTENTION_RUN_STATUSES.has(run.status);
+    if (kind === "pause_run")
+        return ACTIVE_RUN_STATUSES.has(run.status);
+    if (kind === "resume_run")
+        return ACTIVE_RUN_STATUSES.has(run.status) || ATTENTION_RUN_STATUSES.has(run.status);
+    if (kind === "finalize_run")
+        return ACTIVE_RUN_STATUSES.has(run.status) || ATTENTION_RUN_STATUSES.has(run.status);
+    return false;
+}
+function resolveGoalId(run, snapshot) {
+    if (run.kind !== "coreloop_run")
+        return null;
+    if (run.goal_id)
+        return run.goal_id;
+    const child = run.child_session_id
+        ? snapshot.sessions.find((session) => session.id === run.child_session_id)
+        : null;
+    const title = child?.title ?? run.title ?? "";
+    const match = title.match(/^CoreLoop goal\s+(.+)$/);
+    return match?.[1]?.trim() || null;
+}
+function compareUpdated(left, right) {
+    return Date.parse(left.updated_at ?? left.started_at ?? left.created_at ?? "") - Date.parse(right.updated_at ?? right.started_at ?? right.created_at ?? "");
+}
+function blocked(message) {
+    return { ok: false, result: { success: false, message, state: "blocked" } };
+}
 //# sourceMappingURL=runtime-control-service.js.map