@astralyn/pi 1.0.5 → 1.2.0

package/dist/extensions/search/devin.js

@@ -0,0 +1,210 @@
+/**
+ * The two Devin (Windsurf) endpoints the search tools call. Both authenticate with the API key
+ * inside the request body; neither needs a JWT exchange, a rate-limit preflight, or host details.
+ *
+ * - `GetDevstralStream` is one turn of the SWE-grep planner: a Connect-streaming protobuf request
+ *   carrying a chat transcript and tool schemas, answered by one text completion.
+ * - `GetWebSearchResults` is a Connect-unary JSON request answered by `{ results: [...] }`.
+ *
+ * There is no published schema. The field numbers and the client identity below are the minimum
+ * the backend accepts; dropping any of them makes it answer `invalid_argument`.
+ */
+import { gunzipSync, gzipSync } from "node:zlib";
+const SERVICE = "https://server.self-serve.windsurf.com/exa.api_server_pb.ApiServerService";
+const APP = "windsurf";
+const APP_VERSION = "1.48.2";
+const LANGUAGE_SERVER_VERSION = "1.9544.35";
+const WEB_CLIENT_VERSION = "1.9600.41";
+const TIMEOUT_MS = 30_000;
+export class DevinError extends Error {
+    constructor() {
+        super(...arguments);
+        this.name = "DevinError";
+    }
+}
+/** The credential is missing, revoked, or malformed; only signing in again fixes it. */
+export class DevinAuthError extends DevinError {
+    constructor() {
+        super(...arguments);
+        this.name = "DevinAuthError";
+    }
+}
+function errorFor(code, message = "") {
+    if (code === 401 || code === 403 || code === "unauthenticated" || code === "permission_denied") {
+        return new DevinAuthError("Devin rejected the credential.");
+    }
+    if (code === 429 || code === "resource_exhausted") {
+        return new DevinError("Devin rate-limited the request. Wait a moment and retry.");
+    }
+    return new DevinError(`Devin request failed (${code}${message ? `: ${message}` : ""}).`);
+}
+async function post(url, init, signal) {
+    const timeout = AbortSignal.timeout(TIMEOUT_MS);
+    let response;
+    try {
+        response = await fetch(url, {
+            ...init,
+            method: "POST",
+            redirect: "error",
+            signal: signal ? AbortSignal.any([signal, timeout]) : timeout,
+        });
+    }
+    catch (e) {
+        if (signal?.aborted)
+            throw e;
+        throw new DevinError(timeout.aborted ? "Devin did not answer in time." : `Could not reach Devin: ${String(e)}`);
+    }
+    if (!response.ok) {
+        const body = (await response.json().catch(() => undefined));
+        throw errorFor(body?.code ?? response.status, body?.message);
+    }
+    return response;
+}
+// --- Protobuf, just enough for these messages ---
+function varint(value) {
+    const bytes = [];
+    while (value > 0x7f) {
+        bytes.push((value & 0x7f) | 0x80);
+        value >>>= 7;
+    }
+    bytes.push(value);
+    return bytes;
+}
+function field(no, value) {
+    if (typeof value === "number")
+        return Buffer.from([...varint(no << 3), ...varint(value)]);
+    const data = typeof value === "string" ? Buffer.from(value, "utf-8") : value;
+    return Buffer.concat([Buffer.from([...varint((no << 3) | 2), ...varint(data.length)]), data]);
+}
+/** The length-delimited values of field `no` at the top level of `data`. */
+function readField(data, no) {
+    const out = [];
+    let i = 0;
+    const readVarint = () => {
+        let value = 0;
+        for (let shift = 0; i < data.length; shift += 7) {
+            const b = data[i++];
+            value += (b & 0x7f) * 2 ** shift;
+            if (!(b & 0x80))
+                break;
+        }
+        return value;
+    };
+    while (i < data.length) {
+        const tag = readVarint();
+        const wire = tag & 7;
+        if (wire === 0)
+            readVarint();
+        else if (wire === 1)
+            i += 8;
+        else if (wire === 5)
+            i += 4;
+        else if (wire === 2) {
+            const length = readVarint();
+            if (tag >>> 3 === no)
+                out.push(data.subarray(i, i + length));
+            i += length;
+        }
+        else
+            break;
+    }
+    return out;
+}
+const ROLE = { user: 1, assistant: 2, tool: 4, system: 5 };
+export function encodeChatRequest(apiKey, messages, tools) {
+    const metadata = Buffer.concat([
+        field(1, APP),
+        field(2, APP_VERSION),
+        field(3, apiKey),
+        field(7, LANGUAGE_SERVER_VERSION),
+    ]);
+    const parts = [field(1, metadata)];
+    for (const m of messages) {
+        const msg = [field(2, ROLE[m.role]), field(3, m.content)];
+        if (m.call) {
+            msg.push(field(6, Buffer.concat([field(1, m.call.id), field(2, m.call.name), field(3, m.call.arguments)])));
+        }
+        if (m.callId)
+            msg.push(field(7, m.callId));
+        parts.push(field(2, Buffer.concat(msg)));
+    }
+    parts.push(field(3, tools));
+    return Buffer.concat(parts);
+}
+/**
+ * Connect streaming envelopes: a flags byte (bit 0 gzip, bit 1 end-of-stream) and a length. Data
+ * frames carry text chunks in field 2; the end frame is JSON that names an error, if any.
+ */
+export function decodeChatResponse(body) {
+    let text = "";
+    let i = 0;
+    while (i + 5 <= body.length) {
+        const flags = body[i];
+        const length = body.readUInt32BE(i + 1);
+        let payload = body.subarray(i + 5, i + 5 + length);
+        i += 5 + length;
+        if (flags & 1)
+            payload = gunzipSync(payload);
+        if (flags & 2) {
+            const end = JSON.parse(payload.toString("utf-8") || "{}");
+            if (end.error)
+                throw errorFor(end.error.code ?? "unknown", end.error.message);
+            continue;
+        }
+        for (const chunk of readField(payload, 2))
+            text += chunk.toString("utf-8");
+    }
+    return text;
+}
+export async function chat(apiKey, messages, tools, signal) {
+    const message = gzipSync(encodeChatRequest(apiKey, messages, tools));
+    const envelope = Buffer.alloc(5);
+    envelope[0] = 1;
+    envelope.writeUInt32BE(message.length, 1);
+    const response = await post(`${SERVICE}/GetDevstralStream`, {
+        headers: {
+            "Content-Type": "application/connect+proto",
+            "Connect-Protocol-Version": "1",
+            "Connect-Content-Encoding": "gzip",
+            "Connect-Accept-Encoding": "gzip",
+            "Connect-Timeout-Ms": String(TIMEOUT_MS),
+        },
+        body: new Uint8Array(Buffer.concat([envelope, message])),
+    }, signal);
+    return decodeChatResponse(Buffer.from(await response.arrayBuffer()));
+}
+export async function webSearch(apiKey, query, limit, signal) {
+    const response = await post(`${SERVICE}/GetWebSearchResults`, {
+        headers: { "Content-Type": "application/json", "Connect-Protocol-Version": "1" },
+        body: JSON.stringify({
+            metadata: { apiKey, ideName: APP, ideVersion: WEB_CLIENT_VERSION, extensionVersion: WEB_CLIENT_VERSION },
+            query,
+            limit,
+        }),
+    }, signal);
+    const results = (await response.json().catch(() => undefined))?.results;
+    if (!Array.isArray(results))
+        throw new DevinError("Devin returned a malformed web search response.");
+    return results.flatMap((row) => {
+        const { url, title, summary } = (row ?? {});
+        if (typeof url !== "string" || !isWebUrl(url))
+            return [];
+        return [
+            {
+                url,
+                ...(typeof title === "string" && title.trim() ? { title: title.trim() } : {}),
+                ...(typeof summary === "string" && summary.trim() ? { summary: summary.trim() } : {}),
+            },
+        ];
+    });
+}
+function isWebUrl(value) {
+    try {
+        const url = new URL(value);
+        return (url.protocol === "https:" || url.protocol === "http:") && !url.username && !url.password;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=devin.js.map

package/dist/extensions/search/devin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devin.js","sourceRoot":"","sources":["../../../src/extensions/search/devin.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The two Devin (Windsurf) endpoints the search tools call. Both authenticate with the API key\n * inside the request body; neither needs a JWT exchange, a rate-limit preflight, or host details.\n *\n * - `GetDevstralStream` is one turn of the SWE-grep planner: a Connect-streaming protobuf request\n *   carrying a chat transcript and tool schemas, answered by one text completion.\n * - `GetWebSearchResults` is a Connect-unary JSON request answered by `{ results: [...] }`.\n *\n * There is no published schema. The field numbers and the client identity below are the minimum\n * the backend accepts; dropping any of them makes it answer `invalid_argument`.\n */\nimport { gunzipSync, gzipSync } from \"node:zlib\";\n\nconst SERVICE = \"https://server.self-serve.windsurf.com/exa.api_server_pb.ApiServerService\";\nconst APP = \"windsurf\";\nconst APP_VERSION = \"1.48.2\";\nconst LANGUAGE_SERVER_VERSION = \"1.9544.35\";\nconst WEB_CLIENT_VERSION = \"1.9600.41\";\nconst TIMEOUT_MS = 30_000;\n\nexport class DevinError extends Error {\n\toverride name = \"DevinError\";\n}\n\n/** The credential is missing, revoked, or malformed; only signing in again fixes it. */\nexport class DevinAuthError extends DevinError {\n\toverride name = \"DevinAuthError\";\n}\n\nfunction errorFor(code: string | number, message = \"\"): DevinError {\n\tif (code === 401 || code === 403 || code === \"unauthenticated\" || code === \"permission_denied\") {\n\t\treturn new DevinAuthError(\"Devin rejected the credential.\");\n\t}\n\tif (code === 429 || code === \"resource_exhausted\") {\n\t\treturn new DevinError(\"Devin rate-limited the request. Wait a moment and retry.\");\n\t}\n\treturn new DevinError(`Devin request failed (${code}${message ? `: ${message}` : \"\"}).`);\n}\n\nasync function post(url: string, init: RequestInit, signal?: AbortSignal): Promise<Response> {\n\tconst timeout = AbortSignal.timeout(TIMEOUT_MS);\n\tlet response: Response;\n\ttry {\n\t\tresponse = await fetch(url, {\n\t\t\t...init,\n\t\t\tmethod: \"POST\",\n\t\t\tredirect: \"error\",\n\t\t\tsignal: signal ? AbortSignal.any([signal, timeout]) : timeout,\n\t\t});\n\t} catch (e) {\n\t\tif (signal?.aborted) throw e;\n\t\tthrow new DevinError(timeout.aborted ? \"Devin did not answer in time.\" : `Could not reach Devin: ${String(e)}`);\n\t}\n\tif (!response.ok) {\n\t\tconst body = (await response.json().catch(() => undefined)) as { code?: string; message?: string } | undefined;\n\t\tthrow errorFor(body?.code ?? response.status, body?.message);\n\t}\n\treturn response;\n}\n\n// --- Protobuf, just enough for these messages ---\n\nfunction varint(value: number): number[] {\n\tconst bytes: number[] = [];\n\twhile (value > 0x7f) {\n\t\tbytes.push((value & 0x7f) | 0x80);\n\t\tvalue >>>= 7;\n\t}\n\tbytes.push(value);\n\treturn bytes;\n}\n\nfunction field(no: number, value: string | number | Buffer): Buffer {\n\tif (typeof value === \"number\") return Buffer.from([...varint(no << 3), ...varint(value)]);\n\tconst data = typeof value === \"string\" ? Buffer.from(value, \"utf-8\") : value;\n\treturn Buffer.concat([Buffer.from([...varint((no << 3) | 2), ...varint(data.length)]), data]);\n}\n\n/** The length-delimited values of field `no` at the top level of `data`. */\nfunction readField(data: Buffer, no: number): Buffer[] {\n\tconst out: Buffer[] = [];\n\tlet i = 0;\n\tconst readVarint = (): number => {\n\t\tlet value = 0;\n\t\tfor (let shift = 0; i < data.length; shift += 7) {\n\t\t\tconst b = data[i++]!;\n\t\t\tvalue += (b & 0x7f) * 2 ** shift;\n\t\t\tif (!(b & 0x80)) break;\n\t\t}\n\t\treturn value;\n\t};\n\twhile (i < data.length) {\n\t\tconst tag = readVarint();\n\t\tconst wire = tag & 7;\n\t\tif (wire === 0) readVarint();\n\t\telse if (wire === 1) i += 8;\n\t\telse if (wire === 5) i += 4;\n\t\telse if (wire === 2) {\n\t\t\tconst length = readVarint();\n\t\t\tif (tag >>> 3 === no) out.push(data.subarray(i, i + length));\n\t\t\ti += length;\n\t\t} else break;\n\t}\n\treturn out;\n}\n\n// --- Planner turn ---\n\nexport interface ChatMessage {\n\trole: \"system\" | \"user\" | \"assistant\" | \"tool\";\n\tcontent: string;\n\t/** On an assistant message: the tool call it made. */\n\tcall?: { id: string; name: string; arguments: string };\n\t/** On a tool message: the id of the call it answers. */\n\tcallId?: string;\n}\n\nconst ROLE = { user: 1, assistant: 2, tool: 4, system: 5 } as const;\n\nexport function encodeChatRequest(apiKey: string, messages: ChatMessage[], tools: string): Buffer {\n\tconst metadata = Buffer.concat([\n\t\tfield(1, APP),\n\t\tfield(2, APP_VERSION),\n\t\tfield(3, apiKey),\n\t\tfield(7, LANGUAGE_SERVER_VERSION),\n\t]);\n\tconst parts = [field(1, metadata)];\n\tfor (const m of messages) {\n\t\tconst msg = [field(2, ROLE[m.role]), field(3, m.content)];\n\t\tif (m.call) {\n\t\t\tmsg.push(field(6, Buffer.concat([field(1, m.call.id), field(2, m.call.name), field(3, m.call.arguments)])));\n\t\t}\n\t\tif (m.callId) msg.push(field(7, m.callId));\n\t\tparts.push(field(2, Buffer.concat(msg)));\n\t}\n\tparts.push(field(3, tools));\n\treturn Buffer.concat(parts);\n}\n\n/**\n * Connect streaming envelopes: a flags byte (bit 0 gzip, bit 1 end-of-stream) and a length. Data\n * frames carry text chunks in field 2; the end frame is JSON that names an error, if any.\n */\nexport function decodeChatResponse(body: Buffer): string {\n\tlet text = \"\";\n\tlet i = 0;\n\twhile (i + 5 <= body.length) {\n\t\tconst flags = body[i]!;\n\t\tconst length = body.readUInt32BE(i + 1);\n\t\tlet payload = body.subarray(i + 5, i + 5 + length);\n\t\ti += 5 + length;\n\t\tif (flags & 1) payload = gunzipSync(payload);\n\t\tif (flags & 2) {\n\t\t\tconst end = JSON.parse(payload.toString(\"utf-8\") || \"{}\") as { error?: { code?: string; message?: string } };\n\t\t\tif (end.error) throw errorFor(end.error.code ?? \"unknown\", end.error.message);\n\t\t\tcontinue;\n\t\t}\n\t\tfor (const chunk of readField(payload, 2)) text += chunk.toString(\"utf-8\");\n\t}\n\treturn text;\n}\n\nexport async function chat(\n\tapiKey: string,\n\tmessages: ChatMessage[],\n\ttools: string,\n\tsignal?: AbortSignal,\n): Promise<string> {\n\tconst message = gzipSync(encodeChatRequest(apiKey, messages, tools));\n\tconst envelope = Buffer.alloc(5);\n\tenvelope[0] = 1;\n\tenvelope.writeUInt32BE(message.length, 1);\n\tconst response = await post(\n\t\t`${SERVICE}/GetDevstralStream`,\n\t\t{\n\t\t\theaders: {\n\t\t\t\t\"Content-Type\": \"application/connect+proto\",\n\t\t\t\t\"Connect-Protocol-Version\": \"1\",\n\t\t\t\t\"Connect-Content-Encoding\": \"gzip\",\n\t\t\t\t\"Connect-Accept-Encoding\": \"gzip\",\n\t\t\t\t\"Connect-Timeout-Ms\": String(TIMEOUT_MS),\n\t\t\t},\n\t\t\tbody: new Uint8Array(Buffer.concat([envelope, message])),\n\t\t},\n\t\tsignal,\n\t);\n\treturn decodeChatResponse(Buffer.from(await response.arrayBuffer()));\n}\n\n// --- Web search ---\n\nexport interface WebResult {\n\turl: string;\n\ttitle?: string;\n\t/** Query-relevant excerpts of the page, joined by `...`; up to about 4,000 characters. */\n\tsummary?: string;\n}\n\nexport async function webSearch(\n\tapiKey: string,\n\tquery: string,\n\tlimit: number,\n\tsignal?: AbortSignal,\n): Promise<WebResult[]> {\n\tconst response = await post(\n\t\t`${SERVICE}/GetWebSearchResults`,\n\t\t{\n\t\t\theaders: { \"Content-Type\": \"application/json\", \"Connect-Protocol-Version\": \"1\" },\n\t\t\tbody: JSON.stringify({\n\t\t\t\tmetadata: { apiKey, ideName: APP, ideVersion: WEB_CLIENT_VERSION, extensionVersion: WEB_CLIENT_VERSION },\n\t\t\t\tquery,\n\t\t\t\tlimit,\n\t\t\t}),\n\t\t},\n\t\tsignal,\n\t);\n\tconst results = ((await response.json().catch(() => undefined)) as { results?: unknown } | undefined)?.results;\n\tif (!Array.isArray(results)) throw new DevinError(\"Devin returned a malformed web search response.\");\n\treturn results.flatMap((row): WebResult[] => {\n\t\tconst { url, title, summary } = (row ?? {}) as Record<string, unknown>;\n\t\tif (typeof url !== \"string\" || !isWebUrl(url)) return [];\n\t\treturn [\n\t\t\t{\n\t\t\t\turl,\n\t\t\t\t...(typeof title === \"string\" && title.trim() ? { title: title.trim() } : {}),\n\t\t\t\t...(typeof summary === \"string\" && summary.trim() ? { summary: summary.trim() } : {}),\n\t\t\t},\n\t\t];\n\t});\n}\n\nfunction isWebUrl(value: string): boolean {\n\ttry {\n\t\tconst url = new URL(value);\n\t\treturn (url.protocol === \"https:\" || url.protocol === \"http:\") && !url.username && !url.password;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"]}

package/dist/extensions/search/index.d.ts

@@ -0,0 +1,5 @@
+import type { ExtensionAPI } from "../../core/extensions/types.ts";
+import { type WebResult } from "./devin.ts";
+export declare function formatWebResults(query: string, results: WebResult[]): string;
+export default function search(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/search/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAKnE,OAAO,EAAkB,KAAK,SAAS,EAAa,MAAM,YAAY,CAAC;AA8CvE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAW5E;AAED,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA8DrD"}

package/dist/extensions/search/index.js

@@ -0,0 +1,113 @@
+/**
+ * Devin Search: `code_search` and `web_search`, both authenticated by one Devin sign-in.
+ *
+ * Both tools stay registered so `/tools` and old transcripts know them; a session without a
+ * credential starts with them inactive, and signing in or out through `/search` toggles them.
+ */
+import { resolve } from "node:path";
+import { Type } from "typebox";
+import { truncateHead } from "../../core/tools/truncate.js";
+import { codeSearch, formatLocations } from "./code-search.js";
+import { registerSearchCommand, syncTools } from "./command.js";
+import { getCredential } from "./credential.js";
+import { DevinAuthError, webSearch } from "./devin.js";
+import { renderCodeSearchCall, renderCodeSearchResult, renderWebSearchCall, renderWebSearchResult, } from "./render.js";
+import { isInside } from "./workspace.js";
+const WEB_EXCERPT_MAX_CHARS = 1500;
+const CodeSearchParams = Type.Object({
+    query: Type.String({
+        description: "Natural-language description of the behavior, flow, error, or concept to locate, in concise English. Keep identifiers, API names, and error text verbatim. Not for a bare symbol, filename, or literal.",
+    }),
+    path: Type.Optional(Type.String({
+        description: "Subdirectory to search, relative to or inside the working directory. Defaults to the working directory.",
+    })),
+});
+const WebSearchParams = Type.Object({
+    query: Type.String({
+        description: "Web search query. Be specific: product names, versions, exact error text. English matches best.",
+    }),
+    max_results: Type.Optional(Type.Integer({ minimum: 1, maximum: 10, description: "Results to return (default 5)." })),
+});
+const SIGN_IN_HINT = "Ask the user to run /search to sign in to Devin.";
+/** Run a Devin call with the current credential; credential failures tell the model what fixes them. */
+async function withDevin(run) {
+    const credential = getCredential();
+    if (!credential)
+        throw new Error(`Devin Search is not signed in. ${SIGN_IN_HINT}`);
+    try {
+        return await run(credential.apiKey);
+    }
+    catch (error) {
+        throw error instanceof DevinAuthError ? new Error(`${error.message} ${SIGN_IN_HINT}`) : error;
+    }
+}
+export function formatWebResults(query, results) {
+    if (!results.length)
+        return `No web results for "${query}".`;
+    const blocks = results.map((r, i) => {
+        const lines = [`${i + 1}. ${r.title ?? r.url}`, `   ${r.url}`];
+        if (r.summary) {
+            const excerpt = r.summary.replace(/\n\s*\n+/g, "\n").trim();
+            lines.push(excerpt.length > WEB_EXCERPT_MAX_CHARS ? `${excerpt.slice(0, WEB_EXCERPT_MAX_CHARS)}…` : excerpt);
+        }
+        return lines.join("\n");
+    });
+    return truncateHead(`Web results for "${query}":\n\n${blocks.join("\n\n")}`).content;
+}
+export default function search(pi) {
+    pi.registerTool({
+        name: "code_search",
+        label: "Code Search",
+        description: "Find where behavior lives in the local repository from a description of it. " +
+            "Returns candidate files with line ranges.",
+        promptSnippet: "Find code by describing its behavior",
+        promptGuidelines: [
+            "Use `code_search` when you cannot name the file or symbol you need; use `read`, `grep`, or `find` when you can.",
+            "Read the returned ranges before editing; the locations are candidates, not answers.",
+        ],
+        parameters: CodeSearchParams,
+        renderCall: renderCodeSearchCall,
+        renderResult: renderCodeSearchResult,
+        async execute(_toolCallId, params, signal, onUpdate, ctx) {
+            const root = resolve(ctx.cwd, params.path ?? ".");
+            if (!isInside(ctx.cwd, root))
+                throw new Error(`path must be inside the working directory (${ctx.cwd}).`);
+            const locations = await withDevin((apiKey) => codeSearch({
+                apiKey,
+                query: params.query.trim(),
+                root,
+                cwd: ctx.cwd,
+                signal,
+                onProgress: (text) => onUpdate?.({ content: [{ type: "text", text }], details: { locations: [] } }),
+            }));
+            return { content: [{ type: "text", text: formatLocations(locations) }], details: { locations } };
+        },
+    });
+    // Pi's system prompt carries no date, so models otherwise search with their training year.
+    const currentMonth = new Date().toLocaleDateString("en-US", { month: "long", year: "numeric" });
+    pi.registerTool({
+        name: "web_search",
+        label: "Web Search",
+        description: "Search the live web for current information. Returns titles, URLs, and the page excerpts that match the query.",
+        promptSnippet: "Search the live web for current information",
+        promptGuidelines: [
+            "Use `web_search` for information beyond your knowledge cutoff.",
+            `It is ${currentMonth}; put this year in \`web_search\` queries for recent releases, versions, or events, not the year your training data suggests.`,
+            "When an answer relies on `web_search` results, cite each result you used as a markdown link: [Title](URL).",
+        ],
+        parameters: WebSearchParams,
+        renderCall: renderWebSearchCall,
+        renderResult: renderWebSearchResult,
+        async execute(_toolCallId, params, signal) {
+            const query = params.query.trim();
+            const results = await withDevin((apiKey) => webSearch(apiKey, query, params.max_results ?? 5, signal));
+            return {
+                content: [{ type: "text", text: formatWebResults(query, results) }],
+                details: { results: results.map(({ url, title }) => ({ url, title })) },
+            };
+        },
+    });
+    registerSearchCommand(pi);
+    pi.on("session_start", async () => syncTools(pi));
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/search/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Devin Search: `code_search` and `web_search`, both authenticated by one Devin sign-in.\n *\n * Both tools stay registered so `/tools` and old transcripts know them; a session without a\n * credential starts with them inactive, and signing in or out through `/search` toggles them.\n */\nimport { resolve } from \"node:path\";\nimport { type Static, Type } from \"typebox\";\nimport type { ExtensionAPI } from \"../../core/extensions/types.ts\";\nimport { truncateHead } from \"../../core/tools/truncate.ts\";\nimport { codeSearch, formatLocations } from \"./code-search.ts\";\nimport { registerSearchCommand, syncTools } from \"./command.ts\";\nimport { getCredential } from \"./credential.ts\";\nimport { DevinAuthError, type WebResult, webSearch } from \"./devin.ts\";\nimport {\n\ttype CodeSearchDetails,\n\trenderCodeSearchCall,\n\trenderCodeSearchResult,\n\trenderWebSearchCall,\n\trenderWebSearchResult,\n\ttype WebSearchDetails,\n} from \"./render.ts\";\nimport { isInside } from \"./workspace.ts\";\n\nconst WEB_EXCERPT_MAX_CHARS = 1500;\n\nconst CodeSearchParams = Type.Object({\n\tquery: Type.String({\n\t\tdescription:\n\t\t\t\"Natural-language description of the behavior, flow, error, or concept to locate, in concise English. Keep identifiers, API names, and error text verbatim. Not for a bare symbol, filename, or literal.\",\n\t}),\n\tpath: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Subdirectory to search, relative to or inside the working directory. Defaults to the working directory.\",\n\t\t}),\n\t),\n});\n\nconst WebSearchParams = Type.Object({\n\tquery: Type.String({\n\t\tdescription: \"Web search query. Be specific: product names, versions, exact error text. English matches best.\",\n\t}),\n\tmax_results: Type.Optional(Type.Integer({ minimum: 1, maximum: 10, description: \"Results to return (default 5).\" })),\n});\n\nconst SIGN_IN_HINT = \"Ask the user to run /search to sign in to Devin.\";\n\n/** Run a Devin call with the current credential; credential failures tell the model what fixes them. */\nasync function withDevin<T>(run: (apiKey: string) => Promise<T>): Promise<T> {\n\tconst credential = getCredential();\n\tif (!credential) throw new Error(`Devin Search is not signed in. ${SIGN_IN_HINT}`);\n\ttry {\n\t\treturn await run(credential.apiKey);\n\t} catch (error) {\n\t\tthrow error instanceof DevinAuthError ? new Error(`${error.message} ${SIGN_IN_HINT}`) : error;\n\t}\n}\n\nexport function formatWebResults(query: string, results: WebResult[]): string {\n\tif (!results.length) return `No web results for \"${query}\".`;\n\tconst blocks = results.map((r, i) => {\n\t\tconst lines = [`${i + 1}. ${r.title ?? r.url}`, `   ${r.url}`];\n\t\tif (r.summary) {\n\t\t\tconst excerpt = r.summary.replace(/\\n\\s*\\n+/g, \"\\n\").trim();\n\t\t\tlines.push(excerpt.length > WEB_EXCERPT_MAX_CHARS ? `${excerpt.slice(0, WEB_EXCERPT_MAX_CHARS)}…` : excerpt);\n\t\t}\n\t\treturn lines.join(\"\\n\");\n\t});\n\treturn truncateHead(`Web results for \"${query}\":\\n\\n${blocks.join(\"\\n\\n\")}`).content;\n}\n\nexport default function search(pi: ExtensionAPI): void {\n\tpi.registerTool<typeof CodeSearchParams, CodeSearchDetails>({\n\t\tname: \"code_search\",\n\t\tlabel: \"Code Search\",\n\t\tdescription:\n\t\t\t\"Find where behavior lives in the local repository from a description of it. \" +\n\t\t\t\"Returns candidate files with line ranges.\",\n\t\tpromptSnippet: \"Find code by describing its behavior\",\n\t\tpromptGuidelines: [\n\t\t\t\"Use `code_search` when you cannot name the file or symbol you need; use `read`, `grep`, or `find` when you can.\",\n\t\t\t\"Read the returned ranges before editing; the locations are candidates, not answers.\",\n\t\t],\n\t\tparameters: CodeSearchParams,\n\t\trenderCall: renderCodeSearchCall,\n\t\trenderResult: renderCodeSearchResult,\n\n\t\tasync execute(_toolCallId, params: Static<typeof CodeSearchParams>, signal, onUpdate, ctx) {\n\t\t\tconst root = resolve(ctx.cwd, params.path ?? \".\");\n\t\t\tif (!isInside(ctx.cwd, root)) throw new Error(`path must be inside the working directory (${ctx.cwd}).`);\n\t\t\tconst locations = await withDevin((apiKey) =>\n\t\t\t\tcodeSearch({\n\t\t\t\t\tapiKey,\n\t\t\t\t\tquery: params.query.trim(),\n\t\t\t\t\troot,\n\t\t\t\t\tcwd: ctx.cwd,\n\t\t\t\t\tsignal,\n\t\t\t\t\tonProgress: (text) => onUpdate?.({ content: [{ type: \"text\", text }], details: { locations: [] } }),\n\t\t\t\t}),\n\t\t\t);\n\t\t\treturn { content: [{ type: \"text\", text: formatLocations(locations) }], details: { locations } };\n\t\t},\n\t});\n\n\t// Pi's system prompt carries no date, so models otherwise search with their training year.\n\tconst currentMonth = new Date().toLocaleDateString(\"en-US\", { month: \"long\", year: \"numeric\" });\n\tpi.registerTool<typeof WebSearchParams, WebSearchDetails>({\n\t\tname: \"web_search\",\n\t\tlabel: \"Web Search\",\n\t\tdescription:\n\t\t\t\"Search the live web for current information. Returns titles, URLs, and the page excerpts that match the query.\",\n\t\tpromptSnippet: \"Search the live web for current information\",\n\t\tpromptGuidelines: [\n\t\t\t\"Use `web_search` for information beyond your knowledge cutoff.\",\n\t\t\t`It is ${currentMonth}; put this year in \\`web_search\\` queries for recent releases, versions, or events, not the year your training data suggests.`,\n\t\t\t\"When an answer relies on `web_search` results, cite each result you used as a markdown link: [Title](URL).\",\n\t\t],\n\t\tparameters: WebSearchParams,\n\t\trenderCall: renderWebSearchCall,\n\t\trenderResult: renderWebSearchResult,\n\n\t\tasync execute(_toolCallId, params: Static<typeof WebSearchParams>, signal) {\n\t\t\tconst query = params.query.trim();\n\t\t\tconst results = await withDevin((apiKey) => webSearch(apiKey, query, params.max_results ?? 5, signal));\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: formatWebResults(query, results) }],\n\t\t\t\tdetails: { results: results.map(({ url, title }) => ({ url, title })) },\n\t\t\t};\n\t\t},\n\t});\n\n\tregisterSearchCommand(pi);\n\tpi.on(\"session_start\", async () => syncTools(pi));\n}\n"]}

package/dist/extensions/search/panel.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The `/search` panel: one framed view whose screens replace each other in place — the account
+ * menu, browser sign-in, token paste, sign-out confirmation, and a working state between them.
+ */
+import { type Component, type Focusable, type TUI } from "@earendil-works/pi-tui";
+import type { KeybindingsManager } from "../../core/keybindings.ts";
+import { type Theme } from "../../modes/interactive/theme/theme.ts";
+export interface AccountState {
+    /** Where the credential comes from, or undefined when signed out. */
+    source?: "saved" | "env";
+    /** Where a saved credential lives, or the environment variable that supplies one. */
+    location: string;
+}
+export interface PanelActions {
+    state(): AccountState;
+    /** A sign-in URL and a function that turns the pasted code or token into a verified, saved sign-in. */
+    startSignIn(): {
+        url: string;
+        complete(input: string): Promise<void>;
+    };
+    /** Verify and save a pasted token. */
+    saveToken(input: string): Promise<void>;
+    signOut(): void;
+}
+export declare class SearchPanel implements Component, Focusable {
+    private content;
+    private inputHandler;
+    private input;
+    private notice;
+    private _focused;
+    private readonly tui;
+    private readonly theme;
+    private readonly keybindings;
+    private readonly actions;
+    private readonly close;
+    constructor(tui: TUI, theme: Theme, keybindings: KeybindingsManager, actions: PanelActions, close: () => void);
+    get focused(): boolean;
+    set focused(value: boolean);
+    private show;
+    private muted;
+    private showMenu;
+    /** A screen with one text field; Enter submits a non-empty value, Esc returns to the menu. */
+    private showInputScreen;
+    private showBrowserSignIn;
+    private showPaste;
+    private showSignOut;
+    /** Show a working state while `task` runs, then return to the menu with its outcome. */
+    private run;
+    handleInput(data: string): void;
+    render(width: number): string[];
+    invalidate(): void;
+}
+//# sourceMappingURL=panel.d.ts.map

package/dist/extensions/search/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../../src/extensions/search/panel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACN,KAAK,SAAS,EAEd,KAAK,SAAS,EAMd,KAAK,GAAG,EAGR,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAIpE,OAAO,EAAsB,KAAK,KAAK,EAAE,MAAM,wCAAwC,CAAC;AAExF,MAAM,WAAW,YAAY;IAC5B,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACzB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,IAAI,YAAY,CAAC;IACtB,uGAAuG;IACvG,WAAW,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACvE,sCAAsC;IACtC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,IAAI,IAAI,CAAC;CAChB;AAID,qBAAa,WAAY,YAAW,SAAS,EAAE,SAAS;IACvD,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEvB,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,IAAI;IAS7G,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAGzB;IAED,OAAO,CAAC,IAAI;IAuBZ,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,QAAQ;IAsChB,8FAA8F;IAC9F,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;IAuBnB,wFAAwF;YAC1E,GAAG;IAejB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAM/B,UAAU,IAAI,IAAI;CAGlB"}

package/dist/extensions/search/panel.js

@@ -0,0 +1,157 @@
+/**
+ * The `/search` panel: one framed view whose screens replace each other in place — the account
+ * menu, browser sign-in, token paste, sign-out confirmation, and a working state between them.
+ */
+import { Container, Input, SelectList, Spacer, Text, truncateToWidth, visibleWidth, } from "@earendil-works/pi-tui";
+import { AuthUrlComponent } from "../../modes/interactive/components/auth-url.js";
+import { DynamicBorder } from "../../modes/interactive/components/dynamic-border.js";
+import { keyHint } from "../../modes/interactive/components/keybinding-hints.js";
+import { getSelectListTheme } from "../../modes/interactive/theme/theme.js";
+export class SearchPanel {
+    constructor(tui, theme, keybindings, actions, close) {
+        this.content = new Container();
+        this._focused = false;
+        this.tui = tui;
+        this.theme = theme;
+        this.keybindings = keybindings;
+        this.actions = actions;
+        this.close = close;
+        this.showMenu();
+    }
+    get focused() {
+        return this._focused;
+    }
+    set focused(value) {
+        this._focused = value;
+        if (this.input)
+            this.input.focused = value;
+    }
+    show(title, body, hints, handler, input) {
+        const accent = (text) => this.theme.fg("accent", text);
+        const frame = new Container();
+        frame.addChild(new DynamicBorder(accent));
+        frame.addChild(new Text(accent(this.theme.bold(title)), 1, 0));
+        for (const child of body)
+            frame.addChild(child);
+        frame.addChild(new Spacer(1));
+        frame.addChild(new Text(hints.join(this.theme.fg("dim", " • ")), 1, 0));
+        frame.addChild(new DynamicBorder(accent));
+        if (this.input)
+            this.input.focused = false;
+        this.content = frame;
+        this.inputHandler = handler;
+        this.input = input;
+        if (input)
+            input.focused = this._focused;
+        this.tui.requestRender();
+    }
+    muted(text) {
+        return new Text(this.theme.fg("muted", text), 1, 0);
+    }
+    showMenu() {
+        const { source, location } = this.actions.state();
+        const status = source
+            ? `${this.theme.fg("success", "●")} Signed in${source === "env" ? " from the environment" : ""} ${this.theme.fg("dim", `· ${location}`)}`
+            : `${this.theme.fg("dim", "○")} Not signed in ${this.theme.fg("dim", "· code_search and web_search are off")}`;
+        const body = [new Text(status, 1, 0)];
+        if (this.notice) {
+            body.push(new Text(this.theme.fg(this.notice.kind, this.notice.text), 1, 0));
+            this.notice = undefined;
+        }
+        body.push(new Spacer(1));
+        const items = [
+            {
+                value: "browser",
+                label: source ? "Switch account" : "Sign in with browser",
+                description: "Authorize on devin.ai, then paste the code",
+            },
+            { value: "paste", label: "Paste a token", description: "Use an existing Devin session token" },
+        ];
+        if (source === "saved")
+            items.push({ value: "signout", label: "Sign out", description: "Forget the saved token" });
+        const list = new SelectList(items, items.length, getSelectListTheme());
+        list.onSelect = (item) => {
+            if (item.value === "browser")
+                this.showBrowserSignIn();
+            else if (item.value === "paste")
+                this.showPaste();
+            else
+                this.showSignOut();
+        };
+        list.onCancel = () => this.close();
+        body.push(list);
+        this.show("Devin Search", body, [keyHint("tui.select.confirm", "select"), keyHint("tui.select.cancel", "close")], (data) => list.handleInput(data));
+    }
+    /** A screen with one text field; Enter submits a non-empty value, Esc returns to the menu. */
+    showInputScreen(title, intro, label, submit, extraKey) {
+        const input = new Input();
+        this.show(title, [...intro, new Spacer(1), this.muted(label), input], [keyHint("tui.select.confirm", "submit"), keyHint("tui.select.cancel", "back")], (data) => {
+            if (this.keybindings.matches(data, "tui.select.confirm")) {
+                const value = input.getValue().trim();
+                if (value)
+                    void this.run(() => submit(value));
+            }
+            else if (this.keybindings.matches(data, "tui.select.cancel")) {
+                this.showMenu();
+            }
+            else if (!extraKey?.(data)) {
+                input.handleInput(data);
+            }
+        }, input);
+    }
+    showBrowserSignIn() {
+        const attempt = this.actions.startSignIn();
+        const link = new AuthUrlComponent(this.tui, attempt.url);
+        this.showInputScreen("Sign in to Devin", [new Spacer(1), this.muted("Approve access in your browser. If it did not open, visit:"), link], "Paste the code Devin shows:", (value) => attempt.complete(value), (data) => {
+            if (!this.keybindings.matches(data, "app.message.copy"))
+                return false;
+            void link.copy();
+            return true;
+        });
+    }
+    showPaste() {
+        this.showInputScreen("Paste a token", [], "Devin session token:", (value) => this.actions.saveToken(value));
+    }
+    showSignOut() {
+        const { location } = this.actions.state();
+        const items = [
+            { value: "signout", label: "Sign out", description: `Remove the token from ${location}` },
+            { value: "back", label: "Cancel" },
+        ];
+        const list = new SelectList(items, items.length, getSelectListTheme());
+        list.onSelect = (item) => {
+            if (item.value === "signout") {
+                this.actions.signOut();
+                this.notice = { kind: "success", text: "Signed out." };
+            }
+            this.showMenu();
+        };
+        list.onCancel = () => this.showMenu();
+        this.show("Sign out of Devin?", [new Spacer(1), list], [keyHint("tui.select.confirm", "select"), keyHint("tui.select.cancel", "back")], (data) => list.handleInput(data));
+    }
+    /** Show a working state while `task` runs, then return to the menu with its outcome. */
+    async run(task) {
+        this.show("Devin Search", [new Spacer(1), this.muted("Verifying with Devin…")], [this.theme.fg("dim", "please wait")]);
+        try {
+            await task();
+            this.notice = { kind: "success", text: "Signed in — code_search and web_search are on." };
+        }
+        catch (error) {
+            this.notice = { kind: "error", text: error instanceof Error ? error.message : String(error) };
+        }
+        this.showMenu();
+    }
+    handleInput(data) {
+        this.inputHandler?.(data);
+        this.tui.requestRender();
+    }
+    render(width) {
+        return this.content
+            .render(width)
+            .map((line) => (visibleWidth(line) > width ? truncateToWidth(line, width, "") : line));
+    }
+    invalidate() {
+        this.content.invalidate();
+    }
+}
+//# sourceMappingURL=panel.js.map