@agimon-ai/po-autostop 0.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vuong Ngo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# @agimon-ai/po-autostop
+
+Shuts a [Po](https://www.npmjs.com/package/@agimon-ai/po) session down once the agent
+settles and stays idle.
+
+A scripted run wants the session to exit on its own when the work is done. Waiting for
+`agent_settled` alone is not enough: the agent can settle and immediately pick up a queued
+message, and it can settle while the last response is still streaming. So this package settles,
+waits, looks again, and only then stops.
+
+## The policy
+
+| Moment             | Session state                     | Outcome              |
+| ------------------ | --------------------------------- | -------------------- |
+| `agent_settled`    | messages queued                   | stand down           |
+| `agent_settled`    | queue empty                       | look again in 5s     |
+| the scheduled look | messages queued                   | stand down           |
+| the scheduled look | background runner or agent active | look again in 5s     |
+| the scheduled look | still streaming                   | look again in 100ms  |
+| the scheduled look | idle, queue and background empty  | `context.shutdown()` |
+
+Any `input` or `agent_start` event disarms a pending stop. The cooldown is the grace period;
+the 100 ms recheck waits out a stream that has not finished draining. Only two kinds of
+background work keep a settled session alive: supervised Runner processes (`doom-runner`)
+while running or awaiting asynchronous completion admission (published without a status).
+A runner listed as `completed` or `failed` no longer counts. Owned subagents (`team-direct-runs`, `doom-task`) owned by the current session, including
+provider errors from them. The holding rule is shared with workflow step supervision through core's
+`holdsSettledSession`. Workflow runs (`workflow-mcp`) do not hold a session open.
+
+Each wait is recorded as `doom_autostop.waiting_on_background_work` telemetry naming the work
+holding the session, along with `doom_autostop.stood_down` and `doom_autostop.shutdown_requested`.
+
+The idle shutdown watch adds the authoritative background-work gate before the policy may stop the session.
+
+## License
+
+MIT

package/dist/apiContracts.cjs

@@ -0,0 +1,17 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = (0, require("@agimon-ai/po-core/apiContracts").defineApiContract)({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["defineApiContract"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;;;;AAGA,MAAa,gBAAA,4CAAeA,CAAAA,CAAAA,kBAAAA,CAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/apiContracts.d.mts

@@ -0,0 +1,53 @@
+//#region src/schemas/apiContracts.d.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAGa"}

package/dist/apiContracts.mjs

@@ -0,0 +1,13 @@
+import { defineApiContract } from "@agimon-ai/po-core/apiContracts";
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = defineApiContract({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+export { apiContracts, apiContracts as default };
+
+//# sourceMappingURL=apiContracts.mjs.map

package/dist/apiContracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAa,eAAe,kBAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/extensions/server.cjs

@@ -0,0 +1,287 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_idlePolicy = require("../idlePolicy-Dw8blgEH.cjs");
+let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
+let _agimon_ai_po_telemetry = require("@agimon-ai/po-telemetry");
+let _agimon_ai_po_core_backgroundWork = require("@agimon-ai/po-core/backgroundWork");
+//#region src/services/autostopDiagnostics/index.ts
+function detail(values) {
+	const joined = values.join(", ");
+	return joined.length > 500 ? `${joined.slice(0, 499)}…` : joined;
+}
+/**
+* Report what an idle session is waiting on before it stops.
+*
+* The first wait is reported at once and a long one again each interval, so a
+* session held open for an hour names the work holding it without flooding
+* the sink every cooldown.
+*/
+function createAutostopDiagnostics(options) {
+	const reportIntervalMs = options.reportIntervalMs ?? 6e4;
+	const flushTimeoutMs = options.flushTimeoutMs ?? 2e3;
+	let waitStartedAt;
+	let lastReportedAt;
+	let deferrals = 0;
+	const record = (event, attributes) => {
+		options.telemetry.recordEvent(event, attributes).catch(() => void 0);
+	};
+	const waitAttributes = (now) => ({
+		deferral_count: deferrals,
+		waited_ms: waitStartedAt === void 0 ? 0 : now - waitStartedAt
+	});
+	const reset = () => {
+		waitStartedAt = void 0;
+		lastReportedAt = void 0;
+		deferrals = 0;
+	};
+	return {
+		waiting(work) {
+			const now = options.now();
+			waitStartedAt ??= now;
+			deferrals += 1;
+			if (lastReportedAt !== void 0 && now - lastReportedAt < reportIntervalMs) return;
+			lastReportedAt = now;
+			record(require_idlePolicy.AUTO_STOP_EVENT.waitingOnBackgroundWork, {
+				...waitAttributes(now),
+				item_count: work.items.length,
+				error_count: work.errors.length,
+				items: detail(work.items),
+				errors: detail(work.errors)
+			});
+		},
+		stoodDown() {
+			record(require_idlePolicy.AUTO_STOP_EVENT.stoodDown, {
+				...waitAttributes(options.now()),
+				reason: "pending_messages"
+			});
+			reset();
+		},
+		shutdownRequested() {
+			record(require_idlePolicy.AUTO_STOP_EVENT.shutdownRequested, waitAttributes(options.now()));
+			reset();
+		},
+		reset,
+		async dispose() {
+			let timer;
+			await Promise.race([options.telemetry.shutdown().catch(() => void 0), new Promise((settle) => {
+				timer = setTimeout(settle, flushTimeoutMs);
+				timer.unref?.();
+			})]);
+			if (timer) clearTimeout(timer);
+		}
+	};
+}
+//#endregion
+//#region src/services/backgroundWorkGate/index.ts
+const NO_WORK$1 = Object.freeze({
+	active: false,
+	items: [],
+	errors: []
+});
+/**
+* Tracks the current background-work coordinator. Only runners and subagents
+* count, and it fails closed when their snapshot is uncertain.
+*/
+function createBackgroundWorkGate() {
+	let backgroundWork;
+	const inspect = (sessionId) => {
+		if (!backgroundWork) return NO_WORK$1;
+		try {
+			const snapshot = backgroundWork.snapshot(sessionId);
+			const items = snapshot.items.filter(_agimon_ai_po_core_backgroundWork.holdsSettledSession).map((item) => `${item.provider}:${item.id}`);
+			const errors = snapshot.errors.filter((error) => _agimon_ai_po_core_backgroundWork.BACKGROUND_WORK_HOLDING_PROVIDERS.includes(error.provider)).map((error) => `${error.provider}: ${error.message}`);
+			return {
+				active: items.length > 0 || errors.length > 0,
+				items,
+				errors
+			};
+		} catch (error) {
+			return {
+				active: true,
+				items: [],
+				errors: [`snapshot: ${error instanceof Error ? error.message : String(error)}`]
+			};
+		}
+	};
+	return {
+		plugin: (context) => {
+			context.inject([_agimon_ai_po_core_backgroundWork.DOOM_BACKGROUND_WORK_SERVICE], (serviceContext) => {
+				const service = (0, _agimon_ai_po_core_backgroundWork.readDoomBackgroundWorkService)(serviceContext);
+				if (!service) return void 0;
+				backgroundWork = service;
+				return () => {
+					if (backgroundWork === service) backgroundWork = void 0;
+				};
+			});
+		},
+		hasActiveWork: (sessionId) => inspect(sessionId).active,
+		inspect
+	};
+}
+//#endregion
+//#region src/services/serverIdleShutdown/index.ts
+const NO_WORK = Object.freeze({
+	active: false,
+	items: [],
+	errors: []
+});
+function createServerIdleShutdown(host, inspectBackgroundWork = () => NO_WORK, delays = require_idlePolicy.DEFAULT_AUTO_STOP_DELAYS, diagnostics) {
+	let timer;
+	let watching = false;
+	let disposed = false;
+	let generation = 0;
+	const stopWatching = () => {
+		generation += 1;
+		if (timer !== void 0) clearTimeout(timer);
+		timer = void 0;
+		watching = false;
+		diagnostics?.reset();
+	};
+	const schedule = (delayMs) => {
+		if (disposed) return;
+		if (timer !== void 0) clearTimeout(timer);
+		watching = true;
+		const expected = ++generation;
+		timer = setTimeout(() => {
+			timer = void 0;
+			recheck(expected).catch(() => {
+				if (expected === generation) stopWatching();
+			});
+		}, delayMs);
+	};
+	const recheck = async (expected) => {
+		if (disposed || !watching || expected !== generation) return;
+		const work = inspectBackgroundWork();
+		if (work.active) {
+			diagnostics?.waiting(work);
+			schedule(delays.cooldownMs);
+			return;
+		}
+		const activity = await host.context.session.activity();
+		if (disposed || !watching || expected !== generation) return;
+		const currentWork = inspectBackgroundWork();
+		if (currentWork.active) {
+			diagnostics?.waiting(currentWork);
+			schedule(delays.cooldownMs);
+			return;
+		}
+		const decision = require_idlePolicy.decideOnRecheck(activity, delays);
+		if (decision.action === "shutdown") {
+			diagnostics?.shutdownRequested();
+			stopWatching();
+			host.context.shutdown();
+		} else if (decision.action === "stand-down") {
+			diagnostics?.stoodDown();
+			stopWatching();
+		} else schedule(decision.delayMs);
+	};
+	return {
+		hooks: [
+			{
+				event: "agent_start",
+				handle: stopWatching
+			},
+			{
+				event: "agent_settled",
+				async handle() {
+					stopWatching();
+					const expected = generation;
+					const activity = await host.context.session.activity();
+					if (disposed || expected !== generation) return;
+					const decision = require_idlePolicy.decideOnSettled(activity, delays);
+					if (decision.action === "recheck") schedule(decision.delayMs);
+					else diagnostics?.stoodDown();
+				}
+			},
+			{
+				event: "session_shutdown",
+				handle: stopWatching
+			},
+			{
+				event: "session_tree",
+				handle: () => recheck(generation)
+			}
+		],
+		dispose() {
+			disposed = true;
+			stopWatching();
+		}
+	};
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/root.server.ts
+var root_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoot)(({ agent }) => {
+	if (!agent) throw new Error("Autostop requires a session host.");
+	const backgroundWork = createBackgroundWorkGate();
+	const diagnostics = createAutostopDiagnostics({
+		telemetry: (0, _agimon_ai_po_telemetry.createDoomTelemetry)({
+			serviceName: "doom-autostop",
+			packageName: "@agimon-ai/po-autostop",
+			enableLogs: true,
+			enableTraces: false
+		}),
+		now: Date.now
+	});
+	const watch = createServerIdleShutdown(agent, () => backgroundWork.inspect(agent.context.sessionId), void 0, diagnostics);
+	return {
+		value: watch,
+		services: [backgroundWork.plugin],
+		onDispose: async () => {
+			watch.dispose();
+			await diagnostics.dispose();
+		}
+	};
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/agent-settled.server.ts
+var agent_settled_server_default = (0, _agimon_ai_po_core_extensionFile.defineHook)((context) => context.root.hooks.find((hook) => hook.event === "agent_settled"));
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/agent-start.server.ts
+var agent_start_server_default = (0, _agimon_ai_po_core_extensionFile.defineHook)((context) => context.root.hooks.find((hook) => hook.event === "agent_start"));
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/session-shutdown.server.ts
+var session_shutdown_server_default = (0, _agimon_ai_po_core_extensionFile.defineHook)((context) => context.root.hooks.find((hook) => hook.event === "session_shutdown"));
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/session-tree.server.ts
+var session_tree_server_default = (0, _agimon_ai_po_core_extensionFile.defineHook)((context) => context.root.hooks.find((hook) => hook.event === "session_tree"));
+//#endregion
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
+	name: "@agimon-ai/po-autostop",
+	providerOverrides: (0, _agimon_ai_po_core_serverFacet.composeServerProviderOverrides)(root_server_default),
+	session: async (context) => {
+		const scopeSession = await root_server_default(context);
+		const contextSession = {
+			...context,
+			root: scopeSession.value
+		};
+		return {
+			...(0, _agimon_ai_po_core_extensionFile.composeRootHooks)(scopeSession),
+			get hooks() {
+				return [
+					via({ event: "agent_settled" }, at(agent_settled_server_default, contextSession)),
+					via({ event: "agent_start" }, at(agent_start_server_default, contextSession)),
+					via({ event: "session_shutdown" }, at(session_shutdown_server_default, contextSession)),
+					via({ event: "session_tree" }, at(session_tree_server_default, contextSession))
+				];
+			},
+			services: [...scopeSession.services ?? []],
+			get activities() {
+				return [...scopeSession.activities ?? []];
+			}
+		};
+	}
+});
+//#endregion
+exports.default = facet;
+exports.facet = facet;
+
+//# sourceMappingURL=server.cjs.map

package/dist/extensions/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","names":["AUTO_STOP_EVENT","NO_WORK","holdsSettledSession","BACKGROUND_WORK_HOLDING_PROVIDERS","DOOM_BACKGROUND_WORK_SERVICE","readDoomBackgroundWorkService","DEFAULT_AUTO_STOP_DELAYS","decideOnRecheck","decideOnSettled","defineRoot","createDoomTelemetry","defineHook","defineHook","defineHook","defineHook","defineServerPlugin","composeServerProviderOverrides","rootSession","composeRootHooks","hookAgentSettled","hookAgentStart","hookSessionShutdown","hookSessionTree"],"sources":["../../src/services/autostopDiagnostics/index.ts","../../src/services/backgroundWorkGate/index.ts","../../src/services/serverIdleShutdown/index.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/hook/agent-settled.server.ts","../../src/extensions/workspaces/sessions/(backend)/hook/agent-start.server.ts","../../src/extensions/workspaces/sessions/(backend)/hook/session-shutdown.server.ts","../../src/extensions/workspaces/sessions/(backend)/hook/session-tree.server.ts","../../generated/server.ts"],"sourcesContent":["import {\n  AUTO_STOP_DETAIL_MAX_LENGTH,\n  AUTO_STOP_EVENT,\n  AUTO_STOP_REPORT_INTERVAL_MS,\n  AUTO_STOP_TELEMETRY_FLUSH_MS,\n} from '../../constants/idlePolicy';\nimport type { AutostopDiagnostics, AutostopDiagnosticsOptions, AutostopEventAttributes } from './type';\n\nfunction detail(values: readonly string[]): string {\n  const joined = values.join(', ');\n  return joined.length > AUTO_STOP_DETAIL_MAX_LENGTH ? `${joined.slice(0, AUTO_STOP_DETAIL_MAX_LENGTH - 1)}…` : joined;\n}\n\n/**\n * Report what an idle session is waiting on before it stops.\n *\n * The first wait is reported at once and a long one again each interval, so a\n * session held open for an hour names the work holding it without flooding\n * the sink every cooldown.\n */\nexport function createAutostopDiagnostics(options: AutostopDiagnosticsOptions): AutostopDiagnostics {\n  const reportIntervalMs = options.reportIntervalMs ?? AUTO_STOP_REPORT_INTERVAL_MS;\n  const flushTimeoutMs = options.flushTimeoutMs ?? AUTO_STOP_TELEMETRY_FLUSH_MS;\n  let waitStartedAt: number | undefined;\n  let lastReportedAt: number | undefined;\n  let deferrals = 0;\n\n  const record = (event: string, attributes: AutostopEventAttributes): void => {\n    // Diagnostics must never change whether the session stops.\n    options.telemetry.recordEvent(event, attributes).catch(() => undefined);\n  };\n  const waitAttributes = (now: number): AutostopEventAttributes => ({\n    deferral_count: deferrals,\n    waited_ms: waitStartedAt === undefined ? 0 : now - waitStartedAt,\n  });\n  const reset = (): void => {\n    waitStartedAt = undefined;\n    lastReportedAt = undefined;\n    deferrals = 0;\n  };\n\n  return {\n    waiting(work) {\n      const now = options.now();\n      waitStartedAt ??= now;\n      deferrals += 1;\n      if (lastReportedAt !== undefined && now - lastReportedAt < reportIntervalMs) return;\n      lastReportedAt = now;\n      record(AUTO_STOP_EVENT.waitingOnBackgroundWork, {\n        ...waitAttributes(now),\n        item_count: work.items.length,\n        error_count: work.errors.length,\n        items: detail(work.items),\n        errors: detail(work.errors),\n      });\n    },\n    stoodDown() {\n      record(AUTO_STOP_EVENT.stoodDown, { ...waitAttributes(options.now()), reason: 'pending_messages' });\n      reset();\n    },\n    shutdownRequested() {\n      record(AUTO_STOP_EVENT.shutdownRequested, waitAttributes(options.now()));\n      reset();\n    },\n    reset,\n    async dispose() {\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      await Promise.race([\n        options.telemetry.shutdown().catch(() => undefined),\n        new Promise((settle) => {\n          timer = setTimeout(settle, flushTimeoutMs);\n          timer.unref?.();\n        }),\n      ]);\n      if (timer) clearTimeout(timer);\n    },\n  };\n}\n","import {\n  BACKGROUND_WORK_HOLDING_PROVIDERS,\n  DOOM_BACKGROUND_WORK_SERVICE,\n  holdsSettledSession,\n  readDoomBackgroundWorkService,\n  type DoomBackgroundWorkService,\n} from '@agimon-ai/po-core/backgroundWork';\nimport type { Context } from '@deepseek-ai/cordis';\n\n/** What is holding a session open, named so a stuck shutdown can say why. */\nexport interface BackgroundWorkSummary {\n  readonly active: boolean;\n  /** `provider:id` for each item the session still owns. */\n  readonly items: readonly string[];\n  /** `provider: message` for each provider whose snapshot failed. */\n  readonly errors: readonly string[];\n}\n\nexport interface BackgroundWorkGate {\n  readonly plugin: (context: Context) => void;\n  hasActiveWork(sessionId: string): boolean;\n  inspect(sessionId: string): BackgroundWorkSummary;\n}\n\nconst NO_WORK: BackgroundWorkSummary = Object.freeze({ active: false, items: [], errors: [] });\n\n/**\n * Tracks the current background-work coordinator. Only runners and subagents\n * count, and it fails closed when their snapshot is uncertain.\n */\nexport function createBackgroundWorkGate(): BackgroundWorkGate {\n  let backgroundWork: DoomBackgroundWorkService | undefined;\n  const inspect = (sessionId: string): BackgroundWorkSummary => {\n    if (!backgroundWork) return NO_WORK;\n    try {\n      const snapshot = backgroundWork.snapshot(sessionId);\n      const items = snapshot.items.filter(holdsSettledSession).map((item) => `${item.provider}:${item.id}`);\n      const errors = snapshot.errors\n        .filter((error) => BACKGROUND_WORK_HOLDING_PROVIDERS.includes(error.provider))\n        .map((error) => `${error.provider}: ${error.message}`);\n      return { active: items.length > 0 || errors.length > 0, items, errors };\n    } catch (error) {\n      return {\n        active: true,\n        items: [],\n        errors: [`snapshot: ${error instanceof Error ? error.message : String(error)}`],\n      };\n    }\n  };\n  return {\n    plugin: (context) => {\n      context.inject([DOOM_BACKGROUND_WORK_SERVICE], (serviceContext) => {\n        const service = readDoomBackgroundWorkService(serviceContext);\n        if (!service) return undefined;\n        backgroundWork = service;\n        return () => {\n          if (backgroundWork === service) backgroundWork = undefined;\n        };\n      });\n    },\n    hasActiveWork: (sessionId) => inspect(sessionId).active,\n    inspect,\n  };\n}\n","import type { DoomHeadlessHostService, DoomHeadlessHook } from '@agimon-ai/po-core/headless';\n\nimport { DEFAULT_AUTO_STOP_DELAYS } from '../../constants/idlePolicy';\nimport type { AutostopDiagnostics } from '../autostopDiagnostics/type';\nimport type { BackgroundWorkSummary } from '../backgroundWorkGate';\nimport { decideOnRecheck, decideOnSettled } from '../idlePolicy';\nimport type { AutoStopDelays } from '../idlePolicy/type';\nimport type { ServerIdleShutdown } from './type';\n\nconst NO_WORK: BackgroundWorkSummary = Object.freeze({ active: false, items: [], errors: [] });\n\nexport function createServerIdleShutdown(\n  host: DoomHeadlessHostService,\n  inspectBackgroundWork: () => BackgroundWorkSummary = () => NO_WORK,\n  delays: AutoStopDelays = DEFAULT_AUTO_STOP_DELAYS,\n  diagnostics?: Pick<AutostopDiagnostics, 'waiting' | 'stoodDown' | 'shutdownRequested' | 'reset'>,\n): ServerIdleShutdown {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let watching = false;\n  let disposed = false;\n  let generation = 0;\n  const stopWatching = (): void => {\n    generation += 1;\n    if (timer !== undefined) clearTimeout(timer);\n    timer = undefined;\n    watching = false;\n    diagnostics?.reset();\n  };\n  const schedule = (delayMs: number): void => {\n    if (disposed) return;\n    if (timer !== undefined) clearTimeout(timer);\n    watching = true;\n    const expected = ++generation;\n    timer = setTimeout(() => {\n      timer = undefined;\n      void recheck(expected).catch(() => {\n        // Unknown activity cannot justify stopping the session. Stand down.\n        if (expected === generation) stopWatching();\n      });\n    }, delayMs);\n  };\n  const recheck = async (expected: number): Promise<void> => {\n    if (disposed || !watching || expected !== generation) return;\n    const work = inspectBackgroundWork();\n    if (work.active) {\n      diagnostics?.waiting(work);\n      schedule(delays.cooldownMs);\n      return;\n    }\n    const activity = await host.context.session.activity();\n    if (disposed || !watching || expected !== generation) return;\n    // Background work can start while authoritative activity is being read.\n    const currentWork = inspectBackgroundWork();\n    if (currentWork.active) {\n      diagnostics?.waiting(currentWork);\n      schedule(delays.cooldownMs);\n      return;\n    }\n    const decision = decideOnRecheck(activity, delays);\n    if (decision.action === 'shutdown') {\n      diagnostics?.shutdownRequested();\n      stopWatching();\n      host.context.shutdown();\n    } else if (decision.action === 'stand-down') {\n      diagnostics?.stoodDown();\n      stopWatching();\n    } else schedule(decision.delayMs);\n  };\n\n  const hooks: DoomHeadlessHook[] = [\n    { event: 'agent_start', handle: stopWatching },\n    {\n      event: 'agent_settled',\n      async handle() {\n        stopWatching();\n        const expected = generation;\n        const activity = await host.context.session.activity();\n        if (disposed || expected !== generation) return;\n        const decision = decideOnSettled(activity, delays);\n        if (decision.action === 'recheck') schedule(decision.delayMs);\n        else diagnostics?.stoodDown();\n      },\n    },\n    { event: 'session_shutdown', handle: stopWatching },\n    { event: 'session_tree', handle: () => recheck(generation) },\n  ];\n  return {\n    hooks,\n    dispose() {\n      disposed = true;\n      stopWatching();\n    },\n  };\n}\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\nimport { createDoomTelemetry } from '@agimon-ai/po-telemetry';\n\nimport { createAutostopDiagnostics } from '../../../../services/autostopDiagnostics';\nimport { createBackgroundWorkGate } from '../../../../services/backgroundWorkGate';\nimport { createServerIdleShutdown } from '../../../../services/serverIdleShutdown';\nexport default defineRoot(({ agent }: DoomServerPluginContext) => {\n  if (!agent) throw new Error('Autostop requires a session host.');\n  const backgroundWork = createBackgroundWorkGate();\n  const diagnostics = createAutostopDiagnostics({\n    telemetry: createDoomTelemetry({\n      serviceName: 'doom-autostop',\n      packageName: '@agimon-ai/po-autostop',\n      enableLogs: true,\n      enableTraces: false,\n    }),\n    now: Date.now,\n  });\n  const watch = createServerIdleShutdown(\n    agent,\n    () => backgroundWork.inspect(agent.context.sessionId),\n    undefined,\n    diagnostics,\n  );\n  return {\n    value: watch,\n    services: [backgroundWork.plugin],\n    onDispose: async () => {\n      watch.dispose();\n      await diagnostics.dispose();\n    },\n  };\n});\n","import { defineHook, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\ntype AutoStopServerScope = Awaited<ReturnType<typeof import('../root.server').default>>['value'];\nexport default defineHook((context: WithRoot<DoomServerPluginContext, AutoStopServerScope>) =>\n  context.root.hooks.find((hook) => hook.event === 'agent_settled')!,\n);\n","import { defineHook, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\ntype AutoStopServerScope = Awaited<ReturnType<typeof import('../root.server').default>>['value'];\nexport default defineHook((context: WithRoot<DoomServerPluginContext, AutoStopServerScope>) =>\n  context.root.hooks.find((hook) => hook.event === 'agent_start')!,\n);\n","import { defineHook, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\ntype AutoStopServerScope = Awaited<ReturnType<typeof import('../root.server').default>>['value'];\nexport default defineHook((context: WithRoot<DoomServerPluginContext, AutoStopServerScope>) =>\n  context.root.hooks.find((hook) => hook.event === 'session_shutdown')!,\n);\n","import { defineHook, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\ntype AutoStopServerScope = Awaited<ReturnType<typeof import('../root.server').default>>['value'];\nexport default defineHook((context: WithRoot<DoomServerPluginContext, AutoStopServerScope>) =>\n  context.root.hooks.find((hook) => hook.event === 'session_tree')!,\n);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\nimport { composeServerProviderOverrides } from '@agimon-ai/po-core/serverFacet';\nimport { composeRootHooks } from '@agimon-ai/po-core/extensionFile';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.server';\nimport hookAgentSettled from '../src/extensions/workspaces/sessions/(backend)/hook/agent-settled.server';\nimport hookAgentStart from '../src/extensions/workspaces/sessions/(backend)/hook/agent-start.server';\nimport hookSessionShutdown from '../src/extensions/workspaces/sessions/(backend)/hook/session-shutdown.server';\nimport hookSessionTree from '../src/extensions/workspaces/sessions/(backend)/hook/session-tree.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/po-autostop',\n  providerOverrides: composeServerProviderOverrides(rootSession),\n  session: async (context) => {\n    const scopeSession = await rootSession(context);\n    const contextSession = { ...context, root: scopeSession.value };\n    return {\n      ...composeRootHooks(scopeSession),\n      get hooks(): DoomServerSessionPlugin['hooks'] { return [via({ event: 'agent_settled' }, at(hookAgentSettled, contextSession)), via({ event: 'agent_start' }, at(hookAgentStart, contextSession)), via({ event: 'session_shutdown' }, at(hookSessionShutdown, contextSession)), via({ event: 'session_tree' }, at(hookSessionTree, contextSession))]; },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): DoomServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default facet;\n"],"mappings":"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"}

package/dist/extensions/server.d.mts

@@ -0,0 +1,5 @@
+//#region generated/server.d.ts
+export declare const facet: import("@agimon-ai/po-core/serverFacet").DoomServerFacet;
+//#endregion
+export { facet as default };
+//# sourceMappingURL=server.d.mts.map

package/dist/extensions/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","names":[],"sources":["../../generated/server.ts"],"mappings":";qBAiBa,gDAAK"}

package/dist/extensions/server.mjs

@@ -0,0 +1,282 @@
+import { i as AUTO_STOP_EVENT, n as decideOnSettled, s as DEFAULT_AUTO_STOP_DELAYS, t as decideOnRecheck } from "../idlePolicy-BNLdwumq.mjs";
+import { composeServerProviderOverrides, defineServerPlugin } from "@agimon-ai/po-core/serverFacet";
+import { composeRootHooks, defineHook, defineRoot } from "@agimon-ai/po-core/extensionFile";
+import { createDoomTelemetry } from "@agimon-ai/po-telemetry";
+import { BACKGROUND_WORK_HOLDING_PROVIDERS, DOOM_BACKGROUND_WORK_SERVICE, holdsSettledSession, readDoomBackgroundWorkService } from "@agimon-ai/po-core/backgroundWork";
+//#region src/services/autostopDiagnostics/index.ts
+function detail(values) {
+	const joined = values.join(", ");
+	return joined.length > 500 ? `${joined.slice(0, 499)}…` : joined;
+}
+/**
+* Report what an idle session is waiting on before it stops.
+*
+* The first wait is reported at once and a long one again each interval, so a
+* session held open for an hour names the work holding it without flooding
+* the sink every cooldown.
+*/
+function createAutostopDiagnostics(options) {
+	const reportIntervalMs = options.reportIntervalMs ?? 6e4;
+	const flushTimeoutMs = options.flushTimeoutMs ?? 2e3;
+	let waitStartedAt;
+	let lastReportedAt;
+	let deferrals = 0;
+	const record = (event, attributes) => {
+		options.telemetry.recordEvent(event, attributes).catch(() => void 0);
+	};
+	const waitAttributes = (now) => ({
+		deferral_count: deferrals,
+		waited_ms: waitStartedAt === void 0 ? 0 : now - waitStartedAt
+	});
+	const reset = () => {
+		waitStartedAt = void 0;
+		lastReportedAt = void 0;
+		deferrals = 0;
+	};
+	return {
+		waiting(work) {
+			const now = options.now();
+			waitStartedAt ??= now;
+			deferrals += 1;
+			if (lastReportedAt !== void 0 && now - lastReportedAt < reportIntervalMs) return;
+			lastReportedAt = now;
+			record(AUTO_STOP_EVENT.waitingOnBackgroundWork, {
+				...waitAttributes(now),
+				item_count: work.items.length,
+				error_count: work.errors.length,
+				items: detail(work.items),
+				errors: detail(work.errors)
+			});
+		},
+		stoodDown() {
+			record(AUTO_STOP_EVENT.stoodDown, {
+				...waitAttributes(options.now()),
+				reason: "pending_messages"
+			});
+			reset();
+		},
+		shutdownRequested() {
+			record(AUTO_STOP_EVENT.shutdownRequested, waitAttributes(options.now()));
+			reset();
+		},
+		reset,
+		async dispose() {
+			let timer;
+			await Promise.race([options.telemetry.shutdown().catch(() => void 0), new Promise((settle) => {
+				timer = setTimeout(settle, flushTimeoutMs);
+				timer.unref?.();
+			})]);
+			if (timer) clearTimeout(timer);
+		}
+	};
+}
+//#endregion
+//#region src/services/backgroundWorkGate/index.ts
+const NO_WORK$1 = Object.freeze({
+	active: false,
+	items: [],
+	errors: []
+});
+/**
+* Tracks the current background-work coordinator. Only runners and subagents
+* count, and it fails closed when their snapshot is uncertain.
+*/
+function createBackgroundWorkGate() {
+	let backgroundWork;
+	const inspect = (sessionId) => {
+		if (!backgroundWork) return NO_WORK$1;
+		try {
+			const snapshot = backgroundWork.snapshot(sessionId);
+			const items = snapshot.items.filter(holdsSettledSession).map((item) => `${item.provider}:${item.id}`);
+			const errors = snapshot.errors.filter((error) => BACKGROUND_WORK_HOLDING_PROVIDERS.includes(error.provider)).map((error) => `${error.provider}: ${error.message}`);
+			return {
+				active: items.length > 0 || errors.length > 0,
+				items,
+				errors
+			};
+		} catch (error) {
+			return {
+				active: true,
+				items: [],
+				errors: [`snapshot: ${error instanceof Error ? error.message : String(error)}`]
+			};
+		}
+	};
+	return {
+		plugin: (context) => {
+			context.inject([DOOM_BACKGROUND_WORK_SERVICE], (serviceContext) => {
+				const service = readDoomBackgroundWorkService(serviceContext);
+				if (!service) return void 0;
+				backgroundWork = service;
+				return () => {
+					if (backgroundWork === service) backgroundWork = void 0;
+				};
+			});
+		},
+		hasActiveWork: (sessionId) => inspect(sessionId).active,
+		inspect
+	};
+}
+//#endregion
+//#region src/services/serverIdleShutdown/index.ts
+const NO_WORK = Object.freeze({
+	active: false,
+	items: [],
+	errors: []
+});
+function createServerIdleShutdown(host, inspectBackgroundWork = () => NO_WORK, delays = DEFAULT_AUTO_STOP_DELAYS, diagnostics) {
+	let timer;
+	let watching = false;
+	let disposed = false;
+	let generation = 0;
+	const stopWatching = () => {
+		generation += 1;
+		if (timer !== void 0) clearTimeout(timer);
+		timer = void 0;
+		watching = false;
+		diagnostics?.reset();
+	};
+	const schedule = (delayMs) => {
+		if (disposed) return;
+		if (timer !== void 0) clearTimeout(timer);
+		watching = true;
+		const expected = ++generation;
+		timer = setTimeout(() => {
+			timer = void 0;
+			recheck(expected).catch(() => {
+				if (expected === generation) stopWatching();
+			});
+		}, delayMs);
+	};
+	const recheck = async (expected) => {
+		if (disposed || !watching || expected !== generation) return;
+		const work = inspectBackgroundWork();
+		if (work.active) {
+			diagnostics?.waiting(work);
+			schedule(delays.cooldownMs);
+			return;
+		}
+		const activity = await host.context.session.activity();
+		if (disposed || !watching || expected !== generation) return;
+		const currentWork = inspectBackgroundWork();
+		if (currentWork.active) {
+			diagnostics?.waiting(currentWork);
+			schedule(delays.cooldownMs);
+			return;
+		}
+		const decision = decideOnRecheck(activity, delays);
+		if (decision.action === "shutdown") {
+			diagnostics?.shutdownRequested();
+			stopWatching();
+			host.context.shutdown();
+		} else if (decision.action === "stand-down") {
+			diagnostics?.stoodDown();
+			stopWatching();
+		} else schedule(decision.delayMs);
+	};
+	return {
+		hooks: [
+			{
+				event: "agent_start",
+				handle: stopWatching
+			},
+			{
+				event: "agent_settled",
+				async handle() {
+					stopWatching();
+					const expected = generation;
+					const activity = await host.context.session.activity();
+					if (disposed || expected !== generation) return;
+					const decision = decideOnSettled(activity, delays);
+					if (decision.action === "recheck") schedule(decision.delayMs);
+					else diagnostics?.stoodDown();
+				}
+			},
+			{
+				event: "session_shutdown",
+				handle: stopWatching
+			},
+			{
+				event: "session_tree",
+				handle: () => recheck(generation)
+			}
+		],
+		dispose() {
+			disposed = true;
+			stopWatching();
+		}
+	};
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/root.server.ts
+var root_server_default = defineRoot(({ agent }) => {
+	if (!agent) throw new Error("Autostop requires a session host.");
+	const backgroundWork = createBackgroundWorkGate();
+	const diagnostics = createAutostopDiagnostics({
+		telemetry: createDoomTelemetry({
+			serviceName: "doom-autostop",
+			packageName: "@agimon-ai/po-autostop",
+			enableLogs: true,
+			enableTraces: false
+		}),
+		now: Date.now
+	});
+	const watch = createServerIdleShutdown(agent, () => backgroundWork.inspect(agent.context.sessionId), void 0, diagnostics);
+	return {
+		value: watch,
+		services: [backgroundWork.plugin],
+		onDispose: async () => {
+			watch.dispose();
+			await diagnostics.dispose();
+		}
+	};
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/agent-settled.server.ts
+var agent_settled_server_default = defineHook((context) => context.root.hooks.find((hook) => hook.event === "agent_settled"));
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/agent-start.server.ts
+var agent_start_server_default = defineHook((context) => context.root.hooks.find((hook) => hook.event === "agent_start"));
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/session-shutdown.server.ts
+var session_shutdown_server_default = defineHook((context) => context.root.hooks.find((hook) => hook.event === "session_shutdown"));
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/session-tree.server.ts
+var session_tree_server_default = defineHook((context) => context.root.hooks.find((hook) => hook.event === "session_tree"));
+//#endregion
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const facet = defineServerPlugin({
+	name: "@agimon-ai/po-autostop",
+	providerOverrides: composeServerProviderOverrides(root_server_default),
+	session: async (context) => {
+		const scopeSession = await root_server_default(context);
+		const contextSession = {
+			...context,
+			root: scopeSession.value
+		};
+		return {
+			...composeRootHooks(scopeSession),
+			get hooks() {
+				return [
+					via({ event: "agent_settled" }, at(agent_settled_server_default, contextSession)),
+					via({ event: "agent_start" }, at(agent_start_server_default, contextSession)),
+					via({ event: "session_shutdown" }, at(session_shutdown_server_default, contextSession)),
+					via({ event: "session_tree" }, at(session_tree_server_default, contextSession))
+				];
+			},
+			services: [...scopeSession.services ?? []],
+			get activities() {
+				return [...scopeSession.activities ?? []];
+			}
+		};
+	}
+});
+//#endregion
+export { facet as default, facet };
+
+//# sourceMappingURL=server.mjs.map

package/dist/extensions/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":["NO_WORK","rootSession","hookAgentSettled","hookAgentStart","hookSessionShutdown","hookSessionTree"],"sources":["../../src/services/autostopDiagnostics/index.ts","../../src/services/backgroundWorkGate/index.ts","../../src/services/serverIdleShutdown/index.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/hook/agent-settled.server.ts","../../src/extensions/workspaces/sessions/(backend)/hook/agent-start.server.ts","../../src/extensions/workspaces/sessions/(backend)/hook/session-shutdown.server.ts","../../src/extensions/workspaces/sessions/(backend)/hook/session-tree.server.ts","../../generated/server.ts"],"sourcesContent":["import {\n  AUTO_STOP_DETAIL_MAX_LENGTH,\n  AUTO_STOP_EVENT,\n  AUTO_STOP_REPORT_INTERVAL_MS,\n  AUTO_STOP_TELEMETRY_FLUSH_MS,\n} from '../../constants/idlePolicy';\nimport type { AutostopDiagnostics, AutostopDiagnosticsOptions, AutostopEventAttributes } from './type';\n\nfunction detail(values: readonly string[]): string {\n  const joined = values.join(', ');\n  return joined.length > AUTO_STOP_DETAIL_MAX_LENGTH ? `${joined.slice(0, AUTO_STOP_DETAIL_MAX_LENGTH - 1)}…` : joined;\n}\n\n/**\n * Report what an idle session is waiting on before it stops.\n *\n * The first wait is reported at once and a long one again each interval, so a\n * session held open for an hour names the work holding it without flooding\n * the sink every cooldown.\n */\nexport function createAutostopDiagnostics(options: AutostopDiagnosticsOptions): AutostopDiagnostics {\n  const reportIntervalMs = options.reportIntervalMs ?? AUTO_STOP_REPORT_INTERVAL_MS;\n  const flushTimeoutMs = options.flushTimeoutMs ?? AUTO_STOP_TELEMETRY_FLUSH_MS;\n  let waitStartedAt: number | undefined;\n  let lastReportedAt: number | undefined;\n  let deferrals = 0;\n\n  const record = (event: string, attributes: AutostopEventAttributes): void => {\n    // Diagnostics must never change whether the session stops.\n    options.telemetry.recordEvent(event, attributes).catch(() => undefined);\n  };\n  const waitAttributes = (now: number): AutostopEventAttributes => ({\n    deferral_count: deferrals,\n    waited_ms: waitStartedAt === undefined ? 0 : now - waitStartedAt,\n  });\n  const reset = (): void => {\n    waitStartedAt = undefined;\n    lastReportedAt = undefined;\n    deferrals = 0;\n  };\n\n  return {\n    waiting(work) {\n      const now = options.now();\n      waitStartedAt ??= now;\n      deferrals += 1;\n      if (lastReportedAt !== undefined && now - lastReportedAt < reportIntervalMs) return;\n      lastReportedAt = now;\n      record(AUTO_STOP_EVENT.waitingOnBackgroundWork, {\n        ...waitAttributes(now),\n        item_count: work.items.length,\n        error_count: work.errors.length,\n        items: detail(work.items),\n        errors: detail(work.errors),\n      });\n    },\n    stoodDown() {\n      record(AUTO_STOP_EVENT.stoodDown, { ...waitAttributes(options.now()), reason: 'pending_messages' });\n      reset();\n    },\n    shutdownRequested() {\n      record(AUTO_STOP_EVENT.shutdownRequested, waitAttributes(options.now()));\n      reset();\n    },\n    reset,\n    async dispose() {\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      await Promise.race([\n        options.telemetry.shutdown().catch(() => undefined),\n        new Promise((settle) => {\n          timer = setTimeout(settle, flushTimeoutMs);\n          timer.unref?.();\n        }),\n      ]);\n      if (timer) clearTimeout(timer);\n    },\n  };\n}\n","import {\n  BACKGROUND_WORK_HOLDING_PROVIDERS,\n  DOOM_BACKGROUND_WORK_SERVICE,\n  holdsSettledSession,\n  readDoomBackgroundWorkService,\n  type DoomBackgroundWorkService,\n} from '@agimon-ai/po-core/backgroundWork';\nimport type { Context } from '@deepseek-ai/cordis';\n\n/** What is holding a session open, named so a stuck shutdown can say why. */\nexport interface BackgroundWorkSummary {\n  readonly active: boolean;\n  /** `provider:id` for each item the session still owns. */\n  readonly items: readonly string[];\n  /** `provider: message` for each provider whose snapshot failed. */\n  readonly errors: readonly string[];\n}\n\nexport interface BackgroundWorkGate {\n  readonly plugin: (context: Context) => void;\n  hasActiveWork(sessionId: string): boolean;\n  inspect(sessionId: string): BackgroundWorkSummary;\n}\n\nconst NO_WORK: BackgroundWorkSummary = Object.freeze({ active: false, items: [], errors: [] });\n\n/**\n * Tracks the current background-work coordinator. Only runners and subagents\n * count, and it fails closed when their snapshot is uncertain.\n */\nexport function createBackgroundWorkGate(): BackgroundWorkGate {\n  let backgroundWork: DoomBackgroundWorkService | undefined;\n  const inspect = (sessionId: string): BackgroundWorkSummary => {\n    if (!backgroundWork) return NO_WORK;\n    try {\n      const snapshot = backgroundWork.snapshot(sessionId);\n      const items = snapshot.items.filter(holdsSettledSession).map((item) => `${item.provider}:${item.id}`);\n      const errors = snapshot.errors\n        .filter((error) => BACKGROUND_WORK_HOLDING_PROVIDERS.includes(error.provider))\n        .map((error) => `${error.provider}: ${error.message}`);\n      return { active: items.length > 0 || errors.length > 0, items, errors };\n    } catch (error) {\n      return {\n        active: true,\n        items: [],\n        errors: [`snapshot: ${error instanceof Error ? error.message : String(error)}`],\n      };\n    }\n  };\n  return {\n    plugin: (context) => {\n      context.inject([DOOM_BACKGROUND_WORK_SERVICE], (serviceContext) => {\n        const service = readDoomBackgroundWorkService(serviceContext);\n        if (!service) return undefined;\n        backgroundWork = service;\n        return () => {\n          if (backgroundWork === service) backgroundWork = undefined;\n        };\n      });\n    },\n    hasActiveWork: (sessionId) => inspect(sessionId).active,\n    inspect,\n  };\n}\n","import type { DoomHeadlessHostService, DoomHeadlessHook } from '@agimon-ai/po-core/headless';\n\nimport { DEFAULT_AUTO_STOP_DELAYS } from '../../constants/idlePolicy';\nimport type { AutostopDiagnostics } from '../autostopDiagnostics/type';\nimport type { BackgroundWorkSummary } from '../backgroundWorkGate';\nimport { decideOnRecheck, decideOnSettled } from '../idlePolicy';\nimport type { AutoStopDelays } from '../idlePolicy/type';\nimport type { ServerIdleShutdown } from './type';\n\nconst NO_WORK: BackgroundWorkSummary = Object.freeze({ active: false, items: [], errors: [] });\n\nexport function createServerIdleShutdown(\n  host: DoomHeadlessHostService,\n  inspectBackgroundWork: () => BackgroundWorkSummary = () => NO_WORK,\n  delays: AutoStopDelays = DEFAULT_AUTO_STOP_DELAYS,\n  diagnostics?: Pick<AutostopDiagnostics, 'waiting' | 'stoodDown' | 'shutdownRequested' | 'reset'>,\n): ServerIdleShutdown {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let watching = false;\n  let disposed = false;\n  let generation = 0;\n  const stopWatching = (): void => {\n    generation += 1;\n    if (timer !== undefined) clearTimeout(timer);\n    timer = undefined;\n    watching = false;\n    diagnostics?.reset();\n  };\n  const schedule = (delayMs: number): void => {\n    if (disposed) return;\n    if (timer !== undefined) clearTimeout(timer);\n    watching = true;\n    const expected = ++generation;\n    timer = setTimeout(() => {\n      timer = undefined;\n      void recheck(expected).catch(() => {\n        // Unknown activity cannot justify stopping the session. Stand down.\n        if (expected === generation) stopWatching();\n      });\n    }, delayMs);\n  };\n  const recheck = async (expected: number): Promise<void> => {\n    if (disposed || !watching || expected !== generation) return;\n    const work = inspectBackgroundWork();\n    if (work.active) {\n      diagnostics?.waiting(work);\n      schedule(delays.cooldownMs);\n      return;\n    }\n    const activity = await host.context.session.activity();\n    if (disposed || !watching || expected !== generation) return;\n    // Background work can start while authoritative activity is being read.\n    const currentWork = inspectBackgroundWork();\n    if (currentWork.active) {\n      diagnostics?.waiting(currentWork);\n      schedule(delays.cooldownMs);\n      return;\n    }\n    const decision = decideOnRecheck(activity, delays);\n    if (decision.action === 'shutdown') {\n      diagnostics?.shutdownRequested();\n      stopWatching();\n      host.context.shutdown();\n    } else if (decision.action === 'stand-down') {\n      diagnostics?.stoodDown();\n      stopWatching();\n    } else schedule(decision.delayMs);\n  };\n\n  const hooks: DoomHeadlessHook[] = [\n    { event: 'agent_start', handle: stopWatching },\n    {\n      event: 'agent_settled',\n      async handle() {\n        stopWatching();\n        const expected = generation;\n        const activity = await host.context.session.activity();\n        if (disposed || expected !== generation) return;\n        const decision = decideOnSettled(activity, delays);\n        if (decision.action === 'recheck') schedule(decision.delayMs);\n        else diagnostics?.stoodDown();\n      },\n    },\n    { event: 'session_shutdown', handle: stopWatching },\n    { event: 'session_tree', handle: () => recheck(generation) },\n  ];\n  return {\n    hooks,\n    dispose() {\n      disposed = true;\n      stopWatching();\n    },\n  };\n}\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\nimport { createDoomTelemetry } from '@agimon-ai/po-telemetry';\n\nimport { createAutostopDiagnostics } from '../../../../services/autostopDiagnostics';\nimport { createBackgroundWorkGate } from '../../../../services/backgroundWorkGate';\nimport { createServerIdleShutdown } from '../../../../services/serverIdleShutdown';\nexport default defineRoot(({ agent }: DoomServerPluginContext) => {\n  if (!agent) throw new Error('Autostop requires a session host.');\n  const backgroundWork = createBackgroundWorkGate();\n  const diagnostics = createAutostopDiagnostics({\n    telemetry: createDoomTelemetry({\n      serviceName: 'doom-autostop',\n      packageName: '@agimon-ai/po-autostop',\n      enableLogs: true,\n      enableTraces: false,\n    }),\n    now: Date.now,\n  });\n  const watch = createServerIdleShutdown(\n    agent,\n    () => backgroundWork.inspect(agent.context.sessionId),\n    undefined,\n    diagnostics,\n  );\n  return {\n    value: watch,\n    services: [backgroundWork.plugin],\n    onDispose: async () => {\n      watch.dispose();\n      await diagnostics.dispose();\n    },\n  };\n});\n","import { defineHook, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\ntype AutoStopServerScope = Awaited<ReturnType<typeof import('../root.server').default>>['value'];\nexport default defineHook((context: WithRoot<DoomServerPluginContext, AutoStopServerScope>) =>\n  context.root.hooks.find((hook) => hook.event === 'agent_settled')!,\n);\n","import { defineHook, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\ntype AutoStopServerScope = Awaited<ReturnType<typeof import('../root.server').default>>['value'];\nexport default defineHook((context: WithRoot<DoomServerPluginContext, AutoStopServerScope>) =>\n  context.root.hooks.find((hook) => hook.event === 'agent_start')!,\n);\n","import { defineHook, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\ntype AutoStopServerScope = Awaited<ReturnType<typeof import('../root.server').default>>['value'];\nexport default defineHook((context: WithRoot<DoomServerPluginContext, AutoStopServerScope>) =>\n  context.root.hooks.find((hook) => hook.event === 'session_shutdown')!,\n);\n","import { defineHook, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\ntype AutoStopServerScope = Awaited<ReturnType<typeof import('../root.server').default>>['value'];\nexport default defineHook((context: WithRoot<DoomServerPluginContext, AutoStopServerScope>) =>\n  context.root.hooks.find((hook) => hook.event === 'session_tree')!,\n);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\nimport { composeServerProviderOverrides } from '@agimon-ai/po-core/serverFacet';\nimport { composeRootHooks } from '@agimon-ai/po-core/extensionFile';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.server';\nimport hookAgentSettled from '../src/extensions/workspaces/sessions/(backend)/hook/agent-settled.server';\nimport hookAgentStart from '../src/extensions/workspaces/sessions/(backend)/hook/agent-start.server';\nimport hookSessionShutdown from '../src/extensions/workspaces/sessions/(backend)/hook/session-shutdown.server';\nimport hookSessionTree from '../src/extensions/workspaces/sessions/(backend)/hook/session-tree.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/po-autostop',\n  providerOverrides: composeServerProviderOverrides(rootSession),\n  session: async (context) => {\n    const scopeSession = await rootSession(context);\n    const contextSession = { ...context, root: scopeSession.value };\n    return {\n      ...composeRootHooks(scopeSession),\n      get hooks(): DoomServerSessionPlugin['hooks'] { return [via({ event: 'agent_settled' }, at(hookAgentSettled, contextSession)), via({ event: 'agent_start' }, at(hookAgentStart, contextSession)), via({ event: 'session_shutdown' }, at(hookSessionShutdown, contextSession)), via({ event: 'session_tree' }, at(hookSessionTree, contextSession))]; },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): DoomServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default facet;\n"],"mappings":";;;;;;AAQA,SAAS,OAAO,QAAmC;CACjD,MAAM,SAAS,OAAO,KAAK,IAAI;CAC/B,OAAO,OAAO,SAAA,MAAuC,GAAG,OAAO,MAAM,GAAA,GAAkC,EAAE,KAAK;AAChH;;;;;;;;AASA,SAAgB,0BAA0B,SAA0D;CAClG,MAAM,mBAAmB,QAAQ,oBAAA;CACjC,MAAM,iBAAiB,QAAQ,kBAAA;CAC/B,IAAI;CACJ,IAAI;CACJ,IAAI,YAAY;CAEhB,MAAM,UAAU,OAAe,eAA8C;EAE3E,QAAQ,UAAU,YAAY,OAAO,UAAU,CAAC,CAAC,YAAY,KAAA,CAAS;CACxE;CACA,MAAM,kBAAkB,SAA0C;EAChE,gBAAgB;EAChB,WAAW,kBAAkB,KAAA,IAAY,IAAI,MAAM;CACrD;CACA,MAAM,cAAoB;EACxB,gBAAgB,KAAA;EAChB,iBAAiB,KAAA;EACjB,YAAY;CACd;CAEA,OAAO;EACL,QAAQ,MAAM;GACZ,MAAM,MAAM,QAAQ,IAAI;GACxB,kBAAkB;GAClB,aAAa;GACb,IAAI,mBAAmB,KAAA,KAAa,MAAM,iBAAiB,kBAAkB;GAC7E,iBAAiB;GACjB,OAAO,gBAAgB,yBAAyB;IAC9C,GAAG,eAAe,GAAG;IACrB,YAAY,KAAK,MAAM;IACvB,aAAa,KAAK,OAAO;IACzB,OAAO,OAAO,KAAK,KAAK;IACxB,QAAQ,OAAO,KAAK,MAAM;GAC5B,CAAC;EACH;EACA,YAAY;GACV,OAAO,gBAAgB,WAAW;IAAE,GAAG,eAAe,QAAQ,IAAI,CAAC;IAAG,QAAQ;GAAmB,CAAC;GAClG,MAAM;EACR;EACA,oBAAoB;GAClB,OAAO,gBAAgB,mBAAmB,eAAe,QAAQ,IAAI,CAAC,CAAC;GACvE,MAAM;EACR;EACA;EACA,MAAM,UAAU;GACd,IAAI;GACJ,MAAM,QAAQ,KAAK,CACjB,QAAQ,UAAU,SAAS,CAAC,CAAC,YAAY,KAAA,CAAS,GAClD,IAAI,SAAS,WAAW;IACtB,QAAQ,WAAW,QAAQ,cAAc;IACzC,MAAM,QAAQ;GAChB,CAAC,CACH,CAAC;GACD,IAAI,OAAO,aAAa,KAAK;EAC/B;CACF;AACF;;;ACrDA,MAAMA,YAAiC,OAAO,OAAO;CAAE,QAAQ;CAAO,OAAO,CAAC;CAAG,QAAQ,CAAC;AAAE,CAAC;;;;;AAM7F,SAAgB,2BAA+C;CAC7D,IAAI;CACJ,MAAM,WAAW,cAA6C;EAC5D,IAAI,CAAC,gBAAgB,OAAOA;EAC5B,IAAI;GACF,MAAM,WAAW,eAAe,SAAS,SAAS;GAClD,MAAM,QAAQ,SAAS,MAAM,OAAO,mBAAmB,CAAC,CAAC,KAAK,SAAS,GAAG,KAAK,SAAS,GAAG,KAAK,IAAI;GACpG,MAAM,SAAS,SAAS,OACrB,QAAQ,UAAU,kCAAkC,SAAS,MAAM,QAAQ,CAAC,CAAC,CAC7E,KAAK,UAAU,GAAG,MAAM,SAAS,IAAI,MAAM,SAAS;GACvD,OAAO;IAAE,QAAQ,MAAM,SAAS,KAAK,OAAO,SAAS;IAAG;IAAO;GAAO;EACxE,SAAS,OAAO;GACd,OAAO;IACL,QAAQ;IACR,OAAO,CAAC;IACR,QAAQ,CAAC,aAAa,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG;GAChF;EACF;CACF;CACA,OAAO;EACL,SAAS,YAAY;GACnB,QAAQ,OAAO,CAAC,4BAA4B,IAAI,mBAAmB;IACjE,MAAM,UAAU,8BAA8B,cAAc;IAC5D,IAAI,CAAC,SAAS,OAAO,KAAA;IACrB,iBAAiB;IACjB,aAAa;KACX,IAAI,mBAAmB,SAAS,iBAAiB,KAAA;IACnD;GACF,CAAC;EACH;EACA,gBAAgB,cAAc,QAAQ,SAAS,CAAC,CAAC;EACjD;CACF;AACF;;;ACtDA,MAAM,UAAiC,OAAO,OAAO;CAAE,QAAQ;CAAO,OAAO,CAAC;CAAG,QAAQ,CAAC;AAAE,CAAC;AAE7F,SAAgB,yBACd,MACA,8BAA2D,SAC3D,SAAyB,0BACzB,aACoB;CACpB,IAAI;CACJ,IAAI,WAAW;CACf,IAAI,WAAW;CACf,IAAI,aAAa;CACjB,MAAM,qBAA2B;EAC/B,cAAc;EACd,IAAI,UAAU,KAAA,GAAW,aAAa,KAAK;EAC3C,QAAQ,KAAA;EACR,WAAW;EACX,aAAa,MAAM;CACrB;CACA,MAAM,YAAY,YAA0B;EAC1C,IAAI,UAAU;EACd,IAAI,UAAU,KAAA,GAAW,aAAa,KAAK;EAC3C,WAAW;EACX,MAAM,WAAW,EAAE;EACnB,QAAQ,iBAAiB;GACvB,QAAQ,KAAA;GACR,QAAa,QAAQ,CAAC,CAAC,YAAY;IAEjC,IAAI,aAAa,YAAY,aAAa;GAC5C,CAAC;EACH,GAAG,OAAO;CACZ;CACA,MAAM,UAAU,OAAO,aAAoC;EACzD,IAAI,YAAY,CAAC,YAAY,aAAa,YAAY;EACtD,MAAM,OAAO,sBAAsB;EACnC,IAAI,KAAK,QAAQ;GACf,aAAa,QAAQ,IAAI;GACzB,SAAS,OAAO,UAAU;GAC1B;EACF;EACA,MAAM,WAAW,MAAM,KAAK,QAAQ,QAAQ,SAAS;EACrD,IAAI,YAAY,CAAC,YAAY,aAAa,YAAY;EAEtD,MAAM,cAAc,sBAAsB;EAC1C,IAAI,YAAY,QAAQ;GACtB,aAAa,QAAQ,WAAW;GAChC,SAAS,OAAO,UAAU;GAC1B;EACF;EACA,MAAM,WAAW,gBAAgB,UAAU,MAAM;EACjD,IAAI,SAAS,WAAW,YAAY;GAClC,aAAa,kBAAkB;GAC/B,aAAa;GACb,KAAK,QAAQ,SAAS;EACxB,OAAO,IAAI,SAAS,WAAW,cAAc;GAC3C,aAAa,UAAU;GACvB,aAAa;EACf,OAAO,SAAS,SAAS,OAAO;CAClC;CAmBA,OAAO;EACL,OAAA;GAjBA;IAAE,OAAO;IAAe,QAAQ;GAAa;GAC7C;IACE,OAAO;IACP,MAAM,SAAS;KACb,aAAa;KACb,MAAM,WAAW;KACjB,MAAM,WAAW,MAAM,KAAK,QAAQ,QAAQ,SAAS;KACrD,IAAI,YAAY,aAAa,YAAY;KACzC,MAAM,WAAW,gBAAgB,UAAU,MAAM;KACjD,IAAI,SAAS,WAAW,WAAW,SAAS,SAAS,OAAO;UACvD,aAAa,UAAU;IAC9B;GACF;GACA;IAAE,OAAO;IAAoB,QAAQ;GAAa;GAClD;IAAE,OAAO;IAAgB,cAAc,QAAQ,UAAU;GAAE;EAGvD;EACJ,UAAU;GACR,WAAW;GACX,aAAa;EACf;CACF;AACF;;;ACtFA,IAAA,sBAAe,YAAY,EAAE,YAAqC;CAChE,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,mCAAmC;CAC/D,MAAM,iBAAiB,yBAAyB;CAChD,MAAM,cAAc,0BAA0B;EAC5C,WAAW,oBAAoB;GAC7B,aAAa;GACb,aAAa;GACb,YAAY;GACZ,cAAc;EAChB,CAAC;EACD,KAAK,KAAK;CACZ,CAAC;CACD,MAAM,QAAQ,yBACZ,aACM,eAAe,QAAQ,MAAM,QAAQ,SAAS,GACpD,KAAA,GACA,WACF;CACA,OAAO;EACL,OAAO;EACP,UAAU,CAAC,eAAe,MAAM;EAChC,WAAW,YAAY;GACrB,MAAM,QAAQ;GACd,MAAM,YAAY,QAAQ;EAC5B;CACF;AACF,CAAC;;;AC7BD,IAAA,+BAAe,YAAY,YACzB,QAAQ,KAAK,MAAM,MAAM,SAAS,KAAK,UAAU,eAAe,CAClE;;;ACFA,IAAA,6BAAe,YAAY,YACzB,QAAQ,KAAK,MAAM,MAAM,SAAS,KAAK,UAAU,aAAa,CAChE;;;ACFA,IAAA,kCAAe,YAAY,YACzB,QAAQ,KAAK,MAAM,MAAM,SAAS,KAAK,UAAU,kBAAkB,CACrE;;;ACFA,IAAA,8BAAe,YAAY,YACzB,QAAQ,KAAK,MAAM,MAAM,SAAS,KAAK,UAAU,cAAc,CACjE;;;ACMA,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,QAAQ,mBAAmB;CACtC,MAAM;CACN,mBAAmB,+BAA+BC,mBAAW;CAC7D,SAAS,OAAO,YAAY;EAC1B,MAAM,eAAe,MAAMA,oBAAY,OAAO;EAC9C,MAAM,iBAAiB;GAAE,GAAG;GAAS,MAAM,aAAa;EAAM;EAC9D,OAAO;GACL,GAAG,iBAAiB,YAAY;GAChC,IAAI,QAA0C;IAAE,OAAO;KAAC,IAAI,EAAE,OAAO,gBAAgB,GAAG,GAAGC,8BAAkB,cAAc,CAAC;KAAG,IAAI,EAAE,OAAO,cAAc,GAAG,GAAGC,4BAAgB,cAAc,CAAC;KAAG,IAAI,EAAE,OAAO,mBAAmB,GAAG,GAAGC,iCAAqB,cAAc,CAAC;KAAG,IAAI,EAAE,OAAO,eAAe,GAAG,GAAGC,6BAAiB,cAAc,CAAC;IAAC;GAAG;GACrV,UAAU,CAAC,GAAI,aAAa,YAAY,CAAC,CAAE;GAC3C,IAAI,aAAoD;IAAE,OAAO,CAAC,GAAI,aAAa,cAAc,CAAC,CAAE;GAAG;EACzG;CACF;AACF,CAAC"}

package/dist/idlePolicy-BNLdwumq.mjs

@@ -0,0 +1,60 @@
+//#region src/constants/idlePolicy.ts
+const DEFAULT_AUTO_STOP_DELAYS = {
+	cooldownMs: 5e3,
+	recheckMs: 100
+};
+const AUTO_STOP_ACTION = {
+	/** The session has nothing left to do and can exit. */
+	shutdown: "shutdown",
+	/** Look again after the returned delay. */
+	recheck: "recheck",
+	/** The user is back; stop watching until the agent settles again. */
+	standDown: "stand-down"
+};
+/** Telemetry events that explain an auto-stop decision after the fact. */
+const AUTO_STOP_EVENT = {
+	/** Idle, but background work is still listed; carries what it is. */
+	waitingOnBackgroundWork: "doom_autostop.waiting_on_background_work",
+	/** A message was queued, so the watch stopped until the agent settles again. */
+	stoodDown: "doom_autostop.stood_down",
+	/** Everything was clear and shutdown was requested. */
+	shutdownRequested: "doom_autostop.shutdown_requested"
+};
+/** How often a long wait on background work is reported again. */
+const AUTO_STOP_REPORT_INTERVAL_MS = 6e4;
+/** Longest the session waits for telemetry to flush on its way out. */
+const AUTO_STOP_TELEMETRY_FLUSH_MS = 2e3;
+//#endregion
+//#region src/services/idlePolicy/index.ts
+/**
+* Taken when the agent reports it has settled.
+*
+* Settling is not enough on its own: a queued message means the session is
+* about to run again, and even an empty queue gets the cooldown so a user
+* typing their next prompt is not cut off mid-word.
+*/
+function decideOnSettled(activity, delays) {
+	if (activity.hasPendingMessages) return { action: AUTO_STOP_ACTION.standDown };
+	return {
+		action: AUTO_STOP_ACTION.recheck,
+		delayMs: delays.cooldownMs
+	};
+}
+/**
+* Taken when a scheduled look comes due.
+*
+* The agent can still be streaming after it settled, so a session that is not
+* yet idle is polled rather than stopped.
+*/
+function decideOnRecheck(activity, delays) {
+	if (activity.hasPendingMessages) return { action: AUTO_STOP_ACTION.standDown };
+	if (activity.isIdle) return { action: AUTO_STOP_ACTION.shutdown };
+	return {
+		action: AUTO_STOP_ACTION.recheck,
+		delayMs: delays.recheckMs
+	};
+}
+//#endregion
+export { AUTO_STOP_REPORT_INTERVAL_MS as a, AUTO_STOP_EVENT as i, decideOnSettled as n, AUTO_STOP_TELEMETRY_FLUSH_MS as o, AUTO_STOP_ACTION as r, DEFAULT_AUTO_STOP_DELAYS as s, decideOnRecheck as t };
+
+//# sourceMappingURL=idlePolicy-BNLdwumq.mjs.map

package/dist/idlePolicy-BNLdwumq.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idlePolicy-BNLdwumq.mjs","names":[],"sources":["../src/constants/idlePolicy.ts","../src/services/idlePolicy/index.ts"],"sourcesContent":["export const DEFAULT_AUTO_STOP_DELAYS = {\n  cooldownMs: 5_000,\n  recheckMs: 100,\n};\n\nexport const AUTO_STOP_ACTION = {\n  /** The session has nothing left to do and can exit. */\n  shutdown: 'shutdown',\n  /** Look again after the returned delay. */\n  recheck: 'recheck',\n  /** The user is back; stop watching until the agent settles again. */\n  standDown: 'stand-down',\n} as const;\n\n/** Telemetry events that explain an auto-stop decision after the fact. */\nexport const AUTO_STOP_EVENT = {\n  /** Idle, but background work is still listed; carries what it is. */\n  waitingOnBackgroundWork: 'doom_autostop.waiting_on_background_work',\n  /** A message was queued, so the watch stopped until the agent settles again. */\n  stoodDown: 'doom_autostop.stood_down',\n  /** Everything was clear and shutdown was requested. */\n  shutdownRequested: 'doom_autostop.shutdown_requested',\n} as const;\n\n/** How often a long wait on background work is reported again. */\nexport const AUTO_STOP_REPORT_INTERVAL_MS = 60_000;\n/** Longest the session waits for telemetry to flush on its way out. */\nexport const AUTO_STOP_TELEMETRY_FLUSH_MS = 2_000;\n/** Longest list of work items or errors carried on one event. */\nexport const AUTO_STOP_DETAIL_MAX_LENGTH = 500;\n","import { AUTO_STOP_ACTION } from '../../constants/idlePolicy';\nimport type { AutoStopDecision, AutoStopDelays, SessionActivity } from './type';\n/**\n * Taken when the agent reports it has settled.\n *\n * Settling is not enough on its own: a queued message means the session is\n * about to run again, and even an empty queue gets the cooldown so a user\n * typing their next prompt is not cut off mid-word.\n */\nexport function decideOnSettled(activity: SessionActivity, delays: AutoStopDelays): AutoStopDecision {\n  if (activity.hasPendingMessages) return { action: AUTO_STOP_ACTION.standDown };\n  return { action: AUTO_STOP_ACTION.recheck, delayMs: delays.cooldownMs };\n}\n\n/**\n * Taken when a scheduled look comes due.\n *\n * The agent can still be streaming after it settled, so a session that is not\n * yet idle is polled rather than stopped.\n */\nexport function decideOnRecheck(activity: SessionActivity, delays: AutoStopDelays): AutoStopDecision {\n  if (activity.hasPendingMessages) return { action: AUTO_STOP_ACTION.standDown };\n  if (activity.isIdle) return { action: AUTO_STOP_ACTION.shutdown };\n  return { action: AUTO_STOP_ACTION.recheck, delayMs: delays.recheckMs };\n}\n"],"mappings":";AAAA,MAAa,2BAA2B;CACtC,YAAY;CACZ,WAAW;AACb;AAEA,MAAa,mBAAmB;;CAE9B,UAAU;;CAEV,SAAS;;CAET,WAAW;AACb;;AAGA,MAAa,kBAAkB;;CAE7B,yBAAyB;;CAEzB,WAAW;;CAEX,mBAAmB;AACrB;;AAGA,MAAa,+BAA+B;;AAE5C,MAAa,+BAA+B;;;;;;;;;;AClB5C,SAAgB,gBAAgB,UAA2B,QAA0C;CACnG,IAAI,SAAS,oBAAoB,OAAO,EAAE,QAAQ,iBAAiB,UAAU;CAC7E,OAAO;EAAE,QAAQ,iBAAiB;EAAS,SAAS,OAAO;CAAW;AACxE;;;;;;;AAQA,SAAgB,gBAAgB,UAA2B,QAA0C;CACnG,IAAI,SAAS,oBAAoB,OAAO,EAAE,QAAQ,iBAAiB,UAAU;CAC7E,IAAI,SAAS,QAAQ,OAAO,EAAE,QAAQ,iBAAiB,SAAS;CAChE,OAAO;EAAE,QAAQ,iBAAiB;EAAS,SAAS,OAAO;CAAU;AACvE"}

package/dist/idlePolicy-Dw8blgEH.cjs

@@ -0,0 +1,101 @@
+//#region src/constants/idlePolicy.ts
+const DEFAULT_AUTO_STOP_DELAYS = {
+	cooldownMs: 5e3,
+	recheckMs: 100
+};
+const AUTO_STOP_ACTION = {
+	/** The session has nothing left to do and can exit. */
+	shutdown: "shutdown",
+	/** Look again after the returned delay. */
+	recheck: "recheck",
+	/** The user is back; stop watching until the agent settles again. */
+	standDown: "stand-down"
+};
+/** Telemetry events that explain an auto-stop decision after the fact. */
+const AUTO_STOP_EVENT = {
+	/** Idle, but background work is still listed; carries what it is. */
+	waitingOnBackgroundWork: "doom_autostop.waiting_on_background_work",
+	/** A message was queued, so the watch stopped until the agent settles again. */
+	stoodDown: "doom_autostop.stood_down",
+	/** Everything was clear and shutdown was requested. */
+	shutdownRequested: "doom_autostop.shutdown_requested"
+};
+/** How often a long wait on background work is reported again. */
+const AUTO_STOP_REPORT_INTERVAL_MS = 6e4;
+/** Longest the session waits for telemetry to flush on its way out. */
+const AUTO_STOP_TELEMETRY_FLUSH_MS = 2e3;
+//#endregion
+//#region src/services/idlePolicy/index.ts
+/**
+* Taken when the agent reports it has settled.
+*
+* Settling is not enough on its own: a queued message means the session is
+* about to run again, and even an empty queue gets the cooldown so a user
+* typing their next prompt is not cut off mid-word.
+*/
+function decideOnSettled(activity, delays) {
+	if (activity.hasPendingMessages) return { action: AUTO_STOP_ACTION.standDown };
+	return {
+		action: AUTO_STOP_ACTION.recheck,
+		delayMs: delays.cooldownMs
+	};
+}
+/**
+* Taken when a scheduled look comes due.
+*
+* The agent can still be streaming after it settled, so a session that is not
+* yet idle is polled rather than stopped.
+*/
+function decideOnRecheck(activity, delays) {
+	if (activity.hasPendingMessages) return { action: AUTO_STOP_ACTION.standDown };
+	if (activity.isIdle) return { action: AUTO_STOP_ACTION.shutdown };
+	return {
+		action: AUTO_STOP_ACTION.recheck,
+		delayMs: delays.recheckMs
+	};
+}
+//#endregion
+Object.defineProperty(exports, "AUTO_STOP_ACTION", {
+	enumerable: true,
+	get: function() {
+		return AUTO_STOP_ACTION;
+	}
+});
+Object.defineProperty(exports, "AUTO_STOP_EVENT", {
+	enumerable: true,
+	get: function() {
+		return AUTO_STOP_EVENT;
+	}
+});
+Object.defineProperty(exports, "AUTO_STOP_REPORT_INTERVAL_MS", {
+	enumerable: true,
+	get: function() {
+		return AUTO_STOP_REPORT_INTERVAL_MS;
+	}
+});
+Object.defineProperty(exports, "AUTO_STOP_TELEMETRY_FLUSH_MS", {
+	enumerable: true,
+	get: function() {
+		return AUTO_STOP_TELEMETRY_FLUSH_MS;
+	}
+});
+Object.defineProperty(exports, "DEFAULT_AUTO_STOP_DELAYS", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_AUTO_STOP_DELAYS;
+	}
+});
+Object.defineProperty(exports, "decideOnRecheck", {
+	enumerable: true,
+	get: function() {
+		return decideOnRecheck;
+	}
+});
+Object.defineProperty(exports, "decideOnSettled", {
+	enumerable: true,
+	get: function() {
+		return decideOnSettled;
+	}
+});
+
+//# sourceMappingURL=idlePolicy-Dw8blgEH.cjs.map

package/dist/idlePolicy-Dw8blgEH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idlePolicy-Dw8blgEH.cjs","names":[],"sources":["../src/constants/idlePolicy.ts","../src/services/idlePolicy/index.ts"],"sourcesContent":["export const DEFAULT_AUTO_STOP_DELAYS = {\n  cooldownMs: 5_000,\n  recheckMs: 100,\n};\n\nexport const AUTO_STOP_ACTION = {\n  /** The session has nothing left to do and can exit. */\n  shutdown: 'shutdown',\n  /** Look again after the returned delay. */\n  recheck: 'recheck',\n  /** The user is back; stop watching until the agent settles again. */\n  standDown: 'stand-down',\n} as const;\n\n/** Telemetry events that explain an auto-stop decision after the fact. */\nexport const AUTO_STOP_EVENT = {\n  /** Idle, but background work is still listed; carries what it is. */\n  waitingOnBackgroundWork: 'doom_autostop.waiting_on_background_work',\n  /** A message was queued, so the watch stopped until the agent settles again. */\n  stoodDown: 'doom_autostop.stood_down',\n  /** Everything was clear and shutdown was requested. */\n  shutdownRequested: 'doom_autostop.shutdown_requested',\n} as const;\n\n/** How often a long wait on background work is reported again. */\nexport const AUTO_STOP_REPORT_INTERVAL_MS = 60_000;\n/** Longest the session waits for telemetry to flush on its way out. */\nexport const AUTO_STOP_TELEMETRY_FLUSH_MS = 2_000;\n/** Longest list of work items or errors carried on one event. */\nexport const AUTO_STOP_DETAIL_MAX_LENGTH = 500;\n","import { AUTO_STOP_ACTION } from '../../constants/idlePolicy';\nimport type { AutoStopDecision, AutoStopDelays, SessionActivity } from './type';\n/**\n * Taken when the agent reports it has settled.\n *\n * Settling is not enough on its own: a queued message means the session is\n * about to run again, and even an empty queue gets the cooldown so a user\n * typing their next prompt is not cut off mid-word.\n */\nexport function decideOnSettled(activity: SessionActivity, delays: AutoStopDelays): AutoStopDecision {\n  if (activity.hasPendingMessages) return { action: AUTO_STOP_ACTION.standDown };\n  return { action: AUTO_STOP_ACTION.recheck, delayMs: delays.cooldownMs };\n}\n\n/**\n * Taken when a scheduled look comes due.\n *\n * The agent can still be streaming after it settled, so a session that is not\n * yet idle is polled rather than stopped.\n */\nexport function decideOnRecheck(activity: SessionActivity, delays: AutoStopDelays): AutoStopDecision {\n  if (activity.hasPendingMessages) return { action: AUTO_STOP_ACTION.standDown };\n  if (activity.isIdle) return { action: AUTO_STOP_ACTION.shutdown };\n  return { action: AUTO_STOP_ACTION.recheck, delayMs: delays.recheckMs };\n}\n"],"mappings":";AAAA,MAAa,2BAA2B;CACtC,YAAY;CACZ,WAAW;AACb;AAEA,MAAa,mBAAmB;;CAE9B,UAAU;;CAEV,SAAS;;CAET,WAAW;AACb;;AAGA,MAAa,kBAAkB;;CAE7B,yBAAyB;;CAEzB,WAAW;;CAEX,mBAAmB;AACrB;;AAGA,MAAa,+BAA+B;;AAE5C,MAAa,+BAA+B;;;;;;;;;;AClB5C,SAAgB,gBAAgB,UAA2B,QAA0C;CACnG,IAAI,SAAS,oBAAoB,OAAO,EAAE,QAAQ,iBAAiB,UAAU;CAC7E,OAAO;EAAE,QAAQ,iBAAiB;EAAS,SAAS,OAAO;CAAW;AACxE;;;;;;;AAQA,SAAgB,gBAAgB,UAA2B,QAA0C;CACnG,IAAI,SAAS,oBAAoB,OAAO,EAAE,QAAQ,iBAAiB,UAAU;CAC7E,IAAI,SAAS,QAAQ,OAAO,EAAE,QAAQ,iBAAiB,SAAS;CAChE,OAAO;EAAE,QAAQ,iBAAiB;EAAS,SAAS,OAAO;CAAU;AACvE"}

package/dist/index.cjs

@@ -0,0 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_idlePolicy = require("./idlePolicy-Dw8blgEH.cjs");
+exports.AUTO_STOP_ACTION = require_idlePolicy.AUTO_STOP_ACTION;
+exports.DEFAULT_AUTO_STOP_DELAYS = require_idlePolicy.DEFAULT_AUTO_STOP_DELAYS;
+exports.decideOnRecheck = require_idlePolicy.decideOnRecheck;
+exports.decideOnSettled = require_idlePolicy.decideOnSettled;

package/dist/index.d.mts

@@ -0,0 +1,56 @@
+//#region src/constants/idlePolicy.d.ts
+export declare const DEFAULT_AUTO_STOP_DELAYS: {
+  cooldownMs: number;
+  recheckMs: number;
+};
+export declare const AUTO_STOP_ACTION: {
+  /** The session has nothing left to do and can exit. */
+  readonly shutdown: 'shutdown';
+  /** Look again after the returned delay. */
+  readonly recheck: 'recheck';
+  /** The user is back; stop watching until the agent settles again. */
+  readonly standDown: 'stand-down';
+};
+//#endregion
+//#region src/services/idlePolicy/type.d.ts
+/** What the session was doing the moment the policy was asked. */
+interface SessionActivity {
+  readonly hasPendingMessages: boolean;
+  readonly isIdle: boolean;
+}
+/** How long the policy waits before each look at the session. */
+interface AutoStopDelays {
+  /** Grace period after the agent settles, so a follow-up prompt still lands. */
+  readonly cooldownMs: number;
+  /** Gap between looks while the agent is settled but still streaming. */
+  readonly recheckMs: number;
+}
+type AutoStopAction = (typeof AUTO_STOP_ACTION)[keyof typeof AUTO_STOP_ACTION];
+type AutoStopDecision = {
+  readonly action: typeof AUTO_STOP_ACTION.shutdown;
+} | {
+  readonly action: typeof AUTO_STOP_ACTION.recheck;
+  readonly delayMs: number;
+} | {
+  readonly action: typeof AUTO_STOP_ACTION.standDown;
+};
+//#endregion
+//#region src/services/idlePolicy/index.d.ts
+/**
+ * Taken when the agent reports it has settled.
+ *
+ * Settling is not enough on its own: a queued message means the session is
+ * about to run again, and even an empty queue gets the cooldown so a user
+ * typing their next prompt is not cut off mid-word.
+ */
+export declare function decideOnSettled(activity: SessionActivity, delays: AutoStopDelays): AutoStopDecision;
+/**
+ * Taken when a scheduled look comes due.
+ *
+ * The agent can still be streaming after it settled, so a session that is not
+ * yet idle is polled rather than stopped.
+ */
+export declare function decideOnRecheck(activity: SessionActivity, delays: AutoStopDelays): AutoStopDecision;
+//#endregion
+export type { AutoStopAction, AutoStopDecision, AutoStopDelays, SessionActivity };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/constants/idlePolicy.ts","../src/services/idlePolicy/type.ts","../src/services/idlePolicy/index.ts"],"mappings":";qBAAa;EACX;EACA;;qBAGW;;WAEX;;WAEA;;WAEA;;;;;UCTe;WACN;WACA;;;UAIM;;WAEN;;WAEA;;KAGC,yBAAyB,+BAA+B;KAExD;WACG,eAAe,iBAAiB;;WAChC,eAAe,iBAAiB;WAAkB;;WAClD,eAAe,iBAAiB;;;;;;;;;;;wBCX/B,gBAAgB,UAAU,iBAAiB,QAAQ,iBAAiB;;;;;;;wBAWpE,gBAAgB,UAAU,iBAAiB,QAAQ,iBAAiB"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { n as decideOnSettled, r as AUTO_STOP_ACTION, s as DEFAULT_AUTO_STOP_DELAYS, t as decideOnRecheck } from "./idlePolicy-BNLdwumq.mjs";
+export { AUTO_STOP_ACTION, DEFAULT_AUTO_STOP_DELAYS, decideOnRecheck, decideOnSettled };

package/llms.txt

@@ -0,0 +1,7 @@
+# Po Autostop
+
+Shuts a Po session down once the agent settles and stays idle. Shares core's holding rule with workflow supervision: runners awaiting completion admission and owned subagents keep the session open.
+
+## Resources
+
+- [Package README](./README.md): the idle policy, the cooldown, and when the session is left alone.

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@agimon-ai/po-autostop",
+  "version": "0.0.0-alpha.0",
+  "description": "Shuts a Po session down once the agent settles and stays idle.",
+  "keywords": [
+    "ai",
+    "auto-stop",
+    "coding-agent",
+    "developer-tools",
+    "idle-timeout",
+    "pi-coding-agent",
+    "pi-extension",
+    "pi-package",
+    "po",
+    "session-shutdown"
+  ],
+  "homepage": "https://agimon.ai",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/po/issues"
+  },
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgiFlow/po.git",
+    "directory": "packages/foundations/po-autostop"
+  },
+  "files": [
+    "dist",
+    "llms.txt",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./apiContracts": {
+      "types": "./dist/apiContracts.d.mts",
+      "import": "./dist/apiContracts.mjs",
+      "require": "./dist/apiContracts.cjs"
+    },
+    "./extensions/server": {
+      "types": "./dist/extensions/server.d.mts",
+      "import": "./dist/extensions/server.mjs",
+      "require": "./dist/extensions/server.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agimon-ai/po-core": "0.0.0-alpha.0",
+    "@agimon-ai/po-telemetry": "0.0.0-alpha.0",
+    "@deepseek-ai/cordis": "4.0.4"
+  },
+  "devDependencies": {
+    "@agimon-ai/po-build": "0.0.0-alpha.0",
+    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.0-alpha.0",
+    "@earendil-works/pi-coding-agent": "1.0.2",
+    "@types/node": "26.6.4",
+    "@vitest/coverage-v8": "5.0.3",
+    "tsdown": "0.23.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.3"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "1.0.2"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "poServer": {
+    "entry": "./generated/server.ts",
+    "dist": "./dist/extensions/server.mjs",
+    "scopes": [
+      "session"
+    ],
+    "contracts": {
+      "entry": "./src/exports/apiContracts.ts",
+      "dist": "./dist/apiContracts.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}