@meetquinn/animactl 0.1.3 → 0.1.4-canary.101.1.7eafcd7

package/dist/server/providers/child-process.d.ts

@@ -7,6 +7,10 @@ export interface RunningChildProcess {
     kill(signal?: NodeJS.Signals): void;
     writeStdin(input: string): void;
 }
+export interface ChildProcessTerminationOptions {
+    forceAfterMs?: number;
+    signal?: NodeJS.Signals;
+}
 export declare function startChildProcess(input: {
     args: string[];
     bufferOutput?: boolean;
@@ -18,4 +22,7 @@ export declare function startChildProcess(input: {
     onStdoutChunk?: (chunk: string) => Promise<void>;
     signal?: AbortSignal;
 }): RunningChildProcess;
+export declare function terminateChildProcess(child: Pick<RunningChildProcess, 'completion' | 'kill'>, options?: ChildProcessTerminationOptions): Promise<{
+    forced: boolean;
+}>;
 //# sourceMappingURL=child-process.d.ts.map

package/dist/server/providers/child-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"child-process.d.ts","sourceRoot":"","sources":["../../../server/providers/child-process.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,mBAAmB,CA0EtB"}
+{"version":3,"file":"child-process.d.ts","sourceRoot":"","sources":["../../../server/providers/child-process.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,8BAA8B;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,mBAAmB,CA0EtB;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,MAAM,CAAC,EACvD,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAiB9B"}

package/dist/server/providers/child-process.js

@@ -76,6 +76,25 @@ export function startChildProcess(input) {
         },
     };
 }
+export async function terminateChildProcess(child, options = {}) {
+    let forced = false;
+    child.kill(options.signal ?? 'SIGTERM');
+    const forceAfterMs = options.forceAfterMs;
+    const forceTimer = forceAfterMs !== undefined
+        ? setTimeout(() => {
+            forced = true;
+            child.kill('SIGKILL');
+        }, Math.max(0, forceAfterMs))
+        : undefined;
+    try {
+        await child.completion.catch(() => { });
+        return { forced };
+    }
+    finally {
+        if (forceTimer)
+            clearTimeout(forceTimer);
+    }
+}
 function childProcessExitError(label, exit, stdout, stderr) {
     if (exit.signal) {
         return new Error(`${label} terminated by ${exit.signal}${stderr ? `: ${stderr.trim()}` : ''}`);

package/dist/server/providers/claude.d.ts

@@ -1,4 +1,4 @@
-import { AgentRuntime, AgentRuntimeDrainInput, AgentRuntimeFollowupInput, AgentRuntimeFollowupResult, AgentRuntimeInput, AgentRuntimeResult, ClaudeCodeAgentProviderConfig } from './contract.js';
+import { type AgentRuntimeCloseOptions, AgentRuntime, AgentRuntimeDrainInput, AgentRuntimeFollowupInput, AgentRuntimeFollowupResult, AgentRuntimeInput, AgentRuntimeResult, ClaudeCodeAgentProviderConfig } from './contract.js';
 export declare const CLAUDE_DISALLOWED_TOOLS: string[];
 export declare class ClaudeCodeAgentRuntime implements AgentRuntime {
     readonly env: Record<string, string> | undefined;
@@ -7,7 +7,7 @@ export declare class ClaudeCodeAgentRuntime implements AgentRuntime {
     private controller?;
     private readonly activeRun;
     constructor(config: ClaudeCodeAgentProviderConfig);
-    close(): Promise<void>;
+    close(options?: AgentRuntimeCloseOptions): Promise<void>;
     run(input: AgentRuntimeInput): Promise<AgentRuntimeResult>;
     appendToActiveRun(input: AgentRuntimeFollowupInput): Promise<AgentRuntimeFollowupResult>;
     requestDrain(input: AgentRuntimeDrainInput): Promise<void>;

package/dist/server/providers/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../server/providers/claude.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,6BAA6B,EAC9B,MAAM,eAAe,CAAC;AAMvB,eAAO,MAAM,uBAAuB,UAQnC,CAAC;AAIF,qBAAa,sBAAuB,YAAW,YAAY;IACzD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,UAAU,CAAC,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,MAAM,EAAE,6BAA6B;IAQ3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0F1D,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAQxF,YAAY,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;YAOlD,gBAAgB;YA2BhB,OAAO;YAgBP,eAAe;IAQ7B,OAAO,CAAC,UAAU;CAgBnB"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../server/providers/claude.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,wBAAwB,EAG7B,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,6BAA6B,EAC9B,MAAM,eAAe,CAAC;AAMvB,eAAO,MAAM,uBAAuB,UAQnC,CAAC;AAIF,qBAAa,sBAAuB,YAAW,YAAY;IACzD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,UAAU,CAAC,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,MAAM,EAAE,6BAA6B;IAQ3C,KAAK,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0F1D,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAQxF,YAAY,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;YAOlD,gBAAgB;YA2BhB,OAAO;YAgBP,eAAe;IAa7B,OAAO,CAAC,UAAU;CAgBnB"}

package/dist/server/providers/claude.js

@@ -3,7 +3,7 @@ import { dirname } from 'node:path';
 import { isRecord, stringField } from '../json.js';
 import { runtimeErrorPayload } from '../activities/format.js';
 import { ActiveRuntimeRun } from './active-runtime.js';
-import { startChildProcess } from './child-process.js';
+import { startChildProcess, terminateChildProcess } from './child-process.js';
 import { createClaudeJsonlActivityMapper, parseClaudeRuntimeOutput } from './claude-events.js';
 import { CLAUDE_DEFAULT_AUTO_COMPACT_WINDOW, providerSessionPayload, } from './contract.js';
 const CLAUDE_COMMAND = 'claude';
@@ -33,8 +33,8 @@ export class ClaudeCodeAgentRuntime {
             ...(config.env ?? {}),
         };
     }
-    async close() {
-        await this.resetController();
+    async close(options = {}) {
+        await this.resetController(options.signal, options);
     }
     async run(input) {
         await input.effects.recordRuntime('runtime.started', {
@@ -183,13 +183,15 @@ export class ClaudeCodeAgentRuntime {
         }
         return turn;
     }
-    async resetController(signal = 'SIGTERM') {
+    async resetController(signal = 'SIGTERM', options = {}) {
         const controller = this.controller;
         if (!controller)
             return;
         this.controller = undefined;
-        controller.kill(signal);
-        await controller.completion.catch(() => { });
+        await terminateChildProcess(controller, {
+            signal,
+            ...(options.forceAfterMs === undefined ? {} : { forceAfterMs: options.forceAfterMs }),
+        });
     }
     claudeArgs(providerSession, systemPromptFilePath) {
         const args = [

package/dist/server/providers/codex.d.ts

@@ -1,4 +1,4 @@
-import { type AgentRuntime, type AgentRuntimeDrainInput, type AgentRuntimeFollowupInput, type AgentRuntimeFollowupResult, type AgentRuntimeInput, type AgentRuntimeResult, type CodexCliAgentProviderConfig } from './contract.js';
+import { type AgentRuntimeCloseOptions, type AgentRuntime, type AgentRuntimeDrainInput, type AgentRuntimeFollowupInput, type AgentRuntimeFollowupResult, type AgentRuntimeInput, type AgentRuntimeResult, type CodexCliAgentProviderConfig } from './contract.js';
 export declare class CodexCliAgentRuntime implements AgentRuntime {
     readonly env: Record<string, string> | undefined;
     readonly kind = "codex-cli";
@@ -6,7 +6,7 @@ export declare class CodexCliAgentRuntime implements AgentRuntime {
     private controller?;
     private readonly activeRun;
     constructor(config: CodexCliAgentProviderConfig);
-    close(): Promise<void>;
+    close(options?: AgentRuntimeCloseOptions): Promise<void>;
     run(input: AgentRuntimeInput): Promise<AgentRuntimeResult>;
     appendToActiveRun(input: AgentRuntimeFollowupInput): Promise<AgentRuntimeFollowupResult>;
     requestDrain(input: AgentRuntimeDrainInput): Promise<void>;

package/dist/server/providers/codex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../server/providers/codex.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EACjC,MAAM,eAAe,CAAC;AAIvB,qBAAa,oBAAqB,YAAW,YAAY;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,UAAU,CAAC,CAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,MAAM,EAAE,2BAA2B;IAKzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqC1D,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAaxF,YAAY,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,OAAO,CAAC,gBAAgB;YAyBV,eAAe;IAQ7B,OAAO,CAAC,YAAY;CAcrB"}
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../server/providers/codex.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EACjC,MAAM,eAAe,CAAC;AAIvB,qBAAa,oBAAqB,YAAW,YAAY;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,UAAU,CAAC,CAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,MAAM,EAAE,2BAA2B;IAKzC,KAAK,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqC1D,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAaxF,YAAY,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,OAAO,CAAC,gBAAgB;YAyBV,eAAe;IAa7B,OAAO,CAAC,YAAY;CAcrB"}

package/dist/server/providers/codex.js

@@ -1,7 +1,7 @@
 import { nowIso } from '../ids.js';
 import { runtimeErrorPayload } from '../activities/format.js';
 import { ActiveRuntimeRun } from './active-runtime.js';
-import { startChildProcess } from './child-process.js';
+import { startChildProcess, terminateChildProcess } from './child-process.js';
 import { CodexAppServerController } from './codex-app-server.js';
 import { providerSessionPayload, } from './contract.js';
 const CODEX_COMMAND = 'codex';
@@ -15,8 +15,8 @@ export class CodexCliAgentRuntime {
         this.config = config;
         this.env = config.env;
     }
-    async close() {
-        await this.resetController();
+    async close(options = {}) {
+        await this.resetController(options.signal, options);
     }
     async run(input) {
         await input.effects.recordRuntime('runtime.started', {
@@ -99,13 +99,15 @@ export class CodexCliAgentRuntime {
         });
         return controller;
     }
-    async resetController(signal = 'SIGTERM') {
+    async resetController(signal = 'SIGTERM', options = {}) {
         const controller = this.controller;
         if (!controller)
             return;
         this.controller = undefined;
-        controller.kill(signal);
-        await controller.completion.catch(() => { });
+        await terminateChildProcess(controller, {
+            signal,
+            ...(options.forceAfterMs === undefined ? {} : { forceAfterMs: options.forceAfterMs }),
+        });
     }
     threadParams(input) {
         const config = {

package/dist/server/providers/contract.d.ts

@@ -44,10 +44,14 @@ export interface AgentRuntimeDrainInput {
     activeItemId: string;
     signal?: AbortSignal;
 }
+export interface AgentRuntimeCloseOptions {
+    forceAfterMs?: number;
+    signal?: NodeJS.Signals;
+}
 export interface AgentRuntime {
     readonly env?: Record<string, string>;
     readonly kind: string;
-    close?(): Promise<void>;
+    close?(options?: AgentRuntimeCloseOptions): Promise<void>;
     run(input: AgentRuntimeInput): Promise<AgentRuntimeResult>;
     appendToActiveRun(input: AgentRuntimeFollowupInput): Promise<AgentRuntimeFollowupResult>;
     requestDrain?(input: AgentRuntimeDrainInput): Promise<void>;

package/dist/server/providers/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../server/providers/contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../server/providers/contract.ts"],"names":[],"mappings":"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"}

package/dist/server/providers/kimi.d.ts

@@ -1,4 +1,4 @@
-import { type AgentRuntime, type AgentRuntimeDrainInput, type AgentRuntimeFollowupInput, type AgentRuntimeFollowupResult, type AgentRuntimeInput, type AgentRuntimeResult, type KimiCliAgentProviderConfig } from './contract.js';
+import { type AgentRuntimeCloseOptions, type AgentRuntime, type AgentRuntimeDrainInput, type AgentRuntimeFollowupInput, type AgentRuntimeFollowupResult, type AgentRuntimeInput, type AgentRuntimeResult, type KimiCliAgentProviderConfig } from './contract.js';
 export declare class KimiCliAgentRuntime implements AgentRuntime {
     readonly env: Record<string, string> | undefined;
     readonly kind = "kimi-cli";
@@ -6,7 +6,7 @@ export declare class KimiCliAgentRuntime implements AgentRuntime {
     private controller?;
     private readonly activeRun;
     constructor(config: KimiCliAgentProviderConfig);
-    close(): Promise<void>;
+    close(options?: AgentRuntimeCloseOptions): Promise<void>;
     run(input: AgentRuntimeInput): Promise<AgentRuntimeResult>;
     appendToActiveRun(input: AgentRuntimeFollowupInput): Promise<AgentRuntimeFollowupResult>;
     requestDrain(input: AgentRuntimeDrainInput): Promise<void>;

package/dist/server/providers/kimi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kimi.d.ts","sourceRoot":"","sources":["../../../server/providers/kimi.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAChC,MAAM,eAAe,CAAC;AAKvB,qBAAa,mBAAoB,YAAW,YAAY;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,UAAU,CAAC,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,MAAM,EAAE,0BAA0B;IAKxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8B1D,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAQxF,YAAY,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;YAOlD,gBAAgB;IA8B9B,OAAO,CAAC,QAAQ;YAcF,eAAe;CAO9B"}
+{"version":3,"file":"kimi.d.ts","sourceRoot":"","sources":["../../../server/providers/kimi.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAChC,MAAM,eAAe,CAAC;AAKvB,qBAAa,mBAAoB,YAAW,YAAY;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,UAAU,CAAC,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,MAAM,EAAE,0BAA0B;IAKxC,KAAK,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8B1D,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAQxF,YAAY,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;YAOlD,gBAAgB;IA8B9B,OAAO,CAAC,QAAQ;YAcF,eAAe;CAY9B"}

package/dist/server/providers/kimi.js

@@ -5,7 +5,7 @@ import { nowIso } from '../ids.js';
 import { isRecord, singleLineForActivity, stringField } from '../json.js';
 import { ActiveRuntimeRun } from './active-runtime.js';
 import { runtimeErrorPayload, truncateForActivity } from '../activities/format.js';
-import { startChildProcess } from './child-process.js';
+import { startChildProcess, terminateChildProcess } from './child-process.js';
 import { kimiInitializeEvent, recordKimiWireEvent } from './kimi-events.js';
 import { providerSessionPayload, } from './contract.js';
 const KIMI_COMMAND = 'kimi';
@@ -20,8 +20,8 @@ export class KimiCliAgentRuntime {
         this.config = config;
         this.env = config.env;
     }
-    async close() {
-        await this.resetController();
+    async close(options = {}) {
+        await this.resetController(options.signal, options);
     }
     async run(input) {
         await input.effects.recordRuntime('runtime.started', {
@@ -112,13 +112,15 @@ export class KimiCliAgentRuntime {
             args.push('--model', this.config.model);
         return args;
     }
-    async resetController(signal = 'SIGTERM') {
+    async resetController(signal = 'SIGTERM', options = {}) {
         const controller = this.controller;
         if (!controller)
             return;
         this.controller = undefined;
-        controller.kill(signal);
-        await controller.completion.catch(() => { });
+        await terminateChildProcess(controller, {
+            signal,
+            ...(options.forceAfterMs === undefined ? {} : { forceAfterMs: options.forceAfterMs }),
+        });
     }
 }
 class KimiWireController {

package/dist/server/runtime/agent-restart-command.store.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+declare const AgentRestartCommandSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    reason: z.ZodLiteral<"operator_restart">;
+    requestId: z.ZodString;
+    requestedAt: z.ZodString;
+}, z.core.$strip>;
+export type AgentRestartCommand = z.infer<typeof AgentRestartCommandSchema>;
+export declare class AgentRestartCommandStore {
+    private readonly options;
+    private readonly store;
+    constructor(options?: {
+        animaHome?: string;
+    });
+    directory(): string;
+    filename(): string;
+    path(): string;
+    ensureDirectory(): Promise<void>;
+    request(agentId: string): Promise<AgentRestartCommand>;
+    pendingAgentIds(): Promise<string[]>;
+    take(agentId: string): Promise<AgentRestartCommand | undefined>;
+    clear(agentId: string): Promise<void>;
+    private animaHome;
+}
+export declare const defaultAgentRestartCommandStore: AgentRestartCommandStore;
+export {};
+//# sourceMappingURL=agent-restart-command.store.d.ts.map

package/dist/server/runtime/agent-restart-command.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-restart-command.store.d.ts","sourceRoot":"","sources":["../../../server/runtime/agent-restart-command.store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,QAAA,MAAM,yBAAyB;;;;;iBAK7B,CAAC;AAMH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,qBAAa,wBAAwB;IAGvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+D;gBAExD,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAQjE,SAAS,IAAI,MAAM;IAInB,QAAQ,IAAI,MAAM;IAIlB,IAAI,IAAI,MAAM;IAIR,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgBtD,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIpC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAY/D,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3C,OAAO,CAAC,SAAS;CAGlB;AAED,eAAO,MAAM,+BAA+B,0BAAiC,CAAC"}

package/dist/server/runtime/agent-restart-command.store.js

@@ -0,0 +1,84 @@
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { resolveAnimaHome } from '../anima-home.js';
+import { nowIso } from '../ids.js';
+import { JsonStore } from '../storage/json-store.js';
+const RESTART_COMMANDS_FILE = 'agent-restart-requests.json';
+const AgentRestartCommandSchema = z.object({
+    agentId: z.string().min(1),
+    reason: z.literal('operator_restart'),
+    requestId: z.string().min(1),
+    requestedAt: z.string().min(1),
+});
+const AgentRestartCommandStoreSchema = z.object({
+    requests: z.record(z.string(), AgentRestartCommandSchema),
+});
+export class AgentRestartCommandStore {
+    options;
+    store;
+    constructor(options = {}) {
+        this.options = options;
+        this.store = new JsonStore({
+            empty: () => ({ requests: {} }),
+            parse: (value) => AgentRestartCommandStoreSchema.parse(value),
+            path: () => this.path(),
+        });
+    }
+    directory() {
+        return join(this.animaHome(), 'run');
+    }
+    filename() {
+        return RESTART_COMMANDS_FILE;
+    }
+    path() {
+        return join(this.directory(), this.filename());
+    }
+    async ensureDirectory() {
+        await mkdir(this.directory(), { recursive: true });
+    }
+    async request(agentId) {
+        const command = {
+            agentId,
+            reason: 'operator_restart',
+            requestId: randomUUID(),
+            requestedAt: nowIso(),
+        };
+        await this.store.update((current) => ({
+            requests: {
+                ...current.requests,
+                [agentId]: command,
+            },
+        }));
+        return command;
+    }
+    async pendingAgentIds() {
+        return Object.keys((await this.store.read()).requests).sort();
+    }
+    async take(agentId) {
+        let command;
+        await this.store.update((current) => {
+            command = current.requests[agentId];
+            if (!command)
+                return current;
+            const next = { ...current.requests };
+            delete next[agentId];
+            return { requests: next };
+        });
+        return command;
+    }
+    async clear(agentId) {
+        await this.store.update((current) => {
+            if (!current.requests[agentId])
+                return current;
+            const next = { ...current.requests };
+            delete next[agentId];
+            return { requests: next };
+        });
+    }
+    animaHome() {
+        return this.options.animaHome ?? resolveAnimaHome();
+    }
+}
+export const defaultAgentRestartCommandStore = new AgentRestartCommandStore();

package/dist/server/runtime/agent-runner.d.ts

@@ -1,4 +1,5 @@
 import type { AgentRuntime } from '../providers/contract.js';
+import { type AgentRuntimeWorkerCloseOptions } from './runtime-worker.js';
 import type { RuntimeWorkerConfig } from './types.js';
 interface RunningAgentOptions extends RuntimeWorkerConfig {
     agentRuntime: AgentRuntime;
@@ -8,9 +9,7 @@ interface RunningAgentOptions extends RuntimeWorkerConfig {
 }
 export interface RunningAgentHandle {
     isActive?(): boolean;
-    stop(options?: {
-        drainActive?: boolean;
-    }): Promise<void>;
+    stop(options?: AgentRuntimeWorkerCloseOptions): Promise<void>;
 }
 export declare function startRunningAgent(options: RunningAgentOptions): Promise<RunningAgentHandle>;
 export {};

package/dist/server/runtime/agent-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../../server/runtime/agent-runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtD,UAAU,mBAAoB,SAAQ,mBAAmB;IACvD,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,OAAO,CAAC;IACrB,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2CjG"}
+{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../../server/runtime/agent-runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAsB,KAAK,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtD,UAAU,mBAAoB,SAAQ,mBAAmB;IACvD,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,OAAO,CAAC;IACrB,IAAI,CAAC,OAAO,CAAC,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2CjG"}

package/dist/server/runtime/agent-runner.js

@@ -44,7 +44,7 @@ export async function startRunningAgent(options) {
         async stop(stopOptions = {}) {
             await Promise.allSettled([
                 subscriber.stop(),
-                worker.close({ drainActive: stopOptions.drainActive }),
+                worker.close(stopOptions),
             ]);
         },
     };

package/dist/server/runtime/host.d.ts

@@ -1,4 +1,5 @@
 import type { AgentConfig } from '../../shared/agent-config.js';
+import { AgentRestartCommandStore } from './agent-restart-command.store.js';
 import { type RunningAgentHandle } from './agent-runner.js';
 export interface RuntimeHostOptions {
     agent?: string;
@@ -7,9 +8,11 @@ export interface RuntimeHostOptions {
 export type { RunningAgentHandle } from './agent-runner.js';
 export interface RuntimeHostDependencies {
     animaHome?: string;
+    forceRestartTimeoutMs?: number;
     loadAgents?: (opts: RuntimeHostOptions) => Promise<AgentConfig[]>;
     ensureDefaultSkills?: () => Promise<void>;
     logger?: Pick<Console, 'error' | 'log'>;
+    restartCommands?: AgentRestartCommandStore;
     startAgent?: (agent: AgentConfig, animaHome: string) => Promise<RunningAgentHandle>;
     validateAgent?: (agent: AgentConfig) => Promise<void> | void;
 }
@@ -21,12 +24,15 @@ export declare class RuntimeHost {
     private readonly loadAgents;
     private readonly ensureDefaultSkills;
     private readonly logger;
+    private readonly restartCommands;
+    private readonly forceRestartTimeoutMs;
     private readonly startAgent;
     private readonly statusByAgent;
     private readonly validateAgent;
     private pollTimer?;
     private reconcile?;
     private readonly configWatchers;
+    private restartCommandWatcher?;
     private configWatchDebounce?;
     constructor(opts?: RuntimeHostOptions, deps?: RuntimeHostDependencies);
     start(): Promise<void>;
@@ -34,13 +40,17 @@ export declare class RuntimeHost {
     reconcileOnce(): Promise<void>;
     runningAgentIds(): string[];
     private reconcileAgents;
+    private forceRestartAgent;
     private reconcileRunningAgent;
     private startAndStore;
     private stopMissingAgents;
+    private clearMissingRestartCommands;
     private logAgentStatus;
     private syncConfigWatchers;
     private scheduleConfigReconcile;
     private closeConfigWatchers;
+    private syncRestartCommandWatcher;
+    private closeRestartCommandWatcher;
 }
 export declare function loadRuntimeAgents(opts?: RuntimeHostOptions): Promise<AgentConfig[]>;
 //# sourceMappingURL=host.d.ts.map

package/dist/server/runtime/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../server/runtime/host.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG/E,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAO5D,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAClE,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9D;AAKD,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnF;AAED,qBAAa,WAAW;IAepB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAdvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuD;IAClF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyE;IACpG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+C;IAC7E,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,SAAS,CAAC,CAAgB;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAC/D,OAAO,CAAC,mBAAmB,CAAC,CAAiB;gBAG1B,IAAI,GAAE,kBAAuB,EAC9C,IAAI,GAAE,uBAA4B;IAY9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBrB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAWpC,eAAe,IAAI,MAAM,EAAE;YAIb,eAAe;YAgCf,qBAAqB;YAmCrB,aAAa;YAMb,iBAAiB;IAgB/B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,mBAAmB;CAI5B;AAED,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAG7F"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../server/runtime/host.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EACL,wBAAwB,EAEzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG/E,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAO5D,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAClE,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,wBAAwB,CAAC;IAC3C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9D;AAMD,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnF;AAED,qBAAa,WAAW;IAkBpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAjBvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuD;IAClF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAC3D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyE;IACpG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+C;IAC7E,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,SAAS,CAAC,CAAgB;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAC/D,OAAO,CAAC,qBAAqB,CAAC,CAAY;IAC1C,OAAO,CAAC,mBAAmB,CAAC,CAAiB;gBAG1B,IAAI,GAAE,kBAAuB,EAC9C,IAAI,GAAE,uBAA4B;IAc9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBrB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAWpC,eAAe,IAAI,MAAM,EAAE;YAIb,eAAe;YAyCf,iBAAiB;YAwBjB,qBAAqB;YAmCrB,aAAa;YAMb,iBAAiB;YAgBjB,2BAA2B;IAWzC,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,yBAAyB;IAmBjC,OAAO,CAAC,0BAA0B;CAInC;AAED,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAG7F"}

package/dist/server/runtime/host.js

@@ -7,9 +7,11 @@ import { resolveAnimaHome } from '../anima-home.js';
 import { errorMessage } from '../ids.js';
 import { createAgentRuntime } from '../providers/factory.js';
 import { createSlackWebClient } from '../slack/client.js';
+import { AgentRestartCommandStore, } from './agent-restart-command.store.js';
 import { startRunningAgent } from './agent-runner.js';
 const DEFAULT_RECONCILE_INTERVAL_MS = 30_000;
 const CONFIG_WATCH_DEBOUNCE_MS = 150;
+const AGENT_RESTART_FORCE_KILL_AFTER_MS = 5_000;
 export async function startRuntimeHost(opts = {}) {
     const host = new RuntimeHost(opts);
     await host.start();
@@ -24,12 +26,15 @@ export class RuntimeHost {
     loadAgents;
     ensureDefaultSkills;
     logger;
+    restartCommands;
+    forceRestartTimeoutMs;
     startAgent;
     statusByAgent = new Map();
     validateAgent;
     pollTimer;
     reconcile;
     configWatchers = new Map();
+    restartCommandWatcher;
     configWatchDebounce;
     constructor(opts = {}, deps = {}) {
         this.opts = opts;
@@ -39,10 +44,14 @@ export class RuntimeHost {
             await ensureDefaultSkills();
         });
         this.logger = deps.logger ?? console;
+        this.restartCommands = deps.restartCommands ?? new AgentRestartCommandStore({ animaHome: this.animaHome });
+        this.forceRestartTimeoutMs = deps.forceRestartTimeoutMs ?? AGENT_RESTART_FORCE_KILL_AFTER_MS;
         this.startAgent = deps.startAgent ?? startAgentFromConfig;
         this.validateAgent = deps.validateAgent ?? validateAgentConfig;
     }
     async start() {
+        await this.restartCommands.ensureDirectory();
+        this.syncRestartCommandWatcher();
         await this.ensureDefaultSkills().catch((error) => {
             this.logger.error(`Default skill setup failed: ${errorMessage(error)}`);
         });
@@ -63,6 +72,7 @@ export class RuntimeHost {
             this.configWatchDebounce = undefined;
         }
         this.closeConfigWatchers();
+        this.closeRestartCommandWatcher();
         await this.reconcile?.catch((error) => {
             this.logger.error(`Runtime host reconcile failed while stopping: ${errorMessage(error)}`);
         });
@@ -89,6 +99,7 @@ export class RuntimeHost {
     async reconcileAgents() {
         const agents = await this.loadAgents(this.opts);
         this.syncConfigWatchers(agents.map((agent) => agent.id));
+        const pendingRestartAgentIds = new Set(await this.restartCommands.pendingAgentIds());
         const seenAgentIds = new Set();
         for (const agent of agents) {
             seenAgentIds.add(agent.id);
@@ -96,6 +107,13 @@ export class RuntimeHost {
             try {
                 await this.validateAgent(agent);
                 const skipStatus = agentSkipStatus(agent);
+                const restartCommand = pendingRestartAgentIds.has(agent.id)
+                    ? await this.restartCommands.take(agent.id)
+                    : undefined;
+                if (restartCommand) {
+                    await this.forceRestartAgent(agent, running, skipStatus, restartCommand);
+                    continue;
+                }
                 if (running) {
                     await this.reconcileRunningAgent(agent, running, skipStatus);
                     continue;
@@ -116,9 +134,29 @@ export class RuntimeHost {
                 });
             }
         }
+        await this.clearMissingRestartCommands(seenAgentIds, pendingRestartAgentIds);
         if (!this.opts.agent)
             await this.stopMissingAgents(seenAgentIds);
     }
+    async forceRestartAgent(agent, running, skipStatus, command) {
+        if (skipStatus) {
+            this.logAgentStatus(agent.id, `restart-skip:${skipStatus}`, () => {
+                this.logger.log(`Agent ${agent.id}: restart ${command.requestId} skipped; ${skipStatus}.`);
+            });
+            if (running)
+                await this.reconcileRunningAgent(agent, running, skipStatus);
+            return;
+        }
+        this.logger.log(`Agent ${agent.id}: restart requested by operator (${command.requestId}).`);
+        if (running) {
+            await running.handle.stop({
+                abortReason: command.reason,
+                forceAfterMs: this.forceRestartTimeoutMs,
+            });
+            this.agentHandles.delete(agent.id);
+        }
+        await this.startAndStore(agent);
+    }
     async reconcileRunningAgent(agent, running, skipStatus) {
         if (skipStatus) {
             if (isHandleActive(running.handle)) {
@@ -169,6 +207,14 @@ export class RuntimeHost {
             this.logger.log(`Agent ${agentId}: removed from config; stopped.`);
         }
     }
+    async clearMissingRestartCommands(seenAgentIds, pendingRestartAgentIds) {
+        for (const agentId of pendingRestartAgentIds) {
+            if (seenAgentIds.has(agentId))
+                continue;
+            await this.restartCommands.clear(agentId);
+            this.logger.log(`Agent ${agentId}: restart request discarded; agent not found.`);
+        }
+    }
     logAgentStatus(agentId, status, write) {
         if (this.statusByAgent.get(agentId) === status)
             return;
@@ -227,6 +273,32 @@ export class RuntimeHost {
             watcher.close();
         this.configWatchers.clear();
     }
+    syncRestartCommandWatcher() {
+        if (this.restartCommandWatcher)
+            return;
+        const runDir = this.restartCommands.directory();
+        try {
+            const watcher = watch(runDir, { persistent: false }, (_event, filename) => {
+                if (filename && filename.toString() !== this.restartCommands.filename())
+                    return;
+                this.scheduleConfigReconcile();
+            });
+            watcher.on('error', (error) => {
+                this.logger.error(`Runtime host restart-command watcher failed for ${runDir}: ${errorMessage(error)}`);
+                watcher.close();
+                if (this.restartCommandWatcher === watcher)
+                    this.restartCommandWatcher = undefined;
+            });
+            this.restartCommandWatcher = watcher;
+        }
+        catch (error) {
+            this.logger.error(`Runtime host restart-command watcher failed for ${runDir}: ${errorMessage(error)}`);
+        }
+    }
+    closeRestartCommandWatcher() {
+        this.restartCommandWatcher?.close();
+        this.restartCommandWatcher = undefined;
+    }
 }
 export async function loadRuntimeAgents(opts = {}) {
     if (opts.agent)