pi-kot 0.1.38 → 0.1.39

package/dist/client/index.html

@@ -8,17 +8,17 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Noto+Sans+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" />
-    <script type="module" crossorigin src="/assets/index-DsAokEBF.js"></script>
+    <script type="module" crossorigin src="/assets/index-BH5vWV2p.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-QTnfLwEv.js">
-    <link rel="modulepreload" crossorigin href="/assets/vendor-icons-B8pSAnO8.js">
-    <link rel="modulepreload" crossorigin href="/assets/vendor-prism-ChBCet0U.js">
+    <link rel="modulepreload" crossorigin href="/assets/vendor-icons-xTgSApeH.js">
+    <link rel="modulepreload" crossorigin href="/assets/vendor-prism-tzddbd4Y.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-katex-4z5K3dyr.js">
-    <link rel="modulepreload" crossorigin href="/assets/vendor-markdown-BHwes4Q7.js">
+    <link rel="modulepreload" crossorigin href="/assets/vendor-markdown-DUXj0nma.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-codemirror-BB16Y9B-.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-xterm-DXwh06H3.js">
     <link rel="stylesheet" crossorigin href="/assets/vendor-katex-CYlHEDRF.css">
     <link rel="stylesheet" crossorigin href="/assets/vendor-xterm-BrP-ENHg.css">
-    <link rel="stylesheet" crossorigin href="/assets/index-DczdsIBb.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-B959AkDe.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/server/ask-user-question/plan-review-registry.d.ts

@@ -0,0 +1,49 @@
+export interface PendingPlanReview {
+    requestId: string;
+    sessionId: string;
+    planFilePath: string;
+    planContent: string;
+    cwd: string;
+    createdAt: Date;
+}
+export interface PlanReviewDecision {
+    approved: boolean;
+    feedback?: string;
+    updatedContent?: string;
+}
+export interface PlanReviewToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    details: Record<string, unknown>;
+}
+export type PlanReviewEvent = {
+    type: "plan_review_requested";
+    sessionId: string;
+    requestId: string;
+    planFilePath: string;
+    planContent: string;
+} | {
+    type: "plan_review_resolved";
+    sessionId: string;
+    requestId: string;
+    approved: boolean;
+    reason: "answered" | "cancelled" | "aborted" | "superseded";
+};
+type Listener = (event: PlanReviewEvent) => void;
+export declare function subscribePlanReview(fn: Listener): () => void;
+export declare function registerPendingPlanReview(args: {
+    sessionId: string;
+    planFilePath: string;
+    planContent: string;
+    cwd: string;
+    signal?: AbortSignal;
+}): {
+    requestId: string;
+    result: Promise<PlanReviewToolResult>;
+};
+export declare function resolvePendingPlanReview(requestId: string, expectedSessionId: string, decision: PlanReviewDecision): Promise<boolean>;
+export declare function getPendingPlanReviewsForSession(sessionId: string): PendingPlanReview[];
+export {};
+//# sourceMappingURL=plan-review-registry.d.ts.map

package/dist/server/ask-user-question/plan-review-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-review-registry.d.ts","sourceRoot":"","sources":["../../src/ask-user-question/plan-review-registry.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;CAC7D,CAAC;AASN,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAGjD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,IAAI,CAG5D;AAYD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAAE,CAwE/D;AASD,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAkElB;AAED,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAetF"}

package/dist/server/ask-user-question/plan-review-registry.js

@@ -0,0 +1,179 @@
+import { randomUUID } from "node:crypto";
+import { resolve } from "node:path";
+import { writeFile } from "node:fs/promises";
+const byRequestId = new Map();
+const bySessionId = new Map();
+const listeners = new Set();
+export function subscribePlanReview(fn) {
+    listeners.add(fn);
+    return () => listeners.delete(fn);
+}
+function notify(event) {
+    for (const fn of listeners) {
+        try {
+            fn(event);
+        }
+        catch {
+            // best-effort
+        }
+    }
+}
+export function registerPendingPlanReview(args) {
+    const requestId = randomUUID();
+    // If there is already a pending review for this session, supersede it
+    const existingId = bySessionId.get(args.sessionId);
+    if (existingId !== undefined) {
+        const existing = byRequestId.get(existingId);
+        if (existing !== undefined) {
+            byRequestId.delete(existingId);
+            bySessionId.delete(args.sessionId);
+            existing.resolve({
+                content: [{ type: "text", text: "Replaced by a new plan review submission." }],
+                details: { approved: false, cancelled: true, error: "superseded" },
+            });
+            notify({
+                type: "plan_review_resolved",
+                sessionId: args.sessionId,
+                requestId: existingId,
+                approved: false,
+                reason: "superseded",
+            });
+        }
+    }
+    let resolveFn;
+    const result = new Promise((resolve) => {
+        resolveFn = resolve;
+    });
+    const entry = {
+        requestId,
+        sessionId: args.sessionId,
+        planFilePath: args.planFilePath,
+        planContent: args.planContent,
+        cwd: args.cwd,
+        createdAt: new Date(),
+        resolve: resolveFn,
+    };
+    byRequestId.set(requestId, entry);
+    bySessionId.set(args.sessionId, requestId);
+    if (args.signal !== undefined) {
+        const onAbort = () => {
+            if (byRequestId.has(requestId)) {
+                removeEntry(requestId);
+                notify({
+                    type: "plan_review_resolved",
+                    sessionId: args.sessionId,
+                    requestId,
+                    approved: false,
+                    reason: "aborted",
+                });
+                resolveFn({
+                    content: [{ type: "text", text: "The plan review was cancelled or the agent was aborted." }],
+                    details: { approved: false, cancelled: true, error: "aborted" },
+                });
+            }
+        };
+        if (args.signal.aborted)
+            onAbort();
+        else
+            args.signal.addEventListener("abort", onAbort, { once: true });
+    }
+    notify({
+        type: "plan_review_requested",
+        sessionId: args.sessionId,
+        requestId,
+        planFilePath: args.planFilePath,
+        planContent: args.planContent,
+    });
+    return { requestId, result };
+}
+function removeEntry(requestId) {
+    const e = byRequestId.get(requestId);
+    if (e === undefined)
+        return;
+    byRequestId.delete(requestId);
+    bySessionId.delete(e.sessionId);
+}
+export async function resolvePendingPlanReview(requestId, expectedSessionId, decision) {
+    const e = byRequestId.get(requestId);
+    if (e === undefined)
+        return false;
+    if (e.sessionId !== expectedSessionId)
+        return false;
+    removeEntry(requestId);
+    // If the user edited the plan directly before deciding, save changes to disk
+    if (typeof decision.updatedContent === "string" && decision.updatedContent.length > 0) {
+        try {
+            const fullPath = resolve(e.cwd, e.planFilePath);
+            await writeFile(fullPath, decision.updatedContent, "utf-8");
+        }
+        catch (err) {
+            console.error(`Failed to save updated plan to ${e.planFilePath}:`, err);
+        }
+    }
+    notify({
+        type: "plan_review_resolved",
+        sessionId: e.sessionId,
+        requestId,
+        approved: decision.approved,
+        reason: "answered",
+    });
+    const doneMsg = "After completing each step, include [DONE:n] in your response where n is the step number.";
+    const feedback = decision.feedback?.trim();
+    if (decision.approved) {
+        if (feedback) {
+            e.resolve({
+                content: [
+                    {
+                        type: "text",
+                        text: `Plan approved with notes! You now have full tool access (read, bash, edit, write). Execute the plan in ${e.planFilePath}. ${doneMsg}\n\n## Implementation Notes\n\nThe user approved your plan but added the following notes to consider during implementation:\n\n${feedback}\n\nProceed with implementation, incorporating these notes where applicable.`,
+                    },
+                ],
+                details: { approved: true, feedback },
+            });
+        }
+        else {
+            e.resolve({
+                content: [
+                    {
+                        type: "text",
+                        text: `Plan approved. You now have full tool access (read, bash, edit, write). Execute the plan in ${e.planFilePath}. ${doneMsg}`,
+                    },
+                ],
+                details: { approved: true },
+            });
+        }
+    }
+    else {
+        const feedbackText = feedback ||
+            "The user requested revisions to this plan. Please review your draft, address any questions, and update the plan file before resubmitting.";
+        e.resolve({
+            content: [
+                {
+                    type: "text",
+                    text: `YOUR PLAN WAS NOT APPROVED.\n\nYou MUST revise the plan to address ALL of the feedback below before calling submit_plan again.\n\nRules:\n- Your plan is saved at: ${e.planFilePath}\n  You can edit this file to make targeted changes, then pass its path to submit_plan.\n- Do not resubmit the same plan unchanged.\n- Do NOT change the plan title (first # heading) unless the user explicitly asks you to.\n\n${feedbackText}`,
+                },
+            ],
+            details: { approved: false, feedback: feedbackText },
+        });
+    }
+    return true;
+}
+export function getPendingPlanReviewsForSession(sessionId) {
+    const id = bySessionId.get(sessionId);
+    if (id === undefined)
+        return [];
+    const e = byRequestId.get(id);
+    if (e === undefined)
+        return [];
+    return [
+        {
+            requestId: e.requestId,
+            sessionId: e.sessionId,
+            planFilePath: e.planFilePath,
+            planContent: e.planContent,
+            cwd: e.cwd,
+            createdAt: e.createdAt,
+        },
+    ];
+}
+//# sourceMappingURL=plan-review-registry.js.map

package/dist/server/ask-user-question/plan-review-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-review-registry.js","sourceRoot":"","sources":["../../src/ask-user-question/plan-review-registry.ts"],"names":[],"mappings":"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"}

package/dist/server/ask-user-question/plannotator-registry.d.ts

@@ -0,0 +1,49 @@
+export interface PendingPlanReview {
+    requestId: string;
+    sessionId: string;
+    planFilePath: string;
+    planContent: string;
+    cwd: string;
+    createdAt: Date;
+}
+export interface PlanReviewDecision {
+    approved: boolean;
+    feedback?: string;
+    updatedContent?: string;
+}
+export interface PlanReviewToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    details: Record<string, unknown>;
+}
+export type PlanReviewEvent = {
+    type: "plannotator_plan_review_requested";
+    sessionId: string;
+    requestId: string;
+    planFilePath: string;
+    planContent: string;
+} | {
+    type: "plannotator_plan_review_resolved";
+    sessionId: string;
+    requestId: string;
+    approved: boolean;
+    reason: "answered" | "cancelled" | "aborted" | "superseded";
+};
+type Listener = (event: PlanReviewEvent) => void;
+export declare function subscribePlanReview(fn: Listener): () => void;
+export declare function registerPendingPlanReview(args: {
+    sessionId: string;
+    planFilePath: string;
+    planContent: string;
+    cwd: string;
+    signal?: AbortSignal;
+}): {
+    requestId: string;
+    result: Promise<PlanReviewToolResult>;
+};
+export declare function resolvePendingPlanReview(requestId: string, expectedSessionId: string, decision: PlanReviewDecision): Promise<boolean>;
+export declare function getPendingPlanReviewsForSession(sessionId: string): PendingPlanReview[];
+export {};
+//# sourceMappingURL=plannotator-registry.d.ts.map

package/dist/server/ask-user-question/plannotator-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plannotator-registry.d.ts","sourceRoot":"","sources":["../../src/ask-user-question/plannotator-registry.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,mCAAmC,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,kCAAkC,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;CAC7D,CAAC;AASN,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAGjD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,IAAI,CAG5D;AAYD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAAE,CAwE/D;AASD,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAkElB;AAED,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAetF"}

package/dist/server/ask-user-question/plannotator-registry.js

@@ -0,0 +1,179 @@
+import { randomUUID } from "node:crypto";
+import { resolve } from "node:path";
+import { writeFile } from "node:fs/promises";
+const byRequestId = new Map();
+const bySessionId = new Map();
+const listeners = new Set();
+export function subscribePlanReview(fn) {
+    listeners.add(fn);
+    return () => listeners.delete(fn);
+}
+function notify(event) {
+    for (const fn of listeners) {
+        try {
+            fn(event);
+        }
+        catch {
+            // best-effort
+        }
+    }
+}
+export function registerPendingPlanReview(args) {
+    const requestId = randomUUID();
+    // If there is already a pending review for this session, supersede it
+    const existingId = bySessionId.get(args.sessionId);
+    if (existingId !== undefined) {
+        const existing = byRequestId.get(existingId);
+        if (existing !== undefined) {
+            byRequestId.delete(existingId);
+            bySessionId.delete(args.sessionId);
+            existing.resolve({
+                content: [{ type: "text", text: "Replaced by a new plan review submission." }],
+                details: { approved: false, cancelled: true, error: "superseded" },
+            });
+            notify({
+                type: "plannotator_plan_review_resolved",
+                sessionId: args.sessionId,
+                requestId: existingId,
+                approved: false,
+                reason: "superseded",
+            });
+        }
+    }
+    let resolveFn;
+    const result = new Promise((resolve) => {
+        resolveFn = resolve;
+    });
+    const entry = {
+        requestId,
+        sessionId: args.sessionId,
+        planFilePath: args.planFilePath,
+        planContent: args.planContent,
+        cwd: args.cwd,
+        createdAt: new Date(),
+        resolve: resolveFn,
+    };
+    byRequestId.set(requestId, entry);
+    bySessionId.set(args.sessionId, requestId);
+    if (args.signal !== undefined) {
+        const onAbort = () => {
+            if (byRequestId.has(requestId)) {
+                removeEntry(requestId);
+                notify({
+                    type: "plannotator_plan_review_resolved",
+                    sessionId: args.sessionId,
+                    requestId,
+                    approved: false,
+                    reason: "aborted",
+                });
+                resolveFn({
+                    content: [{ type: "text", text: "The plan review was cancelled or the agent was aborted." }],
+                    details: { approved: false, cancelled: true, error: "aborted" },
+                });
+            }
+        };
+        if (args.signal.aborted)
+            onAbort();
+        else
+            args.signal.addEventListener("abort", onAbort, { once: true });
+    }
+    notify({
+        type: "plannotator_plan_review_requested",
+        sessionId: args.sessionId,
+        requestId,
+        planFilePath: args.planFilePath,
+        planContent: args.planContent,
+    });
+    return { requestId, result };
+}
+function removeEntry(requestId) {
+    const e = byRequestId.get(requestId);
+    if (e === undefined)
+        return;
+    byRequestId.delete(requestId);
+    bySessionId.delete(e.sessionId);
+}
+export async function resolvePendingPlanReview(requestId, expectedSessionId, decision) {
+    const e = byRequestId.get(requestId);
+    if (e === undefined)
+        return false;
+    if (e.sessionId !== expectedSessionId)
+        return false;
+    removeEntry(requestId);
+    // If the user edited the plan directly before deciding, save changes to disk
+    if (typeof decision.updatedContent === "string" && decision.updatedContent.length > 0) {
+        try {
+            const fullPath = resolve(e.cwd, e.planFilePath);
+            await writeFile(fullPath, decision.updatedContent, "utf-8");
+        }
+        catch (err) {
+            console.error(`Failed to save updated plan to ${e.planFilePath}:`, err);
+        }
+    }
+    notify({
+        type: "plannotator_plan_review_resolved",
+        sessionId: e.sessionId,
+        requestId,
+        approved: decision.approved,
+        reason: "answered",
+    });
+    const doneMsg = "After completing each step, include [DONE:n] in your response where n is the step number.";
+    const feedback = decision.feedback?.trim();
+    if (decision.approved) {
+        if (feedback) {
+            e.resolve({
+                content: [
+                    {
+                        type: "text",
+                        text: `Plan approved with notes! You now have full tool access (read, bash, edit, write). Execute the plan in ${e.planFilePath}. ${doneMsg}\n\n## Implementation Notes\n\nThe user approved your plan but added the following notes to consider during implementation:\n\n${feedback}\n\nProceed with implementation, incorporating these notes where applicable.`,
+                    },
+                ],
+                details: { approved: true, feedback },
+            });
+        }
+        else {
+            e.resolve({
+                content: [
+                    {
+                        type: "text",
+                        text: `Plan approved. You now have full tool access (read, bash, edit, write). Execute the plan in ${e.planFilePath}. ${doneMsg}`,
+                    },
+                ],
+                details: { approved: true },
+            });
+        }
+    }
+    else {
+        const feedbackText = feedback ||
+            "The user requested revisions to this plan. Please review your draft, address any questions, and update the plan file before resubmitting.";
+        e.resolve({
+            content: [
+                {
+                    type: "text",
+                    text: `YOUR PLAN WAS NOT APPROVED.\n\nYou MUST revise the plan to address ALL of the feedback below before calling plannotator_submit_plan again.\n\nRules:\n- Your plan is saved at: ${e.planFilePath}\n  You can edit this file to make targeted changes, then pass its path to plannotator_submit_plan.\n- Do not resubmit the same plan unchanged.\n- Do NOT change the plan title (first # heading) unless the user explicitly asks you to.\n\n${feedbackText}`,
+                },
+            ],
+            details: { approved: false, feedback: feedbackText },
+        });
+    }
+    return true;
+}
+export function getPendingPlanReviewsForSession(sessionId) {
+    const id = bySessionId.get(sessionId);
+    if (id === undefined)
+        return [];
+    const e = byRequestId.get(id);
+    if (e === undefined)
+        return [];
+    return [
+        {
+            requestId: e.requestId,
+            sessionId: e.sessionId,
+            planFilePath: e.planFilePath,
+            planContent: e.planContent,
+            cwd: e.cwd,
+            createdAt: e.createdAt,
+        },
+    ];
+}
+//# sourceMappingURL=plannotator-registry.js.map

package/dist/server/ask-user-question/plannotator-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plannotator-registry.js","sourceRoot":"","sources":["../../src/ask-user-question/plannotator-registry.ts"],"names":[],"mappings":"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"}

package/dist/server/ask-user-question/plannotator-submit-plan-tool.d.ts

@@ -0,0 +1,6 @@
+import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
+export declare const PLANNOTATOR_SUBMIT_PLAN_TOOL_NAME = "plannotator_submit_plan";
+export declare const SUBMIT_PLAN_TOOL_NAME = "submit_plan";
+export declare function createSubmitPlanTool(sessionId: string, toolName?: string): ToolDefinition;
+export declare function createPlannotatorSubmitPlanTool(sessionId: string): ToolDefinition;
+//# sourceMappingURL=plannotator-submit-plan-tool.d.ts.map

package/dist/server/ask-user-question/plannotator-submit-plan-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plannotator-submit-plan-tool.d.ts","sourceRoot":"","sources":["../../src/ask-user-question/plannotator-submit-plan-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,eAAO,MAAM,iCAAiC,4BAA4B,CAAC;AAC3E,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AASnD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAwB,GAAG,cAAc,CAkHxG;AAED,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAEjF"}

package/dist/server/ask-user-question/plannotator-submit-plan-tool.js

@@ -0,0 +1,124 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { isAbsolute, normalize, relative, resolve } from "node:path";
+import { registerPendingPlanReview } from "./plannotator-registry.js";
+export const PLANNOTATOR_SUBMIT_PLAN_TOOL_NAME = "plannotator_submit_plan";
+export const SUBMIT_PLAN_TOOL_NAME = "submit_plan";
+function isPlanWritePathAllowed(filePath, cwd) {
+    if (!/\.(?:md|mdx)$/i.test(filePath))
+        return false;
+    const target = isAbsolute(filePath) ? normalize(filePath) : resolve(cwd, filePath);
+    const rel = relative(cwd, target);
+    return !rel.startsWith("..") && !isAbsolute(rel);
+}
+export function createSubmitPlanTool(sessionId, toolName = SUBMIT_PLAN_TOOL_NAME) {
+    return {
+        name: toolName,
+        label: "Submit Plan",
+        description: "Submit your implementation plan for user review. " +
+            "Call this after drafting your plan as a markdown file anywhere inside the working directory. " +
+            "Pass the path to the plan file (e.g. PLAN.md or plans/auth.md). " +
+            "The user will review the plan in a native side panel and can edit, approve, or request revisions. " +
+            "If revisions are requested, edit the same file in place, then call this tool again.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            required: ["filePath"],
+            properties: {
+                filePath: {
+                    type: "string",
+                    description: "Path to the markdown plan file, relative to the working directory. Must end in .md or .mdx and resolve inside cwd.",
+                },
+            },
+        },
+        async execute(_toolCallId, params, signal, _onUpdate, ctx) {
+            const inputPath = params?.filePath?.trim();
+            if (!inputPath) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: ${toolName} requires a filePath argument pointing to your markdown plan file (e.g. "PLAN.md" or "plans/auth.md").`,
+                        },
+                    ],
+                    details: { approved: false },
+                };
+            }
+            const cwd = ctx?.cwd ?? process.cwd();
+            if (!isPlanWritePathAllowed(inputPath, cwd)) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: plan file must be a markdown file (.md or .mdx) inside the working directory. Rejected: ${inputPath}`,
+                        },
+                    ],
+                    details: { approved: false },
+                };
+            }
+            const fullPath = resolve(cwd, inputPath);
+            try {
+                if (!existsSync(fullPath) || !statSync(fullPath).isFile()) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Error: ${inputPath} does not exist or is not a regular file. Write your plan using the write tool first, then call ${toolName} with its path.`,
+                            },
+                        ],
+                        details: { approved: false },
+                    };
+                }
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: cannot access ${inputPath}: ${err instanceof Error ? err.message : String(err)}`,
+                        },
+                    ],
+                    details: { approved: false },
+                };
+            }
+            let planContent;
+            try {
+                planContent = readFileSync(fullPath, "utf-8");
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: failed to read ${inputPath}: ${err instanceof Error ? err.message : String(err)}`,
+                        },
+                    ],
+                    details: { approved: false },
+                };
+            }
+            if (planContent.trim().length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: ${inputPath} is empty. Write your plan first, then call ${toolName} again.`,
+                        },
+                    ],
+                    details: { approved: false },
+                };
+            }
+            // Register with the in-memory plan review registry and wait for the user to review
+            const { result } = registerPendingPlanReview({
+                sessionId,
+                planFilePath: inputPath,
+                planContent,
+                cwd,
+                signal,
+            });
+            return await result;
+        },
+    };
+}
+export function createPlannotatorSubmitPlanTool(sessionId) {
+    return createSubmitPlanTool(sessionId, PLANNOTATOR_SUBMIT_PLAN_TOOL_NAME);
+}
+//# sourceMappingURL=plannotator-submit-plan-tool.js.map

package/dist/server/ask-user-question/plannotator-submit-plan-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plannotator-submit-plan-tool.js","sourceRoot":"","sources":["../../src/ask-user-question/plannotator-submit-plan-tool.ts"],"names":[],"mappings":"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"}

package/dist/server/ask-user-question/plannotator-submit-plan.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plannotator-submit-plan.test.d.ts.map