@minpeter/pss-coding-agent 0.0.0

package/README.md

@@ -0,0 +1,18 @@
+# @minpeter/pss-coding-agent
+
+Coding-agent product package for pss-next. It provides TinyFish-backed web tools
+and keeps TUI startup isolated from the side-effect-free root import.
+
+```ts
+import { tools, webFetchTool, webSearchTool } from "@minpeter/pss-coding-agent";
+import { Agent } from "@minpeter/pss-runtime";
+
+const agent = new Agent({ tools });
+```
+
+Set `TINYFISH_API_KEY` before invoking `web_search` or `web_fetch`. Token pools
+can be provided as semicolon-delimited values.
+
+```bash
+node --conditions=@minpeter/pss-source --import tsx packages/coding-agent/src/tui.ts
+```

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { DefaultTools } from "./tools";
+export { tools } from "./tools";
+export type { WebFetchError, WebFetchOutput, WebFetchResult, } from "./tools/web-fetch";
+export { webFetchTool } from "./tools/web-fetch";
+export type { WebSearchOutput, WebSearchResult, } from "./tools/web-search";
+export { webSearchTool } from "./tools/web-search";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EACV,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EACV,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { tools } from "./tools/index.js";
+export { webFetchTool } from "./tools/web-fetch.js";
+export { webSearchTool } from "./tools/web-search.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMhC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/integrations/tinyfish.d.ts

@@ -0,0 +1,59 @@
+export type TinyFishFetchFormat = "markdown" | "html" | "json";
+export type JsonValue = boolean | null | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export interface TinyFishFetchRequest {
+    format: TinyFishFetchFormat;
+    image_links: boolean;
+    links: boolean;
+    urls: string[];
+}
+export interface TinyFishFetchResult {
+    author?: string;
+    description?: string;
+    final_url: string;
+    format: string;
+    image_links?: string[];
+    language?: string;
+    latency_ms?: number;
+    links?: string[];
+    published_date?: string;
+    text: JsonValue;
+    title?: string;
+    url: string;
+}
+export interface TinyFishFetchError {
+    error: string;
+    status?: number;
+    url: string;
+}
+export interface TinyFishFetchOutput {
+    errors: TinyFishFetchError[];
+    results: TinyFishFetchResult[];
+}
+export interface TinyFishSearchRequest {
+    language: string;
+    location: string;
+    page: number;
+    query: string;
+}
+export interface TinyFishSearchResult {
+    position: number;
+    site_name: string;
+    snippet: string;
+    title: string;
+    url: string;
+}
+export interface TinyFishSearchOutput {
+    page: number;
+    query: string;
+    results: TinyFishSearchResult[];
+    total_results: number;
+}
+interface TinyFishRequestOptions {
+    signal?: AbortSignal;
+}
+export declare function fetchTinyFishPages(request: TinyFishFetchRequest, options?: TinyFishRequestOptions): Promise<TinyFishFetchOutput>;
+export declare function searchTinyFishWeb(request: TinyFishSearchRequest, options?: TinyFishRequestOptions): Promise<TinyFishSearchOutput>;
+export {};
+//# sourceMappingURL=tinyfish.d.ts.map

package/dist/integrations/tinyfish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tinyfish.d.ts","sourceRoot":"","sources":["../../src/integrations/tinyfish.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/D,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,IAAI,GACJ,MAAM,GACN,MAAM,GACN,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAOD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AASD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,sBAAsB;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAKD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,mBAAmB,CAAC,CAgB9B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC,CAkB/B"}

package/dist/integrations/tinyfish.js

@@ -0,0 +1,221 @@
+import { z } from "zod";
+import { readObject, readOptionalNumber, readOptionalString, readRequiredArray, readRequiredNumber, readRequiredString, readStringArray, } from "../utils/unknown.js";
+const fetchEndpoint = "https://api.fetch.tinyfish.ai";
+const requiredApiKeyError = "TINYFISH_API_KEY is required to use the built-in TinyFish web tools.";
+const searchEndpoint = "https://api.search.tinyfish.ai";
+const tinyFishApiKeyPoolSchema = z
+    .string()
+    .default("")
+    .transform((value) => value
+    .split(";")
+    .map((segment) => segment.trim())
+    .filter((segment) => segment.length > 0));
+let tinyFishApiKeyPoolSource;
+let tinyFishApiKeyIndex = 0;
+export async function fetchTinyFishPages(request, options = {}) {
+    const body = await requestTinyFishJson("fetch", (apiKey) => fetch(fetchEndpoint, {
+        body: JSON.stringify(request),
+        headers: {
+            "Content-Type": "application/json",
+            "X-API-Key": apiKey,
+        },
+        method: "POST",
+        signal: options.signal,
+    }));
+    return sanitizeFetchResponse(body);
+}
+export async function searchTinyFishWeb(request, options = {}) {
+    const url = new URL(searchEndpoint);
+    url.searchParams.set("query", request.query);
+    url.searchParams.set("location", request.location);
+    url.searchParams.set("language", request.language);
+    url.searchParams.set("page", String(request.page));
+    const body = await requestTinyFishJson("search", (apiKey) => fetch(url.toString(), {
+        headers: { "X-API-Key": apiKey },
+        method: "GET",
+        signal: options.signal,
+    }));
+    return sanitizeSearchResponse(body);
+}
+function getTinyFishApiKeyAttemptOrder() {
+    const apiKeys = getTinyFishApiKeyPool();
+    const startIndex = tinyFishApiKeyIndex % apiKeys.length;
+    tinyFishApiKeyIndex = (startIndex + 1) % apiKeys.length;
+    return [...apiKeys.slice(startIndex), ...apiKeys.slice(0, startIndex)];
+}
+function getTinyFishApiKeyPool() {
+    const apiKeyPoolSource = process.env.TINYFISH_API_KEY;
+    if (apiKeyPoolSource !== tinyFishApiKeyPoolSource) {
+        tinyFishApiKeyPoolSource = apiKeyPoolSource;
+        tinyFishApiKeyIndex = 0;
+    }
+    const apiKeys = tinyFishApiKeyPoolSchema.parse(apiKeyPoolSource);
+    if (apiKeys.length === 0) {
+        throw new Error(requiredApiKeyError);
+    }
+    return apiKeys;
+}
+async function parseTinyFishJsonResponse(response, serviceName) {
+    const bodyText = await response.text();
+    const { parseError, value } = parseJsonBody(bodyText);
+    if (!response.ok) {
+        throw createTinyFishHttpError(response, serviceName, value, parseError);
+    }
+    if (parseError) {
+        throw new Error(`TinyFish returned invalid JSON: ${parseError}`);
+    }
+    return value;
+}
+async function requestTinyFishJson(serviceName, requestWithApiKey) {
+    const [firstApiKey, ...remainingApiKeys] = getTinyFishApiKeyAttemptOrder();
+    const firstResponse = await requestWithApiKey(firstApiKey);
+    if (firstResponse.status !== 429) {
+        return parseTinyFishJsonResponse(firstResponse, serviceName);
+    }
+    let lastRateLimitError = await readTinyFishHttpError(firstResponse, serviceName);
+    for (const apiKey of remainingApiKeys) {
+        const response = await requestWithApiKey(apiKey);
+        if (response.status !== 429) {
+            return parseTinyFishJsonResponse(response, serviceName);
+        }
+        lastRateLimitError = await readTinyFishHttpError(response, serviceName);
+    }
+    if (remainingApiKeys.length === 0) {
+        throw lastRateLimitError;
+    }
+    throw new Error(`${lastRateLimitError.message} (all ${remainingApiKeys.length + 1} configured TinyFish API keys returned HTTP 429)`);
+}
+async function readTinyFishHttpError(response, serviceName) {
+    const bodyText = await response.text();
+    const { parseError, value } = parseJsonBody(bodyText);
+    return createTinyFishHttpError(response, serviceName, value, parseError);
+}
+function createTinyFishHttpError(response, serviceName, body, parseError) {
+    const retryAfter = response.headers.get("retry-after");
+    const retryAfterMessage = retryAfter ? ` Retry-After: ${retryAfter}.` : "";
+    return new Error(`TinyFish ${serviceName} request failed with HTTP ${response.status}: ${readErrorMessage(body, parseError)}.${retryAfterMessage}`);
+}
+function sanitizeFetchResponse(response) {
+    const results = readRequiredArray(response.results, "TinyFish fetch results");
+    const errors = readRequiredArray(response.errors, "TinyFish fetch errors");
+    return {
+        results: results.map(sanitizeFetchResult),
+        errors: errors.map(sanitizeFetchError),
+    };
+}
+function sanitizeFetchResult(value) {
+    const object = readObject(value);
+    assertHasField(object, "text", "fetch results[].text");
+    const result = {
+        final_url: readRequiredString(object.final_url, "TinyFish fetch results[].final_url"),
+        format: readRequiredString(object.format, "TinyFish fetch results[].format"),
+        text: normalizeJsonValue(object.text),
+        url: readRequiredString(object.url, "TinyFish fetch results[].url"),
+    };
+    const optionalStrings = {
+        author: readOptionalString(object.author),
+        description: readOptionalString(object.description),
+        language: readOptionalString(object.language),
+        published_date: readOptionalString(object.published_date),
+        title: readOptionalString(object.title),
+    };
+    const latencyMs = readOptionalNumber(object.latency_ms);
+    const links = readStringArray(object.links);
+    const imageLinks = readStringArray(object.image_links);
+    for (const [key, optionalValue] of Object.entries(optionalStrings)) {
+        if (optionalValue !== undefined) {
+            result[key] = optionalValue;
+        }
+    }
+    if (latencyMs !== undefined) {
+        result.latency_ms = latencyMs;
+    }
+    if (links !== undefined) {
+        result.links = links;
+    }
+    if (imageLinks !== undefined) {
+        result.image_links = imageLinks;
+    }
+    return result;
+}
+function sanitizeFetchError(value) {
+    const object = readObject(value);
+    const error = {
+        error: readRequiredString(object.error, "TinyFish fetch errors[].error"),
+        url: readRequiredString(object.url, "TinyFish fetch errors[].url"),
+    };
+    const status = readOptionalNumber(object.status);
+    if (status !== undefined) {
+        error.status = status;
+    }
+    return error;
+}
+function sanitizeSearchResponse(response) {
+    const results = readRequiredArray(response.results, "TinyFish search results");
+    return {
+        page: readRequiredNumber(response.page, "TinyFish search page"),
+        query: readRequiredString(response.query, "TinyFish search query"),
+        results: results.map(sanitizeSearchResult),
+        total_results: readRequiredNumber(response.total_results, "TinyFish search total_results"),
+    };
+}
+function sanitizeSearchResult(value) {
+    const object = readObject(value);
+    return {
+        position: readRequiredNumber(object.position, "TinyFish search results[].position"),
+        site_name: readRequiredString(object.site_name, "TinyFish search results[].site_name"),
+        snippet: readRequiredString(object.snippet, "TinyFish search results[].snippet"),
+        title: readRequiredString(object.title, "TinyFish search results[].title"),
+        url: readRequiredString(object.url, "TinyFish search results[].url"),
+    };
+}
+function assertHasField(object, key, fieldName) {
+    if (!Object.hasOwn(object, key)) {
+        throw new Error(`Expected TinyFish ${fieldName} to be present.`);
+    }
+}
+function normalizeJsonValue(value) {
+    if (value === null ||
+        typeof value === "boolean" ||
+        typeof value === "number" ||
+        typeof value === "string") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(normalizeJsonValue);
+    }
+    if (typeof value === "object" && value !== null) {
+        const normalized = {};
+        for (const [key, nestedValue] of Object.entries(value)) {
+            normalized[key] = normalizeJsonValue(nestedValue);
+        }
+        return normalized;
+    }
+    return null;
+}
+function parseJsonBody(bodyText) {
+    if (!bodyText.trim()) {
+        return { value: {} };
+    }
+    try {
+        return { value: JSON.parse(bodyText) };
+    }
+    catch (error) {
+        return {
+            parseError: error instanceof Error ? error.message : String(error),
+            value: bodyText,
+        };
+    }
+}
+function readErrorMessage(body, parseError) {
+    if (parseError) {
+        return `invalid JSON response body: ${parseError}`;
+    }
+    const error = readObject(readObject(body).error);
+    const message = readOptionalString(error.message);
+    if (message) {
+        return message;
+    }
+    return JSON.stringify(body);
+}
+//# sourceMappingURL=tinyfish.js.map

package/dist/integrations/tinyfish.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,4 @@
+import type { AgentTools } from "@minpeter/pss-runtime";
+export declare const tools: AgentTools;
+export type DefaultTools = typeof tools;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD,eAAO,MAAM,KAAK,EAAE,UAGnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,OAAO,KAAK,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,7 @@
+import { webFetchTool as defaultWebFetchTool } from "./web-fetch.js";
+import { webSearchTool as defaultWebSearchTool } from "./web-search.js";
+export const tools = {
+    web_fetch: defaultWebFetchTool,
+    web_search: defaultWebSearchTool,
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,IAAI,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,aAAa,IAAI,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,SAAS,EAAE,mBAAmB;IAC9B,UAAU,EAAE,oBAAoB;CACjC,CAAC"}

package/dist/tools/web-fetch.d.ts

@@ -0,0 +1,6 @@
+import { type TinyFishFetchError, type TinyFishFetchOutput, type TinyFishFetchResult } from "../integrations/tinyfish";
+export type WebFetchResult = TinyFishFetchResult;
+export type WebFetchError = TinyFishFetchError;
+export type WebFetchOutput = TinyFishFetchOutput;
+export declare const webFetchTool: unknown;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/tools/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAExB,KAAK,mBAAmB,EACzB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AACjD,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAC/C,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAQjD,eAAO,MAAM,YAAY,EAAE,OA6BzB,CAAC"}

package/dist/tools/web-fetch.js

@@ -0,0 +1,69 @@
+import { jsonSchema, tool } from "ai";
+import { fetchTinyFishPages, } from "../integrations/tinyfish.js";
+import { readObject, readString } from "../utils/unknown.js";
+const fetchDefaults = {
+    format: "markdown",
+    image_links: false,
+    links: false,
+};
+export const webFetchTool = tool({
+    description: "Fetch and extract readable content from up to 10 absolute HTTP(S) URLs. Use after web_search or when the user provides URLs; markdown is the best default format for LLM context.",
+    execute: (input, options) => {
+        const request = parseWebFetchInput(input);
+        return fetchTinyFishPages(request, { signal: options?.abortSignal });
+    },
+    inputSchema: jsonSchema({
+        additionalProperties: false,
+        description: "URLs to fetch. Format and link extraction are intentionally managed by the tool.",
+        properties: {
+            urls: {
+                description: "Absolute http or https URLs to fetch. Maximum 10 URLs per request.",
+                items: {
+                    description: "Absolute http or https URL.",
+                    format: "uri",
+                    type: "string",
+                },
+                maxItems: 10,
+                minItems: 1,
+                type: "array",
+            },
+        },
+        required: ["urls"],
+        type: "object",
+    }),
+});
+function parseWebFetchInput(input) {
+    const object = readObject(input);
+    const urls = readUrls(object.urls);
+    return {
+        ...fetchDefaults,
+        urls,
+    };
+}
+function readUrls(value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new Error("web_fetch requires at least one URL.");
+    }
+    if (value.length > 10) {
+        throw new Error("web_fetch accepts at most 10 URLs per request.");
+    }
+    return value.map((item) => readHttpUrl(item));
+}
+function readHttpUrl(value) {
+    const url = readString(value).trim();
+    if (!url) {
+        throw new Error("web_fetch URLs must be non-empty strings.");
+    }
+    let parsedUrl;
+    try {
+        parsedUrl = new URL(url);
+    }
+    catch {
+        throw new Error("web_fetch URLs must be valid absolute http or https URLs.");
+    }
+    if (parsedUrl.protocol !== "http:" && parsedUrl.protocol !== "https:") {
+        throw new Error("web_fetch only accepts http and https URLs.");
+    }
+    return parsedUrl.href;
+}
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/web-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.js","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,EACL,kBAAkB,GAKnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM1D,MAAM,aAAa,GAAG;IACpB,MAAM,EAAE,UAAU;IAClB,WAAW,EAAE,KAAK;IAClB,KAAK,EAAE,KAAK;CAC4D,CAAC;AAE3E,MAAM,CAAC,MAAM,YAAY,GAAY,IAAI,CAAC;IACxC,WAAW,EACT,mLAAmL;IACrL,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAA2B,EAAE;QACnD,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAE1C,OAAO,kBAAkB,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,WAAW,EAAE,UAAU,CAAC;QACtB,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EACT,kFAAkF;QACpF,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,WAAW,EACT,oEAAoE;gBACtE,KAAK,EAAE;oBACL,WAAW,EAAE,6BAA6B;oBAC1C,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,QAAQ;iBACf;gBACD,QAAQ,EAAE,EAAE;gBACZ,QAAQ,EAAE,CAAC;gBACX,IAAI,EAAE,OAAO;aACd;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,IAAI,EAAE,QAAQ;KACf,CAAC;CACH,CAAC,CAAC;AAEH,SAAS,kBAAkB,CAAC,KAAc;IACxC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEnC,OAAO;QACL,GAAG,aAAa;QAChB,IAAI;KACL,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAErC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,SAAc,CAAC;IAEnB,IAAI,CAAC;QACH,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,KAAK,OAAO,IAAI,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,SAAS,CAAC,IAAI,CAAC;AACxB,CAAC"}

package/dist/tools/web-search.d.ts

@@ -0,0 +1,5 @@
+import { type TinyFishSearchOutput, type TinyFishSearchResult } from "../integrations/tinyfish";
+export type WebSearchResult = TinyFishSearchResult;
+export type WebSearchOutput = TinyFishSearchOutput;
+export declare const webSearchTool: unknown;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEnD,eAAO,MAAM,aAAa,EAAE,OAuB1B,CAAC"}

package/dist/tools/web-search.js

@@ -0,0 +1,37 @@
+import { jsonSchema, tool } from "ai";
+import { searchTinyFishWeb, } from "../integrations/tinyfish.js";
+import { readObject, readString } from "../utils/unknown.js";
+export const webSearchTool = tool({
+    description: "Search the public web for current or external information. Returns ranked results with titles, snippets, and URLs; use web_fetch afterward to read full page content.",
+    execute: (input, options) => {
+        const request = parseWebSearchInput(input);
+        return searchTinyFishWeb(request, { signal: options?.abortSignal });
+    },
+    inputSchema: jsonSchema({
+        additionalProperties: false,
+        description: "Search query. Locale and pagination are intentionally managed by the tool.",
+        properties: {
+            query: {
+                description: "Non-empty search query. Search operators such as site:example.com or -site:example.com may be included.",
+                minLength: 1,
+                type: "string",
+            },
+        },
+        required: ["query"],
+        type: "object",
+    }),
+});
+function parseWebSearchInput(input) {
+    const object = readObject(input);
+    const query = readString(object.query).trim();
+    if (!query) {
+        throw new Error("web_search requires a non-empty query string.");
+    }
+    return {
+        language: "en",
+        location: "US",
+        page: 0,
+        query,
+    };
+}
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AACtC,OAAO,EACL,iBAAiB,GAIlB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK1D,MAAM,CAAC,MAAM,aAAa,GAAY,IAAI,CAAC;IACzC,WAAW,EACT,uKAAuK;IACzK,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAA4B,EAAE;QACpD,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAE3C,OAAO,iBAAiB,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,WAAW,EAAE,UAAU,CAAC;QACtB,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EACT,4EAA4E;QAC9E,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,WAAW,EACT,yGAAyG;gBAC3G,SAAS,EAAE,CAAC;gBACZ,IAAI,EAAE,QAAQ;aACf;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,IAAI,EAAE,QAAQ;KACf,CAAC;CACH,CAAC,CAAC;AAEH,SAAS,mBAAmB,CAAC,KAAc;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAE9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,CAAC;QACP,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/tui-tool-printer.d.ts

@@ -0,0 +1,16 @@
+export interface TuiToolCallView {
+    input: unknown;
+    toolCallId: string;
+    toolName: string;
+}
+export interface TuiToolResultView {
+    output: unknown;
+    toolCallId: string;
+    toolName: string;
+}
+export declare const safeText: (text: string) => string;
+export declare const safeInlineText: (text: string) => string;
+export declare const truncateDetail: (text: string, maxLength?: number) => string;
+export declare function formatToolCallForTui(event: TuiToolCallView): string;
+export declare function formatToolResultForTui(event: TuiToolResultView): string;
+//# sourceMappingURL=tui-tool-printer.d.ts.map

package/dist/tui-tool-printer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-tool-printer.d.ts","sourceRoot":"","sources":["../src/tui-tool-printer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAWD,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,MAG3B,CAAC;AAEd,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,MACS,CAAC;AAExD,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,kBAA2B,KAC1B,MACqE,CAAC;AAEzE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAEnE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAEvE"}

package/dist/tui-tool-printer.js

@@ -0,0 +1,122 @@
+const defaultJsonLength = 220;
+const darkGrayText = "\x1b[90m";
+const errorPrefixPattern = /^Error: /;
+const maxDetailLength = 600;
+const resetText = "\x1b[0m";
+const toolCallIdDisplayEnd = 13;
+const toolCallIdDisplayStart = 5;
+const whitespacePattern = /\s+/g;
+export const safeText = (text) => Array.from(text)
+    .filter((value) => !isTerminalControlCharacter(value))
+    .join("");
+export const safeInlineText = (text) => safeText(text).replace(whitespacePattern, " ").trim();
+export const truncateDetail = (text, maxLength = maxDetailLength) => text.length <= maxLength ? text : `${text.slice(0, maxLength - 3)}...`;
+export function formatToolCallForTui(event) {
+    return `${formatToolLabel(event)} ${formatToolInput(event.input)}`;
+}
+export function formatToolResultForTui(event) {
+    return `${formatToolLabel(event)} ${formatToolOutput(event.output)}`;
+}
+function formatToolLabel(event) {
+    return `${safeInlineText(event.toolName)}${darkGrayText}#${shortToolCallId(event.toolCallId)}${resetText}`;
+}
+function isTerminalControlCharacter(value) {
+    const code = value.codePointAt(0);
+    return (code !== undefined &&
+        (code <= 0x08 ||
+            (code >= 0x0b && code <= 0x1f) ||
+            (code >= 0x7f && code <= 0x9f)));
+}
+function safeJson(value, maxLength = maxDetailLength) {
+    try {
+        return truncateDetail(safeInlineText(JSON.stringify(value) ?? "undefined"), maxLength);
+    }
+    catch {
+        return truncateDetail(safeInlineText(String(value)), maxLength);
+    }
+}
+function shortToolCallId(toolCallId) {
+    // Fixed display window: do not parse separators; AI SDK call IDs usually put
+    // the useful unique block after "call-", while other providers still render consistently.
+    return safeInlineText(toolCallId.slice(toolCallIdDisplayStart, toolCallIdDisplayEnd));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function quoted(value, maxLength = 80) {
+    return `"${truncateDetail(safeInlineText(value), maxLength)}"`;
+}
+function formatToolInput(input) {
+    if (isRecord(input)) {
+        const knownInput = formatKnownToolInput(input);
+        if (knownInput) {
+            return knownInput;
+        }
+    }
+    return `input=${safeJson(input, 120)}`;
+}
+function formatKnownToolInput(input) {
+    if (typeof input.query === "string") {
+        return `query=${quoted(input.query)}`;
+    }
+    if (Array.isArray(input.urls)) {
+        return formatUrls(input.urls);
+    }
+}
+function formatUrls(urls) {
+    const first = urls[0];
+    const label = typeof first === "string" ? first : String(first);
+    return `urls=${urls.length} first=${quoted(label, 40)}`;
+}
+function formatToolOutput(output) {
+    if (!isRecord(output) || typeof output.type !== "string") {
+        return `output=${safeJson(output, defaultJsonLength)}`;
+    }
+    if (output.type === "json") {
+        return `json ${formatJsonOutputValue(output.value)}`;
+    }
+    if (typeof output.value === "string") {
+        return `${output.type}=${quoted(output.value.replace(errorPrefixPattern, ""), 72)}`;
+    }
+    if (output.type === "execution-denied") {
+        return `denied=${quoted(String(output.reason ?? "no reason"), 100)}`;
+    }
+    return `${output.type} ${safeJson(output, 160)}`;
+}
+function formatJsonOutputValue(value) {
+    if (!isRecord(value)) {
+        return safeJson(value, defaultJsonLength);
+    }
+    const knownOutput = formatKnownJsonOutputValue(value);
+    return knownOutput ?? safeJson(value, defaultJsonLength);
+}
+function formatKnownJsonOutputValue(value) {
+    const parts = [];
+    if (Array.isArray(value.results)) {
+        parts.push(`results=${value.results.length}`);
+        const title = firstResultTitle(value.results);
+        if (title) {
+            parts.push(`top=${quoted(title, 36)}`);
+        }
+    }
+    if (Array.isArray(value.errors)) {
+        parts.push(`errors=${value.errors.length}`);
+    }
+    return parts.length > 0 ? parts.join(" ") : undefined;
+}
+function firstResultTitle(results) {
+    const first = results.find(isRecord);
+    if (!first) {
+        return;
+    }
+    if (typeof first.title === "string") {
+        return first.title;
+    }
+    if (typeof first.final_url === "string") {
+        return first.final_url;
+    }
+    if (typeof first.url === "string") {
+        return first.url;
+    }
+}
+//# sourceMappingURL=tui-tool-printer.js.map

package/dist/tui-tool-printer.js.map

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

package/dist/tui.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tui.d.ts.map

package/dist/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":""}

package/dist/tui.js

@@ -0,0 +1,91 @@
+import { Container, Input, matchesKey, ProcessTerminal, Text, TUI, } from "@earendil-works/pi-tui";
+import { Agent } from "@minpeter/pss-runtime";
+import { tools } from "./tools/index.js";
+import { formatToolCallForTui, formatToolResultForTui, safeInlineText, safeText, truncateDetail, } from "./tui-tool-printer.js";
+const agent = new Agent({
+    instructions: "Answer in 2 short sentences and 280 characters or fewer unless the user explicitly asks for detail. Avoid headings.",
+    tools,
+});
+const session = agent.createSession();
+const terminal = new ProcessTerminal();
+const tui = new TUI(terminal);
+const chat = new Container();
+const input = new Input();
+tui.addChild(new Text("\x1b[1mpss-next\x1b[0m \x1b[2m(Esc to interrupt · Ctrl-C to quit)\x1b[0m", 1, 0));
+tui.addChild(chat);
+tui.addChild(input);
+tui.setFocus(input);
+let finish;
+const done = new Promise((resolve) => {
+    finish = resolve;
+});
+const addLine = (text) => {
+    chat.addChild(new Text(text, 1, 0));
+    tui.requestRender();
+};
+const formatEvent = (event) => {
+    switch (event.type) {
+        case "user-text":
+            return `\x1b[36myou\x1b[0m: ${safeText(event.text)}`;
+        case "assistant-text":
+            return `\x1b[32massistant\x1b[0m: ${safeText(event.text)}`;
+        case "assistant-reasoning":
+            return `\x1b[35mreasoning\x1b[0m: ${truncateDetail(safeInlineText(event.text), 240)}`;
+        case "tool-call":
+            return `\x1b[33mtool\x1b[0m ${formatToolCallForTui(event)}`;
+        case "tool-result":
+            return `\x1b[33mtool result\x1b[0m ${formatToolResultForTui(event)}`;
+        case "turn-start":
+            return "\x1b[2mrunning...\x1b[0m";
+        case "turn-abort":
+            return "\x1b[2minterrupted\x1b[0m";
+        case "turn-error":
+            return `\x1b[31merror\x1b[0m: ${safeText(event.message)}`;
+        case "turn-end":
+            return "\x1b[2mdone\x1b[0m";
+        case "step-start":
+        case "step-end":
+            return;
+        default:
+            return;
+    }
+};
+session.subscribe((event) => {
+    const line = formatEvent(event);
+    if (line) {
+        addLine(line);
+    }
+});
+input.onSubmit = (text) => {
+    input.setValue("");
+    const trimmed = text.trim();
+    if (!trimmed) {
+        tui.requestRender();
+        return;
+    }
+    session
+        .submit({ type: "user-text", text: trimmed })
+        .catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        addLine(`\x1b[31merror\x1b[0m: ${safeText(message)}`);
+    });
+};
+const removeInputListener = tui.addInputListener((data) => {
+    // Avoid input.onEscape because pi-tui maps both Escape and Ctrl-C to it.
+    if (matchesKey(data, "escape")) {
+        session.interrupt();
+        return { consume: true };
+    }
+    if (!matchesKey(data, "ctrl+c")) {
+        return;
+    }
+    removeInputListener();
+    session.kill();
+    tui.stop();
+    finish();
+    return { consume: true };
+});
+tui.start();
+tui.requestRender();
+await done;
+//# sourceMappingURL=tui.js.map

package/dist/tui.js.map

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

package/dist/utils/unknown.d.ts

@@ -0,0 +1,9 @@
+export declare function readObject(value: unknown): Record<string, unknown>;
+export declare function readString(value: unknown): string;
+export declare function readRequiredString(value: unknown, fieldName: string): string;
+export declare function readOptionalString(value: unknown): string | undefined;
+export declare function readRequiredNumber(value: unknown, fieldName: string): number;
+export declare function readRequiredArray(value: unknown, fieldName: string): unknown[];
+export declare function readOptionalNumber(value: unknown): number | undefined;
+export declare function readStringArray(value: unknown): string[] | undefined;
+//# sourceMappingURL=unknown.d.ts.map

package/dist/utils/unknown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown.d.ts","sourceRoot":"","sources":["../../src/utils/unknown.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMlE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAErE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,EAAE,CAMX;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIrE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAMpE"}

package/dist/utils/unknown.js

@@ -0,0 +1,42 @@
+export function readObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return {};
+    }
+    return value;
+}
+export function readString(value) {
+    return typeof value === "string" ? value : "";
+}
+export function readRequiredString(value, fieldName) {
+    if (typeof value !== "string") {
+        throw new Error(`Expected ${fieldName} to be a string.`);
+    }
+    return value;
+}
+export function readOptionalString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+export function readRequiredNumber(value, fieldName) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new Error(`Expected ${fieldName} to be a finite number.`);
+    }
+    return value;
+}
+export function readRequiredArray(value, fieldName) {
+    if (!Array.isArray(value)) {
+        throw new Error(`Expected ${fieldName} to be an array.`);
+    }
+    return value;
+}
+export function readOptionalNumber(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? value
+        : undefined;
+}
+export function readStringArray(value) {
+    if (!Array.isArray(value)) {
+        return;
+    }
+    return value.filter((item) => typeof item === "string");
+}
+//# sourceMappingURL=unknown.js.map

package/dist/utils/unknown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown.js","sourceRoot":"","sources":["../../src/utils/unknown.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,SAAiB;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,kBAAkB,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,SAAiB;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,yBAAyB,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAc,EACd,SAAiB;IAEjB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,kBAAkB,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACxD,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@minpeter/pss-coding-agent",
+  "version": "0.0.0",
+  "description": "Coding-agent product tools and TUI wiring for pss-next.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "@minpeter/pss-source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./tui": {
+      "@minpeter/pss-source": "./src/tui.ts",
+      "types": "./dist/tui.d.ts",
+      "import": "./dist/tui.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/minpeter/pss-next.git",
+    "directory": "packages/coding-agent"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@earendil-works/pi-tui": "^0.74.1",
+    "ai": "7.0.0-canary.142",
+    "zod": "^4.4.3",
+    "@minpeter/pss-runtime": "0.0.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && node ../../scripts/fix-esm-imports.mjs dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "ultracite check ."
+  }
+}