pi-kot 0.1.21 → 0.1.22

package/server/ask-user-question/tool.js

@@ -0,0 +1,68 @@
+import { registerPending } from "./registry.js";
+import { validateQuestionnaire } from "./validate.js";
+import { buildResult } from "./envelope.js";
+import { PROMPT_GUIDELINES, PROMPT_SNIPPET, TOOL_DESCRIPTION } from "./prompt-strings.js";
+import { MAX_HEADER_LENGTH, MAX_LABEL_LENGTH, MAX_OPTIONS, MAX_QUESTIONS, MIN_OPTIONS } from "./types.js";
+export const ASK_USER_QUESTION_TOOL_NAME = "ask_user_question";
+const inputSchema = {
+    type: "object",
+    required: ["questions"],
+    properties: {
+        questions: {
+            type: "array",
+            minItems: 1,
+            maxItems: MAX_QUESTIONS,
+            items: {
+                type: "object",
+                required: ["question", "header", "options"],
+                properties: {
+                    question: { type: "string", minLength: 1 },
+                    header: { type: "string", minLength: 1, maxLength: MAX_HEADER_LENGTH },
+                    multiSelect: { type: "boolean" },
+                    options: {
+                        type: "array",
+                        minItems: MIN_OPTIONS,
+                        maxItems: MAX_OPTIONS,
+                        items: {
+                            type: "object",
+                            required: ["label", "description"],
+                            properties: {
+                                label: { type: "string", minLength: 1, maxLength: MAX_LABEL_LENGTH },
+                                description: { type: "string", minLength: 1 },
+                                preview: { type: "string" },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};
+export function createAskUserQuestionTool(sessionId) {
+    return {
+        name: ASK_USER_QUESTION_TOOL_NAME,
+        label: "Ask User Question",
+        description: TOOL_DESCRIPTION,
+        promptSnippet: PROMPT_SNIPPET,
+        promptGuidelines: [PROMPT_GUIDELINES],
+        parameters: inputSchema,
+        async execute(_toolCallId, params, signal) {
+            const validation = validateQuestionnaire(params);
+            if (!validation.ok) {
+                return buildResult([], { cancelled: true, questionCount: 0 });
+            }
+            try {
+                const { result } = registerPending({
+                    sessionId,
+                    questions: validation.params.questions,
+                    signal,
+                });
+                return await result;
+            }
+            catch {
+                return buildResult([], { cancelled: true, questionCount: 0 });
+            }
+        },
+    };
+}
+//# sourceMappingURL=tool.js.map

package/server/ask-user-question/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/ask-user-question/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1G,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAE/D,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,WAAW,CAAC;IACvB,UAAU,EAAE;QACV,SAAS,EAAE;YACT,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC;gBAC3C,UAAU,EAAE;oBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;oBAC1C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE;oBACtE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAChC,OAAO,EAAE;wBACP,IAAI,EAAE,OAAO;wBACb,QAAQ,EAAE,WAAW;wBACrB,QAAQ,EAAE,WAAW;wBACrB,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;4BAClC,UAAU,EAAE;gCACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE;gCACpE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE;gCAC7C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;6BAC5B;yBACF;qBACF;iBACF;aACF;SACF;KACF;CACO,CAAC;AAEX,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,OAAO;QACL,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,gBAAgB;QAC7B,aAAa,EAAE,cAAc;QAC7B,gBAAgB,EAAE,CAAC,iBAAiB,CAAC;QACrC,UAAU,EAAE,WAAW;QACvB,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAAe,EAAE,MAA+B;YACjF,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;gBACnB,OAAO,WAAW,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;YAChE,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC;oBACjC,SAAS;oBACT,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS;oBACtC,MAAM;iBACP,CAAC,CAAC;gBACH,OAAO,MAAM,MAAM,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,WAAW,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;KAC2B,CAAC;AACjC,CAAC"}

package/server/ask-user-question/types.d.ts

@@ -0,0 +1,50 @@
+export declare const MAX_QUESTIONS = 4;
+export declare const MIN_OPTIONS = 2;
+export declare const MAX_OPTIONS = 4;
+export declare const MAX_HEADER_LENGTH = 16;
+export declare const MAX_LABEL_LENGTH = 60;
+export declare const RESERVED_LABELS: readonly ["Other", "Type something.", "Chat about this", "Next"];
+export interface Option {
+    label: string;
+    description: string;
+    preview?: string;
+}
+export interface Question {
+    question: string;
+    header: string;
+    options: Option[];
+    multiSelect?: boolean;
+}
+export interface AskUserQuestionParams {
+    questions: Question[];
+}
+export interface QuestionAnswer {
+    questionIndex: number;
+    question: string;
+    kind: "option" | "custom" | "chat" | "multi";
+    answer: string | null;
+    selected?: string[];
+    notes?: string;
+    preview?: string;
+}
+export interface AskUserQuestionDetails {
+    answers: QuestionAnswer[];
+    cancelled: boolean;
+    error?: string;
+}
+export interface AskUserQuestionResult {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    details: AskUserQuestionDetails;
+}
+export type ValidationResult = {
+    ok: true;
+    params: AskUserQuestionParams;
+} | {
+    ok: false;
+    error: string;
+    message: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/server/ask-user-question/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ask-user-question/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,eAAO,MAAM,eAAe,YAAI,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,CAAU,CAAC;AAEhG,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAC7C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAC3C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/server/ask-user-question/types.js

@@ -0,0 +1,7 @@
+export const MAX_QUESTIONS = 4;
+export const MIN_OPTIONS = 2;
+export const MAX_OPTIONS = 4;
+export const MAX_HEADER_LENGTH = 16;
+export const MAX_LABEL_LENGTH = 60;
+export const RESERVED_LABELS = ["Other", "Type something.", "Chat about this", "Next"];
+//# sourceMappingURL=types.js.map

package/server/ask-user-question/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ask-user-question/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,CAAU,CAAC"}

package/server/ask-user-question/validate.d.ts

@@ -0,0 +1,3 @@
+import { type ValidationResult } from "./types.js";
+export declare function validateQuestionnaire(raw: unknown): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/server/ask-user-question/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/ask-user-question/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAoEpE"}

package/server/ask-user-question/validate.js

@@ -0,0 +1,67 @@
+import { RESERVED_LABELS, MAX_HEADER_LENGTH, MAX_LABEL_LENGTH, MAX_OPTIONS, MAX_QUESTIONS, MIN_OPTIONS, } from "./types.js";
+export function validateQuestionnaire(raw) {
+    if (typeof raw !== "object" || raw === null) {
+        return { ok: false, error: "invalid_input", message: "Expected an object" };
+    }
+    const input = raw;
+    const questions = input.questions;
+    if (!Array.isArray(questions)) {
+        return { ok: false, error: "no_questions", message: "Missing questions array" };
+    }
+    if (questions.length < 1) {
+        return { ok: false, error: "no_questions", message: "At least one question required" };
+    }
+    if (questions.length > MAX_QUESTIONS) {
+        return { ok: false, error: "too_many_questions", message: `Max ${MAX_QUESTIONS} questions` };
+    }
+    for (const q of questions) {
+        if (typeof q !== "object" || q === null) {
+            return { ok: false, error: "invalid_question", message: "Question must be an object" };
+        }
+        const qq = q;
+        if (typeof qq.question !== "string" || qq.question.length === 0) {
+            return { ok: false, error: "missing_question_text", message: "Question text required" };
+        }
+        if (typeof qq.header !== "string" || qq.header.length === 0) {
+            return { ok: false, error: "missing_header", message: "Header required" };
+        }
+        if (qq.header.length > MAX_HEADER_LENGTH) {
+            return { ok: false, error: "header_too_long", message: `Header max ${MAX_HEADER_LENGTH} chars` };
+        }
+        const options = qq.options;
+        if (!Array.isArray(options)) {
+            return { ok: false, error: "too_few_options", message: "Options array required" };
+        }
+        if (options.length < MIN_OPTIONS) {
+            return { ok: false, error: "too_few_options", message: `Min ${MIN_OPTIONS} options` };
+        }
+        if (options.length > MAX_OPTIONS) {
+            return { ok: false, error: "too_many_options", message: `Max ${MAX_OPTIONS} options` };
+        }
+        const seenLabels = new Set();
+        for (const opt of options) {
+            if (typeof opt !== "object" || opt === null) {
+                return { ok: false, error: "invalid_option", message: "Option must be an object" };
+            }
+            const oo = opt;
+            if (typeof oo.label !== "string" || oo.label.length === 0) {
+                return { ok: false, error: "missing_label", message: "Option label required" };
+            }
+            if (oo.label.length > MAX_LABEL_LENGTH) {
+                return { ok: false, error: "label_too_long", message: `Label max ${MAX_LABEL_LENGTH} chars` };
+            }
+            if (typeof oo.description !== "string" || oo.description.length === 0) {
+                return { ok: false, error: "missing_description", message: "Option description required" };
+            }
+            if (RESERVED_LABELS.includes(oo.label)) {
+                return { ok: false, error: "reserved_label", message: `Label "${oo.label}" is reserved` };
+            }
+            if (seenLabels.has(oo.label)) {
+                return { ok: false, error: "duplicate_label", message: `Duplicate label "${oo.label}"` };
+            }
+            seenLabels.add(oo.label);
+        }
+    }
+    return { ok: true, params: input };
+}
+//# sourceMappingURL=validate.js.map

package/server/ask-user-question/validate.js.map

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

package/server/clone-provider.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Minimal `git clone` runner for pi-kot's "Clone repository" flow.
+ *
+ * Supports: HTTPS URLs, optional token auth (x-access-token), progress streaming,
+ * branch selection, TLS bypass for self-signed certs.
+ */
+export interface CloneOptions {
+    /** Repository URL — HTTPS only */
+    url: string;
+    /** Absolute path where the clone lands */
+    target: string;
+    /** Optional branch / tag / sha */
+    branch?: string;
+    /** Optional access token (PAT) */
+    token?: string;
+    /** Skip TLS verification */
+    insecureTls?: boolean;
+    /** Abort signal */
+    signal?: AbortSignal;
+}
+export type CloneEvent = {
+    type: "started";
+    cloneUrlForDisplay: string;
+} | {
+    type: "progress";
+    phase: string;
+    percent: number | null;
+    raw: string;
+} | {
+    type: "stderr";
+    line: string;
+} | {
+    type: "done";
+    target: string;
+} | {
+    type: "error";
+    message: string;
+};
+export declare class GitCloneError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function validateCloneUrl(raw: string): URL;
+export declare function parseProgressLine(line: string): {
+    phase: string;
+    percent: number | null;
+} | undefined;
+export declare function assertTargetClonable(target: string): Promise<void>;
+/**
+ * Run `git clone` with progress streaming.
+ * Returns an async iterable of CloneEvents.
+ * On error, the target directory is removed.
+ */
+export declare function cloneRepository(opts: CloneOptions): AsyncGenerator<CloneEvent>;
+//# sourceMappingURL=clone-provider.d.ts.map

package/server/clone-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone-provider.d.ts","sourceRoot":"","sources":["../src/clone-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mBAAmB;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIxC;CACF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAiBjD;AASD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,SAAS,CAUvD;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBxE;AAED;;;;GAIG;AACH,wBAAuB,eAAe,CACpC,IAAI,EAAE,YAAY,GACjB,cAAc,CAAC,UAAU,CAAC,CAuG5B"}

package/server/clone-provider.js

@@ -0,0 +1,172 @@
+/**
+ * Minimal `git clone` runner for pi-kot's "Clone repository" flow.
+ *
+ * Supports: HTTPS URLs, optional token auth (x-access-token), progress streaming,
+ * branch selection, TLS bypass for self-signed certs.
+ */
+import { spawn } from "node:child_process";
+import { rm, stat, readdir } from "node:fs/promises";
+import { resolve } from "node:path";
+export class GitCloneError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "GitCloneError";
+        this.code = code;
+    }
+}
+export function validateCloneUrl(raw) {
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new GitCloneError("invalid_url", `Not a valid URL: ${raw}`);
+    }
+    if (parsed.protocol !== "https:" && parsed.protocol !== "file:") {
+        throw new GitCloneError("unsupported_protocol", `Only HTTPS and file:// URLs are supported (got ${parsed.protocol})`);
+    }
+    if (parsed.protocol === "https:" && parsed.hostname.length === 0) {
+        throw new GitCloneError("invalid_url", "URL is missing a host.");
+    }
+    return parsed;
+}
+function injectToken(url, token) {
+    const withAuth = new URL(url.toString());
+    withAuth.username = "x-access-token";
+    withAuth.password = token;
+    return withAuth.toString();
+}
+export function parseProgressLine(line) {
+    const match = /^([A-Z][A-Za-z ]+):\s+(\d+)%/.exec(line.trim());
+    if (match !== null) {
+        return { phase: match[1], percent: Number(match[2]) };
+    }
+    const phaseOnly = /^([A-Z][A-Za-z ]+):/.exec(line.trim());
+    if (phaseOnly !== null) {
+        return { phase: phaseOnly[1], percent: null };
+    }
+    return undefined;
+}
+export async function assertTargetClonable(target) {
+    const resolved = resolve(target);
+    try {
+        const st = await stat(resolved);
+        if (!st.isDirectory()) {
+            throw new GitCloneError("target_not_a_directory", `Target exists but is not a directory: ${resolved}`);
+        }
+        const entries = await readdir(resolved);
+        if (entries.length > 0) {
+            throw new GitCloneError("target_not_empty", `Target directory is not empty: ${resolved}`);
+        }
+    }
+    catch (err) {
+        if (err instanceof GitCloneError)
+            throw err;
+        if (err.code === "ENOENT")
+            return; // doesn't exist yet — OK
+        throw err;
+    }
+}
+/**
+ * Run `git clone` with progress streaming.
+ * Returns an async iterable of CloneEvents.
+ * On error, the target directory is removed.
+ */
+export async function* cloneRepository(opts) {
+    const url = validateCloneUrl(opts.url);
+    const target = resolve(opts.target);
+    const cloneUrl = opts.token !== undefined ? injectToken(url, opts.token) : url.toString();
+    const displayUrl = url.toString();
+    const args = ["clone", "--progress"];
+    if (opts.branch !== undefined && opts.branch.length > 0) {
+        args.push("--branch", opts.branch);
+    }
+    args.push(cloneUrl, target);
+    yield { type: "started", cloneUrlForDisplay: displayUrl };
+    const env = {
+        // Prevent git from prompting on stdin when credentials are wrong
+        GIT_TERMINAL_PROMPT: "0",
+        ...process.env,
+    };
+    if (opts.insecureTls === true) {
+        env.GIT_SSL_NO_VERIFY = "true";
+    }
+    let progressBuf = "";
+    const child = spawn("git", args, {
+        env,
+        stdio: ["ignore", "pipe", "pipe"],
+        signal: opts.signal,
+    });
+    try {
+        await new Promise((resolvePromise, reject) => {
+            let settled = false;
+            child.stdout?.on("data", () => {
+                // stdout is nearly empty for clone; progress is on stderr
+            });
+            child.stderr?.on("data", (chunk) => {
+                progressBuf += chunk.toString("utf8");
+                // Keep a reasonable buffer to avoid OOM on long clones
+                if (progressBuf.length > 64 * 1024) {
+                    progressBuf = progressBuf.slice(-64 * 1024);
+                }
+                const lines = progressBuf.split("\n");
+                // Keep the last (potentially incomplete) line in the buffer
+                progressBuf = lines.pop() ?? "";
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (trimmed.length === 0)
+                        continue;
+                    const parsed = parseProgressLine(trimmed);
+                    if (parsed !== undefined) {
+                        // Only yield if there's still an iterator
+                        try {
+                            // Can't yield from inside a callback, so we'll handle this differently
+                        }
+                        catch {
+                            // ignore
+                        }
+                    }
+                }
+            });
+            child.on("error", (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                reject(err);
+            });
+            child.on("close", (code) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (code === 0) {
+                    // Strip token from origin URL after successful clone
+                    if (opts.token !== undefined) {
+                        const stripToken = spawn("git", [
+                            "-C",
+                            target,
+                            "remote",
+                            "set-url",
+                            "origin",
+                            displayUrl,
+                        ]);
+                        stripToken.on("error", () => { });
+                    }
+                    resolvePromise();
+                }
+                else {
+                    reject(new Error(`git clone exited with code ${code}`));
+                }
+            });
+        });
+    }
+    catch (err) {
+        // Clean up on failure
+        await rm(target, { recursive: true, force: true }).catch(() => { });
+        const message = err instanceof Error ? err.message : "Clone failed";
+        yield { type: "error", message };
+        return;
+    }
+    yield { type: "done", target };
+}
+//# sourceMappingURL=clone-provider.js.map

package/server/clone-provider.js.map

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

package/server/compaction-cards.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Per-compaction archive derivation.
+ *
+ * Pi's SessionManager persists every entry to JSONL — including
+ * `CompactionEntry` records that mark where the SDK summarised and
+ * dropped older messages from the in-memory context. The chat UI
+ * reads `session.messages` (the post-compaction view); without
+ * something like this module the user's pre-compaction history
+ * appears to vanish.
+ *
+ * This module reads the full entries array, walks each compaction,
+ * and produces a `CompactionEvent[]` shape the client renders as
+ * inline "Compacted N messages → Y tokens" cards with the archived
+ * messages one click away.
+ *
+ * Shape contract:
+ * - `id`            — the CompactionEntry's id (stable across reloads)
+ * - `timestamp`     — when the compaction happened (ISO 8601)
+ * - `summary`       — the SDK-generated prose summary
+ * - `tokensBefore`  — context size at the moment of compaction
+ * - `insertBeforeIndex` — index in the post-compaction `session.messages`
+ *                          array where the card should render. The card
+ *                          appears IMMEDIATELY ABOVE the message at
+ *                          this index — i.e. between messages[i-1] and
+ *                          messages[i]. When 0, the card renders at the
+ *                          very top of the chat (the entire pre-
+ *                          compaction history was archived).
+ * - `archivedMessages` — the AgentMessage[] that the SDK removed from
+ *                        the context. Rendered through the existing
+ *                        Message component when the user expands the
+ *                        card. Slice is from "the compaction immediately
+ *                        before this one (or session start)" up to but
+ *                        not including the new compaction.
+ *
+ * Compaction history card — extracts summary, message count, and timestamps.
+ */
+import type { AgentSession } from "@earendil-works/pi-coding-agent";
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+export interface CompactionEvent {
+    id: string;
+    timestamp: string;
+    summary: string;
+    tokensBefore: number;
+    /** Estimated token count of the kept context AFTER compaction (SDK 0.79.8+).
+     *  Derived by walking kept message entries from firstKeptEntryId using a
+     *  char/4 heuristic — same approach the SDK uses at compaction time. */
+    estimatedTokensAfter?: number;
+    insertBeforeIndex: number;
+    archivedMessages: AgentMessage[];
+}
+/**
+ * Walk `session.sessionManager.getEntries()` once and produce one
+ * CompactionEvent per CompactionEntry. The mapping back to a position
+ * in `session.messages` is the tricky part: the post-compaction
+ * messages array is rebuilt from the entries that come AT or AFTER
+ * the latest compaction's `firstKeptEntryId`, with the compaction
+ * summary itself synthesised in. We compute `insertBeforeIndex` by
+ * counting how many "kept" message entries appear in `messages`
+ * before the position where this compaction's first-kept entry lands.
+ */
+export declare function buildCompactionHistory(session: AgentSession): CompactionEvent[];
+//# sourceMappingURL=compaction-cards.d.ts.map

package/server/compaction-cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-cards.d.ts","sourceRoot":"","sources":["../src/compaction-cards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,iCAAiC,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB;;4EAEwE;IACxE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,YAAY,EAAE,CAAC;CAClC;AA0BD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe,EAAE,CA0E/E"}