@agimon-ai/doompi-autostop 0.0.1-alpha.10

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,45 @@
+# @agimon-ai/doompi-autostop
+
+Shuts a [DoomPi](https://www.npmjs.com/package/@agimon-ai/doompi) 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 | still streaming   | look again in 100ms  |
+| the scheduled look | idle, queue empty | `context.shutdown()` |
+
+Any `input` or `agent_start` disarms a pending stop, so a user who starts typing during the
+cooldown keeps their session. The cooldown is the grace period; the 100 ms recheck is the poll
+that waits out a stream that has not finished draining.
+
+`decideOnSettled` and `decideOnRecheck` are the whole policy and take the session state as a
+plain value, so the timing rules are testable without a Pi host.
+
+## What it registers
+
+| Entry             | Surface                                                                               |
+| ----------------- | ------------------------------------------------------------------------------------- |
+| `./extensions/pi` | `input`, `agent_start` and `agent_settled` hooks, plus the shutdown that disarms them |
+
+The extension owns a Cordis fiber; `session_shutdown` disposes it, which cancels any armed stop.
+That matters because Pi reloads extensions in process. A timer left armed by the previous load
+would stop the session it was reloaded into.
+
+## Installation
+
+DoomPi depends on this package and activates it when a run asks for `--auto-stop`. It is not
+selectable from `.doom/modes.yaml`.
+
+## License
+
+MIT

package/dist/adapters/pi/extension.cjs

@@ -0,0 +1,2 @@
+const e=require("../../services/idlePolicy.cjs"),t=require("./idleShutdown.cjs");let n=require("@agimon-ai/doompi-extension-contracts/cordis-host");const r=`@agimon-ai/doompi-autostop`;async function i(t,i=e.DEFAULT_AUTO_STOP_DELAYS){let o=await(0,n.connectDoomCordisHost)(t,r),s=o.root.plugin(a,{pi:t,delays:i});try{await s}catch(e){try{await s.dispose()}finally{await o.dispose()}throw e}let c;t.on(`session_shutdown`,()=>c??=(async()=>{try{await s.dispose()}finally{await o.dispose()}})())}function a(e,n){e.effect(function*(){yield t.registerIdleShutdown(n.pi,n.delays)},r)}exports.autoStopExtension=i,exports.default=i;
+//# sourceMappingURL=extension.cjs.map

package/dist/adapters/pi/extension.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.cjs","names":["DEFAULT_AUTO_STOP_DELAYS","connectDoomCordisHost","registerIdleShutdown"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { type AutoStopDelays, DEFAULT_AUTO_STOP_DELAYS } from '../../services/idlePolicy.ts';\nimport { registerIdleShutdown } from './idleShutdown.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-autostop';\n\n/**\n * The package's single standard Pi factory.\n */\nexport async function autoStopExtension(\n  pi: ExtensionAPI,\n  delays: AutoStopDelays = DEFAULT_AUTO_STOP_DELAYS,\n): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(autoStopPlugin, { pi, delays });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface AutoStopPluginConfig {\n  readonly pi: ExtensionAPI;\n  readonly delays: AutoStopDelays;\n}\n\nfunction autoStopPlugin(cordis: Context, config: AutoStopPluginConfig): void {\n  cordis.effect(function* () {\n    yield registerIdleShutdown(config.pi, config.delays);\n  }, PACKAGE_SOURCE);\n}\n\nexport default autoStopExtension;\n"],"mappings":"oJAMA,MAAM,EAAiB,6BAKvB,eAAsB,EACpB,EACA,EAAyBA,EAAAA,yBACV,CACf,IAAM,EAAa,MAAA,EAAMC,EAAAA,sBAAAA,CAAsB,EAAI,CAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAgB,CAAE,KAAI,QAAO,CAAC,EACnE,GAAI,CACF,MAAM,CACR,OAAS,EAAO,CACd,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACA,MAAM,CACR,CACA,IAAI,EACJ,EAAG,GACD,uBAEG,KAAc,SAAY,CACzB,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACF,EAAA,CAAG,CACP,CACF,CAOA,SAAS,EAAe,EAAiB,EAAoC,CAC3E,EAAO,OAAO,WAAa,CACzB,MAAMC,EAAAA,qBAAqB,EAAO,GAAI,EAAO,MAAM,CACrD,EAAG,CAAc,CACnB"}

package/dist/adapters/pi/extension.d.cts

@@ -0,0 +1,10 @@
+import { AutoStopDelays } from "../../services/idlePolicy.cjs";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/adapters/pi/extension.d.ts
+/**
+ * The package's single standard Pi factory.
+ */
+declare function autoStopExtension(pi: ExtensionAPI, delays?: AutoStopDelays): Promise<void>;
+//#endregion
+export { autoStopExtension, autoStopExtension as default };
+//# sourceMappingURL=extension.d.cts.map

package/dist/adapters/pi/extension.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;;;iBAWsB,kBACpB,IAAI,cACJ,SAAQ,iBACP"}

package/dist/adapters/pi/extension.d.mts

@@ -0,0 +1,10 @@
+import { AutoStopDelays } from "../../services/idlePolicy.mjs";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/adapters/pi/extension.d.ts
+/**
+ * The package's single standard Pi factory.
+ */
+declare function autoStopExtension(pi: ExtensionAPI, delays?: AutoStopDelays): Promise<void>;
+//#endregion
+export { autoStopExtension, autoStopExtension as default };
+//# sourceMappingURL=extension.d.mts.map

package/dist/adapters/pi/extension.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.mts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;;;iBAWsB,kBACpB,IAAI,cACJ,SAAQ,iBACP"}

package/dist/adapters/pi/extension.mjs

@@ -0,0 +1,2 @@
+import{DEFAULT_AUTO_STOP_DELAYS as e}from"../../services/idlePolicy.mjs";import{registerIdleShutdown as t}from"./idleShutdown.mjs";import{connectDoomCordisHost as n}from"@agimon-ai/doompi-extension-contracts/cordis-host";const r=`@agimon-ai/doompi-autostop`;async function i(t,i=e){let o=await n(t,r),s=o.root.plugin(a,{pi:t,delays:i});try{await s}catch(e){try{await s.dispose()}finally{await o.dispose()}throw e}let c;t.on(`session_shutdown`,()=>c??=(async()=>{try{await s.dispose()}finally{await o.dispose()}})())}function a(e,n){e.effect(function*(){yield t(n.pi,n.delays)},r)}export{i as autoStopExtension,i as default};
+//# sourceMappingURL=extension.mjs.map

package/dist/adapters/pi/extension.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.mjs","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { type AutoStopDelays, DEFAULT_AUTO_STOP_DELAYS } from '../../services/idlePolicy.ts';\nimport { registerIdleShutdown } from './idleShutdown.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-autostop';\n\n/**\n * The package's single standard Pi factory.\n */\nexport async function autoStopExtension(\n  pi: ExtensionAPI,\n  delays: AutoStopDelays = DEFAULT_AUTO_STOP_DELAYS,\n): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(autoStopPlugin, { pi, delays });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface AutoStopPluginConfig {\n  readonly pi: ExtensionAPI;\n  readonly delays: AutoStopDelays;\n}\n\nfunction autoStopPlugin(cordis: Context, config: AutoStopPluginConfig): void {\n  cordis.effect(function* () {\n    yield registerIdleShutdown(config.pi, config.delays);\n  }, PACKAGE_SOURCE);\n}\n\nexport default autoStopExtension;\n"],"mappings":"6NAMA,MAAM,EAAiB,6BAKvB,eAAsB,EACpB,EACA,EAAyB,EACV,CACf,IAAM,EAAa,MAAM,EAAsB,EAAI,CAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAgB,CAAE,KAAI,QAAO,CAAC,EACnE,GAAI,CACF,MAAM,CACR,OAAS,EAAO,CACd,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACA,MAAM,CACR,CACA,IAAI,EACJ,EAAG,GACD,uBAEG,KAAc,SAAY,CACzB,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACF,EAAA,CAAG,CACP,CACF,CAOA,SAAS,EAAe,EAAiB,EAAoC,CAC3E,EAAO,OAAO,WAAa,CACzB,MAAM,EAAqB,EAAO,GAAI,EAAO,MAAM,CACrD,EAAG,CAAc,CACnB"}

package/dist/adapters/pi/idleShutdown.cjs

@@ -0,0 +1,2 @@
+const e=require("../../services/idlePolicy.cjs");function t(e){return{hasPendingMessages:e.hasPendingMessages(),isIdle:e.isIdle()}}function n(n,r){let i,a=()=>{i&&=(clearTimeout(i),void 0)},o=(n,a)=>{i=setTimeout(()=>{i=void 0;let a=e.decideOnRecheck(t(n),r);if(a.action===e.AUTO_STOP_ACTION.shutdown){n.shutdown();return}a.action===e.AUTO_STOP_ACTION.recheck&&o(n,a.delayMs)},a)};return n.on(`input`,a),n.on(`agent_start`,a),n.on(`agent_settled`,(n,i)=>{a();let s=e.decideOnSettled(t(i),r);s.action===e.AUTO_STOP_ACTION.recheck&&o(i,s.delayMs)}),a}exports.registerIdleShutdown=n;
+//# sourceMappingURL=idleShutdown.cjs.map

package/dist/adapters/pi/idleShutdown.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idleShutdown.cjs","names":["decideOnRecheck","AUTO_STOP_ACTION","decideOnSettled"],"sources":["../../../src/adapters/pi/idleShutdown.ts"],"sourcesContent":["import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport {\n  AUTO_STOP_ACTION,\n  type AutoStopDelays,\n  type SessionActivity,\n  decideOnRecheck,\n  decideOnSettled,\n} from '../../services/idlePolicy.ts';\n\nfunction readActivity(context: ExtensionContext): SessionActivity {\n  return { hasPendingMessages: context.hasPendingMessages(), isIdle: context.isIdle() };\n}\n\n/**\n * Watches the session for idleness and returns the disposer for that watch.\n *\n * Pi's `on` hands back nothing to unsubscribe with, so the only resource this\n * owns across a reload is the armed timer — and an armed timer is the one that\n * matters, because firing it would stop the session Pi has just reloaded into.\n */\nexport function registerIdleShutdown(pi: ExtensionAPI, delays: AutoStopDelays): () => void {\n  let shutdownTimer: NodeJS.Timeout | undefined;\n\n  const cancelScheduledShutdown = (): void => {\n    if (!shutdownTimer) return;\n    clearTimeout(shutdownTimer);\n    shutdownTimer = undefined;\n  };\n\n  const scheduleShutdown = (context: ExtensionContext, delayMs: number): void => {\n    shutdownTimer = setTimeout(() => {\n      shutdownTimer = undefined;\n      const decision = decideOnRecheck(readActivity(context), delays);\n      if (decision.action === AUTO_STOP_ACTION.shutdown) {\n        context.shutdown();\n        return;\n      }\n      if (decision.action === AUTO_STOP_ACTION.recheck) scheduleShutdown(context, decision.delayMs);\n    }, delayMs);\n  };\n\n  pi.on('input', cancelScheduledShutdown);\n  pi.on('agent_start', cancelScheduledShutdown);\n\n  pi.on('agent_settled', (_event, context) => {\n    cancelScheduledShutdown();\n    const decision = decideOnSettled(readActivity(context), delays);\n    if (decision.action === AUTO_STOP_ACTION.recheck) scheduleShutdown(context, decision.delayMs);\n  });\n\n  return cancelScheduledShutdown;\n}\n"],"mappings":"iDASA,SAAS,EAAa,EAA4C,CAChE,MAAO,CAAE,mBAAoB,EAAQ,mBAAmB,EAAG,OAAQ,EAAQ,OAAO,CAAE,CACtF,CASA,SAAgB,EAAqB,EAAkB,EAAoC,CACzF,IAAI,EAEE,MAAsC,CACrC,AAEL,KADA,aAAa,CAAa,EACV,IAAA,GAClB,EAEM,GAAoB,EAA2B,IAA0B,CAC7E,EAAgB,eAAiB,CAC/B,EAAgB,IAAA,GAChB,IAAM,EAAWA,EAAAA,gBAAgB,EAAa,CAAO,EAAG,CAAM,EAC9D,GAAI,EAAS,SAAWC,EAAAA,iBAAiB,SAAU,CACjD,EAAQ,SAAS,EACjB,MACF,CACI,EAAS,SAAWA,EAAAA,iBAAiB,SAAS,EAAiB,EAAS,EAAS,OAAO,CAC9F,EAAG,CAAO,CACZ,EAWA,OATA,EAAG,GAAG,QAAS,CAAuB,EACtC,EAAG,GAAG,cAAe,CAAuB,EAE5C,EAAG,GAAG,iBAAkB,EAAQ,IAAY,CAC1C,EAAwB,EACxB,IAAM,EAAWC,EAAAA,gBAAgB,EAAa,CAAO,EAAG,CAAM,EAC1D,EAAS,SAAWD,EAAAA,iBAAiB,SAAS,EAAiB,EAAS,EAAS,OAAO,CAC9F,CAAC,EAEM,CACT"}

package/dist/adapters/pi/idleShutdown.d.cts

@@ -0,0 +1,14 @@
+import { AutoStopDelays } from "../../services/idlePolicy.cjs";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/adapters/pi/idleShutdown.d.ts
+/**
+ * Watches the session for idleness and returns the disposer for that watch.
+ *
+ * Pi's `on` hands back nothing to unsubscribe with, so the only resource this
+ * owns across a reload is the armed timer — and an armed timer is the one that
+ * matters, because firing it would stop the session Pi has just reloaded into.
+ */
+declare function registerIdleShutdown(pi: ExtensionAPI, delays: AutoStopDelays): () => void;
+//#endregion
+export { registerIdleShutdown };
+//# sourceMappingURL=idleShutdown.d.cts.map

package/dist/adapters/pi/idleShutdown.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idleShutdown.d.cts","names":[],"sources":["../../../src/adapters/pi/idleShutdown.ts"],"mappings":";;;;;;;;;;iBAoBgB,qBAAqB,IAAI,cAAc,QAAQ"}

package/dist/adapters/pi/idleShutdown.d.mts

@@ -0,0 +1,14 @@
+import { AutoStopDelays } from "../../services/idlePolicy.mjs";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/adapters/pi/idleShutdown.d.ts
+/**
+ * Watches the session for idleness and returns the disposer for that watch.
+ *
+ * Pi's `on` hands back nothing to unsubscribe with, so the only resource this
+ * owns across a reload is the armed timer — and an armed timer is the one that
+ * matters, because firing it would stop the session Pi has just reloaded into.
+ */
+declare function registerIdleShutdown(pi: ExtensionAPI, delays: AutoStopDelays): () => void;
+//#endregion
+export { registerIdleShutdown };
+//# sourceMappingURL=idleShutdown.d.mts.map

package/dist/adapters/pi/idleShutdown.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idleShutdown.d.mts","names":[],"sources":["../../../src/adapters/pi/idleShutdown.ts"],"mappings":";;;;;;;;;;iBAoBgB,qBAAqB,IAAI,cAAc,QAAQ"}

package/dist/adapters/pi/idleShutdown.mjs

@@ -0,0 +1,2 @@
+import{AUTO_STOP_ACTION as e,decideOnRecheck as t,decideOnSettled as n}from"../../services/idlePolicy.mjs";function r(e){return{hasPendingMessages:e.hasPendingMessages(),isIdle:e.isIdle()}}function i(i,a){let o,s=()=>{o&&=(clearTimeout(o),void 0)},c=(n,i)=>{o=setTimeout(()=>{o=void 0;let i=t(r(n),a);if(i.action===e.shutdown){n.shutdown();return}i.action===e.recheck&&c(n,i.delayMs)},i)};return i.on(`input`,s),i.on(`agent_start`,s),i.on(`agent_settled`,(t,i)=>{s();let o=n(r(i),a);o.action===e.recheck&&c(i,o.delayMs)}),s}export{i as registerIdleShutdown};
+//# sourceMappingURL=idleShutdown.mjs.map

package/dist/adapters/pi/idleShutdown.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idleShutdown.mjs","names":[],"sources":["../../../src/adapters/pi/idleShutdown.ts"],"sourcesContent":["import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';\nimport {\n  AUTO_STOP_ACTION,\n  type AutoStopDelays,\n  type SessionActivity,\n  decideOnRecheck,\n  decideOnSettled,\n} from '../../services/idlePolicy.ts';\n\nfunction readActivity(context: ExtensionContext): SessionActivity {\n  return { hasPendingMessages: context.hasPendingMessages(), isIdle: context.isIdle() };\n}\n\n/**\n * Watches the session for idleness and returns the disposer for that watch.\n *\n * Pi's `on` hands back nothing to unsubscribe with, so the only resource this\n * owns across a reload is the armed timer — and an armed timer is the one that\n * matters, because firing it would stop the session Pi has just reloaded into.\n */\nexport function registerIdleShutdown(pi: ExtensionAPI, delays: AutoStopDelays): () => void {\n  let shutdownTimer: NodeJS.Timeout | undefined;\n\n  const cancelScheduledShutdown = (): void => {\n    if (!shutdownTimer) return;\n    clearTimeout(shutdownTimer);\n    shutdownTimer = undefined;\n  };\n\n  const scheduleShutdown = (context: ExtensionContext, delayMs: number): void => {\n    shutdownTimer = setTimeout(() => {\n      shutdownTimer = undefined;\n      const decision = decideOnRecheck(readActivity(context), delays);\n      if (decision.action === AUTO_STOP_ACTION.shutdown) {\n        context.shutdown();\n        return;\n      }\n      if (decision.action === AUTO_STOP_ACTION.recheck) scheduleShutdown(context, decision.delayMs);\n    }, delayMs);\n  };\n\n  pi.on('input', cancelScheduledShutdown);\n  pi.on('agent_start', cancelScheduledShutdown);\n\n  pi.on('agent_settled', (_event, context) => {\n    cancelScheduledShutdown();\n    const decision = decideOnSettled(readActivity(context), delays);\n    if (decision.action === AUTO_STOP_ACTION.recheck) scheduleShutdown(context, decision.delayMs);\n  });\n\n  return cancelScheduledShutdown;\n}\n"],"mappings":"2GASA,SAAS,EAAa,EAA4C,CAChE,MAAO,CAAE,mBAAoB,EAAQ,mBAAmB,EAAG,OAAQ,EAAQ,OAAO,CAAE,CACtF,CASA,SAAgB,EAAqB,EAAkB,EAAoC,CACzF,IAAI,EAEE,MAAsC,CACrC,AAEL,KADA,aAAa,CAAa,EACV,IAAA,GAClB,EAEM,GAAoB,EAA2B,IAA0B,CAC7E,EAAgB,eAAiB,CAC/B,EAAgB,IAAA,GAChB,IAAM,EAAW,EAAgB,EAAa,CAAO,EAAG,CAAM,EAC9D,GAAI,EAAS,SAAW,EAAiB,SAAU,CACjD,EAAQ,SAAS,EACjB,MACF,CACI,EAAS,SAAW,EAAiB,SAAS,EAAiB,EAAS,EAAS,OAAO,CAC9F,EAAG,CAAO,CACZ,EAWA,OATA,EAAG,GAAG,QAAS,CAAuB,EACtC,EAAG,GAAG,cAAe,CAAuB,EAE5C,EAAG,GAAG,iBAAkB,EAAQ,IAAY,CAC1C,EAAwB,EACxB,IAAM,EAAW,EAAgB,EAAa,CAAO,EAAG,CAAM,EAC1D,EAAS,SAAW,EAAiB,SAAS,EAAiB,EAAS,EAAS,OAAO,CAC9F,CAAC,EAEM,CACT"}

package/dist/extensions/pi.cjs

@@ -0,0 +1 @@
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("../adapters/pi/extension.cjs");exports.autoStopExtension=e.autoStopExtension,exports.default=e.autoStopExtension;

package/dist/extensions/pi.d.cts

@@ -0,0 +1,2 @@
+import { autoStopExtension } from "../adapters/pi/extension.cjs";
+export { autoStopExtension, autoStopExtension as default };

package/dist/extensions/pi.d.mts

@@ -0,0 +1,2 @@
+import { autoStopExtension } from "../adapters/pi/extension.mjs";
+export { autoStopExtension, autoStopExtension as default };

package/dist/extensions/pi.mjs

@@ -0,0 +1 @@
+import{autoStopExtension as e}from"../adapters/pi/extension.mjs";export{e as autoStopExtension,e as default};

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./services/idlePolicy.cjs"),t=require("./adapters/pi/idleShutdown.cjs"),n=require("./adapters/pi/extension.cjs");exports.AUTO_STOP_ACTION=e.AUTO_STOP_ACTION,exports.DEFAULT_AUTO_STOP_DELAYS=e.DEFAULT_AUTO_STOP_DELAYS,exports.autoStopExtension=n.autoStopExtension,exports.decideOnRecheck=e.decideOnRecheck,exports.decideOnSettled=e.decideOnSettled,exports.registerIdleShutdown=t.registerIdleShutdown;

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+import { AUTO_STOP_ACTION, AutoStopAction, AutoStopDecision, AutoStopDelays, DEFAULT_AUTO_STOP_DELAYS, SessionActivity, decideOnRecheck, decideOnSettled } from "./services/idlePolicy.cjs";
+import { autoStopExtension } from "./adapters/pi/extension.cjs";
+import { registerIdleShutdown } from "./adapters/pi/idleShutdown.cjs";
+export { AUTO_STOP_ACTION, type AutoStopAction, type AutoStopDecision, type AutoStopDelays, DEFAULT_AUTO_STOP_DELAYS, type SessionActivity, autoStopExtension, decideOnRecheck, decideOnSettled, registerIdleShutdown };

package/dist/index.d.mts

@@ -0,0 +1,4 @@
+import { AUTO_STOP_ACTION, AutoStopAction, AutoStopDecision, AutoStopDelays, DEFAULT_AUTO_STOP_DELAYS, SessionActivity, decideOnRecheck, decideOnSettled } from "./services/idlePolicy.mjs";
+import { autoStopExtension } from "./adapters/pi/extension.mjs";
+import { registerIdleShutdown } from "./adapters/pi/idleShutdown.mjs";
+export { AUTO_STOP_ACTION, type AutoStopAction, type AutoStopDecision, type AutoStopDelays, DEFAULT_AUTO_STOP_DELAYS, type SessionActivity, autoStopExtension, decideOnRecheck, decideOnSettled, registerIdleShutdown };

package/dist/index.mjs

@@ -0,0 +1 @@
+import{AUTO_STOP_ACTION as e,DEFAULT_AUTO_STOP_DELAYS as t,decideOnRecheck as n,decideOnSettled as r}from"./services/idlePolicy.mjs";import{registerIdleShutdown as i}from"./adapters/pi/idleShutdown.mjs";import{autoStopExtension as a}from"./adapters/pi/extension.mjs";export{e as AUTO_STOP_ACTION,t as DEFAULT_AUTO_STOP_DELAYS,a as autoStopExtension,n as decideOnRecheck,r as decideOnSettled,i as registerIdleShutdown};

package/dist/services/idlePolicy.cjs

@@ -0,0 +1,2 @@
+const e={cooldownMs:5e3,recheckMs:100},t={shutdown:`shutdown`,recheck:`recheck`,standDown:`stand-down`};function n(e,n){return e.hasPendingMessages?{action:t.standDown}:{action:t.recheck,delayMs:n.cooldownMs}}function r(e,n){return e.hasPendingMessages?{action:t.standDown}:e.isIdle?{action:t.shutdown}:{action:t.recheck,delayMs:n.recheckMs}}exports.AUTO_STOP_ACTION=t,exports.DEFAULT_AUTO_STOP_DELAYS=e,exports.decideOnRecheck=r,exports.decideOnSettled=n;
+//# sourceMappingURL=idlePolicy.cjs.map

package/dist/services/idlePolicy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idlePolicy.cjs","names":[],"sources":["../../src/services/idlePolicy.ts"],"sourcesContent":["/** What the session was doing the moment the policy was asked. */\nexport interface SessionActivity {\n  readonly hasPendingMessages: boolean;\n  readonly isIdle: boolean;\n}\n\n/** How long the policy waits before each look at the session. */\nexport interface AutoStopDelays {\n  /** Grace period after the agent settles, so a follow-up prompt still lands. */\n  readonly cooldownMs: number;\n  /** Gap between looks while the agent is settled but still streaming. */\n  readonly recheckMs: number;\n}\n\nexport const DEFAULT_AUTO_STOP_DELAYS: AutoStopDelays = {\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\nexport type AutoStopAction = (typeof AUTO_STOP_ACTION)[keyof typeof AUTO_STOP_ACTION];\n\nexport type AutoStopDecision =\n  | { readonly action: typeof AUTO_STOP_ACTION.shutdown }\n  | { readonly action: typeof AUTO_STOP_ACTION.recheck; readonly delayMs: number }\n  | { readonly action: typeof AUTO_STOP_ACTION.standDown };\n\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":"AAcA,MAAa,EAA2C,CACtD,WAAY,IACZ,UAAW,GACb,EAEa,EAAmB,CAE9B,SAAU,WAEV,QAAS,UAET,UAAW,YACb,EAgBA,SAAgB,EAAgB,EAA2B,EAA0C,CAEnG,OADI,EAAS,mBAA2B,CAAE,OAAQ,EAAiB,SAAU,EACtE,CAAE,OAAQ,EAAiB,QAAS,QAAS,EAAO,UAAW,CACxE,CAQA,SAAgB,EAAgB,EAA2B,EAA0C,CAGnG,OAFI,EAAS,mBAA2B,CAAE,OAAQ,EAAiB,SAAU,EACzE,EAAS,OAAe,CAAE,OAAQ,EAAiB,QAAS,EACzD,CAAE,OAAQ,EAAiB,QAAS,QAAS,EAAO,SAAU,CACvE"}

package/dist/services/idlePolicy.d.cts

@@ -0,0 +1,49 @@
+//#region src/services/idlePolicy.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;
+}
+declare const DEFAULT_AUTO_STOP_DELAYS: AutoStopDelays;
+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';
+};
+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;
+};
+/**
+ * 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.
+ */
+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.
+ */
+declare function decideOnRecheck(activity: SessionActivity, delays: AutoStopDelays): AutoStopDecision;
+//#endregion
+export { AUTO_STOP_ACTION, AutoStopAction, AutoStopDecision, AutoStopDelays, DEFAULT_AUTO_STOP_DELAYS, SessionActivity, decideOnRecheck, decideOnSettled };
+//# sourceMappingURL=idlePolicy.d.cts.map

package/dist/services/idlePolicy.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idlePolicy.d.cts","names":[],"sources":["../../src/services/idlePolicy.ts"],"mappings":";;UACiB;WACN;WACA;;;UAIM;;WAEN;;WAEA;;cAGE,0BAA0B;cAK1B;;WAEX;;WAEA;;WAEA;;KAGU,yBAAyB,+BAA+B;KAExD;WACG,eAAe,iBAAiB;;WAChC,eAAe,iBAAiB;WAAkB;;WAClD,eAAe,iBAAiB;;;;;;;;;iBAS/B,gBAAgB,UAAU,iBAAiB,QAAQ,iBAAiB;;;;;;;iBAWpE,gBAAgB,UAAU,iBAAiB,QAAQ,iBAAiB"}

package/dist/services/idlePolicy.d.mts

@@ -0,0 +1,49 @@
+//#region src/services/idlePolicy.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;
+}
+declare const DEFAULT_AUTO_STOP_DELAYS: AutoStopDelays;
+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';
+};
+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;
+};
+/**
+ * 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.
+ */
+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.
+ */
+declare function decideOnRecheck(activity: SessionActivity, delays: AutoStopDelays): AutoStopDecision;
+//#endregion
+export { AUTO_STOP_ACTION, AutoStopAction, AutoStopDecision, AutoStopDelays, DEFAULT_AUTO_STOP_DELAYS, SessionActivity, decideOnRecheck, decideOnSettled };
+//# sourceMappingURL=idlePolicy.d.mts.map

package/dist/services/idlePolicy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idlePolicy.d.mts","names":[],"sources":["../../src/services/idlePolicy.ts"],"mappings":";;UACiB;WACN;WACA;;;UAIM;;WAEN;;WAEA;;cAGE,0BAA0B;cAK1B;;WAEX;;WAEA;;WAEA;;KAGU,yBAAyB,+BAA+B;KAExD;WACG,eAAe,iBAAiB;;WAChC,eAAe,iBAAiB;WAAkB;;WAClD,eAAe,iBAAiB;;;;;;;;;iBAS/B,gBAAgB,UAAU,iBAAiB,QAAQ,iBAAiB;;;;;;;iBAWpE,gBAAgB,UAAU,iBAAiB,QAAQ,iBAAiB"}

package/dist/services/idlePolicy.mjs

@@ -0,0 +1,2 @@
+const e={cooldownMs:5e3,recheckMs:100},t={shutdown:`shutdown`,recheck:`recheck`,standDown:`stand-down`};function n(e,n){return e.hasPendingMessages?{action:t.standDown}:{action:t.recheck,delayMs:n.cooldownMs}}function r(e,n){return e.hasPendingMessages?{action:t.standDown}:e.isIdle?{action:t.shutdown}:{action:t.recheck,delayMs:n.recheckMs}}export{t as AUTO_STOP_ACTION,e as DEFAULT_AUTO_STOP_DELAYS,r as decideOnRecheck,n as decideOnSettled};
+//# sourceMappingURL=idlePolicy.mjs.map

package/dist/services/idlePolicy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"idlePolicy.mjs","names":[],"sources":["../../src/services/idlePolicy.ts"],"sourcesContent":["/** What the session was doing the moment the policy was asked. */\nexport interface SessionActivity {\n  readonly hasPendingMessages: boolean;\n  readonly isIdle: boolean;\n}\n\n/** How long the policy waits before each look at the session. */\nexport interface AutoStopDelays {\n  /** Grace period after the agent settles, so a follow-up prompt still lands. */\n  readonly cooldownMs: number;\n  /** Gap between looks while the agent is settled but still streaming. */\n  readonly recheckMs: number;\n}\n\nexport const DEFAULT_AUTO_STOP_DELAYS: AutoStopDelays = {\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\nexport type AutoStopAction = (typeof AUTO_STOP_ACTION)[keyof typeof AUTO_STOP_ACTION];\n\nexport type AutoStopDecision =\n  | { readonly action: typeof AUTO_STOP_ACTION.shutdown }\n  | { readonly action: typeof AUTO_STOP_ACTION.recheck; readonly delayMs: number }\n  | { readonly action: typeof AUTO_STOP_ACTION.standDown };\n\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":"AAcA,MAAa,EAA2C,CACtD,WAAY,IACZ,UAAW,GACb,EAEa,EAAmB,CAE9B,SAAU,WAEV,QAAS,UAET,UAAW,YACb,EAgBA,SAAgB,EAAgB,EAA2B,EAA0C,CAEnG,OADI,EAAS,mBAA2B,CAAE,OAAQ,EAAiB,SAAU,EACtE,CAAE,OAAQ,EAAiB,QAAS,QAAS,EAAO,UAAW,CACxE,CAQA,SAAgB,EAAgB,EAA2B,EAA0C,CAGnG,OAFI,EAAS,mBAA2B,CAAE,OAAQ,EAAiB,SAAU,EACzE,EAAS,OAAe,CAAE,OAAQ,EAAiB,QAAS,EACzD,CAAE,OAAQ,EAAiB,QAAS,QAAS,EAAO,SAAU,CACvE"}

package/llms.txt

@@ -0,0 +1,7 @@
+# Doom Pi Autostop
+
+Shuts a Doom Pi session down once the agent settles and stays idle.
+
+## Resources
+
+- [Package README](./README.md): the idle policy, the cooldown, and when the session is left alone.

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@agimon-ai/doompi-autostop",
+  "version": "0.0.1-alpha.10",
+  "description": "Shuts a DoomPi session down once the agent settles and stays idle.",
+  "keywords": [
+    "ai",
+    "auto-stop",
+    "coding-agent",
+    "developer-tools",
+    "doompi",
+    "idle-timeout",
+    "pi-coding-agent",
+    "pi-extension",
+    "pi-package",
+    "session-shutdown"
+  ],
+  "homepage": "https://agimon.ai",
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "files": [
+    "dist",
+    "llms.txt",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./extensions/pi": {
+      "types": "./dist/extensions/pi.d.mts",
+      "import": "./dist/extensions/pi.mjs",
+      "require": "./dist/extensions/pi.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.32"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.2",
+    "@types/node": "26.2.0",
+    "@vitest/coverage-v8": "4.1.11",
+    "tsdown": "0.22.14",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11",
+    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.1-alpha.30"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "0.84.2"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "pi": {
+    "extensions": [
+      "./dist/extensions/pi.mjs"
+    ]
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}