@agimon-ai/doompi-runner 0.0.1-alpha.0

package/dist/services/RunnerRegistry/RunnerRegistry.d.mts

@@ -0,0 +1,40 @@
+import { IRunnerPaths } from "../RunnerPaths/types.mjs";
+import "../RunnerPaths/index.mjs";
+import { IProcessControl } from "../ProcessControl/types.mjs";
+import "../ProcessControl/index.mjs";
+import { CompleteRunnerInput, IRunnerRegistry, RegisterRunnerInput, RunnerRecord } from "./types.mjs";
+import "reflect-metadata/lite";
+import { ProcessRegistryService } from "@agimon-ai/foundation-process-registry";
+//#region src/services/RunnerRegistry/RunnerRegistry.d.ts
+/** The slice of the shared registry service this wrapper depends on. */
+type ProcessRegistryPort = Pick<ProcessRegistryService, 'registerProcess' | 'releaseProcess' | 'listProcesses' | 'close'>;
+/** Opens the SQLite-backed registry the rest of the monorepo already shares. */
+declare function createDefaultProcessRegistry(): ProcessRegistryPort;
+declare class RunnerRegistry implements IRunnerRegistry {
+  private readonly paths;
+  private readonly processControl;
+  private readonly registry;
+  private readonly listeners;
+  constructor(paths: IRunnerPaths, processControl: IProcessControl, registry: ProcessRegistryPort);
+  register(input: RegisterRunnerInput): Promise<RunnerRecord>;
+  list(): Promise<RunnerRecord[]>;
+  listAcrossRepositories(): Promise<RunnerRecord[]>;
+  listBySession(sessionId: string): Promise<RunnerRecord[]>;
+  listByRootSession(rootSessionId: string): Promise<RunnerRecord[]>;
+  listAll(sessionId?: string): Promise<RunnerRecord[]>;
+  get(id: string, sessionId?: string): Promise<RunnerRecord | undefined>;
+  markPromoted(id: string): Promise<RunnerRecord | undefined>;
+  clearAlarm(id: string, sessionId?: string): Promise<RunnerRecord | undefined>;
+  markAlarmFired(id: string, firedAt: string): Promise<RunnerRecord | undefined>;
+  complete(id: string, outcome: CompleteRunnerInput, sessionId?: string): Promise<RunnerRecord | undefined>;
+  release(id: string): Promise<void>;
+  pruneDead(): Promise<string[]>;
+  subscribe(listener: () => void): () => void;
+  close(): void;
+  private notify;
+  private repositoryPath;
+  private writeRecord;
+}
+//#endregion
+export { ProcessRegistryPort, RunnerRegistry, createDefaultProcessRegistry };
+//# sourceMappingURL=RunnerRegistry.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RunnerRegistry.d.mts","names":[],"sources":["../../../src/services/RunnerRegistry/RunnerRegistry.ts"],"mappings":";;;;;;;;;KA2BY,sBAAsB,KAChC;;iBAKc,gCAAgC;cAmBnC,0BAA0B;mBAIS;mBACG;mBACC;mBALjC;EAG6B,YAAA,OAAO,cACJ,gBAAgB,iBACf,UAAU;EAGtD,SAAS,OAAO,sBAAsB,QAAQ;EAoD9C,QAAQ,QAAQ;EAShB,0BAA0B,QAAQ;EAQlC,cAAc,oBAAoB,QAAQ;EAK1C,kBAAkB,wBAAwB,QAAQ;EAKlD,QAAQ,qBAAqB,QAAQ;EAgBrC,IAAI,YAAY,qBAAqB,QAAQ;EAgB7C,aAAa,aAAa,QAAQ;EASlC,WAAW,YAAY,qBAAqB,QAAQ;EAWpD,eAAe,YAAY,kBAAkB,QAAQ;EASrD,SAAS,YAAY,SAAS,qBAAqB,qBAAqB,QAAQ;EA0BhF,QAAQ,aAAa;EAerB,aAAa;EAQnB,UAAU;EAKV;UAKQ;UAIA;UAIA"}

package/dist/services/RunnerRegistry/RunnerRegistry.mjs

@@ -0,0 +1,2 @@
+import{TYPES as e}from"../../types.mjs";import t from"../../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateMetadata.mjs";import n from"../../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorateParam.mjs";import r from"../../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.mjs";import{inject as i,injectable as a}from"inversify";import"reflect-metadata/lite";import o from"node:fs";import s from"node:path";import{resolveRootSessionId as c}from"@agimon-ai/doompi-extension-contracts/child-process";import{createProcessRegistryService as l,normalizeRepositoryPath as u,resolveProcessTags as d}from"@agimon-ai/foundation-process-registry";const f=`tool`,p=`doom-runner:`,m=`doom-runner`;function h(){return l(process.env.PROCESS_REGISTRY_PATH)}function g(e){return`session:${e}`}function _(e,t){let n=e.metadata?.[t];return typeof n==`string`?n:``}function v(e,t){let n=e.metadata?.[t];return typeof n==`number`?n:0}let y=class{paths;processControl;registry;listeners=new Set;constructor(e,t,n){this.paths=e,this.processControl=t,this.registry=n}async register(e){let t=new Date().toISOString(),n=c(e.sessionId),r=await this.registry.registerProcess({repositoryPath:this.repositoryPath(),serviceName:`${p}${e.id}`,serviceType:f,pid:e.pid,command:e.command,tags:d([m,`runner:${e.id}`,g(e.sessionId)]),metadata:{id:e.id,name:e.name,command:e.command,cwd:e.cwd,logPath:e.logPath,interactive:e.interactive,sessionId:e.sessionId,rootSessionId:n,backend:e.backend,...e.backendTarget?{backendTarget:e.backendTarget}:{},startedAt:t,hostPid:process.pid},force:!0});if(!r.success)throw Error(r.error??`Failed to register runner ${e.name}`);let i={id:e.id,name:e.name,pid:e.pid,command:e.command,cwd:e.cwd,logPath:e.logPath,interactive:e.interactive,sessionId:e.sessionId,rootSessionId:n,startedAt:t,state:`running`,promoted:!1,backend:e.backend,...e.backendTarget?{backendTarget:e.backendTarget}:{},...e.alarmMs?{alarm:{intervalMs:e.alarmMs,lastFiredAt:t}}:{},hostPid:process.pid};return this.writeRecord(i),this.notify(),i}async list(){return(await this.registry.listProcesses({repositoryPath:this.repositoryPath(),serviceType:f,tags:d([m])})).map(b)}async listAcrossRepositories(){return(await this.registry.listProcesses({serviceType:f,tags:d([m])})).map(b)}async listBySession(e){return(await this.list()).filter(t=>t.sessionId===e)}async listByRootSession(e){return(await this.list()).filter(t=>(t.rootSessionId??t.sessionId)===e)}async listAll(e){this.paths.ensureDirectories(e);let t=[],n=this.paths.stateDirectory(e);for(let e of o.readdirSync(n))if(S(e))try{let r=JSON.parse(o.readFileSync(`${n}/${e}`,`utf8`));C(r)&&t.push(r)}catch(t){process.emitWarning(`Could not read runner metadata ${e}: ${String(t)}`)}return t.sort((e,t)=>t.startedAt.localeCompare(e.startedAt))}async get(e,t){let n=this.paths.statePathFor(e,t);try{let t=JSON.parse(o.readFileSync(n,`utf8`));if(!C(t)||t.id!==e){process.emitWarning(`Could not read runner metadata ${s.basename(n)}: invalid runner record`);return}return t}catch(e){if(e.code===`ENOENT`)return;process.emitWarning(`Could not read runner metadata ${s.basename(n)}: ${String(e)}`);return}}async markPromoted(e){let t=await this.get(e);if(!t)return;let n={...t,promoted:!0};return this.writeRecord(n),this.notify(),n}async clearAlarm(e,t){let n=await this.get(e,t);if(!n)return;if(!n.alarm)return n;let r={...n};return delete r.alarm,this.writeRecord(r),this.notify(),r}async markAlarmFired(e,t){let n=await this.get(e);if(!n?.alarm||n.state!==`running`)return;let r={...n,alarm:{...n.alarm,lastFiredAt:t}};return this.writeRecord(r),this.notify(),r}async complete(e,t,n){let r=await this.get(e,n);if(r?.state===`completed`)return await this.release(e),r;let i=await this.list(),a=r??i.find(t=>t.id===e&&(n===void 0||t.sessionId===n));if(!a){n!==void 0&&i.some(t=>t.id===e&&t.sessionId!==n)||await this.release(e);return}let o={...a,state:`completed`,exit:{...t,finishedAt:new Date().toISOString()}};return this.writeRecord(o),await this.release(e),o}async release(e){let t=await this.registry.releaseProcess({repositoryPath:this.repositoryPath(),serviceName:`${p}${e}`,serviceType:f,kill:!1,releasePort:!1,force:!0});if(!t.success&&!t.error?.includes(`No matching process entry`))throw Error(t.error??`Failed to release runner ${e}`);this.notify()}async pruneDead(){let e=(await this.list()).filter(e=>!this.processControl.isAlive(e.pid));for(let t of e)await this.complete(t.id,{reason:`backend_lost`,code:null,signal:null},t.sessionId);return e.map(e=>e.id)}subscribe(e){return this.listeners.add(e),()=>this.listeners.delete(e)}close(){this.listeners.clear(),this.registry.close()}notify(){for(let e of this.listeners)e()}repositoryPath(){return u(this.paths.repositoryPath())}writeRecord(e){this.paths.ensureDirectories(e.sessionId);let t=this.paths.statePathFor(e.id,e.sessionId),n=`${t}.${process.pid}.tmp`;o.writeFileSync(n,`${JSON.stringify(e,null,2)}\n`,`utf8`),o.renameSync(n,t)}};y=r([a(),n(0,i(e.RunnerPaths)),n(1,i(e.ProcessControl)),n(2,i(e.ProcessRegistry)),t(`design:paramtypes`,[Object,Object,Object])],y);function b(e){return{id:_(e,`id`),name:_(e,`name`),pid:e.pid,command:_(e,`command`),cwd:_(e,`cwd`),logPath:_(e,`logPath`),interactive:e.metadata?.interactive===!0,sessionId:_(e,`sessionId`),..._(e,`rootSessionId`)?{rootSessionId:_(e,`rootSessionId`)}:{},startedAt:_(e,`startedAt`),state:`running`,promoted:!1,backend:x(e.metadata?.backend),..._(e,`backendTarget`)?{backendTarget:_(e,`backendTarget`)}:{},hostPid:v(e,`hostPid`)}}function x(e){return e===`rmux`||e===`tmux`?e:`native`}function S(e){return e.endsWith(`.json`)&&!e.endsWith(`.command.json`)&&!e.endsWith(`.exit.json`)}function C(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.id==`string`&&typeof t.name==`string`&&typeof t.pid==`number`&&typeof t.command==`string`&&typeof t.cwd==`string`&&typeof t.logPath==`string`&&typeof t.sessionId==`string`&&typeof t.startedAt==`string`&&(t.state===`running`||t.state===`completed`)&&typeof t.promoted==`boolean`&&(t.backend===`rmux`||t.backend===`tmux`||t.backend===`native`)}export{y as RunnerRegistry,h as createDefaultProcessRegistry};
+//# sourceMappingURL=RunnerRegistry.mjs.map

package/dist/services/RunnerRegistry/RunnerRegistry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunnerRegistry.mjs","names":[],"sources":["../../../src/services/RunnerRegistry/RunnerRegistry.ts"],"sourcesContent":["import { resolveRootSessionId } from '@agimon-ai/doompi-extension-contracts/child-process';\nimport {\n  createProcessRegistryService,\n  normalizeRepositoryPath,\n  type ProcessRegistryRecord,\n  type ProcessRegistryService,\n  resolveProcessTags,\n} from '@agimon-ai/foundation-process-registry';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { inject, injectable } from 'inversify';\nimport 'reflect-metadata/lite';\nimport type { IProcessControl } from '../ProcessControl/index.ts';\nimport type { IRunnerPaths } from '../RunnerPaths/index.ts';\nimport { TYPES } from '../../types.ts';\nimport type { CompleteRunnerInput, IRunnerRegistry, RegisterRunnerInput, RunnerRecord } from './types.ts';\n\nconst SERVICE_TYPE = 'tool';\nconst SERVICE_PREFIX = 'doom-runner:';\nconst RUNNER_TAG = 'doom-runner';\nconst REGISTRY_PATH_ENV = 'PROCESS_REGISTRY_PATH';\nconst JSON_EXTENSION = '.json';\nconst COMMAND_SIDECAR_SUFFIX = '.command.json';\nconst EXIT_SIDECAR_SUFFIX = '.exit.json';\nconst NOT_FOUND_ERROR_CODE = 'ENOENT';\n\n/** The slice of the shared registry service this wrapper depends on. */\nexport type ProcessRegistryPort = Pick<\n  ProcessRegistryService,\n  'registerProcess' | 'releaseProcess' | 'listProcesses' | 'close'\n>;\n\n/** Opens the SQLite-backed registry the rest of the monorepo already shares. */\nexport function createDefaultProcessRegistry(): ProcessRegistryPort {\n  return createProcessRegistryService(process.env[REGISTRY_PATH_ENV]);\n}\n\nfunction sessionTag(sessionId: string): string {\n  return `session:${sessionId}`;\n}\n\nfunction readString(record: ProcessRegistryRecord, key: string): string {\n  const value = record.metadata?.[key];\n  return typeof value === 'string' ? value : '';\n}\n\nfunction readNumber(record: ProcessRegistryRecord, key: string): number {\n  const value = record.metadata?.[key];\n  return typeof value === 'number' ? value : 0;\n}\n\n@injectable()\nexport class RunnerRegistry implements IRunnerRegistry {\n  private readonly listeners = new Set<() => void>();\n\n  constructor(\n    @inject(TYPES.RunnerPaths) private readonly paths: IRunnerPaths,\n    @inject(TYPES.ProcessControl) private readonly processControl: IProcessControl,\n    @inject(TYPES.ProcessRegistry) private readonly registry: ProcessRegistryPort,\n  ) {}\n\n  async register(input: RegisterRunnerInput): Promise<RunnerRecord> {\n    const startedAt = new Date().toISOString();\n    const rootSessionId = resolveRootSessionId(input.sessionId);\n    const response = await this.registry.registerProcess({\n      repositoryPath: this.repositoryPath(),\n      serviceName: `${SERVICE_PREFIX}${input.id}`,\n      serviceType: SERVICE_TYPE,\n      pid: input.pid,\n      command: input.command,\n      tags: resolveProcessTags([RUNNER_TAG, `runner:${input.id}`, sessionTag(input.sessionId)]),\n      metadata: {\n        id: input.id,\n        name: input.name,\n        command: input.command,\n        cwd: input.cwd,\n        logPath: input.logPath,\n        interactive: input.interactive,\n        sessionId: input.sessionId,\n        rootSessionId,\n        backend: input.backend,\n        ...(input.backendTarget ? { backendTarget: input.backendTarget } : {}),\n        startedAt,\n        hostPid: process.pid,\n      },\n      // The caller has already resolved name collisions against live records,\n      // so anything still holding this name is stale.\n      force: true,\n    });\n    if (!response.success) throw new Error(response.error ?? `Failed to register runner ${input.name}`);\n    const record: RunnerRecord = {\n      id: input.id,\n      name: input.name,\n      pid: input.pid,\n      command: input.command,\n      cwd: input.cwd,\n      logPath: input.logPath,\n      interactive: input.interactive,\n      sessionId: input.sessionId,\n      rootSessionId,\n      startedAt,\n      state: 'running',\n      promoted: false,\n      backend: input.backend,\n      ...(input.backendTarget ? { backendTarget: input.backendTarget } : {}),\n      ...(input.alarmMs ? { alarm: { intervalMs: input.alarmMs, lastFiredAt: startedAt } } : {}),\n      hostPid: process.pid,\n    };\n    this.writeRecord(record);\n    this.notify();\n    return record;\n  }\n\n  async list(): Promise<RunnerRecord[]> {\n    const records = await this.registry.listProcesses({\n      repositoryPath: this.repositoryPath(),\n      serviceType: SERVICE_TYPE,\n      tags: resolveProcessTags([RUNNER_TAG]),\n    });\n    return records.map(toRunnerRecord);\n  }\n\n  async listAcrossRepositories(): Promise<RunnerRecord[]> {\n    const records = await this.registry.listProcesses({\n      serviceType: SERVICE_TYPE,\n      tags: resolveProcessTags([RUNNER_TAG]),\n    });\n    return records.map(toRunnerRecord);\n  }\n\n  async listBySession(sessionId: string): Promise<RunnerRecord[]> {\n    const records = await this.list();\n    return records.filter((record) => record.sessionId === sessionId);\n  }\n\n  async listByRootSession(rootSessionId: string): Promise<RunnerRecord[]> {\n    const records = await this.list();\n    return records.filter((record) => (record.rootSessionId ?? record.sessionId) === rootSessionId);\n  }\n\n  async listAll(sessionId?: string): Promise<RunnerRecord[]> {\n    this.paths.ensureDirectories(sessionId);\n    const records: RunnerRecord[] = [];\n    const directory = this.paths.stateDirectory(sessionId);\n    for (const entry of fs.readdirSync(directory)) {\n      if (!isPrimaryMetadataEntry(entry)) continue;\n      try {\n        const parsed: unknown = JSON.parse(fs.readFileSync(`${directory}/${entry}`, 'utf8'));\n        if (isRunnerRecord(parsed)) records.push(parsed);\n      } catch (error) {\n        process.emitWarning(`Could not read runner metadata ${entry}: ${String(error)}`);\n      }\n    }\n    return records.sort((left, right) => right.startedAt.localeCompare(left.startedAt));\n  }\n\n  async get(id: string, sessionId?: string): Promise<RunnerRecord | undefined> {\n    const target = this.paths.statePathFor(id, sessionId);\n    try {\n      const parsed: unknown = JSON.parse(fs.readFileSync(target, 'utf8'));\n      if (!isRunnerRecord(parsed) || parsed.id !== id) {\n        process.emitWarning(`Could not read runner metadata ${path.basename(target)}: invalid runner record`);\n        return undefined;\n      }\n      return parsed;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === NOT_FOUND_ERROR_CODE) return undefined;\n      process.emitWarning(`Could not read runner metadata ${path.basename(target)}: ${String(error)}`);\n      return undefined;\n    }\n  }\n\n  async markPromoted(id: string): Promise<RunnerRecord | undefined> {\n    const record = await this.get(id);\n    if (!record) return undefined;\n    const promoted = { ...record, promoted: true };\n    this.writeRecord(promoted);\n    this.notify();\n    return promoted;\n  }\n\n  async clearAlarm(id: string, sessionId?: string): Promise<RunnerRecord | undefined> {\n    const record = await this.get(id, sessionId);\n    if (!record) return undefined;\n    if (!record.alarm) return record;\n    const cleared: RunnerRecord = { ...record };\n    delete cleared.alarm;\n    this.writeRecord(cleared);\n    this.notify();\n    return cleared;\n  }\n\n  async markAlarmFired(id: string, firedAt: string): Promise<RunnerRecord | undefined> {\n    const record = await this.get(id);\n    if (!record?.alarm || record.state !== 'running') return undefined;\n    const fired: RunnerRecord = { ...record, alarm: { ...record.alarm, lastFiredAt: firedAt } };\n    this.writeRecord(fired);\n    this.notify();\n    return fired;\n  }\n\n  async complete(id: string, outcome: CompleteRunnerInput, sessionId?: string): Promise<RunnerRecord | undefined> {\n    const persisted = await this.get(id, sessionId);\n    if (persisted?.state === 'completed') {\n      await this.release(id);\n      return persisted;\n    }\n    const active = await this.list();\n    const record =\n      persisted ??\n      active.find((candidate) => candidate.id === id && (sessionId === undefined || candidate.sessionId === sessionId));\n    if (!record) {\n      const belongsToAnotherSession =\n        sessionId !== undefined && active.some((candidate) => candidate.id === id && candidate.sessionId !== sessionId);\n      if (!belongsToAnotherSession) await this.release(id);\n      return undefined;\n    }\n    const completed: RunnerRecord = {\n      ...record,\n      state: 'completed',\n      exit: { ...outcome, finishedAt: new Date().toISOString() },\n    };\n    this.writeRecord(completed);\n    await this.release(id);\n    return completed;\n  }\n\n  async release(id: string): Promise<void> {\n    const response = await this.registry.releaseProcess({\n      repositoryPath: this.repositoryPath(),\n      serviceName: `${SERVICE_PREFIX}${id}`,\n      serviceType: SERVICE_TYPE,\n      kill: false,\n      releasePort: false,\n      force: true,\n    });\n    if (!response.success && !response.error?.includes('No matching process entry')) {\n      throw new Error(response.error ?? `Failed to release runner ${id}`);\n    }\n    this.notify();\n  }\n\n  async pruneDead(): Promise<string[]> {\n    const dead = (await this.list()).filter((record) => !this.processControl.isAlive(record.pid));\n    for (const record of dead) {\n      await this.complete(record.id, { reason: 'backend_lost', code: null, signal: null }, record.sessionId);\n    }\n    return dead.map((record) => record.id);\n  }\n\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  close(): void {\n    this.listeners.clear();\n    this.registry.close();\n  }\n\n  private notify(): void {\n    for (const listener of this.listeners) listener();\n  }\n\n  private repositoryPath(): string {\n    return normalizeRepositoryPath(this.paths.repositoryPath());\n  }\n\n  private writeRecord(record: RunnerRecord): void {\n    this.paths.ensureDirectories(record.sessionId);\n    const target = this.paths.statePathFor(record.id, record.sessionId);\n    const temporary = `${target}.${process.pid}.tmp`;\n    fs.writeFileSync(temporary, `${JSON.stringify(record, null, 2)}\\n`, 'utf8');\n    fs.renameSync(temporary, target);\n  }\n}\n\n/** Every field is read back from metadata this class wrote on registration. */\nfunction toRunnerRecord(record: ProcessRegistryRecord): RunnerRecord {\n  return {\n    id: readString(record, 'id'),\n    name: readString(record, 'name'),\n    pid: record.pid,\n    command: readString(record, 'command'),\n    cwd: readString(record, 'cwd'),\n    logPath: readString(record, 'logPath'),\n    interactive: record.metadata?.interactive === true,\n    sessionId: readString(record, 'sessionId'),\n    ...(readString(record, 'rootSessionId') ? { rootSessionId: readString(record, 'rootSessionId') } : {}),\n    startedAt: readString(record, 'startedAt'),\n    state: 'running',\n    promoted: false,\n    backend: readBackend(record.metadata?.backend),\n    ...(readString(record, 'backendTarget') ? { backendTarget: readString(record, 'backendTarget') } : {}),\n    hostPid: readNumber(record, 'hostPid'),\n  };\n}\n\nfunction readBackend(value: unknown): RunnerRecord['backend'] {\n  return value === 'rmux' || value === 'tmux' ? value : 'native';\n}\n\nfunction isPrimaryMetadataEntry(entry: string): boolean {\n  return (\n    entry.endsWith(JSON_EXTENSION) && !entry.endsWith(COMMAND_SIDECAR_SUFFIX) && !entry.endsWith(EXIT_SIDECAR_SUFFIX)\n  );\n}\n\nfunction isRunnerRecord(value: unknown): value is RunnerRecord {\n  if (typeof value !== 'object' || value === null) return false;\n  const record = value as Partial<RunnerRecord>;\n  return (\n    typeof record.id === 'string' &&\n    typeof record.name === 'string' &&\n    typeof record.pid === 'number' &&\n    typeof record.command === 'string' &&\n    typeof record.cwd === 'string' &&\n    typeof record.logPath === 'string' &&\n    typeof record.sessionId === 'string' &&\n    typeof record.startedAt === 'string' &&\n    (record.state === 'running' || record.state === 'completed') &&\n    typeof record.promoted === 'boolean' &&\n    (record.backend === 'rmux' || record.backend === 'tmux' || record.backend === 'native')\n  );\n}\n"],"mappings":"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"}

package/dist/services/RunnerRegistry/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./RunnerRegistry.cjs");Object.defineProperty(exports,"RunnerRegistry",{enumerable:!0,get:function(){return e.RunnerRegistry}}),exports.createDefaultProcessRegistry=e.createDefaultProcessRegistry;

package/dist/services/RunnerRegistry/index.d.cts

@@ -0,0 +1,3 @@
+import { IRunnerRegistry, RegisterRunnerInput, RunnerRecord } from "./types.cjs";
+import { ProcessRegistryPort, RunnerRegistry, createDefaultProcessRegistry } from "./RunnerRegistry.cjs";
+export { type IRunnerRegistry, type ProcessRegistryPort, type RegisterRunnerInput, type RunnerRecord, RunnerRegistry, createDefaultProcessRegistry };

package/dist/services/RunnerRegistry/index.d.mts

@@ -0,0 +1,3 @@
+import { IRunnerRegistry, RegisterRunnerInput, RunnerRecord } from "./types.mjs";
+import { ProcessRegistryPort, RunnerRegistry, createDefaultProcessRegistry } from "./RunnerRegistry.mjs";
+export { type IRunnerRegistry, type ProcessRegistryPort, type RegisterRunnerInput, type RunnerRecord, RunnerRegistry, createDefaultProcessRegistry };

package/dist/services/RunnerRegistry/index.mjs

@@ -0,0 +1 @@
+import{RunnerRegistry as e,createDefaultProcessRegistry as t}from"./RunnerRegistry.mjs";export{e as RunnerRegistry,t as createDefaultProcessRegistry};

package/dist/services/RunnerRegistry/types.d.cts

@@ -0,0 +1,98 @@
+//#region src/services/RunnerRegistry/types.d.ts
+type RunnerBackend = 'rmux' | 'tmux' | 'native';
+type RunnerState = 'running' | 'completed';
+type RunnerExitReason = 'completed' | 'failed' | 'signaled' | 'stopped' | 'timed_out' | 'launcher_error' | 'backend_lost';
+interface RunnerExit {
+  reason: RunnerExitReason;
+  code: number | null;
+  signal: NodeJS.Signals | null;
+  stopReason?: string;
+  finishedAt: string;
+}
+/** A recurring snapshot of a running runner, pushed to the model until it exits. */
+interface RunnerAlarm {
+  intervalMs: number;
+  /** The last fire, or the runner's start time before the first one. */
+  lastFiredAt: string;
+}
+/** A command this extension supervises, retained after completion for CLI access. */
+interface RunnerRecord {
+  id: string;
+  name: string;
+  /** Process group leader, the pid signals are sent to. */
+  pid: number;
+  command: string;
+  cwd: string;
+  logPath: string;
+  interactive: boolean;
+  sessionId: string;
+  /** Root Pi session shared by the process tree. Ownership remains with sessionId. */
+  rootSessionId?: string;
+  startedAt: string;
+  state: RunnerState;
+  promoted: boolean;
+  backend: RunnerBackend;
+  backendTarget?: string;
+  exit?: RunnerExit;
+  /** Present only while a runner is running with an alarm attached. */
+  alarm?: RunnerAlarm;
+  /** pid of the pi process that launched it, for orphan detection. */
+  hostPid: number;
+}
+interface RegisterRunnerInput {
+  id: string;
+  name: string;
+  pid: number;
+  command: string;
+  cwd: string;
+  logPath: string;
+  interactive: boolean;
+  sessionId: string;
+  backend: RunnerBackend;
+  backendTarget?: string;
+  /** Arms a recurring snapshot at this interval. */
+  alarmMs?: number;
+}
+interface CompleteRunnerInput {
+  reason: RunnerExitReason;
+  code: number | null;
+  signal: NodeJS.Signals | null;
+  stopReason?: string;
+}
+/** Worktree-scoped active registry with session-scoped retained history. */
+interface IRunnerRegistry {
+  register(input: RegisterRunnerInput): Promise<RunnerRecord>;
+  list(): Promise<RunnerRecord[]>;
+  /** Active doom-runner records across repository scopes, used only for safe legacy-store cleanup. */
+  listAcrossRepositories(): Promise<RunnerRecord[]>;
+  /** Active records started by one session, used for scoped bulk stop and shutdown. */
+  listBySession(sessionId: string): Promise<RunnerRecord[]>;
+  /** Active records visible to every descendant of one root Pi session. */
+  listByRootSession(rootSessionId: string): Promise<RunnerRecord[]>;
+  /** Active and recently completed records retained for one session. */
+  listAll(sessionId?: string): Promise<RunnerRecord[]>;
+  get(id: string, sessionId?: string): Promise<RunnerRecord | undefined>;
+  markPromoted(id: string): Promise<RunnerRecord | undefined>;
+  complete(id: string, outcome: CompleteRunnerInput, sessionId?: string): Promise<RunnerRecord | undefined>;
+  /** Disarms an alarm. Safe to call on a runner that has none. */
+  clearAlarm(id: string, sessionId?: string): Promise<RunnerRecord | undefined>;
+  /**
+   * Reschedules an alarm from `firedAt`, returning the record the caller may
+   * report on.
+   *
+   * Returns undefined when the alarm was disarmed or the runner finished since
+   * the caller read it, which is what stops a concurrent `alarm stop` from
+   * being overwritten by an in-flight fire.
+   */
+  markAlarmFired(id: string, firedAt: string): Promise<RunnerRecord | undefined>;
+  /** Removes the active process entry while retaining run metadata. */
+  release(id: string): Promise<void>;
+  /** Marks entries whose process is gone as lost. Returns their ids. */
+  pruneDead(): Promise<string[]>;
+  /** Notifies in-process consumers after the registry changes. */
+  subscribe(listener: () => void): () => void;
+  close(): void;
+}
+//#endregion
+export { CompleteRunnerInput, IRunnerRegistry, RegisterRunnerInput, RunnerAlarm, RunnerBackend, RunnerExit, RunnerExitReason, RunnerRecord, RunnerState };
+//# sourceMappingURL=types.d.cts.map

package/dist/services/RunnerRegistry/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/services/RunnerRegistry/types.ts"],"mappings":";KAAY;KACA;KACA;UASK;EACf,QAAQ;EACR;EACA,QAAQ,OAAO;EACf;EACA;;;UAIe;EACf;;EAEA;;;UAIe;EACf;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA,OAAO;EACP;EACA,SAAS;EACT;EACA,OAAO;;EAEP,QAAQ;;EAER;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,SAAS;EACT;;EAEA;;UAGe;EACf,QAAQ;EACR;EACA,QAAQ,OAAO;EACf;;;UAIe;EACf,SAAS,OAAO,sBAAsB,QAAQ;EAC9C,QAAQ,QAAQ;;EAEhB,0BAA0B,QAAQ;;EAElC,cAAc,oBAAoB,QAAQ;;EAE1C,kBAAkB,wBAAwB,QAAQ;;EAElD,QAAQ,qBAAqB,QAAQ;EACrC,IAAI,YAAY,qBAAqB,QAAQ;EAC7C,aAAa,aAAa,QAAQ;EAClC,SAAS,YAAY,SAAS,qBAAqB,qBAAqB,QAAQ;;EAEhF,WAAW,YAAY,qBAAqB,QAAQ;;;;;;;;;EASpD,eAAe,YAAY,kBAAkB,QAAQ;;EAErD,QAAQ,aAAa;;EAErB,aAAa;;EAEb,UAAU;EACV"}

package/dist/services/RunnerRegistry/types.d.mts

@@ -0,0 +1,98 @@
+//#region src/services/RunnerRegistry/types.d.ts
+type RunnerBackend = 'rmux' | 'tmux' | 'native';
+type RunnerState = 'running' | 'completed';
+type RunnerExitReason = 'completed' | 'failed' | 'signaled' | 'stopped' | 'timed_out' | 'launcher_error' | 'backend_lost';
+interface RunnerExit {
+  reason: RunnerExitReason;
+  code: number | null;
+  signal: NodeJS.Signals | null;
+  stopReason?: string;
+  finishedAt: string;
+}
+/** A recurring snapshot of a running runner, pushed to the model until it exits. */
+interface RunnerAlarm {
+  intervalMs: number;
+  /** The last fire, or the runner's start time before the first one. */
+  lastFiredAt: string;
+}
+/** A command this extension supervises, retained after completion for CLI access. */
+interface RunnerRecord {
+  id: string;
+  name: string;
+  /** Process group leader, the pid signals are sent to. */
+  pid: number;
+  command: string;
+  cwd: string;
+  logPath: string;
+  interactive: boolean;
+  sessionId: string;
+  /** Root Pi session shared by the process tree. Ownership remains with sessionId. */
+  rootSessionId?: string;
+  startedAt: string;
+  state: RunnerState;
+  promoted: boolean;
+  backend: RunnerBackend;
+  backendTarget?: string;
+  exit?: RunnerExit;
+  /** Present only while a runner is running with an alarm attached. */
+  alarm?: RunnerAlarm;
+  /** pid of the pi process that launched it, for orphan detection. */
+  hostPid: number;
+}
+interface RegisterRunnerInput {
+  id: string;
+  name: string;
+  pid: number;
+  command: string;
+  cwd: string;
+  logPath: string;
+  interactive: boolean;
+  sessionId: string;
+  backend: RunnerBackend;
+  backendTarget?: string;
+  /** Arms a recurring snapshot at this interval. */
+  alarmMs?: number;
+}
+interface CompleteRunnerInput {
+  reason: RunnerExitReason;
+  code: number | null;
+  signal: NodeJS.Signals | null;
+  stopReason?: string;
+}
+/** Worktree-scoped active registry with session-scoped retained history. */
+interface IRunnerRegistry {
+  register(input: RegisterRunnerInput): Promise<RunnerRecord>;
+  list(): Promise<RunnerRecord[]>;
+  /** Active doom-runner records across repository scopes, used only for safe legacy-store cleanup. */
+  listAcrossRepositories(): Promise<RunnerRecord[]>;
+  /** Active records started by one session, used for scoped bulk stop and shutdown. */
+  listBySession(sessionId: string): Promise<RunnerRecord[]>;
+  /** Active records visible to every descendant of one root Pi session. */
+  listByRootSession(rootSessionId: string): Promise<RunnerRecord[]>;
+  /** Active and recently completed records retained for one session. */
+  listAll(sessionId?: string): Promise<RunnerRecord[]>;
+  get(id: string, sessionId?: string): Promise<RunnerRecord | undefined>;
+  markPromoted(id: string): Promise<RunnerRecord | undefined>;
+  complete(id: string, outcome: CompleteRunnerInput, sessionId?: string): Promise<RunnerRecord | undefined>;
+  /** Disarms an alarm. Safe to call on a runner that has none. */
+  clearAlarm(id: string, sessionId?: string): Promise<RunnerRecord | undefined>;
+  /**
+   * Reschedules an alarm from `firedAt`, returning the record the caller may
+   * report on.
+   *
+   * Returns undefined when the alarm was disarmed or the runner finished since
+   * the caller read it, which is what stops a concurrent `alarm stop` from
+   * being overwritten by an in-flight fire.
+   */
+  markAlarmFired(id: string, firedAt: string): Promise<RunnerRecord | undefined>;
+  /** Removes the active process entry while retaining run metadata. */
+  release(id: string): Promise<void>;
+  /** Marks entries whose process is gone as lost. Returns their ids. */
+  pruneDead(): Promise<string[]>;
+  /** Notifies in-process consumers after the registry changes. */
+  subscribe(listener: () => void): () => void;
+  close(): void;
+}
+//#endregion
+export { CompleteRunnerInput, IRunnerRegistry, RegisterRunnerInput, RunnerAlarm, RunnerBackend, RunnerExit, RunnerExitReason, RunnerRecord, RunnerState };
+//# sourceMappingURL=types.d.mts.map

package/dist/services/RunnerRegistry/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/RunnerRegistry/types.ts"],"mappings":";KAAY;KACA;KACA;UASK;EACf,QAAQ;EACR;EACA,QAAQ,OAAO;EACf;EACA;;;UAIe;EACf;;EAEA;;;UAIe;EACf;EACA;;EAEA;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA,OAAO;EACP;EACA,SAAS;EACT;EACA,OAAO;;EAEP,QAAQ;;EAER;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,SAAS;EACT;;EAEA;;UAGe;EACf,QAAQ;EACR;EACA,QAAQ,OAAO;EACf;;;UAIe;EACf,SAAS,OAAO,sBAAsB,QAAQ;EAC9C,QAAQ,QAAQ;;EAEhB,0BAA0B,QAAQ;;EAElC,cAAc,oBAAoB,QAAQ;;EAE1C,kBAAkB,wBAAwB,QAAQ;;EAElD,QAAQ,qBAAqB,QAAQ;EACrC,IAAI,YAAY,qBAAqB,QAAQ;EAC7C,aAAa,aAAa,QAAQ;EAClC,SAAS,YAAY,SAAS,qBAAqB,qBAAqB,QAAQ;;EAEhF,WAAW,YAAY,qBAAqB,QAAQ;;;;;;;;;EASpD,eAAe,YAAY,kBAAkB,QAAQ;;EAErD,QAAQ,aAAa;;EAErB,aAAa;;EAEb,UAAU;EACV"}

package/dist/services/Spawner/NodeSpawner.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.cjs");let t=require("inversify");require("reflect-metadata/lite");let n=require("node:child_process"),r=class{spawn(e){let t=(0,n.spawn)(e.command,{cwd:e.cwd,env:e.env,detached:e.detached,shell:`/bin/bash`,stdio:[`ignore`,`pipe`,`pipe`]});return t.stdout?.setEncoding(`utf8`),t.stderr?.setEncoding(`utf8`),{pid:t.pid,onOutput(e){t.stdout?.on(`data`,t=>e(t,`stdout`)),t.stderr?.on(`data`,t=>e(t,`stderr`))},onExit(e){t.on(`close`,(t,n)=>e({code:t,signal:n}))},onError(e){t.on(`error`,e)},kill(e){t.kill(e)},unref(){t.unref()}}}};r=e.default([(0,t.injectable)()],r),Object.defineProperty(exports,"NodeSpawner",{enumerable:!0,get:function(){return r}});
+//# sourceMappingURL=NodeSpawner.cjs.map

package/dist/services/Spawner/NodeSpawner.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeSpawner.cjs","names":["spawn","injectable"],"sources":["../../../src/services/Spawner/NodeSpawner.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport { injectable } from 'inversify';\nimport 'reflect-metadata/lite';\nimport type { ExitResult, ISpawner, OutputStream, SpawnedProcess, SpawnRequest } from './types.ts';\n\nconst SHELL = '/bin/bash';\n\n/** Wraps `node:child_process.spawn`. */\n@injectable()\nexport class NodeSpawner implements ISpawner {\n  spawn(request: SpawnRequest): SpawnedProcess {\n    const child = spawn(request.command, {\n      cwd: request.cwd,\n      env: request.env,\n      detached: request.detached,\n      shell: SHELL,\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n\n    child.stdout?.setEncoding('utf8');\n    child.stderr?.setEncoding('utf8');\n\n    return {\n      pid: child.pid,\n      onOutput(handler: (chunk: string, stream: OutputStream) => void): void {\n        child.stdout?.on('data', (chunk: string) => handler(chunk, 'stdout'));\n        child.stderr?.on('data', (chunk: string) => handler(chunk, 'stderr'));\n      },\n      onExit(handler: (result: ExitResult) => void): void {\n        child.on('close', (code, signal) => handler({ code, signal }));\n      },\n      onError(handler: (error: Error) => void): void {\n        child.on('error', handler);\n      },\n      kill(signal?: NodeJS.Signals): void {\n        child.kill(signal);\n      },\n      unref(): void {\n        child.unref();\n      },\n    };\n  }\n}\n"],"mappings":"4PASa,EAAN,KAAsC,CAC3C,MAAM,EAAuC,CAC3C,IAAM,GAAA,EAAQA,EAAAA,MAAAA,CAAM,EAAQ,QAAS,CACnC,IAAK,EAAQ,IACb,IAAK,EAAQ,IACb,SAAU,EAAQ,SAClB,MAAO,YACP,MAAO,CAAC,SAAU,OAAQ,MAAM,CAClC,CAAC,EAKD,OAHA,EAAM,QAAQ,YAAY,MAAM,EAChC,EAAM,QAAQ,YAAY,MAAM,EAEzB,CACL,IAAK,EAAM,IACX,SAAS,EAA8D,CACrE,EAAM,QAAQ,GAAG,OAAS,GAAkB,EAAQ,EAAO,QAAQ,CAAC,EACpE,EAAM,QAAQ,GAAG,OAAS,GAAkB,EAAQ,EAAO,QAAQ,CAAC,CACtE,EACA,OAAO,EAA6C,CAClD,EAAM,GAAG,SAAU,EAAM,IAAW,EAAQ,CAAE,OAAM,QAAO,CAAC,CAAC,CAC/D,EACA,QAAQ,EAAuC,CAC7C,EAAM,GAAG,QAAS,CAAO,CAC3B,EACA,KAAK,EAA+B,CAClC,EAAM,KAAK,CAAM,CACnB,EACA,OAAc,CACZ,EAAM,MAAM,CACd,CACF,CACF,CACF,EAlCCC,EAAAA,EAAAA,QAAAA,EAAAA,EAAAA,EAAAA,WAAAA,CAAW,CAAA,EAAA,CAAA"}

package/dist/services/Spawner/NodeSpawner.d.cts

@@ -0,0 +1,10 @@
+import { ISpawner, SpawnRequest, SpawnedProcess } from "./types.cjs";
+import "reflect-metadata/lite";
+//#region src/services/Spawner/NodeSpawner.d.ts
+/** Wraps `node:child_process.spawn`. */
+declare class NodeSpawner implements ISpawner {
+  spawn(request: SpawnRequest): SpawnedProcess;
+}
+//#endregion
+export { NodeSpawner };
+//# sourceMappingURL=NodeSpawner.d.cts.map

package/dist/services/Spawner/NodeSpawner.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeSpawner.d.cts","names":[],"sources":["../../../src/services/Spawner/NodeSpawner.ts"],"mappings":";;;;cASa,uBAAuB;EAClC,MAAM,SAAS,eAAe"}

package/dist/services/Spawner/NodeSpawner.d.mts

@@ -0,0 +1,10 @@
+import { ISpawner, SpawnRequest, SpawnedProcess } from "./types.mjs";
+import "reflect-metadata/lite";
+//#region src/services/Spawner/NodeSpawner.d.ts
+/** Wraps `node:child_process.spawn`. */
+declare class NodeSpawner implements ISpawner {
+  spawn(request: SpawnRequest): SpawnedProcess;
+}
+//#endregion
+export { NodeSpawner };
+//# sourceMappingURL=NodeSpawner.d.mts.map

package/dist/services/Spawner/NodeSpawner.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeSpawner.d.mts","names":[],"sources":["../../../src/services/Spawner/NodeSpawner.ts"],"mappings":";;;;cASa,uBAAuB;EAClC,MAAM,SAAS,eAAe"}

package/dist/services/Spawner/NodeSpawner.mjs

@@ -0,0 +1,2 @@
+import e from"../../_virtual/_@oxc-project_runtime@0.143.0/helpers/esm/decorate.mjs";import{injectable as t}from"inversify";import"reflect-metadata/lite";import{spawn as n}from"node:child_process";let r=class{spawn(e){let t=n(e.command,{cwd:e.cwd,env:e.env,detached:e.detached,shell:`/bin/bash`,stdio:[`ignore`,`pipe`,`pipe`]});return t.stdout?.setEncoding(`utf8`),t.stderr?.setEncoding(`utf8`),{pid:t.pid,onOutput(e){t.stdout?.on(`data`,t=>e(t,`stdout`)),t.stderr?.on(`data`,t=>e(t,`stderr`))},onExit(e){t.on(`close`,(t,n)=>e({code:t,signal:n}))},onError(e){t.on(`error`,e)},kill(e){t.kill(e)},unref(){t.unref()}}}};r=e([t()],r);export{r as NodeSpawner};
+//# sourceMappingURL=NodeSpawner.mjs.map

package/dist/services/Spawner/NodeSpawner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeSpawner.mjs","names":[],"sources":["../../../src/services/Spawner/NodeSpawner.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\nimport { injectable } from 'inversify';\nimport 'reflect-metadata/lite';\nimport type { ExitResult, ISpawner, OutputStream, SpawnedProcess, SpawnRequest } from './types.ts';\n\nconst SHELL = '/bin/bash';\n\n/** Wraps `node:child_process.spawn`. */\n@injectable()\nexport class NodeSpawner implements ISpawner {\n  spawn(request: SpawnRequest): SpawnedProcess {\n    const child = spawn(request.command, {\n      cwd: request.cwd,\n      env: request.env,\n      detached: request.detached,\n      shell: SHELL,\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n\n    child.stdout?.setEncoding('utf8');\n    child.stderr?.setEncoding('utf8');\n\n    return {\n      pid: child.pid,\n      onOutput(handler: (chunk: string, stream: OutputStream) => void): void {\n        child.stdout?.on('data', (chunk: string) => handler(chunk, 'stdout'));\n        child.stderr?.on('data', (chunk: string) => handler(chunk, 'stderr'));\n      },\n      onExit(handler: (result: ExitResult) => void): void {\n        child.on('close', (code, signal) => handler({ code, signal }));\n      },\n      onError(handler: (error: Error) => void): void {\n        child.on('error', handler);\n      },\n      kill(signal?: NodeJS.Signals): void {\n        child.kill(signal);\n      },\n      unref(): void {\n        child.unref();\n      },\n    };\n  }\n}\n"],"mappings":"qMASO,IAAM,EAAN,KAAsC,CAC3C,MAAM,EAAuC,CAC3C,IAAM,EAAQ,EAAM,EAAQ,QAAS,CACnC,IAAK,EAAQ,IACb,IAAK,EAAQ,IACb,SAAU,EAAQ,SAClB,MAAO,YACP,MAAO,CAAC,SAAU,OAAQ,MAAM,CAClC,CAAC,EAKD,OAHA,EAAM,QAAQ,YAAY,MAAM,EAChC,EAAM,QAAQ,YAAY,MAAM,EAEzB,CACL,IAAK,EAAM,IACX,SAAS,EAA8D,CACrE,EAAM,QAAQ,GAAG,OAAS,GAAkB,EAAQ,EAAO,QAAQ,CAAC,EACpE,EAAM,QAAQ,GAAG,OAAS,GAAkB,EAAQ,EAAO,QAAQ,CAAC,CACtE,EACA,OAAO,EAA6C,CAClD,EAAM,GAAG,SAAU,EAAM,IAAW,EAAQ,CAAE,OAAM,QAAO,CAAC,CAAC,CAC/D,EACA,QAAQ,EAAuC,CAC7C,EAAM,GAAG,QAAS,CAAO,CAC3B,EACA,KAAK,EAA+B,CAClC,EAAM,KAAK,CAAM,CACnB,EACA,OAAc,CACZ,EAAM,MAAM,CACd,CACF,CACF,CACF,EAlCC,EAAA,EAAA,CAAA,EAAW,CAAA,EAAA,CAAA"}

package/dist/services/Spawner/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./NodeSpawner.cjs");Object.defineProperty(exports,"NodeSpawner",{enumerable:!0,get:function(){return e.NodeSpawner}});

package/dist/services/Spawner/index.d.cts

@@ -0,0 +1,3 @@
+import { ExitResult, ISpawner, OutputStream, SpawnRequest, SpawnedProcess } from "./types.cjs";
+import { NodeSpawner } from "./NodeSpawner.cjs";
+export { type ExitResult, type ISpawner, NodeSpawner, type OutputStream, type SpawnRequest, type SpawnedProcess };

package/dist/services/Spawner/index.d.mts

@@ -0,0 +1,3 @@
+import { ExitResult, ISpawner, OutputStream, SpawnRequest, SpawnedProcess } from "./types.mjs";
+import { NodeSpawner } from "./NodeSpawner.mjs";
+export { type ExitResult, type ISpawner, NodeSpawner, type OutputStream, type SpawnRequest, type SpawnedProcess };

package/dist/services/Spawner/index.mjs

@@ -0,0 +1 @@
+import{NodeSpawner as e}from"./NodeSpawner.mjs";export{e as NodeSpawner};

package/dist/services/Spawner/types.d.cts

@@ -0,0 +1,31 @@
+//#region src/services/Spawner/types.d.ts
+/** Outcome of a finished child process. */
+interface ExitResult {
+  code: number | null;
+  signal: NodeJS.Signals | null;
+}
+type OutputStream = 'stdout' | 'stderr';
+interface SpawnRequest {
+  /** Shell command line, run through the login shell like pi's built-in bash. */
+  command: string;
+  cwd: string;
+  env: NodeJS.ProcessEnv;
+  /** Detached puts the child in its own process group, so the whole tree stays killable. */
+  detached: boolean;
+}
+interface SpawnedProcess {
+  readonly pid: number | undefined;
+  onOutput(handler: (chunk: string, stream: OutputStream) => void): void;
+  onExit(handler: (result: ExitResult) => void): void;
+  onError(handler: (error: Error) => void): void;
+  kill(signal?: NodeJS.Signals): void;
+  /** Lets the host process exit while the child keeps running. */
+  unref(): void;
+}
+/** Subprocess creation as a port, so launching is testable without real processes. */
+interface ISpawner {
+  spawn(request: SpawnRequest): SpawnedProcess;
+}
+//#endregion
+export { ExitResult, ISpawner, OutputStream, SpawnRequest, SpawnedProcess };
+//# sourceMappingURL=types.d.cts.map

package/dist/services/Spawner/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/services/Spawner/types.ts"],"mappings":";;UACiB;EACf;EACA,QAAQ,OAAO;;KAGL;UAEK;;EAEf;EACA;EACA,KAAK,OAAO;;EAEZ;;UAGe;WACN;EACT,SAAS,UAAU,eAAe,QAAQ;EAC1C,OAAO,UAAU,QAAQ;EACzB,QAAQ,UAAU,OAAO;EACzB,KAAK,SAAS,OAAO;;EAErB;;;UAIe;EACf,MAAM,SAAS,eAAe"}

package/dist/services/Spawner/types.d.mts

@@ -0,0 +1,31 @@
+//#region src/services/Spawner/types.d.ts
+/** Outcome of a finished child process. */
+interface ExitResult {
+  code: number | null;
+  signal: NodeJS.Signals | null;
+}
+type OutputStream = 'stdout' | 'stderr';
+interface SpawnRequest {
+  /** Shell command line, run through the login shell like pi's built-in bash. */
+  command: string;
+  cwd: string;
+  env: NodeJS.ProcessEnv;
+  /** Detached puts the child in its own process group, so the whole tree stays killable. */
+  detached: boolean;
+}
+interface SpawnedProcess {
+  readonly pid: number | undefined;
+  onOutput(handler: (chunk: string, stream: OutputStream) => void): void;
+  onExit(handler: (result: ExitResult) => void): void;
+  onError(handler: (error: Error) => void): void;
+  kill(signal?: NodeJS.Signals): void;
+  /** Lets the host process exit while the child keeps running. */
+  unref(): void;
+}
+/** Subprocess creation as a port, so launching is testable without real processes. */
+interface ISpawner {
+  spawn(request: SpawnRequest): SpawnedProcess;
+}
+//#endregion
+export { ExitResult, ISpawner, OutputStream, SpawnRequest, SpawnedProcess };
+//# sourceMappingURL=types.d.mts.map

package/dist/services/Spawner/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/services/Spawner/types.ts"],"mappings":";;UACiB;EACf;EACA,QAAQ,OAAO;;KAGL;UAEK;;EAEf;EACA;EACA,KAAK,OAAO;;EAEZ;;UAGe;WACN;EACT,SAAS,UAAU,eAAe,QAAQ;EAC1C,OAAO,UAAU,QAAQ;EACzB,QAAQ,UAAU,OAAO;EACzB,KAAK,SAAS,OAAO;;EAErB;;;UAIe;EACf,MAAM,SAAS,eAAe"}

package/dist/session.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=`PI_SESSION_ID`;function t(t=process.env){return t[e]?.trim()||void 0}function n(n=process.env){let r=t(n);if(!r)throw Error(`${e} is required for doom-runner`);return r}exports.PI_SESSION_ID_ENV=e,exports.inheritedSessionId=t,exports.requiredSessionId=n;
+//# sourceMappingURL=session.cjs.map

package/dist/session.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.cjs","names":[],"sources":["../src/session.ts"],"sourcesContent":["/** Session identity inherited by commands launched from a Pi session. */\nexport const PI_SESSION_ID_ENV = 'PI_SESSION_ID';\n\n/** Returns a usable inherited session id, failing closed on blank values. */\nexport function inheritedSessionId(env: NodeJS.ProcessEnv = process.env): string | undefined {\n  const value = env[PI_SESSION_ID_ENV]?.trim();\n  return value ? value : undefined;\n}\n\n/** Returns the inherited Pi session id or fails closed outside a session. */\nexport function requiredSessionId(env: NodeJS.ProcessEnv = process.env): string {\n  const sessionId = inheritedSessionId(env);\n  if (!sessionId) throw new Error(`${PI_SESSION_ID_ENV} is required for doom-runner`);\n  return sessionId;\n}\n"],"mappings":"mEACA,MAAa,EAAoB,gBAGjC,SAAgB,EAAmB,EAAyB,QAAQ,IAAyB,CAE3F,OADc,EAAI,EAAkB,EAAE,KAAK,GACpB,IAAA,EACzB,CAGA,SAAgB,EAAkB,EAAyB,QAAQ,IAAa,CAC9E,IAAM,EAAY,EAAmB,CAAG,EACxC,GAAI,CAAC,EAAW,MAAU,MAAM,GAAG,EAAkB,6BAA6B,EAClF,OAAO,CACT"}

package/dist/session.d.cts

@@ -0,0 +1,10 @@
+//#region src/session.d.ts
+/** Session identity inherited by commands launched from a Pi session. */
+declare const PI_SESSION_ID_ENV = "PI_SESSION_ID";
+/** Returns a usable inherited session id, failing closed on blank values. */
+declare function inheritedSessionId(env?: NodeJS.ProcessEnv): string | undefined;
+/** Returns the inherited Pi session id or fails closed outside a session. */
+declare function requiredSessionId(env?: NodeJS.ProcessEnv): string;
+//#endregion
+export { PI_SESSION_ID_ENV, inheritedSessionId, requiredSessionId };
+//# sourceMappingURL=session.d.cts.map

package/dist/session.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.cts","names":[],"sources":["../src/session.ts"],"mappings":";;cACa;;iBAGG,mBAAmB,MAAK,OAAO;;iBAM/B,kBAAkB,MAAK,OAAO"}

package/dist/session.d.mts

@@ -0,0 +1,10 @@
+//#region src/session.d.ts
+/** Session identity inherited by commands launched from a Pi session. */
+declare const PI_SESSION_ID_ENV = "PI_SESSION_ID";
+/** Returns a usable inherited session id, failing closed on blank values. */
+declare function inheritedSessionId(env?: NodeJS.ProcessEnv): string | undefined;
+/** Returns the inherited Pi session id or fails closed outside a session. */
+declare function requiredSessionId(env?: NodeJS.ProcessEnv): string;
+//#endregion
+export { PI_SESSION_ID_ENV, inheritedSessionId, requiredSessionId };
+//# sourceMappingURL=session.d.mts.map

package/dist/session.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.mts","names":[],"sources":["../src/session.ts"],"mappings":";;cACa;;iBAGG,mBAAmB,MAAK,OAAO;;iBAM/B,kBAAkB,MAAK,OAAO"}

package/dist/session.mjs

@@ -0,0 +1,2 @@
+const e=`PI_SESSION_ID`;function t(t=process.env){return t[e]?.trim()||void 0}function n(n=process.env){let r=t(n);if(!r)throw Error(`${e} is required for doom-runner`);return r}export{e as PI_SESSION_ID_ENV,t as inheritedSessionId,n as requiredSessionId};
+//# sourceMappingURL=session.mjs.map

package/dist/session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.mjs","names":[],"sources":["../src/session.ts"],"sourcesContent":["/** Session identity inherited by commands launched from a Pi session. */\nexport const PI_SESSION_ID_ENV = 'PI_SESSION_ID';\n\n/** Returns a usable inherited session id, failing closed on blank values. */\nexport function inheritedSessionId(env: NodeJS.ProcessEnv = process.env): string | undefined {\n  const value = env[PI_SESSION_ID_ENV]?.trim();\n  return value ? value : undefined;\n}\n\n/** Returns the inherited Pi session id or fails closed outside a session. */\nexport function requiredSessionId(env: NodeJS.ProcessEnv = process.env): string {\n  const sessionId = inheritedSessionId(env);\n  if (!sessionId) throw new Error(`${PI_SESSION_ID_ENV} is required for doom-runner`);\n  return sessionId;\n}\n"],"mappings":"AACA,MAAa,EAAoB,gBAGjC,SAAgB,EAAmB,EAAyB,QAAQ,IAAyB,CAE3F,OADc,EAAI,EAAkB,EAAE,KAAK,GACpB,IAAA,EACzB,CAGA,SAAgB,EAAkB,EAAyB,QAAQ,IAAa,CAC9E,IAAM,EAAY,EAAmB,CAAG,EACxC,GAAI,CAAC,EAAW,MAAU,MAAM,GAAG,EAAkB,6BAA6B,EAClF,OAAO,CACT"}

package/dist/tool/bashTool.cjs

@@ -0,0 +1,7 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../config.cjs"),t=require("../services/AnsiScrub/ansiScrub.cjs");require("../services/AnsiScrub/index.cjs");const n=require("./responseEnvelope.cjs"),r=require("../tui/bashRender.cjs"),i=require("./schema.cjs"),a=1e3,o=`Options:`,s={requested:`Started in the background`,threshold:`Still running after the background threshold, so it was moved to the background`,interactive:`Started on a terminal so it can prompt, which means it runs in the background`},c=`Execute bash commands, with long-running ones supervised in the background`;function l(t=e.getBackgroundThresholdMs()){return[`A command still running after ${Math.round(t/a)} seconds remains active as a background runner. You get its unique id and streaming log path, then inspect it with the doom-runner CLI.`,`Pass background: true for commands you already know will not finish on their own (dev servers, watchers, tails). Waiting the full threshold first wastes a turn.`,`Pass interactive: true only when the command will prompt for confirmation or input. Use Runner Space for terminal input. Interactive logs are noisier, so avoid it otherwise.`,`Do not re-run a command to recover output. Read its saved log with doom-runner logs <id>.`,`Stop runners you no longer need. Every runner is stopped automatically when the session ends.`]}function u(e,t){e.registerTool({name:i.BASH_TOOL_NAME,label:i.BASH_TOOL_LABEL,description:`Execute a bash command in the current working directory. A command that outlives the background threshold keeps running under doom-runner and returns a unique id plus a streaming log path. Completed commands return a bounded log tail with exact file metadata. Optionally provide a timeout in seconds, background: true to background it immediately, or interactive: true if it will prompt.`,promptSnippet:c,promptGuidelines:l(),parameters:i.BashParamsSchema,async execute(e,r,i,s,c){let{command:l,timeout:u,background:f,interactive:p,name:m}=r,h;s&&s(n.textResult(`Starting ${p===!0?`interactive runner`:f===!0?`background runner`:`command`}...`)),f!==!0&&p!==!0&&s&&(h=e=>s(n.textResult(e)));let g;try{g=await t.bashRunService.run({command:l,timeoutMs:u===void 0?void 0:u*a,background:f,interactive:p,name:m,...h?{onOutput:h}:{},sessionId:t.getSessionId()})}catch(e){let t=e instanceof Error?e.message:String(e);throw Error([`Could not execute the command: ${t}`,``,o,`- Check the command, runtime, and working directory, then retry once.`,`- Use a read-only diagnostic to confirm the missing dependency or environment value.`,`- Ask the user if recovery requires changing the requested approach.`].join(`
+`),{cause:e})}return g.kind===`promoted`&&t.onRunnerStarted(g.id),d(g)},renderCall(e,t,n){return r.renderBashCall(e,t)},renderResult(e,t,n,i){return r.renderBashResult(e,t,n)}})}function d(e){if(e.kind===`failed`)throw Error([`Could not start runner "${e.name}": ${e.error}`,``,o,`- Correct the command or missing executable, then retry once.`,`- Use a read-only diagnostic to inspect the runtime environment.`,`- Ask the user if a different execution approach is required.`].join(`
+`));if(e.kind===`promoted`){let t=[`${s[e.reason]} as runner "${e.name}".`,`Runner ID: ${e.id}`,`Backend: ${e.backend}`,`Log (streaming): ${e.logPath}`,`Inspect it with: doom-runner logs ${e.id}`].filter(e=>e.length>0).join(`
+`);return{...n.textResult(t,{id:e.id,runner:e.name,pid:e.pid,logPath:e.logPath,promoted:!0,reason:e.reason})}}let r=n.summarizeLog(e.logPath),i=[];e.timedOut?i.push(`Command stopped: it exceeded the requested timeout.`):e.exitCode===null?e.signal!==null&&i.push(`Terminated by ${e.signal}`):i.push(`Exit: completed with code ${e.exitCode}.`);let a=t.stripAnsi(r.tail),c=[a.length>0?`Log tail (${r.tailLines} lines):\n${a}`:`Log tail: (no output)`,`Runner ID: ${e.id}`,...i,`Log: ${e.logPath}`,`File size: ${n.formatSize(r.bytes)}`,`Lines: ${r.lines.toLocaleString(`en-US`)}`].join(`
+`),l={id:e.id,runner:e.name,exitCode:e.exitCode,logPath:e.logPath,backend:e.backend,fileSize:r.bytes,lines:r.lines,tail:r.tail,tailLines:r.tailLines,...e.timedOut?{timedOut:!0}:{}};if(e.timedOut||e.signal!==null||e.exitCode!==null&&e.exitCode!==0)throw Error([c,``,o,`- Inspect the full log at ${e.logPath}, correct the cause, then retry once.`,`- Run a read-only diagnostic if the output does not explain the failure.`,`- Ask the user if the failure requires changing the requested approach.`].join(`
+`));return n.textResult(c,l)}exports.BASH_PROMPT_SNIPPET=c,exports.bashPromptGuidelines=l,exports.formatRunResult=d,exports.registerBashTool=u;
+//# sourceMappingURL=bashTool.cjs.map

package/dist/tool/bashTool.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bashTool.cjs","names":["getBackgroundThresholdMs","BASH_TOOL_NAME","BASH_TOOL_LABEL","BashParamsSchema","textResult","renderBashCall","renderBashResult","summarizeLog","stripAnsi","formatSize"],"sources":["../../src/tool/bashTool.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { getBackgroundThresholdMs } from '../config.ts';\nimport { stripAnsi } from '../services/AnsiScrub/index.ts';\nimport type { BashRunResult, IBashRunService } from '../services/BashRunService/index.ts';\nimport { renderBashCall, renderBashResult } from '../tui/bashRender.ts';\nimport { formatSize, summarizeLog, textResult, type ToolResult } from './responseEnvelope.ts';\nimport { BASH_TOOL_LABEL, BASH_TOOL_NAME, type BashParams, BashParamsSchema } from './schema.ts';\n\nconst MS_PER_SECOND = 1000;\nconst ERROR_OPTIONS_HEADING = 'Options:';\n\nconst PROMOTION_REASONS: Record<'requested' | 'threshold' | 'interactive', string> = {\n  requested: 'Started in the background',\n  threshold: 'Still running after the background threshold, so it was moved to the background',\n  interactive: 'Started on a terminal so it can prompt, which means it runs in the background',\n};\n\nexport const BASH_PROMPT_SNIPPET = 'Execute bash commands, with long-running ones supervised in the background';\n\n/** Written at registration time so the stated threshold matches the configured one. */\nexport function bashPromptGuidelines(thresholdMs = getBackgroundThresholdMs()): string[] {\n  return [\n    `A command still running after ${Math.round(thresholdMs / MS_PER_SECOND)} seconds remains active as a background runner. You get its unique id and streaming log path, then inspect it with the doom-runner CLI.`,\n    'Pass background: true for commands you already know will not finish on their own (dev servers, watchers, tails). Waiting the full threshold first wastes a turn.',\n    'Pass interactive: true only when the command will prompt for confirmation or input. Use Runner Space for terminal input. Interactive logs are noisier, so avoid it otherwise.',\n    'Do not re-run a command to recover output. Read its saved log with doom-runner logs <id>.',\n    'Stop runners you no longer need. Every runner is stopped automatically when the session ends.',\n  ];\n}\n\nexport interface BashToolDependencies {\n  bashRunService: IBashRunService;\n  getSessionId(): string;\n  /** Called after a runner is promoted, so UI state can refresh. */\n  onRunnerStarted(id: string): void;\n}\n\n/**\n * Registers a tool named `bash`, replacing pi's built-in.\n *\n * The name is deliberate: hooks, guardrails and doom-pi's dispatcher all key on\n * `bash`, and they keep working only while the replacement keeps the name.\n */\nexport function registerBashTool(pi: ExtensionAPI, dependencies: BashToolDependencies): void {\n  pi.registerTool({\n    name: BASH_TOOL_NAME,\n    label: BASH_TOOL_LABEL,\n    description:\n      'Execute a bash command in the current working directory. A command that outlives the background threshold keeps running under doom-runner and returns a unique id plus a streaming log path. Completed commands return a bounded log tail with exact file metadata. Optionally provide a timeout in seconds, background: true to background it immediately, or interactive: true if it will prompt.',\n    promptSnippet: BASH_PROMPT_SNIPPET,\n    promptGuidelines: bashPromptGuidelines(),\n    parameters: BashParamsSchema,\n\n    async execute(_toolCallId, params, _signal, onUpdate, _ctx): Promise<ToolResult> {\n      const { command, timeout, background, interactive, name } = params as BashParams;\n      let onOutput: ((output: string) => void) | undefined;\n      if (onUpdate) {\n        const mode =\n          interactive === true ? 'interactive runner' : background === true ? 'background runner' : 'command';\n        onUpdate(textResult(`Starting ${mode}...`));\n      }\n      if (background !== true && interactive !== true && onUpdate) {\n        onOutput = (output) => onUpdate(textResult(output));\n      }\n      let result: BashRunResult;\n      try {\n        result = await dependencies.bashRunService.run({\n          command,\n          timeoutMs: timeout === undefined ? undefined : timeout * MS_PER_SECOND,\n          background,\n          interactive,\n          name,\n          ...(onOutput ? { onOutput } : {}),\n          sessionId: dependencies.getSessionId(),\n        });\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        throw new Error(\n          [\n            `Could not execute the command: ${message}`,\n            '',\n            ERROR_OPTIONS_HEADING,\n            '- Check the command, runtime, and working directory, then retry once.',\n            '- Use a read-only diagnostic to confirm the missing dependency or environment value.',\n            '- Ask the user if recovery requires changing the requested approach.',\n          ].join('\\n'),\n          { cause: error },\n        );\n      }\n\n      if (result.kind === 'promoted') dependencies.onRunnerStarted(result.id);\n      return formatRunResult(result);\n    },\n\n    // Without these, pi falls back to echoing the raw command and the tail end of\n    // the result text, which is the metadata footer rather than the log output.\n    renderCall(args, theme, _context) {\n      return renderBashCall(args as BashParams, theme);\n    },\n\n    renderResult(result, options, theme, _context) {\n      return renderBashResult(result, options, theme);\n    },\n  });\n}\n\nexport function formatRunResult(result: BashRunResult): ToolResult {\n  if (result.kind === 'failed') {\n    throw new Error(\n      [\n        `Could not start runner \"${result.name}\": ${result.error}`,\n        '',\n        ERROR_OPTIONS_HEADING,\n        '- Correct the command or missing executable, then retry once.',\n        '- Use a read-only diagnostic to inspect the runtime environment.',\n        '- Ask the user if a different execution approach is required.',\n      ].join('\\n'),\n    );\n  }\n\n  if (result.kind === 'promoted') {\n    const reason = PROMOTION_REASONS[result.reason];\n    const body = [\n      `${reason} as runner \"${result.name}\".`,\n      `Runner ID: ${result.id}`,\n      `Backend: ${result.backend}`,\n      `Log (streaming): ${result.logPath}`,\n      `Inspect it with: doom-runner logs ${result.id}`,\n    ]\n      .filter((line) => line.length > 0)\n      .join('\\n');\n\n    return {\n      ...textResult(body, {\n        id: result.id,\n        runner: result.name,\n        pid: result.pid,\n        logPath: result.logPath,\n        promoted: true,\n        reason: result.reason,\n      }),\n    };\n  }\n\n  const log = summarizeLog(result.logPath);\n  const notes: string[] = [];\n  if (result.timedOut) notes.push('Command stopped: it exceeded the requested timeout.');\n  else if (result.exitCode !== null) notes.push(`Exit: completed with code ${result.exitCode}.`);\n  else if (result.signal !== null) notes.push(`Terminated by ${result.signal}`);\n\n  // The model reads plain text; only the renderer gets the coloured copy below.\n  const plainTail = stripAnsi(log.tail);\n  const text = [\n    plainTail.length > 0 ? `Log tail (${log.tailLines} lines):\\n${plainTail}` : 'Log tail: (no output)',\n    `Runner ID: ${result.id}`,\n    ...notes,\n    `Log: ${result.logPath}`,\n    `File size: ${formatSize(log.bytes)}`,\n    `Lines: ${log.lines.toLocaleString('en-US')}`,\n  ].join('\\n');\n  const details = {\n    id: result.id,\n    runner: result.name,\n    exitCode: result.exitCode,\n    logPath: result.logPath,\n    backend: result.backend,\n    fileSize: log.bytes,\n    lines: log.lines,\n    // Carried structurally so renderResult shows the output instead of the footer.\n    tail: log.tail,\n    tailLines: log.tailLines,\n    ...(result.timedOut ? { timedOut: true } : {}),\n  };\n  if (result.timedOut || result.signal !== null || (result.exitCode !== null && result.exitCode !== 0)) {\n    throw new Error(\n      [\n        text,\n        '',\n        ERROR_OPTIONS_HEADING,\n        `- Inspect the full log at ${result.logPath}, correct the cause, then retry once.`,\n        '- Run a read-only diagnostic if the output does not explain the failure.',\n        '- Ask the user if the failure requires changing the requested approach.',\n      ].join('\\n'),\n    );\n  }\n  return textResult(text, details);\n}\n"],"mappings":"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"}

package/dist/tool/bashTool.d.cts

@@ -0,0 +1,25 @@
+import { BashRunResult, IBashRunService } from "../services/BashRunService/types.cjs";
+import "../services/BashRunService/index.cjs";
+import { ToolResult } from "./responseEnvelope.cjs";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/tool/bashTool.d.ts
+declare const BASH_PROMPT_SNIPPET = "Execute bash commands, with long-running ones supervised in the background";
+/** Written at registration time so the stated threshold matches the configured one. */
+declare function bashPromptGuidelines(thresholdMs?: number): string[];
+interface BashToolDependencies {
+  bashRunService: IBashRunService;
+  getSessionId(): string;
+  /** Called after a runner is promoted, so UI state can refresh. */
+  onRunnerStarted(id: string): void;
+}
+/**
+ * Registers a tool named `bash`, replacing pi's built-in.
+ *
+ * The name is deliberate: hooks, guardrails and doom-pi's dispatcher all key on
+ * `bash`, and they keep working only while the replacement keeps the name.
+ */
+declare function registerBashTool(pi: ExtensionAPI, dependencies: BashToolDependencies): void;
+declare function formatRunResult(result: BashRunResult): ToolResult;
+//#endregion
+export { BASH_PROMPT_SNIPPET, BashToolDependencies, bashPromptGuidelines, formatRunResult, registerBashTool };
+//# sourceMappingURL=bashTool.d.cts.map

package/dist/tool/bashTool.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bashTool.d.cts","names":[],"sources":["../../src/tool/bashTool.ts"],"mappings":";;;;;cAiBa;;iBAGG,qBAAqB;UAUpB;EACf,gBAAgB;EAChB;;EAEA,gBAAgB;;;;;;;;iBASF,iBAAiB,IAAI,cAAc,cAAc;iBA+DjD,gBAAgB,QAAQ,gBAAgB"}