pi-subagents 0.69.0 → 0.70.0

package/src/watchdog/model-selection.js

@@ -0,0 +1,168 @@
+import { normalizeModelSegment, resolveModelCandidate } from "../runs/shared/model-resolution.js";
+import { getSupportedThinkingLevels, splitKnownThinkingSuffix, THINKING_LEVELS, toModelInfo, } from "../shared/model-info.js";
+export const STRONG_WATCHDOG_THINKING = "high";
+const STRONG_WATCHDOG_MODELS = {
+    opus48: {
+        label: "Opus 4.8",
+        queries: [
+            "anthropic/claude-opus-4-8",
+            "anthropic/claude-opus-4.8",
+            "anthropic/opus-4-8",
+            "anthropic/opus-4.8",
+        ],
+    },
+    gpt55: {
+        label: "GPT 5.5",
+        queries: [
+            "openai-codex/gpt-5.5",
+            "openai-codex/gpt-5-5",
+            "openai/gpt-5.5",
+            "openai/gpt-5-5",
+        ],
+    },
+};
+function fullModelId(model) {
+    return `${model.provider}/${model.id}`;
+}
+function modelRegistryEntries(ctx) {
+    return ctx.modelRegistry.getAvailable().map(toModelInfo);
+}
+function splitProviderModel(value) {
+    const slashIndex = value.indexOf("/");
+    if (slashIndex <= 0 || slashIndex === value.length - 1)
+        return undefined;
+    return { provider: value.slice(0, slashIndex), id: value.slice(slashIndex + 1) };
+}
+function assertSupportedThinking(value, source) {
+    if (THINKING_LEVELS.includes(value))
+        return value;
+    throw new Error(`Unsupported watchdog thinking '${value}' from ${source}; expected ${THINKING_LEVELS.join(", ")}, false, or inherit.`);
+}
+export function parseWatchdogThinkingInput(value, source = "watchdog input") {
+    if (value === undefined || value === "")
+        return undefined;
+    if (value === false)
+        return false;
+    if (value === "false")
+        return false;
+    return assertSupportedThinking(value, source);
+}
+export function resolveWatchdogModelInput(ctx, rawModel) {
+    const trimmed = rawModel.trim();
+    if (!trimmed)
+        throw new Error("Watchdog model must be a non-empty provider/model value.");
+    const availableModels = modelRegistryEntries(ctx);
+    const preferredProvider = typeof ctx.model?.provider === "string" ? ctx.model.provider : undefined;
+    const resolved = resolveModelCandidate(trimmed, availableModels, preferredProvider) ?? trimmed;
+    const { baseModel, thinkingSuffix } = splitKnownThinkingSuffix(resolved);
+    const named = splitProviderModel(baseModel);
+    if (!named)
+        throw new Error(`Watchdog model '${rawModel}' did not resolve to provider/model. Use a provider-qualified model such as openai-codex/gpt-5.5:high or anthropic/claude-opus-4-8:high.`);
+    const registryModel = ctx.modelRegistry.find(named.provider, named.id);
+    if (!registryModel)
+        throw new Error(`Watchdog model '${rawModel}' was not found as '${baseModel}'.`);
+    if (!ctx.modelRegistry.hasConfiguredAuth(registryModel)) {
+        throw new Error(`Watchdog model '${baseModel}' is not authenticated. Configure credentials for provider '${named.provider}' or choose an authenticated model.`);
+    }
+    return {
+        model: `${named.provider}/${named.id}`,
+        ...(thinkingSuffix ? { thinking: assertSupportedThinking(thinkingSuffix.slice(1), "watchdog model suffix") } : {}),
+        registryModel,
+    };
+}
+function familyForModel(model) {
+    if (!model)
+        return undefined;
+    const provider = normalizeModelSegment(model.provider);
+    const id = normalizeModelSegment(model.id);
+    if (provider.includes("openai") && /^gpt-5-5(-\d{8}|-\d{4}-\d{2}-\d{2})?$/.test(id))
+        return "gpt55";
+    if (provider.includes("anthropic") && /^(claude-opus-4-8|opus-4-8)(-\d{8}|-\d{4}-\d{2}-\d{2})?$/.test(id))
+        return "opus48";
+    return undefined;
+}
+function currentProviderFamily(ctx) {
+    const provider = typeof ctx.model?.provider === "string" ? normalizeModelSegment(ctx.model.provider) : "";
+    if (provider.includes("openai"))
+        return "openai";
+    if (provider.includes("anthropic"))
+        return "anthropic";
+    return undefined;
+}
+function strongFamilyOrder(ctx) {
+    const current = ctx.model ? familyForModel(toModelInfo(ctx.model)) : undefined;
+    if (current === "gpt55")
+        return ["opus48"];
+    if (current === "opus48")
+        return ["gpt55"];
+    const providerFamily = currentProviderFamily(ctx);
+    if (providerFamily === "openai")
+        return ["opus48", "gpt55"];
+    if (providerFamily === "anthropic")
+        return ["gpt55", "opus48"];
+    return ["gpt55", "opus48"];
+}
+function findFamilyMatch(family, availableModels) {
+    const matches = availableModels.filter((entry) => familyForModel(entry) === family);
+    if (matches.length === 1)
+        return matches[0].fullId;
+    return undefined;
+}
+function resolveStrongCandidate(ctx, family) {
+    const availableModels = modelRegistryEntries(ctx);
+    const preference = STRONG_WATCHDOG_MODELS[family];
+    const queries = [...preference.queries];
+    const familyMatch = findFamilyMatch(family, availableModels);
+    if (familyMatch)
+        queries.push(familyMatch);
+    for (const query of queries) {
+        let resolved;
+        try {
+            resolved = resolveWatchdogModelInput(ctx, query);
+        }
+        catch {
+            continue;
+        }
+        const modelInfo = toModelInfo(resolved.registryModel);
+        if (familyForModel(modelInfo) !== family)
+            continue;
+        if (!getSupportedThinkingLevels(modelInfo).includes(STRONG_WATCHDOG_THINKING))
+            continue;
+        const current = ctx.model ? fullModelId(toModelInfo(ctx.model)) : "no current session model";
+        return {
+            source: "suggested",
+            model: resolved.model,
+            thinking: STRONG_WATCHDOG_THINKING,
+            label: preference.label,
+            reason: `Use ${preference.label} with thinking high as a strong independent watchdog for ${current}.`,
+            registryModel: resolved.registryModel,
+        };
+    }
+    return undefined;
+}
+export function recommendStrongWatchdogModel(ctx) {
+    for (const family of strongFamilyOrder(ctx)) {
+        const recommendation = resolveStrongCandidate(ctx, family);
+        if (recommendation)
+            return recommendation;
+    }
+    const current = ctx.model ? fullModelId(toModelInfo(ctx.model)) : "the current session";
+    throw new Error(`No authenticated strong complementary watchdog model was found for ${current}. Configure access to Opus 4.8 or GPT 5.5, then run the recommendation again.`);
+}
+export function recommendWatchdogModel(ctx, configured) {
+    if (!configured.model)
+        return recommendStrongWatchdogModel(ctx);
+    const resolved = resolveWatchdogModelInput(ctx, configured.model);
+    const thinking = resolved.thinking ?? parseWatchdogThinkingInput(configured.thinking) ?? "off";
+    return {
+        ...resolved,
+        source: "configured",
+        thinking: thinking === false ? "off" : thinking,
+        label: "configured watchdog",
+        reason: "Keep the configured watchdog model and thinking; no replacement recommendation is needed. This is not a strength or independence assessment.",
+    };
+}
+export function formatWatchdogRecommendation(recommendation) {
+    return `${recommendation.source === "configured" ? "Keep configured watchdog" : "Recommended strong watchdog"}: ${recommendation.model}:${recommendation.thinking}`;
+}
+//# sourceMappingURL=model-selection.js.map

package/src/watchdog/model-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selection.js","sourceRoot":"","sources":["../../../src/watchdog/model-selection.ts"],"names":[],"mappings":"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"}

package/src/watchdog/permission-arbiter.d.ts

@@ -0,0 +1,21 @@
+import { type StreamFn } from "@earendil-works/pi-agent-core";
+import { type ExtensionContext } from "@earendil-works/pi-coding-agent";
+export interface WatchdogPermissionResult {
+    approved: boolean;
+    reason: string;
+    source: "watchdog";
+}
+export interface WatchdogPermissionRequest {
+    ctx: ExtensionContext;
+    toolName: string;
+    args: unknown;
+    rawWatchdogConfig?: string;
+    auditPath?: string;
+    signal?: AbortSignal;
+}
+export interface WatchdogPermissionArbiterOptions {
+    streamFn?: StreamFn;
+}
+export declare function createWatchdogPermissionArbiter(options?: WatchdogPermissionArbiterOptions): (request: WatchdogPermissionRequest) => Promise<WatchdogPermissionResult>;
+export declare const requestWatchdogPermission: (request: WatchdogPermissionRequest) => Promise<WatchdogPermissionResult>;
+//# sourceMappingURL=permission-arbiter.d.ts.map

package/src/watchdog/permission-arbiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-arbiter.d.ts","sourceRoot":"","sources":["../../../src/watchdog/permission-arbiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAiBtF,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACzC,GAAG,EAAE,gBAAgB,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,gCAAgC;IAChD,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACpB;AAOD,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,gCAAqC,IAC/E,SAAS,yBAAyB,KAAG,OAAO,CAAC,wBAAwB,CAAC,CA8GpF;AAED,eAAO,MAAM,yBAAyB,YAhHd,yBAAyB,KAAG,OAAO,CAAC,wBAAwB,CAgHV,CAAC"}

package/src/watchdog/permission-arbiter.js

@@ -0,0 +1,136 @@
+import { Agent } from "@earendil-works/pi-agent-core";
+import { convertToLlm } from "@earendil-works/pi-coding-agent";
+import { streamSimple } from "@earendil-works/pi-ai/compat";
+import { Type } from "typebox";
+import { appendPermissionAudit, permissionArgsPreview } from "../runs/shared/permissions.js";
+import { agentStreamOptions } from "../shared/agent-stream-options.js";
+import { opencodeSessionHeaders } from "../shared/opencode-session-headers.js";
+import { decodeChildWatchdogConfig } from "./child-status.js";
+import { childResolvedConfig } from "./register-child.js";
+import { resolveWatchdogReviewModel } from "./review.js";
+const PermissionDecisionParams = Type.Object({
+    decision: Type.String({ enum: ["approve", "deny"] }),
+    reason: Type.String({ description: "One concise reason for this exact decision." }),
+}, { additionalProperties: false });
+function conciseReason(value) {
+    const trimmed = value.trim();
+    return trimmed ? trimmed.slice(0, 500) : "Watchdog returned an empty reason.";
+}
+export function createWatchdogPermissionArbiter(options = {}) {
+    return async (request) => {
+        const preview = permissionArgsPreview(request.args);
+        const createdAt = Date.now();
+        const auditBase = { type: "permission.request", createdAt, toolName: request.toolName, preview, matchedRule: "ask", decisionSource: "watchdog" };
+        appendPermissionAudit(request.auditPath, auditBase);
+        let completed = false;
+        const finish = (approved, reason, decision) => {
+            const concise = conciseReason(reason);
+            if (completed)
+                return { approved, reason: concise, source: "watchdog" };
+            completed = true;
+            appendPermissionAudit(request.auditPath, {
+                type: "permission.decision",
+                createdAt: Date.now(),
+                requestCreatedAt: createdAt,
+                toolName: request.toolName,
+                decision,
+                approved,
+                decisionSource: "watchdog",
+                reason: concise,
+            });
+            return { approved, reason: concise, source: "watchdog" };
+        };
+        let childConfig;
+        try {
+            childConfig = decodeChildWatchdogConfig(request.rawWatchdogConfig);
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            return finish(false, `Watchdog permission arbiter configuration is invalid: ${reason}`, "unavailable");
+        }
+        if (!childConfig)
+            return finish(false, "Watchdog permission arbiter is unavailable because the child watchdog is disabled.", "unavailable");
+        if (request.signal?.aborted || request.ctx.signal?.aborted)
+            return finish(false, "Watchdog permission decision was cancelled.", "cancelled");
+        let decision;
+        const tool = {
+            name: "watchdog_permission_decision",
+            label: "Watchdog permission decision",
+            description: "Approve or deny this exact child tool call. Call exactly once.",
+            parameters: PermissionDecisionParams,
+            executionMode: "sequential",
+            async execute(_toolCallId, params) {
+                if (!decision)
+                    decision = params;
+                return { content: [{ type: "text", text: "Permission decision recorded." }], details: { recorded: true } };
+            },
+        };
+        let timeout;
+        let agent;
+        let abort;
+        try {
+            const run = async () => {
+                const config = childResolvedConfig(childConfig);
+                const selection = await resolveWatchdogReviewModel(request.ctx, config);
+                const auth = selection.auth;
+                const sessionId = request.ctx.sessionManager.getSessionId();
+                const registeredProvider = request.ctx.modelRegistry.getRegisteredProviderConfig?.(selection.model.provider);
+                const baseStreamFn = options.streamFn ?? (registeredProvider?.streamSimple && registeredProvider.api === selection.model.api
+                    ? registeredProvider.streamSimple
+                    : streamSimple);
+                const streamFn = (model, context, streamOptions) => baseStreamFn(model, context, {
+                    ...streamOptions,
+                    ...(auth.apiKey ? { apiKey: auth.apiKey } : {}),
+                    env: auth.env || streamOptions?.env ? { ...(auth.env ?? {}), ...(streamOptions?.env ?? {}) } : undefined,
+                    headers: { ...opencodeSessionHeaders(model, sessionId), ...(streamOptions?.headers ?? {}), ...(auth.headers ?? {}) },
+                });
+                agent = new Agent({
+                    initialState: {
+                        systemPrompt: [
+                            "You are the pi-subagents watchdog permission arbiter.",
+                            "Decide only whether this exact non-bash child tool call should proceed.",
+                            "Call watchdog_permission_decision exactly once with approve or deny and a concise reason.",
+                            "Deny when uncertain. Do not produce freeform advice or ask the parent orchestrator.",
+                        ].join("\n"),
+                        model: selection.model,
+                        thinkingLevel: selection.thinkingLevel,
+                        tools: [tool],
+                    },
+                    convertToLlm,
+                    ...agentStreamOptions(streamFn),
+                    getApiKey: (providerName) => providerName === selection.model.provider ? auth.apiKey : undefined,
+                    beforeToolCall: async ({ toolCall }) => toolCall.name === tool.name ? undefined : { block: true, reason: `Permission arbiter tool '${toolCall.name}' is not allowed.` },
+                    toolExecution: "sequential",
+                });
+                await agent.prompt(`Tool: ${request.toolName}\nRedacted arguments: ${preview}`);
+                if (!decision)
+                    return finish(false, "Watchdog permission arbiter returned no decision.", "malformed");
+                const approved = decision.decision === "approve";
+                return finish(approved, decision.reason, decision.decision);
+            };
+            return await Promise.race([
+                run(),
+                new Promise((resolve) => { timeout = setTimeout(() => { agent?.abort(); resolve(finish(false, "Watchdog permission decision timed out.", "timeout")); }, childConfig.agentEndTimeoutMs); }),
+                new Promise((resolve) => {
+                    abort = () => { agent?.abort(); resolve(finish(false, "Watchdog permission decision was cancelled.", "cancelled")); };
+                    request.signal?.addEventListener("abort", abort, { once: true });
+                    request.ctx.signal?.addEventListener("abort", abort, { once: true });
+                }),
+            ]);
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            return finish(false, `Watchdog permission arbiter failed closed: ${reason}`, reason.includes("timed out") ? "timeout" : "error");
+        }
+        finally {
+            if (timeout)
+                clearTimeout(timeout);
+            if (abort) {
+                request.signal?.removeEventListener("abort", abort);
+                request.ctx.signal?.removeEventListener("abort", abort);
+            }
+        }
+    };
+}
+export const requestWatchdogPermission = createWatchdogPermissionArbiter();
+//# sourceMappingURL=permission-arbiter.js.map

package/src/watchdog/permission-arbiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-arbiter.js","sourceRoot":"","sources":["../../../src/watchdog/permission-arbiter.ts"],"names":[],"mappings":"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"}

package/src/watchdog/register-child.d.ts

@@ -0,0 +1,12 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { MainWatchdogRuntime } from "./runtime.ts";
+import { type ChildWatchdogConfig, type ChildWatchdogStatusEvent } from "./child-status.ts";
+import { type ResolvedWatchdogConfig } from "./types.ts";
+export declare function childResolvedConfig(config: ChildWatchdogConfig): ResolvedWatchdogConfig;
+/**
+ * Register the child-side watchdog. Status events go to the sink the hosting
+ * process passed in the child runtime config; the host folds them into the
+ * child's event stream.
+ */
+export declare function registerChildWatchdog(pi: ExtensionAPI, childConfig: ChildWatchdogConfig | undefined, writeStatus: ((event: ChildWatchdogStatusEvent) => void) | undefined): MainWatchdogRuntime | undefined;
+//# sourceMappingURL=register-child.d.ts.map

package/src/watchdog/register-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-child.d.ts","sourceRoot":"","sources":["../../../src/watchdog/register-child.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAEtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAInD,OAAO,EAEN,KAAK,mBAAmB,EAExB,KAAK,wBAAwB,EAC7B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAkC,KAAK,sBAAsB,EAA+B,MAAM,YAAY,CAAC;AAEtH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,sBAAsB,CAmBvF;AAWD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,EAAE,EAAE,YAAY,EAChB,WAAW,EAAE,mBAAmB,GAAG,SAAS,EAC5C,WAAW,EAAE,CAAC,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC,GAAG,SAAS,GAClE,mBAAmB,GAAG,SAAS,CAyEjC"}

package/src/watchdog/register-child.js

@@ -0,0 +1,120 @@
+import { captureWatchdogDiffBaseline } from "./diff-tool.js";
+import { MainWatchdogRuntime } from "./runtime.js";
+import { createMainWatchdogReview } from "./review.js";
+import { DEFAULT_WATCHDOG_CONFIG } from "./settings.js";
+import { createWatchdogWarningMessage } from "./warning-format.js";
+import { CHILD_WATCHDOG_STATUS_EVENT, } from "./child-status.js";
+import { SUBAGENT_WATCHDOG_WARNING_TYPE } from "./types.js";
+export function childResolvedConfig(config) {
+    return {
+        ...DEFAULT_WATCHDOG_CONFIG,
+        enabled: true,
+        agentEndTimeoutMs: config.agentEndTimeoutMs,
+        maxWarnings: config.maxWarnings,
+        main: {
+            enabled: true,
+            ...(config.model ? { model: config.model } : {}),
+            ...(config.thinking !== undefined ? { thinking: config.thinking } : {}),
+        },
+        stalemateRepeats: config.stalemateRepeats,
+        cadence: { ...config.cadence },
+        children: {
+            ...DEFAULT_WATCHDOG_CONFIG.children,
+            watchdogTailTimeoutMs: config.watchdogTailTimeoutMs,
+        },
+        lsp: { ...config.lsp },
+    };
+}
+function childWarningDetails(details, config) {
+    return {
+        ...details,
+        source: details.source === "lsp" ? "lsp" : "child",
+        ...(config.agent ? { agent: config.agent } : {}),
+        ...(config.runId ? { runId: config.runId } : {}),
+    };
+}
+/**
+ * Register the child-side watchdog. Status events go to the sink the hosting
+ * process passed in the child runtime config; the host folds them into the
+ * child's event stream.
+ */
+export function registerChildWatchdog(pi, childConfig, writeStatus) {
+    if (!childConfig)
+        return undefined;
+    if (!writeStatus)
+        throw new Error("Child watchdog status sink is missing; the host must pass ChildRuntimeConfig.watchdogStatus.");
+    let currentContext;
+    let diffBaseline;
+    let seq = 0;
+    const emitStatus = (phase, reason, warning) => {
+        writeStatus({
+            type: CHILD_WATCHDOG_STATUS_EVENT,
+            ...(childConfig.runId ? { runId: childConfig.runId } : {}),
+            ...(childConfig.agent ? { agent: childConfig.agent } : {}),
+            ...(childConfig.childIndex !== undefined ? { childIndex: childConfig.childIndex, stepIndex: childConfig.childIndex } : {}),
+            seq: ++seq,
+            phase,
+            ts: Date.now(),
+            ...(reason ? { reason } : {}),
+            ...(warning ? { warning } : {}),
+        });
+    };
+    const resolved = childResolvedConfig(childConfig);
+    const runtime = new MainWatchdogRuntime({
+        resolveConfig: () => ({ ok: true, config: resolved, errors: [], sources: [{ scope: "session", exists: true }] }),
+        review: createMainWatchdogReview(() => currentContext, { getThinkingLevel: () => pi.getThinkingLevel(), diffBaseline: () => diffBaseline }),
+        reviewDescription: "child model review",
+        reviewChangesOnly: true,
+        displayWarning: (details, options) => {
+            const childDetails = childWarningDetails(details, childConfig);
+            emitStatus("reviewing", undefined, { severity: childDetails.severity, importance: childDetails.importance, category: childDetails.category, summary: childDetails.summary, evidence: childDetails.evidence, recommendedAction: childDetails.recommendedAction, ...(childDetails.displayedAt ? { displayedAt: childDetails.displayedAt } : {}), addressed: false, stalemate: childDetails.state === "stalemate" });
+            pi.sendMessage(createWatchdogWarningMessage(childDetails, { display: true, details: childDetails }), options);
+        },
+        displayUserWarning: (details) => {
+            const childDetails = childWarningDetails(details, childConfig);
+            emitStatus("reviewing", undefined, { severity: childDetails.severity, importance: childDetails.importance, category: childDetails.category, summary: childDetails.summary, evidence: childDetails.evidence, recommendedAction: childDetails.recommendedAction, ...(childDetails.displayedAt ? { displayedAt: childDetails.displayedAt } : {}), addressed: false, stalemate: childDetails.state === "stalemate" });
+            pi.appendEntry(SUBAGENT_WATCHDOG_WARNING_TYPE, childDetails);
+        },
+    });
+    const rememberContext = (ctx) => {
+        currentContext = ctx;
+    };
+    const onRuntimeEvent = pi.on;
+    onRuntimeEvent("session_start", (_event, ctx) => {
+        rememberContext(ctx);
+        diffBaseline = captureWatchdogDiffBaseline(ctx.cwd);
+        runtime.bindSession(ctx);
+        emitStatus("idle");
+    });
+    onRuntimeEvent("before_agent_start", (event, ctx) => {
+        rememberContext(ctx);
+        runtime.handleBeforeAgentStart(event, ctx);
+    });
+    onRuntimeEvent("turn_end", (event, ctx) => {
+        rememberContext(ctx);
+        runtime.handleTurnEnd(event, ctx);
+    });
+    onRuntimeEvent("tool_result", (_event, ctx) => {
+        rememberContext(ctx);
+        runtime.handleToolResult(ctx);
+    });
+    onRuntimeEvent("agent_end", async (event, ctx) => {
+        rememberContext(ctx);
+        emitStatus("reviewing");
+        await runtime.handleAgentEnd(event, ctx);
+        const snapshot = runtime.getSnapshot(ctx.cwd);
+        if (snapshot.status === "failed")
+            emitStatus("failed", snapshot.lastError);
+        else if (snapshot.status === "stale")
+            emitStatus("stale", "review stale");
+        else
+            emitStatus("idle");
+    });
+    onRuntimeEvent("session_shutdown", () => {
+        currentContext = undefined;
+        runtime.dispose();
+        emitStatus("idle");
+    });
+    return runtime;
+}
+//# sourceMappingURL=register-child.js.map

package/src/watchdog/register-child.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-child.js","sourceRoot":"","sources":["../../../src/watchdog/register-child.ts"],"names":[],"mappings":"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"}

package/src/watchdog/register-main.d.ts

@@ -0,0 +1,10 @@
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { MainWatchdogRuntime, type WatchdogReviewFunction } from "./runtime.ts";
+interface RegisterMainWatchdogOptions {
+    runtime?: MainWatchdogRuntime;
+    review?: WatchdogReviewFunction;
+}
+export declare function buildWatchdogStatus(snapshot: ReturnType<MainWatchdogRuntime["getSnapshot"]>, ctx: ExtensionContext): string;
+export declare function registerMainWatchdog(pi: ExtensionAPI, options?: RegisterMainWatchdogOptions): MainWatchdogRuntime;
+export {};
+//# sourceMappingURL=register-main.d.ts.map

package/src/watchdog/register-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-main.d.ts","sourceRoot":"","sources":["../../../src/watchdog/register-main.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA2B,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAQ/G,OAAO,EAAE,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAUhF,UAAU,2BAA2B;IACpC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,sBAAsB,CAAC;CAChC;AAsFD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,gBAAgB,GAAG,MAAM,CA+C3H;AA0ND,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,GAAE,2BAAgC,GAAG,mBAAmB,CAwErH"}