advisor-pi 1.0.0

package/README.md

@@ -0,0 +1,102 @@
+# advisor-pi
+
+Advisor-style strategic guidance for Pi Coding Agent.
+
+![advisor-pi screenshot](../../assets/advisor-pi.png)
+
+`advisor-pi` adds an LLM-callable `advisor` tool. During complex workflows, the
+executor model can pause and consult a configured higher-capability advisor model
+for planning, risk analysis, course correction, or review guidance.
+
+The advisor receives the current conversation transcript plus the executor's
+question. It has no tools and cannot modify files; it only returns strategic
+advice to the executor.
+
+## Behavior
+
+- Registers an `advisor` tool for complex or high-risk tasks.
+- Lets the executor decide when a consultation is useful.
+- Calls a configured advisor model through Pi's model registry and auth.
+- Tracks advisor uses per session branch and stops after the configured limit.
+- Passes a prompt-cache preference (`none`, `short`, or `long`) where the
+  selected provider supports it.
+- Shows a compact `advisor:<remaining>` status in Pi's footer when UI is
+  available.
+
+## Commands
+
+```text
+/advisor-pi status
+/advisor-pi enable
+/advisor-pi disable
+/advisor-pi model <provider>/<model>
+/advisor-pi max-uses <number>
+/advisor-pi cache <none|short|long>
+/advisor-pi reset
+```
+
+Examples:
+
+```text
+/advisor-pi model anthropic/claude-opus-4-5
+/advisor-pi max-uses 5
+/advisor-pi cache long
+```
+
+## CLI flags
+
+```bash
+pi --advisor-model anthropic/claude-opus-4-5 \
+   --advisor-max-uses 3 \
+   --advisor-cache short
+```
+
+Disable on startup:
+
+```bash
+pi --advisor-enabled=false
+```
+
+## Install
+
+From the repo root:
+
+```bash
+cp -r extensions/advisor-pi ~/.pi/agent/extensions/
+```
+
+Then run `/reload` in Pi.
+
+## Cost and latency
+
+Each advisor consultation is a separate model call. That means:
+
+- Advisor input and output are billed separately by the selected provider.
+- Streaming from the executor pauses while the advisor call runs.
+- Longer transcripts cost more because the advisor reads the conversation
+  context.
+- The `max-uses` setting is a safety budget; raise it only when deeper review is
+  worth the extra cost.
+
+## Caching
+
+`advisor-pi` passes the configured cache preference to Pi's AI provider layer:
+
+- `none` — do not request prompt caching.
+- `short` — request normal/short cache retention where supported.
+- `long` — request long cache retention where supported.
+
+Provider support varies. Some providers ignore cache preferences, some require
+specific model compatibility, and cache reads/writes may still be billed.
+
+## Known limitations
+
+- This is a portable Pi custom-tool approximation, not Anthropic's native beta
+  `advisor_20260301` server tool.
+- Native provider-specific advisor usage fields may not appear in provider usage
+  reports.
+- The advisor has no tools and cannot inspect files beyond what appears in the
+  transcript.
+- Very long conversations can make advisor calls slower and more expensive.
+- `max-uses` is tracked per Pi session branch from extension state and tool
+  result details; manual session editing can affect reconstruction.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function advisorPiExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,KAAK,YAAY,EAEjB,MAAM,iCAAiC,CAAC;AAgEzC,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EAAE,EAAE,YAAY,QAkW1D"}

package/dist/index.js

@@ -0,0 +1,489 @@
+import { complete, StringEnum } from "@earendil-works/pi-ai";
+import { buildSessionContext, convertToLlm, serializeConversation, } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+const STATE_ENTRY = "advisor-pi-state";
+const TOOL_NAME = "advisor";
+const DEFAULT_ADVISOR_MODEL = "openai-codex/gpt-5.5";
+const DEFAULT_MAX_USES = 3;
+const DEFAULT_CACHE_RETENTION = "short";
+const DEFAULT_TIMEOUT_MS = 600_000;
+const DEFAULT_MAX_TOKENS = 4_000;
+const advisorToolSchema = Type.Object({
+    question: Type.String({
+        description: "Strategic question for the advisor. Ask for planning, risk analysis, course correction, or review guidance.",
+    }),
+    phase: Type.Optional(StringEnum(["planning", "course_correction", "review", "stuck", "other"], {
+        description: "Why the executor is consulting the advisor.",
+        default: "other",
+    })),
+    context: Type.Optional(Type.String({
+        description: "Optional extra context that is not obvious from the transcript, such as constraints, current plan, or failed attempts.",
+    })),
+});
+export default function advisorPiExtension(pi) {
+    let config = defaultConfig();
+    let useCount = 0;
+    pi.registerFlag("advisor-model", {
+        description: "Advisor model as provider/model, e.g. openai-codex/gpt-5.5",
+        type: "string",
+    });
+    pi.registerFlag("advisor-max-uses", {
+        description: "Maximum advisor calls per session branch",
+        type: "string",
+    });
+    pi.registerFlag("advisor-cache", {
+        description: "Advisor prompt-cache preference: none, short, or long",
+        type: "string",
+    });
+    pi.registerFlag("advisor-enabled", {
+        description: "Enable the advisor tool on startup",
+        type: "boolean",
+        default: true,
+    });
+    pi.registerTool({
+        name: TOOL_NAME,
+        label: "Advisor",
+        description: "Consult a configured higher-capability advisor model for strategic guidance during complex agent tasks. The advisor reads the current conversation transcript and returns planning, risk, or course-correction advice. It has no tools and does not modify files.",
+        promptSnippet: "Consult a higher-capability advisor model for strategic planning, risk checks, and course correction on complex tasks.",
+        promptGuidelines: [
+            "Use advisor before starting a complex, multi-step, or high-risk task when strategic planning would reduce mistakes.",
+            "Use advisor when stuck, when tests keep failing, or when choosing between competing implementation approaches.",
+            "Do not use advisor for simple lookups, trivial edits, or when the user explicitly wants the fastest possible answer.",
+        ],
+        parameters: advisorToolSchema,
+        executionMode: "sequential",
+        async execute(_toolCallId, params, signal, onUpdate, ctx) {
+            refreshStateFromBranch(ctx);
+            if (!config.enabled) {
+                return advisorDisabledResult(config, useCount, params);
+            }
+            if (useCount >= config.maxUses) {
+                return advisorLimitResult(config, useCount, params);
+            }
+            const model = ctx.modelRegistry.find(config.provider, config.modelId);
+            if (!model) {
+                throw new Error(`Advisor model not found: ${config.provider}/${config.modelId}. Run /advisor-pi model <provider>/<model>.`);
+            }
+            onUpdate?.({
+                content: [
+                    {
+                        type: "text",
+                        text: `Consulting advisor ${config.provider}/${config.modelId}...`,
+                    },
+                ],
+                details: makeSkippedDetails(config, useCount, params),
+            });
+            const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
+            if (!auth.ok)
+                throw new Error(auth.error);
+            const startedAt = Date.now();
+            const conversationText = serializeCurrentConversation(ctx);
+            const userMessage = {
+                role: "user",
+                content: [
+                    {
+                        type: "text",
+                        text: buildAdvisorUserPrompt(params, conversationText),
+                    },
+                ],
+                timestamp: Date.now(),
+            };
+            const response = await complete(model, {
+                systemPrompt: ADVISOR_SYSTEM_PROMPT,
+                messages: [userMessage],
+            }, {
+                apiKey: auth.apiKey,
+                headers: auth.headers,
+                signal,
+                cacheRetention: config.cacheRetention,
+                sessionId: `advisor-pi:${ctx.sessionManager.getSessionId()}`,
+                maxTokens: config.maxTokens,
+                timeoutMs: config.timeoutMs,
+            });
+            if (response.stopReason === "error") {
+                throw new Error(response.errorMessage ?? "Advisor model returned an error");
+            }
+            if (response.stopReason === "aborted") {
+                throw new Error("Advisor call aborted");
+            }
+            useCount += 1;
+            persistState(pi, config, useCount);
+            updateStatus(ctx);
+            const elapsedMs = Date.now() - startedAt;
+            const text = extractText(response.content) || "Advisor returned no text guidance.";
+            const details = {
+                advisor: {
+                    provider: response.provider,
+                    model: response.model,
+                    phase: params.phase ?? "other",
+                    useCount,
+                    maxUses: config.maxUses,
+                    cacheRetention: config.cacheRetention,
+                    elapsedMs,
+                    stopReason: response.stopReason,
+                    usage: response.usage,
+                },
+                state: makeStateEntry(config, useCount),
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Advisor guidance (${useCount}/${config.maxUses}, ${config.provider}/${config.modelId}):\n\n${text}`,
+                    },
+                ],
+                details,
+            };
+        },
+    });
+    pi.registerCommand("advisor-pi", {
+        description: "Configure advisor-pi: status, enable, disable, model, max-uses, cache, reset",
+        handler: async (args, ctx) => {
+            const result = handleCommand(args.trim(), ctx);
+            if (result.persist)
+                persistState(pi, config, useCount);
+            if (result.updateToolState)
+                syncActiveTool(pi);
+            updateStatus(ctx);
+            ctx.ui.notify(result.message, result.level);
+        },
+    });
+    pi.on("session_start", async (_event, ctx) => {
+        refreshStateFromBranch(ctx);
+    });
+    pi.on("session_tree", async (_event, ctx) => {
+        refreshStateFromBranch(ctx);
+    });
+    pi.on("before_agent_start", async (event) => {
+        if (!config.enabled)
+            return;
+        return {
+            systemPrompt: `${event.systemPrompt}\n\n${buildExecutorGuidance(config, useCount)}`,
+        };
+    });
+    pi.on("turn_start", async () => {
+        persistState(pi, config, useCount);
+    });
+    function refreshStateFromBranch(ctx) {
+        config = defaultConfig();
+        useCount = 0;
+        const restoredFromBranch = restoreStateFromSession(ctx);
+        if (!restoredFromBranch)
+            applyStartupFlags(pi);
+        syncActiveTool(pi);
+        updateStatus(ctx);
+    }
+    function restoreStateFromSession(ctx) {
+        let restored = false;
+        const branch = ctx.sessionManager.getBranch();
+        for (const entry of branch) {
+            if (entry.type === "custom" && entry.customType === STATE_ENTRY) {
+                restored = true;
+                const data = entry.data;
+                if (data?.config)
+                    config = normalizeConfig(data.config, config);
+                if (typeof data?.useCount === "number")
+                    useCount = Math.max(0, data.useCount);
+            }
+            if (entry.type === "message" && entry.message.role === "toolResult" && entry.message.toolName === TOOL_NAME) {
+                restored = true;
+                const details = entry.message.details;
+                if (details?.state?.config)
+                    config = normalizeConfig(details.state.config, config);
+                if (typeof details?.state?.useCount === "number")
+                    useCount = Math.max(useCount, details.state.useCount);
+                else if (details?.advisor?.useCount)
+                    useCount = Math.max(useCount, details.advisor.useCount);
+            }
+        }
+        return restored;
+    }
+    function applyStartupFlags(api) {
+        const enabledFlag = api.getFlag("advisor-enabled");
+        if (typeof enabledFlag === "boolean")
+            config.enabled = enabledFlag;
+        const modelFlag = api.getFlag("advisor-model");
+        if (typeof modelFlag === "string" && modelFlag.trim()) {
+            const parsed = parseModelSpec(modelFlag.trim());
+            if (parsed) {
+                config.provider = parsed.provider;
+                config.modelId = parsed.modelId;
+            }
+        }
+        const maxUsesFlag = api.getFlag("advisor-max-uses");
+        if (typeof maxUsesFlag === "string") {
+            const maxUses = parsePositiveInt(maxUsesFlag);
+            if (maxUses !== undefined)
+                config.maxUses = maxUses;
+        }
+        const cacheFlag = api.getFlag("advisor-cache");
+        if (typeof cacheFlag === "string") {
+            const cacheRetention = parseCacheRetention(cacheFlag);
+            if (cacheRetention)
+                config.cacheRetention = cacheRetention;
+        }
+    }
+    function handleCommand(args, ctx) {
+        if (!args || args === "status") {
+            return {
+                message: formatStatus(ctx),
+                level: "info",
+                persist: false,
+                updateToolState: false,
+            };
+        }
+        const [command, ...rest] = args.split(/\s+/);
+        const value = rest.join(" ").trim();
+        switch (command) {
+            case "enable":
+                config.enabled = true;
+                return { message: "advisor-pi enabled", level: "info", persist: true, updateToolState: true };
+            case "disable":
+                config.enabled = false;
+                return { message: "advisor-pi disabled", level: "info", persist: true, updateToolState: true };
+            case "reset":
+                useCount = 0;
+                return { message: "advisor-pi use count reset", level: "info", persist: true, updateToolState: false };
+            case "model": {
+                const parsed = parseModelSpec(value);
+                if (!parsed) {
+                    return {
+                        message: "Usage: /advisor-pi model <provider>/<model>",
+                        level: "error",
+                        persist: false,
+                        updateToolState: false,
+                    };
+                }
+                const model = ctx.modelRegistry.find(parsed.provider, parsed.modelId);
+                if (!model) {
+                    return {
+                        message: `Advisor model not found: ${parsed.provider}/${parsed.modelId}`,
+                        level: "error",
+                        persist: false,
+                        updateToolState: false,
+                    };
+                }
+                config.provider = parsed.provider;
+                config.modelId = parsed.modelId;
+                return {
+                    message: `advisor-pi model set to ${config.provider}/${config.modelId}`,
+                    level: "info",
+                    persist: true,
+                    updateToolState: false,
+                };
+            }
+            case "max-uses": {
+                const maxUses = parsePositiveInt(value);
+                if (maxUses === undefined) {
+                    return {
+                        message: "Usage: /advisor-pi max-uses <positive-number>",
+                        level: "error",
+                        persist: false,
+                        updateToolState: false,
+                    };
+                }
+                config.maxUses = maxUses;
+                return {
+                    message: `advisor-pi max uses set to ${maxUses}`,
+                    level: "info",
+                    persist: true,
+                    updateToolState: false,
+                };
+            }
+            case "cache": {
+                const cacheRetention = parseCacheRetention(value);
+                if (!cacheRetention) {
+                    return {
+                        message: "Usage: /advisor-pi cache <none|short|long>",
+                        level: "error",
+                        persist: false,
+                        updateToolState: false,
+                    };
+                }
+                config.cacheRetention = cacheRetention;
+                return {
+                    message: `advisor-pi cache set to ${cacheRetention}`,
+                    level: "info",
+                    persist: true,
+                    updateToolState: false,
+                };
+            }
+            default:
+                return {
+                    message: "Usage: /advisor-pi [status|enable|disable|model <provider>/<model>|max-uses <n>|cache <none|short|long>|reset]",
+                    level: "error",
+                    persist: false,
+                    updateToolState: false,
+                };
+        }
+    }
+    function syncActiveTool(api) {
+        const activeTools = api.getActiveTools();
+        const hasAdvisor = activeTools.includes(TOOL_NAME);
+        if (config.enabled && !hasAdvisor) {
+            api.setActiveTools([...activeTools, TOOL_NAME]);
+        }
+        else if (!config.enabled && hasAdvisor) {
+            api.setActiveTools(activeTools.filter((tool) => tool !== TOOL_NAME));
+        }
+    }
+    function updateStatus(ctx) {
+        if (!ctx.hasUI)
+            return;
+        if (!config.enabled) {
+            ctx.ui.setStatus("advisor-pi", undefined);
+            return;
+        }
+        const remaining = Math.max(0, config.maxUses - useCount);
+        ctx.ui.setStatus("advisor-pi", ctx.ui.theme.fg(remaining > 0 ? "accent" : "warning", `advisor:${remaining}`));
+    }
+    function formatStatus(ctx) {
+        const model = ctx.modelRegistry.find(config.provider, config.modelId);
+        const availability = model ? "available" : "not found";
+        return [
+            `advisor-pi ${config.enabled ? "enabled" : "disabled"}`,
+            `model: ${config.provider}/${config.modelId} (${availability})`,
+            `uses: ${useCount}/${config.maxUses}`,
+            `cache: ${config.cacheRetention}`,
+        ].join(" • ");
+    }
+}
+const ADVISOR_SYSTEM_PROMPT = `You are an advisor model for Pi Coding Agent.
+
+Your role is strategic guidance only. You do not have tools and you do not make changes. Given the executor's question and conversation transcript:
+
+- Identify the best next plan or course correction.
+- Call out risks, missing information, edge cases, and test strategy.
+- Prefer concise, actionable guidance the executor can apply immediately.
+- Do not restate the full transcript.
+- If the task is unsafe, impossible, or underspecified, say what must be clarified.
+
+Return guidance in short sections with bullets when useful.`;
+function defaultConfig() {
+    const parsed = parseModelSpec(DEFAULT_ADVISOR_MODEL) ?? { provider: "openai-codex", modelId: "gpt-5.5" };
+    return {
+        enabled: true,
+        provider: parsed.provider,
+        modelId: parsed.modelId,
+        maxUses: DEFAULT_MAX_USES,
+        cacheRetention: DEFAULT_CACHE_RETENTION,
+        maxTokens: DEFAULT_MAX_TOKENS,
+        timeoutMs: DEFAULT_TIMEOUT_MS,
+    };
+}
+function buildExecutorGuidance(config, useCount) {
+    const remaining = Math.max(0, config.maxUses - useCount);
+    return [
+        "Advisor-pi is enabled.",
+        `The advisor tool consults ${config.provider}/${config.modelId} for strategic guidance and has ${remaining}/${config.maxUses} uses remaining on this branch.`,
+        "Use advisor for complex planning, risky implementation choices, repeated failures, or course correction. Do not use advisor for trivial edits or simple facts.",
+        `Advisor cache preference is ${config.cacheRetention}; caching support is provider-dependent.`,
+    ].join("\n");
+}
+function serializeCurrentConversation(ctx) {
+    const entries = ctx.sessionManager.getEntries();
+    const leafId = ctx.sessionManager.getLeafId();
+    const sessionContext = buildSessionContext(entries, leafId);
+    const llmMessages = convertToLlm(sessionContext.messages);
+    return serializeConversation(llmMessages);
+}
+function buildAdvisorUserPrompt(params, conversationText) {
+    return [
+        "## Executor Question",
+        params.question,
+        "",
+        "## Consultation Phase",
+        params.phase ?? "other",
+        "",
+        ...(params.context ? ["## Extra Context", params.context, ""] : []),
+        "## Conversation Transcript",
+        conversationText,
+    ].join("\n");
+}
+function extractText(content) {
+    return content
+        .filter((part) => part.type === "text" && typeof part.text === "string")
+        .map((part) => part.text)
+        .join("\n")
+        .trim();
+}
+function advisorDisabledResult(config, useCount, params) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: `advisor-pi is disabled. The executor should continue without advisor guidance for: ${params.question}`,
+            },
+        ],
+        details: makeSkippedDetails(config, useCount, params),
+    };
+}
+function advisorLimitResult(config, useCount, params) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Advisor use limit reached. The executor should continue without another advisor call for: ${params.question}`,
+            },
+        ],
+        details: makeSkippedDetails(config, useCount, params),
+    };
+}
+function makeSkippedDetails(config, useCount, params) {
+    return {
+        advisor: {
+            provider: config.provider,
+            model: config.modelId,
+            phase: params.phase ?? "other",
+            useCount,
+            maxUses: config.maxUses,
+            cacheRetention: config.cacheRetention,
+            elapsedMs: 0,
+            stopReason: "skipped",
+        },
+        state: makeStateEntry(config, useCount),
+    };
+}
+function makeStateEntry(config, useCount) {
+    return {
+        version: 1,
+        config: { ...config },
+        useCount,
+        updatedAt: new Date().toISOString(),
+    };
+}
+function persistState(pi, config, useCount) {
+    pi.appendEntry(STATE_ENTRY, makeStateEntry(config, useCount));
+}
+function normalizeConfig(input, fallback) {
+    return {
+        enabled: typeof input.enabled === "boolean" ? input.enabled : fallback.enabled,
+        provider: typeof input.provider === "string" && input.provider ? input.provider : fallback.provider,
+        modelId: typeof input.modelId === "string" && input.modelId ? input.modelId : fallback.modelId,
+        maxUses: typeof input.maxUses === "number" && input.maxUses > 0 ? Math.floor(input.maxUses) : fallback.maxUses,
+        cacheRetention: parseCacheRetention(input.cacheRetention) ?? fallback.cacheRetention,
+        maxTokens: typeof input.maxTokens === "number" && input.maxTokens > 0 ? Math.floor(input.maxTokens) : fallback.maxTokens,
+        timeoutMs: typeof input.timeoutMs === "number" && input.timeoutMs > 0 ? Math.floor(input.timeoutMs) : fallback.timeoutMs,
+    };
+}
+function parseModelSpec(value) {
+    const slash = value.indexOf("/");
+    if (slash <= 0 || slash === value.length - 1)
+        return undefined;
+    return {
+        provider: value.slice(0, slash),
+        modelId: value.slice(slash + 1),
+    };
+}
+function parsePositiveInt(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return undefined;
+    return parsed;
+}
+function parseCacheRetention(value) {
+    if (value === "none" || value === "short" || value === "long")
+        return value;
+    return undefined;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAiD,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EACN,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,GAGrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,IAAI,EAAe,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,GAAG,kBAAkB,CAAC;AACvC,MAAM,SAAS,GAAG,SAAS,CAAC;AAC5B,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AACrD,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,uBAAuB,GAAmB,OAAO,CAAC;AACxD,MAAM,kBAAkB,GAAG,OAAO,CAAC;AACnC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAEjC,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACrB,WAAW,EACV,6GAA6G;KAC9G,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,QAAQ,CACnB,UAAU,CAAC,CAAC,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAU,EAAE;QAClF,WAAW,EAAE,6CAA6C;QAC1D,OAAO,EAAE,OAAO;KAChB,CAAC,CACF;IACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CACrB,IAAI,CAAC,MAAM,CAAC;QACX,WAAW,EACV,wHAAwH;KACzH,CAAC,CACF;CACD,CAAC,CAAC;AAoCH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EAAgB;IAC1D,IAAI,MAAM,GAAG,aAAa,EAAE,CAAC;IAC7B,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE;QAChC,WAAW,EAAE,4DAA4D;QACzE,IAAI,EAAE,QAAQ;KACd,CAAC,CAAC;IACH,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE;QACnC,WAAW,EAAE,0CAA0C;QACvD,IAAI,EAAE,QAAQ;KACd,CAAC,CAAC;IACH,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE;QAChC,WAAW,EAAE,uDAAuD;QACpE,IAAI,EAAE,QAAQ;KACd,CAAC,CAAC;IACH,EAAE,CAAC,YAAY,CAAC,iBAAiB,EAAE;QAClC,WAAW,EAAE,oCAAoC;QACjD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;KACb,CAAC,CAAC;IAEH,EAAE,CAAC,YAAY,CAA+C;QAC7D,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,WAAW,EACV,mQAAmQ;QACpQ,aAAa,EACZ,wHAAwH;QACzH,gBAAgB,EAAE;YACjB,qHAAqH;YACrH,gHAAgH;YAChH,sHAAsH;SACtH;QACD,UAAU,EAAE,iBAAiB;QAC7B,aAAa,EAAE,YAAY;QAC3B,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG;YACvD,sBAAsB,CAAC,GAAG,CAAC,CAAC;YAE5B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACrB,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACxD,CAAC;YAED,IAAI,QAAQ,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAChC,OAAO,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACrD,CAAC;YAED,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACtE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACd,4BAA4B,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,6CAA6C,CAC1G,CAAC;YACH,CAAC;YAED,QAAQ,EAAE,CAAC;gBACV,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sBAAsB,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK;qBAClE;iBACD;gBACD,OAAO,EAAE,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC;aACrD,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAChE,IAAI,CAAC,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAE1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,GAAG,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAY;gBAC5B,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,CAAC;qBACtD;iBACD;gBACD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAC9B,KAAK,EACL;gBACC,YAAY,EAAE,qBAAqB;gBACnC,QAAQ,EAAE,CAAC,WAAW,CAAC;aACvB,EACD;gBACC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM;gBACN,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,SAAS,EAAE,cAAc,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,EAAE;gBAC5D,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;aAC3B,CACD,CAAC;YAEF,IAAI,QAAQ,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,IAAI,iCAAiC,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACzC,CAAC;YAED,QAAQ,IAAI,CAAC,CAAC;YACd,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YACnC,YAAY,CAAC,GAAG,CAAC,CAAC;YAElB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACzC,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,oCAAoC,CAAC;YACnF,MAAM,OAAO,GAAuB;gBACnC,OAAO,EAAE;oBACR,QAAQ,EAAE,QAAQ,CAAC,QAAQ;oBAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,OAAO;oBAC9B,QAAQ;oBACR,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,cAAc,EAAE,MAAM,CAAC,cAAc;oBACrC,SAAS;oBACT,UAAU,EAAE,QAAQ,CAAC,UAAU;oBAC/B,KAAK,EAAE,QAAQ,CAAC,KAAK;iBACrB;gBACD,KAAK,EAAE,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC;aACvC,CAAC;YAEF,OAAO;gBACN,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,qBAAqB,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,SAAS,IAAI,EAAE;qBAC1G;iBACD;gBACD,OAAO;aACP,CAAC;QACH,CAAC;KACD,CAAC,CAAC;IAEH,EAAE,CAAC,eAAe,CAAC,YAAY,EAAE;QAChC,WAAW,EAAE,8EAA8E;QAC3F,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;YAC/C,IAAI,MAAM,CAAC,OAAO;gBAAE,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YACvD,IAAI,MAAM,CAAC,eAAe;gBAAE,cAAc,CAAC,EAAE,CAAC,CAAC;YAC/C,YAAY,CAAC,GAAG,CAAC,CAAC;YAClB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;KACD,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC5C,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC3C,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC3C,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAC5B,OAAO;YACN,YAAY,EAAE,GAAG,KAAK,CAAC,YAAY,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE;SACnF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;QAC9B,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,SAAS,sBAAsB,CAAC,GAAqB;QACpD,MAAM,GAAG,aAAa,EAAE,CAAC;QACzB,QAAQ,GAAG,CAAC,CAAC;QACb,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,kBAAkB;YAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAC/C,cAAc,CAAC,EAAE,CAAC,CAAC;QACnB,YAAY,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,SAAS,uBAAuB,CAAC,GAAqB;QACrD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,MAAM,GAAG,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;QAC9C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;gBACjE,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,IAAI,GAAG,KAAK,CAAC,IAA8C,CAAC;gBAClE,IAAI,IAAI,EAAE,MAAM;oBAAE,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAChE,IAAI,OAAO,IAAI,EAAE,QAAQ,KAAK,QAAQ;oBAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/E,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC7G,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAkD,CAAC;gBACjF,IAAI,OAAO,EAAE,KAAK,EAAE,MAAM;oBAAE,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACnF,IAAI,OAAO,OAAO,EAAE,KAAK,EAAE,QAAQ,KAAK,QAAQ;oBAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;qBACnG,IAAI,OAAO,EAAE,OAAO,EAAE,QAAQ;oBAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC9F,CAAC;QACF,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,SAAS,iBAAiB,CAAC,GAAiB;QAC3C,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACnD,IAAI,OAAO,WAAW,KAAK,SAAS;YAAE,MAAM,CAAC,OAAO,GAAG,WAAW,CAAC;QAEnE,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC/C,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;YAChD,IAAI,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;gBAClC,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YACjC,CAAC;QACF,CAAC;QAED,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACpD,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QACrD,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC/C,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,cAAc,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;YACtD,IAAI,cAAc;gBAAE,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC;QAC5D,CAAC;IACF,CAAC;IAED,SAAS,aAAa,CACrB,IAAY,EACZ,GAAqB;QAErB,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACN,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC;gBAC1B,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,KAAK;gBACd,eAAe,EAAE,KAAK;aACtB,CAAC;QACH,CAAC;QAED,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAEpC,QAAQ,OAAO,EAAE,CAAC;YACjB,KAAK,QAAQ;gBACZ,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;gBACtB,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;YAC/F,KAAK,SAAS;gBACb,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;gBACvB,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;YAChG,KAAK,OAAO;gBACX,QAAQ,GAAG,CAAC,CAAC;gBACb,OAAO,EAAE,OAAO,EAAE,4BAA4B,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;YACxG,KAAK,OAAO,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;gBACrC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACb,OAAO;wBACN,OAAO,EAAE,6CAA6C;wBACtD,KAAK,EAAE,OAAO;wBACd,OAAO,EAAE,KAAK;wBACd,eAAe,EAAE,KAAK;qBACtB,CAAC;gBACH,CAAC;gBACD,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBACtE,IAAI,CAAC,KAAK,EAAE,CAAC;oBACZ,OAAO;wBACN,OAAO,EAAE,4BAA4B,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,EAAE;wBACxE,KAAK,EAAE,OAAO;wBACd,OAAO,EAAE,KAAK;wBACd,eAAe,EAAE,KAAK;qBACtB,CAAC;gBACH,CAAC;gBACD,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;gBAClC,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;gBAChC,OAAO;oBACN,OAAO,EAAE,2BAA2B,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,EAAE;oBACvE,KAAK,EAAE,MAAM;oBACb,OAAO,EAAE,IAAI;oBACb,eAAe,EAAE,KAAK;iBACtB,CAAC;YACH,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBACjB,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBACxC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC3B,OAAO;wBACN,OAAO,EAAE,+CAA+C;wBACxD,KAAK,EAAE,OAAO;wBACd,OAAO,EAAE,KAAK;wBACd,eAAe,EAAE,KAAK;qBACtB,CAAC;gBACH,CAAC;gBACD,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;gBACzB,OAAO;oBACN,OAAO,EAAE,8BAA8B,OAAO,EAAE;oBAChD,KAAK,EAAE,MAAM;oBACb,OAAO,EAAE,IAAI;oBACb,eAAe,EAAE,KAAK;iBACtB,CAAC;YACH,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACd,MAAM,cAAc,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;gBAClD,IAAI,CAAC,cAAc,EAAE,CAAC;oBACrB,OAAO;wBACN,OAAO,EAAE,4CAA4C;wBACrD,KAAK,EAAE,OAAO;wBACd,OAAO,EAAE,KAAK;wBACd,eAAe,EAAE,KAAK;qBACtB,CAAC;gBACH,CAAC;gBACD,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC;gBACvC,OAAO;oBACN,OAAO,EAAE,2BAA2B,cAAc,EAAE;oBACpD,KAAK,EAAE,MAAM;oBACb,OAAO,EAAE,IAAI;oBACb,eAAe,EAAE,KAAK;iBACtB,CAAC;YACH,CAAC;YACD;gBACC,OAAO;oBACN,OAAO,EACN,gHAAgH;oBACjH,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,KAAK;oBACd,eAAe,EAAE,KAAK;iBACtB,CAAC;QACJ,CAAC;IACF,CAAC;IAED,SAAS,cAAc,CAAC,GAAiB;QACxC,MAAM,WAAW,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,GAAG,CAAC,cAAc,CAAC,CAAC,GAAG,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC;YAC1C,GAAG,CAAC,cAAc,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC;QACtE,CAAC;IACF,CAAC;IAED,SAAS,YAAY,CAAC,GAAqB;QAC1C,IAAI,CAAC,GAAG,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrB,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;YAC1C,OAAO;QACR,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;QACzD,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,WAAW,SAAS,EAAE,CAAC,CAAC,CAAC;IAC/G,CAAC;IAED,SAAS,YAAY,CAAC,GAAqB;QAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;QACvD,OAAO;YACN,cAAc,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE;YACvD,UAAU,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,YAAY,GAAG;YAC/D,SAAS,QAAQ,IAAI,MAAM,CAAC,OAAO,EAAE;YACrC,UAAU,MAAM,CAAC,cAAc,EAAE;SACjC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACf,CAAC;AACF,CAAC;AAED,MAAM,qBAAqB,GAAG;;;;;;;;;;4DAU8B,CAAC;AAE7D,SAAS,aAAa;IACrB,MAAM,MAAM,GAAG,cAAc,CAAC,qBAAqB,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACzG,OAAO;QACN,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,gBAAgB;QACzB,cAAc,EAAE,uBAAuB;QACvC,SAAS,EAAE,kBAAkB;QAC7B,SAAS,EAAE,kBAAkB;KAC7B,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAqB,EAAE,QAAgB;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;IACzD,OAAO;QACN,wBAAwB;QACxB,6BAA6B,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,mCAAmC,SAAS,IAAI,MAAM,CAAC,OAAO,iCAAiC;QAC7J,gKAAgK;QAChK,+BAA+B,MAAM,CAAC,cAAc,0CAA0C;KAC9F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,SAAS,4BAA4B,CAAC,GAAqB;IAC1D,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;IAC9C,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,YAAY,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1D,OAAO,qBAAqB,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAwB,EAAE,gBAAwB;IACjF,OAAO;QACN,sBAAsB;QACtB,MAAM,CAAC,QAAQ;QACf,EAAE;QACF,uBAAuB;QACvB,MAAM,CAAC,KAAK,IAAI,OAAO;QACvB,EAAE;QACF,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,4BAA4B;QAC5B,gBAAgB;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,OAA+C;IACnE,OAAO,OAAO;SACZ,MAAM,CAAC,CAAC,IAAI,EAA0C,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;SAC/G,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;AACV,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAqB,EAAE,QAAgB,EAAE,MAAwB;IAC/F,OAAO;QACN,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,sFAAsF,MAAM,CAAC,QAAQ,EAAE;aAC7G;SACD;QACD,OAAO,EAAE,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC;KACrD,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAqB,EAAE,QAAgB,EAAE,MAAwB;IAC5F,OAAO;QACN,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,6FAA6F,MAAM,CAAC,QAAQ,EAAE;aACpH;SACD;QACD,OAAO,EAAE,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC;KACrD,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAqB,EAAE,QAAgB,EAAE,MAAwB;IAC5F,OAAO;QACN,OAAO,EAAE;YACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,OAAO;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,OAAO;YAC9B,QAAQ;YACR,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,SAAS;SACrB;QACD,KAAK,EAAE,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC;KACvC,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,MAAqB,EAAE,QAAgB;IAC9D,OAAO;QACN,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE;QACrB,QAAQ;QACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACnC,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,EAAgB,EAAE,MAAqB,EAAE,QAAgB;IAC9E,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,eAAe,CAAC,KAA6B,EAAE,QAAuB;IAC9E,OAAO;QACN,OAAO,EAAE,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO;QAC9E,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ;QACnG,OAAO,EAAE,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO;QAC9F,OAAO,EAAE,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO;QAC9G,cAAc,EAAE,mBAAmB,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,QAAQ,CAAC,cAAc;QACpF,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS;QACxH,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS;KACxH,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACpC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/D,OAAO;QACN,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QAC/B,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;KAC/B,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9D,OAAO,MAAM,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC5E,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "advisor-pi",
+  "version": "1.0.0",
+  "description": "Advisor-style strategic model guidance for Pi Coding Agent workflows",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "pi": {
+    "extensions": ["./src/index.ts"]
+  },
+  "keywords": [
+    "pi",
+    "advisor",
+    "strategic-guidance",
+    "model-delegation",
+    "agent-workflows"
+  ],
+  "author": "pi-extensions contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/luongnv89/pi-extensions.git"
+  },
+  "bugs": {
+    "url": "https://github.com/luongnv89/pi-extensions/issues"
+  },
+  "homepage": "https://github.com/luongnv89/pi-extensions/tree/main/extensions/advisor-pi",
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": "^0.75.4",
+    "@earendil-works/pi-ai": "^0.75.4",
+    "@earendil-works/pi-coding-agent": "^0.75.4",
+    "typebox": "^1.0.55"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,577 @@
+import { complete, StringEnum, type CacheRetention, type Message, type Usage } from "@earendil-works/pi-ai";
+import {
+	buildSessionContext,
+	convertToLlm,
+	serializeConversation,
+	type ExtensionAPI,
+	type ExtensionContext,
+} from "@earendil-works/pi-coding-agent";
+import { Type, type Static } from "typebox";
+
+const STATE_ENTRY = "advisor-pi-state";
+const TOOL_NAME = "advisor";
+const DEFAULT_ADVISOR_MODEL = "openai-codex/gpt-5.5";
+const DEFAULT_MAX_USES = 3;
+const DEFAULT_CACHE_RETENTION: CacheRetention = "short";
+const DEFAULT_TIMEOUT_MS = 600_000;
+const DEFAULT_MAX_TOKENS = 4_000;
+
+const advisorToolSchema = Type.Object({
+	question: Type.String({
+		description:
+			"Strategic question for the advisor. Ask for planning, risk analysis, course correction, or review guidance.",
+	}),
+	phase: Type.Optional(
+		StringEnum(["planning", "course_correction", "review", "stuck", "other"] as const, {
+			description: "Why the executor is consulting the advisor.",
+			default: "other",
+		}),
+	),
+	context: Type.Optional(
+		Type.String({
+			description:
+				"Optional extra context that is not obvious from the transcript, such as constraints, current plan, or failed attempts.",
+		}),
+	),
+});
+
+type AdvisorToolInput = Static<typeof advisorToolSchema>;
+
+type AdvisorConfig = {
+	enabled: boolean;
+	provider: string;
+	modelId: string;
+	maxUses: number;
+	cacheRetention: CacheRetention;
+	maxTokens: number;
+	timeoutMs: number;
+};
+
+type AdvisorStateEntry = {
+	version: 1;
+	config: AdvisorConfig;
+	useCount: number;
+	updatedAt: string;
+};
+
+type AdvisorToolDetails = {
+	advisor: {
+		provider: string;
+		model: string;
+		phase: string;
+		useCount: number;
+		maxUses: number;
+		cacheRetention: CacheRetention;
+		elapsedMs: number;
+		stopReason: string;
+		usage?: Usage;
+	};
+	state: AdvisorStateEntry;
+};
+
+export default function advisorPiExtension(pi: ExtensionAPI) {
+	let config = defaultConfig();
+	let useCount = 0;
+
+	pi.registerFlag("advisor-model", {
+		description: "Advisor model as provider/model, e.g. openai-codex/gpt-5.5",
+		type: "string",
+	});
+	pi.registerFlag("advisor-max-uses", {
+		description: "Maximum advisor calls per session branch",
+		type: "string",
+	});
+	pi.registerFlag("advisor-cache", {
+		description: "Advisor prompt-cache preference: none, short, or long",
+		type: "string",
+	});
+	pi.registerFlag("advisor-enabled", {
+		description: "Enable the advisor tool on startup",
+		type: "boolean",
+		default: true,
+	});
+
+	pi.registerTool<typeof advisorToolSchema, AdvisorToolDetails>({
+		name: TOOL_NAME,
+		label: "Advisor",
+		description:
+			"Consult a configured higher-capability advisor model for strategic guidance during complex agent tasks. The advisor reads the current conversation transcript and returns planning, risk, or course-correction advice. It has no tools and does not modify files.",
+		promptSnippet:
+			"Consult a higher-capability advisor model for strategic planning, risk checks, and course correction on complex tasks.",
+		promptGuidelines: [
+			"Use advisor before starting a complex, multi-step, or high-risk task when strategic planning would reduce mistakes.",
+			"Use advisor when stuck, when tests keep failing, or when choosing between competing implementation approaches.",
+			"Do not use advisor for simple lookups, trivial edits, or when the user explicitly wants the fastest possible answer.",
+		],
+		parameters: advisorToolSchema,
+		executionMode: "sequential",
+		async execute(_toolCallId, params, signal, onUpdate, ctx) {
+			refreshStateFromBranch(ctx);
+
+			if (!config.enabled) {
+				return advisorDisabledResult(config, useCount, params);
+			}
+
+			if (useCount >= config.maxUses) {
+				return advisorLimitResult(config, useCount, params);
+			}
+
+			const model = ctx.modelRegistry.find(config.provider, config.modelId);
+			if (!model) {
+				throw new Error(
+					`Advisor model not found: ${config.provider}/${config.modelId}. Run /advisor-pi model <provider>/<model>.`,
+				);
+			}
+
+			onUpdate?.({
+				content: [
+					{
+						type: "text",
+						text: `Consulting advisor ${config.provider}/${config.modelId}...`,
+					},
+				],
+				details: makeSkippedDetails(config, useCount, params),
+			});
+
+			const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
+			if (!auth.ok) throw new Error(auth.error);
+
+			const startedAt = Date.now();
+			const conversationText = serializeCurrentConversation(ctx);
+			const userMessage: Message = {
+				role: "user",
+				content: [
+					{
+						type: "text",
+						text: buildAdvisorUserPrompt(params, conversationText),
+					},
+				],
+				timestamp: Date.now(),
+			};
+
+			const response = await complete(
+				model,
+				{
+					systemPrompt: ADVISOR_SYSTEM_PROMPT,
+					messages: [userMessage],
+				},
+				{
+					apiKey: auth.apiKey,
+					headers: auth.headers,
+					signal,
+					cacheRetention: config.cacheRetention,
+					sessionId: `advisor-pi:${ctx.sessionManager.getSessionId()}`,
+					maxTokens: config.maxTokens,
+					timeoutMs: config.timeoutMs,
+				},
+			);
+
+			if (response.stopReason === "error") {
+				throw new Error(response.errorMessage ?? "Advisor model returned an error");
+			}
+			if (response.stopReason === "aborted") {
+				throw new Error("Advisor call aborted");
+			}
+
+			useCount += 1;
+			persistState(pi, config, useCount);
+			updateStatus(ctx);
+
+			const elapsedMs = Date.now() - startedAt;
+			const text = extractText(response.content) || "Advisor returned no text guidance.";
+			const details: AdvisorToolDetails = {
+				advisor: {
+					provider: response.provider,
+					model: response.model,
+					phase: params.phase ?? "other",
+					useCount,
+					maxUses: config.maxUses,
+					cacheRetention: config.cacheRetention,
+					elapsedMs,
+					stopReason: response.stopReason,
+					usage: response.usage,
+				},
+				state: makeStateEntry(config, useCount),
+			};
+
+			return {
+				content: [
+					{
+						type: "text",
+						text: `Advisor guidance (${useCount}/${config.maxUses}, ${config.provider}/${config.modelId}):\n\n${text}`,
+					},
+				],
+				details,
+			};
+		},
+	});
+
+	pi.registerCommand("advisor-pi", {
+		description: "Configure advisor-pi: status, enable, disable, model, max-uses, cache, reset",
+		handler: async (args, ctx) => {
+			const result = handleCommand(args.trim(), ctx);
+			if (result.persist) persistState(pi, config, useCount);
+			if (result.updateToolState) syncActiveTool(pi);
+			updateStatus(ctx);
+			ctx.ui.notify(result.message, result.level);
+		},
+	});
+
+	pi.on("session_start", async (_event, ctx) => {
+		refreshStateFromBranch(ctx);
+	});
+
+	pi.on("session_tree", async (_event, ctx) => {
+		refreshStateFromBranch(ctx);
+	});
+
+	pi.on("before_agent_start", async (event) => {
+		if (!config.enabled) return;
+		return {
+			systemPrompt: `${event.systemPrompt}\n\n${buildExecutorGuidance(config, useCount)}`,
+		};
+	});
+
+	pi.on("turn_start", async () => {
+		persistState(pi, config, useCount);
+	});
+
+	function refreshStateFromBranch(ctx: ExtensionContext): void {
+		config = defaultConfig();
+		useCount = 0;
+		const restoredFromBranch = restoreStateFromSession(ctx);
+		if (!restoredFromBranch) applyStartupFlags(pi);
+		syncActiveTool(pi);
+		updateStatus(ctx);
+	}
+
+	function restoreStateFromSession(ctx: ExtensionContext): boolean {
+		let restored = false;
+		const branch = ctx.sessionManager.getBranch();
+		for (const entry of branch) {
+			if (entry.type === "custom" && entry.customType === STATE_ENTRY) {
+				restored = true;
+				const data = entry.data as Partial<AdvisorStateEntry> | undefined;
+				if (data?.config) config = normalizeConfig(data.config, config);
+				if (typeof data?.useCount === "number") useCount = Math.max(0, data.useCount);
+			}
+			if (entry.type === "message" && entry.message.role === "toolResult" && entry.message.toolName === TOOL_NAME) {
+				restored = true;
+				const details = entry.message.details as Partial<AdvisorToolDetails> | undefined;
+				if (details?.state?.config) config = normalizeConfig(details.state.config, config);
+				if (typeof details?.state?.useCount === "number") useCount = Math.max(useCount, details.state.useCount);
+				else if (details?.advisor?.useCount) useCount = Math.max(useCount, details.advisor.useCount);
+			}
+		}
+		return restored;
+	}
+
+	function applyStartupFlags(api: ExtensionAPI): void {
+		const enabledFlag = api.getFlag("advisor-enabled");
+		if (typeof enabledFlag === "boolean") config.enabled = enabledFlag;
+
+		const modelFlag = api.getFlag("advisor-model");
+		if (typeof modelFlag === "string" && modelFlag.trim()) {
+			const parsed = parseModelSpec(modelFlag.trim());
+			if (parsed) {
+				config.provider = parsed.provider;
+				config.modelId = parsed.modelId;
+			}
+		}
+
+		const maxUsesFlag = api.getFlag("advisor-max-uses");
+		if (typeof maxUsesFlag === "string") {
+			const maxUses = parsePositiveInt(maxUsesFlag);
+			if (maxUses !== undefined) config.maxUses = maxUses;
+		}
+
+		const cacheFlag = api.getFlag("advisor-cache");
+		if (typeof cacheFlag === "string") {
+			const cacheRetention = parseCacheRetention(cacheFlag);
+			if (cacheRetention) config.cacheRetention = cacheRetention;
+		}
+	}
+
+	function handleCommand(
+		args: string,
+		ctx: ExtensionContext,
+	): { message: string; level: "info" | "warning" | "error"; persist: boolean; updateToolState: boolean } {
+		if (!args || args === "status") {
+			return {
+				message: formatStatus(ctx),
+				level: "info",
+				persist: false,
+				updateToolState: false,
+			};
+		}
+
+		const [command, ...rest] = args.split(/\s+/);
+		const value = rest.join(" ").trim();
+
+		switch (command) {
+			case "enable":
+				config.enabled = true;
+				return { message: "advisor-pi enabled", level: "info", persist: true, updateToolState: true };
+			case "disable":
+				config.enabled = false;
+				return { message: "advisor-pi disabled", level: "info", persist: true, updateToolState: true };
+			case "reset":
+				useCount = 0;
+				return { message: "advisor-pi use count reset", level: "info", persist: true, updateToolState: false };
+			case "model": {
+				const parsed = parseModelSpec(value);
+				if (!parsed) {
+					return {
+						message: "Usage: /advisor-pi model <provider>/<model>",
+						level: "error",
+						persist: false,
+						updateToolState: false,
+					};
+				}
+				const model = ctx.modelRegistry.find(parsed.provider, parsed.modelId);
+				if (!model) {
+					return {
+						message: `Advisor model not found: ${parsed.provider}/${parsed.modelId}`,
+						level: "error",
+						persist: false,
+						updateToolState: false,
+					};
+				}
+				config.provider = parsed.provider;
+				config.modelId = parsed.modelId;
+				return {
+					message: `advisor-pi model set to ${config.provider}/${config.modelId}`,
+					level: "info",
+					persist: true,
+					updateToolState: false,
+				};
+			}
+			case "max-uses": {
+				const maxUses = parsePositiveInt(value);
+				if (maxUses === undefined) {
+					return {
+						message: "Usage: /advisor-pi max-uses <positive-number>",
+						level: "error",
+						persist: false,
+						updateToolState: false,
+					};
+				}
+				config.maxUses = maxUses;
+				return {
+					message: `advisor-pi max uses set to ${maxUses}`,
+					level: "info",
+					persist: true,
+					updateToolState: false,
+				};
+			}
+			case "cache": {
+				const cacheRetention = parseCacheRetention(value);
+				if (!cacheRetention) {
+					return {
+						message: "Usage: /advisor-pi cache <none|short|long>",
+						level: "error",
+						persist: false,
+						updateToolState: false,
+					};
+				}
+				config.cacheRetention = cacheRetention;
+				return {
+					message: `advisor-pi cache set to ${cacheRetention}`,
+					level: "info",
+					persist: true,
+					updateToolState: false,
+				};
+			}
+			default:
+				return {
+					message:
+						"Usage: /advisor-pi [status|enable|disable|model <provider>/<model>|max-uses <n>|cache <none|short|long>|reset]",
+					level: "error",
+					persist: false,
+					updateToolState: false,
+				};
+		}
+	}
+
+	function syncActiveTool(api: ExtensionAPI): void {
+		const activeTools = api.getActiveTools();
+		const hasAdvisor = activeTools.includes(TOOL_NAME);
+		if (config.enabled && !hasAdvisor) {
+			api.setActiveTools([...activeTools, TOOL_NAME]);
+		} else if (!config.enabled && hasAdvisor) {
+			api.setActiveTools(activeTools.filter((tool) => tool !== TOOL_NAME));
+		}
+	}
+
+	function updateStatus(ctx: ExtensionContext): void {
+		if (!ctx.hasUI) return;
+		if (!config.enabled) {
+			ctx.ui.setStatus("advisor-pi", undefined);
+			return;
+		}
+		const remaining = Math.max(0, config.maxUses - useCount);
+		ctx.ui.setStatus("advisor-pi", ctx.ui.theme.fg(remaining > 0 ? "accent" : "warning", `advisor:${remaining}`));
+	}
+
+	function formatStatus(ctx: ExtensionContext): string {
+		const model = ctx.modelRegistry.find(config.provider, config.modelId);
+		const availability = model ? "available" : "not found";
+		return [
+			`advisor-pi ${config.enabled ? "enabled" : "disabled"}`,
+			`model: ${config.provider}/${config.modelId} (${availability})`,
+			`uses: ${useCount}/${config.maxUses}`,
+			`cache: ${config.cacheRetention}`,
+		].join(" • ");
+	}
+}
+
+const ADVISOR_SYSTEM_PROMPT = `You are an advisor model for Pi Coding Agent.
+
+Your role is strategic guidance only. You do not have tools and you do not make changes. Given the executor's question and conversation transcript:
+
+- Identify the best next plan or course correction.
+- Call out risks, missing information, edge cases, and test strategy.
+- Prefer concise, actionable guidance the executor can apply immediately.
+- Do not restate the full transcript.
+- If the task is unsafe, impossible, or underspecified, say what must be clarified.
+
+Return guidance in short sections with bullets when useful.`;
+
+function defaultConfig(): AdvisorConfig {
+	const parsed = parseModelSpec(DEFAULT_ADVISOR_MODEL) ?? { provider: "openai-codex", modelId: "gpt-5.5" };
+	return {
+		enabled: true,
+		provider: parsed.provider,
+		modelId: parsed.modelId,
+		maxUses: DEFAULT_MAX_USES,
+		cacheRetention: DEFAULT_CACHE_RETENTION,
+		maxTokens: DEFAULT_MAX_TOKENS,
+		timeoutMs: DEFAULT_TIMEOUT_MS,
+	};
+}
+
+function buildExecutorGuidance(config: AdvisorConfig, useCount: number): string {
+	const remaining = Math.max(0, config.maxUses - useCount);
+	return [
+		"Advisor-pi is enabled.",
+		`The advisor tool consults ${config.provider}/${config.modelId} for strategic guidance and has ${remaining}/${config.maxUses} uses remaining on this branch.`,
+		"Use advisor for complex planning, risky implementation choices, repeated failures, or course correction. Do not use advisor for trivial edits or simple facts.",
+		`Advisor cache preference is ${config.cacheRetention}; caching support is provider-dependent.`,
+	].join("\n");
+}
+
+function serializeCurrentConversation(ctx: ExtensionContext): string {
+	const entries = ctx.sessionManager.getEntries();
+	const leafId = ctx.sessionManager.getLeafId();
+	const sessionContext = buildSessionContext(entries, leafId);
+	const llmMessages = convertToLlm(sessionContext.messages);
+	return serializeConversation(llmMessages);
+}
+
+function buildAdvisorUserPrompt(params: AdvisorToolInput, conversationText: string): string {
+	return [
+		"## Executor Question",
+		params.question,
+		"",
+		"## Consultation Phase",
+		params.phase ?? "other",
+		"",
+		...(params.context ? ["## Extra Context", params.context, ""] : []),
+		"## Conversation Transcript",
+		conversationText,
+	].join("\n");
+}
+
+function extractText(content: Array<{ type: string; text?: string }>): string {
+	return content
+		.filter((part): part is { type: "text"; text: string } => part.type === "text" && typeof part.text === "string")
+		.map((part) => part.text)
+		.join("\n")
+		.trim();
+}
+
+function advisorDisabledResult(config: AdvisorConfig, useCount: number, params: AdvisorToolInput) {
+	return {
+		content: [
+			{
+				type: "text" as const,
+				text: `advisor-pi is disabled. The executor should continue without advisor guidance for: ${params.question}`,
+			},
+		],
+		details: makeSkippedDetails(config, useCount, params),
+	};
+}
+
+function advisorLimitResult(config: AdvisorConfig, useCount: number, params: AdvisorToolInput) {
+	return {
+		content: [
+			{
+				type: "text" as const,
+				text: `Advisor use limit reached. The executor should continue without another advisor call for: ${params.question}`,
+			},
+		],
+		details: makeSkippedDetails(config, useCount, params),
+	};
+}
+
+function makeSkippedDetails(config: AdvisorConfig, useCount: number, params: AdvisorToolInput): AdvisorToolDetails {
+	return {
+		advisor: {
+			provider: config.provider,
+			model: config.modelId,
+			phase: params.phase ?? "other",
+			useCount,
+			maxUses: config.maxUses,
+			cacheRetention: config.cacheRetention,
+			elapsedMs: 0,
+			stopReason: "skipped",
+		},
+		state: makeStateEntry(config, useCount),
+	};
+}
+
+function makeStateEntry(config: AdvisorConfig, useCount: number): AdvisorStateEntry {
+	return {
+		version: 1,
+		config: { ...config },
+		useCount,
+		updatedAt: new Date().toISOString(),
+	};
+}
+
+function persistState(pi: ExtensionAPI, config: AdvisorConfig, useCount: number): void {
+	pi.appendEntry(STATE_ENTRY, makeStateEntry(config, useCount));
+}
+
+function normalizeConfig(input: Partial<AdvisorConfig>, fallback: AdvisorConfig): AdvisorConfig {
+	return {
+		enabled: typeof input.enabled === "boolean" ? input.enabled : fallback.enabled,
+		provider: typeof input.provider === "string" && input.provider ? input.provider : fallback.provider,
+		modelId: typeof input.modelId === "string" && input.modelId ? input.modelId : fallback.modelId,
+		maxUses: typeof input.maxUses === "number" && input.maxUses > 0 ? Math.floor(input.maxUses) : fallback.maxUses,
+		cacheRetention: parseCacheRetention(input.cacheRetention) ?? fallback.cacheRetention,
+		maxTokens: typeof input.maxTokens === "number" && input.maxTokens > 0 ? Math.floor(input.maxTokens) : fallback.maxTokens,
+		timeoutMs: typeof input.timeoutMs === "number" && input.timeoutMs > 0 ? Math.floor(input.timeoutMs) : fallback.timeoutMs,
+	};
+}
+
+function parseModelSpec(value: string): { provider: string; modelId: string } | undefined {
+	const slash = value.indexOf("/");
+	if (slash <= 0 || slash === value.length - 1) return undefined;
+	return {
+		provider: value.slice(0, slash),
+		modelId: value.slice(slash + 1),
+	};
+}
+
+function parsePositiveInt(value: string): number | undefined {
+	const parsed = Number.parseInt(value, 10);
+	if (!Number.isFinite(parsed) || parsed <= 0) return undefined;
+	return parsed;
+}
+
+function parseCacheRetention(value: unknown): CacheRetention | undefined {
+	if (value === "none" || value === "short" || value === "long") return value;
+	return undefined;
+}
+