@octelium/console-agent 0.1.0-b-ca02.1.1

package/dist/agent/tools/present.d.ts

@@ -0,0 +1,61 @@
+import { Type } from "@earendil-works/pi-ai";
+import { type ChartSpec, type TableBlock, type TableColumn } from "../../protocol/index.ts";
+import type { FileStore } from "../../store/files.ts";
+import { type ToolDeps } from "./util.ts";
+export declare const PRESENTATION_TOOL_NAMES: string[];
+export declare const MAX_TABLE_ROWS = 500;
+export declare const MAX_CHART_ROWS = 2000;
+export declare const MAX_ARTIFACT_BYTES: number;
+export declare const MAX_SNAPSHOTS = 50;
+export declare const MAX_SNAPSHOT_CHARS: number;
+export interface PresentToolDeps extends ToolDeps {
+    files: FileStore;
+}
+export declare const buildTable: (rows: Record<string, unknown>[], columns?: TableColumn[]) => Pick<TableBlock, "columns" | "rows" | "totalRows" | "truncated">;
+export declare const buildChart: (spec: Omit<ChartSpec, "rows">, rows: Record<string, unknown>[]) => ChartSpec;
+export declare const createPresentationTools: (deps: PresentToolDeps) => ((import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+    title: Type.TOptional<Type.TString>;
+    caption: Type.TOptional<Type.TString>;
+    columns: Type.TOptional<Type.TArray<Type.TObject<{
+        key: Type.TString;
+        label: Type.TOptional<Type.TString>;
+        type: Type.TOptional<Type.TEnum<["string", "number", "boolean", "datetime", "json"]>>;
+        unit: Type.TOptional<Type.TString>;
+    }>>>;
+    rows: Type.TOptional<Type.TArray<Type.TObject<{}>>>;
+    dataPath: Type.TOptional<Type.TString>;
+}>, import("../../protocol/index.ts").ToolDetails | undefined, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>) | (import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+    chartType: Type.TEnum<["line", "area", "bar", "pie", "scatter"]>;
+    title: Type.TOptional<Type.TString>;
+    description: Type.TOptional<Type.TString>;
+    x: Type.TObject<{
+        key: Type.TString;
+        label: Type.TOptional<Type.TString>;
+        type: Type.TOptional<Type.TEnum<["time", "category", "number"]>>;
+    }>;
+    y: Type.TOptional<Type.TObject<{
+        label: Type.TOptional<Type.TString>;
+        unit: Type.TOptional<Type.TString>;
+    }>>;
+    series: Type.TArray<Type.TObject<{
+        key: Type.TString;
+        label: Type.TOptional<Type.TString>;
+        unit: Type.TOptional<Type.TString>;
+    }>>;
+    stacked: Type.TOptional<Type.TBoolean>;
+    rows: Type.TOptional<Type.TArray<Type.TObject<{}>>>;
+    dataPath: Type.TOptional<Type.TString>;
+}>, import("../../protocol/index.ts").ToolDetails | undefined, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>) | (import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+    title: Type.TOptional<Type.TString>;
+    resources: Type.TArray<Type.TObject<{
+        apiVersion: Type.TString;
+        kind: Type.TString;
+        name: Type.TString;
+    }>>;
+}>, import("../../protocol/index.ts").ToolDetails | undefined, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>) | (import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+    path: Type.TString;
+    title: Type.TOptional<Type.TString>;
+    description: Type.TOptional<Type.TString>;
+    name: Type.TOptional<Type.TString>;
+    mimeType: Type.TOptional<Type.TString>;
+}>, import("../../protocol/index.ts").ToolDetails | undefined, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>))[];

package/dist/agent/tools/present.js

@@ -0,0 +1,273 @@
+import * as fs from "node:fs";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { Type } from "@earendil-works/pi-ai";
+import { formatResourceURI, } from "../../protocol/index.js";
+import { errorResult, readRowsFile, requireRunContext, resolvePath, textResult, } from "./util.js";
+export const PRESENTATION_TOOL_NAMES = [
+    "present_table",
+    "present_chart",
+    "present_resources",
+    "publish_artifact",
+];
+export const MAX_TABLE_ROWS = 500;
+export const MAX_CHART_ROWS = 2000;
+export const MAX_ARTIFACT_BYTES = 512 * 1024 * 1024;
+export const MAX_SNAPSHOTS = 50;
+export const MAX_SNAPSHOT_CHARS = 16 * 1024;
+const isRecord = (arg) => typeof arg === "object" && arg !== null && !Array.isArray(arg);
+const loadRows = (deps, rows, dataPath) => {
+    if (dataPath) {
+        return readRowsFile(resolvePath(deps.workDir, dataPath));
+    }
+    return (rows ?? []);
+};
+const columnTypes = Type.Enum([
+    "string",
+    "number",
+    "boolean",
+    "datetime",
+    "json",
+]);
+const inferColumnType = (rows, key) => {
+    const values = rows
+        .slice(0, 50)
+        .map((row) => row[key])
+        .filter((v) => v !== undefined && v !== null && v !== "");
+    if (values.length === 0) {
+        return "string";
+    }
+    if (values.every((v) => typeof v === "number")) {
+        return "number";
+    }
+    if (values.every((v) => typeof v === "boolean")) {
+        return "boolean";
+    }
+    if (values.some((v) => typeof v === "object")) {
+        return "json";
+    }
+    if (values.every((v) => typeof v === "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/.test(v))) {
+        return "datetime";
+    }
+    return "string";
+};
+export const buildTable = (rows, columns) => {
+    if (!rows.every(isRecord)) {
+        throw new Error("Every row must be a JSON object");
+    }
+    const cols = columns && columns.length > 0
+        ? columns
+        : [...new Set(rows.slice(0, 100).flatMap((row) => Object.keys(row)))].map((key) => ({ key }));
+    if (cols.length === 0) {
+        throw new Error("The table has no columns");
+    }
+    const resolved = cols.map((col) => ({
+        ...col,
+        type: col.type ?? inferColumnType(rows, col.key),
+    }));
+    const shown = rows
+        .slice(0, MAX_TABLE_ROWS)
+        .map((row) => Object.fromEntries(resolved.map((col) => [col.key, row[col.key] ?? null])));
+    return {
+        columns: resolved,
+        rows: shown,
+        totalRows: rows.length,
+        truncated: rows.length > MAX_TABLE_ROWS || undefined,
+    };
+};
+export const buildChart = (spec, rows) => {
+    if (!rows.every(isRecord)) {
+        throw new Error("Every row must be a JSON object");
+    }
+    if (rows.length === 0) {
+        throw new Error("The chart has no data rows");
+    }
+    if (spec.series.length === 0) {
+        throw new Error("The chart must have at least one series");
+    }
+    const keys = new Set(rows.slice(0, 100).flatMap((row) => Object.keys(row)));
+    const missing = [spec.x.key, ...spec.series.map((s) => s.key)].filter((key) => !keys.has(key));
+    if (missing.length > 0) {
+        throw new Error(`The rows do not contain the key(s): ${missing.join(", ")}. Available keys: ${[...keys].join(", ")}`);
+    }
+    const normalized = rows.slice(0, MAX_CHART_ROWS).map((row) => {
+        const ret = {};
+        const x = row[spec.x.key];
+        ret[spec.x.key] =
+            typeof x === "number" || typeof x === "string"
+                ? x
+                : x == null
+                    ? null
+                    : String(x);
+        for (const s of spec.series) {
+            const v = row[s.key];
+            const num = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+            ret[s.key] = Number.isFinite(num) ? num : null;
+        }
+        return ret;
+    });
+    if (spec.series.every((s) => normalized.every((row) => row[s.key] === null))) {
+        throw new Error("The series values must be numeric");
+    }
+    return { ...spec, rows: normalized };
+};
+export const createPresentationTools = (deps) => {
+    const table = defineTool({
+        name: "present_table",
+        label: "Present table",
+        description: `Render a table in the User's chat UI. Prefer it over Markdown tables for more than a few rows or columns. Provide either "rows" (an array of objects) or "dataPath" (a JSON array, JSONL or CSV file). At most ${MAX_TABLE_ROWS} rows are shown.`,
+        parameters: Type.Object({
+            title: Type.Optional(Type.String()),
+            caption: Type.Optional(Type.String()),
+            columns: Type.Optional(Type.Array(Type.Object({
+                key: Type.String({
+                    description: "The key of the value in each row",
+                }),
+                label: Type.Optional(Type.String()),
+                type: Type.Optional(columnTypes),
+                unit: Type.Optional(Type.String()),
+            }), {
+                description: "The columns to show. Inferred from the rows if omitted.",
+            })),
+            rows: Type.Optional(Type.Array(Type.Object({}, { additionalProperties: true }))),
+            dataPath: Type.Optional(Type.String({ description: "Path to a JSON, JSONL or CSV data file" })),
+        }),
+        async execute(_toolCallId, params) {
+            const ctx = requireRunContext(deps);
+            let result;
+            try {
+                result = buildTable(loadRows(deps, params.rows, params.dataPath), params.columns);
+            }
+            catch (err) {
+                return errorResult(`Could not render the table: ${err.message}`);
+            }
+            const block = ctx.builder.addBlock({
+                type: "table",
+                title: params.title,
+                caption: params.caption,
+                ...result,
+            });
+            return textResult(`Rendered a table (${result.totalRows} rows${result.truncated ? `, ${MAX_TABLE_ROWS} shown` : ""}) as block ${block.id}. Do not repeat its content in your answer.`);
+        },
+    });
+    const chart = defineTool({
+        name: "present_chart",
+        label: "Present chart",
+        description: `Render a chart in the User's chat UI (line, area, bar, pie or scatter). Each row is an object holding the x value under x.key and one numeric value per series key. For a pie chart, x.key is the category and the first series is the value. Provide either "rows" or "dataPath" (a JSON array, JSONL or CSV file). At most ${MAX_CHART_ROWS} rows are used.`,
+        parameters: Type.Object({
+            chartType: Type.Enum(["line", "area", "bar", "pie", "scatter"]),
+            title: Type.Optional(Type.String()),
+            description: Type.Optional(Type.String()),
+            x: Type.Object({
+                key: Type.String(),
+                label: Type.Optional(Type.String()),
+                type: Type.Optional(Type.Enum(["time", "category", "number"])),
+            }),
+            y: Type.Optional(Type.Object({
+                label: Type.Optional(Type.String()),
+                unit: Type.Optional(Type.String()),
+            })),
+            series: Type.Array(Type.Object({
+                key: Type.String(),
+                label: Type.Optional(Type.String()),
+                unit: Type.Optional(Type.String()),
+            }), { minItems: 1 }),
+            stacked: Type.Optional(Type.Boolean()),
+            rows: Type.Optional(Type.Array(Type.Object({}, { additionalProperties: true }))),
+            dataPath: Type.Optional(Type.String({ description: "Path to a JSON, JSONL or CSV data file" })),
+        }),
+        async execute(_toolCallId, params) {
+            const ctx = requireRunContext(deps);
+            let spec;
+            try {
+                const { rows, dataPath, ...rest } = params;
+                spec = buildChart(rest, loadRows(deps, rows, dataPath));
+            }
+            catch (err) {
+                return errorResult(`Could not render the chart: ${err.message}`);
+            }
+            const block = ctx.builder.addBlock({
+                type: "chart",
+                chart: spec,
+            });
+            return textResult(`Rendered a ${spec.chartType} chart with ${spec.rows.length} data points as block ${block.id}.`);
+        },
+    });
+    const resources = defineTool({
+        name: "present_resources",
+        label: "Present resources",
+        description: "Show one or more Octelium/Cordium resources (e.g. Services, Users, Policies, Workspaces) as interactive items in the User's chat UI that link to their pages in the web console. Use the resources' apiVersion (e.g. core/v1, cordium/v1), kind and name exactly as returned by the APIs.",
+        parameters: Type.Object({
+            title: Type.Optional(Type.String()),
+            resources: Type.Array(Type.Object({
+                apiVersion: Type.String({ description: 'e.g. "core/v1"' }),
+                kind: Type.String({ description: 'e.g. "Service"' }),
+                name: Type.String(),
+            }), { minItems: 1, maxItems: 200 }),
+        }),
+        async execute(_toolCallId, params) {
+            const ctx = requireRunContext(deps);
+            const items = params.resources.map((ref, i) => {
+                const snapshot = i < MAX_SNAPSHOTS ? ctx.resources.get(ref) : undefined;
+                return {
+                    ref,
+                    uri: formatResourceURI(ref),
+                    snapshot: snapshot && JSON.stringify(snapshot).length <= MAX_SNAPSHOT_CHARS
+                        ? snapshot
+                        : undefined,
+                };
+            });
+            const block = ctx.builder.addBlock({
+                type: "resources",
+                title: params.title,
+                resources: items,
+            });
+            return textResult(`Rendered ${items.length} resource(s) as block ${block.id}.`);
+        },
+    });
+    const artifact = defineTool({
+        name: "publish_artifact",
+        label: "Publish artifact",
+        description: "Publish a file that you created (e.g. a report, a CSV/JSON export, a YAML manifest, an image, an archive) so that the User can preview or download it from the chat UI. Write the file first, then publish it. Never paste large file contents into your answer.",
+        parameters: Type.Object({
+            path: Type.String({ description: "Path of the file to publish" }),
+            title: Type.Optional(Type.String()),
+            description: Type.Optional(Type.String()),
+            name: Type.Optional(Type.String({
+                description: "The download file name (defaults to the file's name)",
+            })),
+            mimeType: Type.Optional(Type.String()),
+        }),
+        async execute(_toolCallId, params) {
+            const ctx = requireRunContext(deps);
+            const filePath = resolvePath(deps.workDir, params.path);
+            let size;
+            try {
+                const stat = fs.statSync(filePath);
+                if (!stat.isFile()) {
+                    return errorResult(`Not a regular file: ${filePath}`);
+                }
+                size = stat.size;
+            }
+            catch (err) {
+                return errorResult(`Could not access ${filePath}: ${err.message}`);
+            }
+            if (size > MAX_ARTIFACT_BYTES) {
+                return errorResult(`The file is too large to be published (${size} bytes, the maximum is ${MAX_ARTIFACT_BYTES})`);
+            }
+            const info = deps.files.publishArtifact(filePath, {
+                name: params.name,
+                title: params.title,
+                description: params.description,
+                mimeType: params.mimeType,
+                conversationId: deps.conversationId,
+            });
+            const block = ctx.builder.addBlock({
+                type: "artifact",
+                artifact: info,
+            });
+            return textResult(`Published the artifact "${info.name}" (${info.size} bytes, ${info.mimeType}) as block ${block.id}.`);
+        },
+    });
+    return [table, chart, resources, artifact];
+};
+//# sourceMappingURL=present.js.map

package/dist/agent/tools/present.js.map

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

package/dist/agent/tools/util.d.ts

@@ -0,0 +1,19 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import type { ToolDetails } from "../../protocol/index.ts";
+import type { ToolContextProvider, ToolRunContext } from "../types.ts";
+export interface ToolDeps {
+    conversationId: string;
+    workDir: string;
+    runtime: ToolContextProvider;
+}
+export declare const textResult: (text: string, details?: ToolDetails, isError?: boolean) => AgentToolResult<ToolDetails | undefined>;
+export declare const errorResult: (text: string, details?: ToolDetails) => AgentToolResult<ToolDetails | undefined>;
+export declare const truncateText: (text: string, max: number) => {
+    text: string;
+    truncated: boolean;
+};
+export declare const resolvePath: (workDir: string, p: string) => string;
+export declare const requireRunContext: (deps: ToolDeps) => ToolRunContext;
+export declare const writeJSONFile: (filePath: string, data: unknown) => void;
+export declare const parseCSV: (text: string) => Record<string, string>[];
+export declare const readRowsFile: (filePath: string) => Record<string, unknown>[];

package/dist/agent/tools/util.js

@@ -0,0 +1,103 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+export const textResult = (text, details, isError = false) => ({
+    content: [{ type: "text", text }],
+    details,
+    isError: isError || undefined,
+});
+export const errorResult = (text, details) => textResult(text, details, true);
+export const truncateText = (text, max) => text.length <= max
+    ? { text, truncated: false }
+    : { text: `${text.slice(0, max)}\n…[truncated]`, truncated: true };
+export const resolvePath = (workDir, p) => path.resolve(workDir, p.startsWith("~/") ? path.join(process.env.HOME ?? "", p.slice(2)) : p);
+export const requireRunContext = (deps) => {
+    const ctx = deps.runtime.current(deps.conversationId);
+    if (!ctx) {
+        throw new Error("This tool can only be used within an active run");
+    }
+    return ctx;
+};
+export const writeJSONFile = (filePath, data) => {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`);
+};
+export const parseCSV = (text) => {
+    const rows = [];
+    let row = [];
+    let field = "";
+    let inQuotes = false;
+    for (let i = 0; i < text.length; i++) {
+        const c = text[i];
+        if (inQuotes) {
+            if (c === '"') {
+                if (text[i + 1] === '"') {
+                    field += '"';
+                    i++;
+                }
+                else {
+                    inQuotes = false;
+                }
+            }
+            else {
+                field += c;
+            }
+            continue;
+        }
+        if (c === '"') {
+            inQuotes = true;
+        }
+        else if (c === ",") {
+            row.push(field);
+            field = "";
+        }
+        else if (c === "\n" || c === "\r") {
+            if (c === "\r" && text[i + 1] === "\n") {
+                i++;
+            }
+            row.push(field);
+            field = "";
+            if (row.some((v) => v !== "")) {
+                rows.push(row);
+            }
+            row = [];
+        }
+        else {
+            field += c;
+        }
+    }
+    row.push(field);
+    if (row.some((v) => v !== "")) {
+        rows.push(row);
+    }
+    const [header, ...data] = rows;
+    if (!header) {
+        return [];
+    }
+    return data.map((values) => Object.fromEntries(header.map((key, i) => [key.trim(), values[i] ?? ""])));
+};
+export const readRowsFile = (filePath) => {
+    const raw = fs.readFileSync(filePath, "utf8");
+    const ext = path.extname(filePath).toLowerCase();
+    if (ext === ".csv") {
+        return parseCSV(raw);
+    }
+    if (ext === ".jsonl" || ext === ".ndjson") {
+        return raw
+            .split("\n")
+            .filter((line) => line.trim() !== "")
+            .map((line) => JSON.parse(line));
+    }
+    const parsed = JSON.parse(raw);
+    if (Array.isArray(parsed)) {
+        return parsed;
+    }
+    if (parsed && typeof parsed === "object") {
+        for (const key of ["rows", "items", "data", "results"]) {
+            if (Array.isArray(parsed[key])) {
+                return parsed[key];
+            }
+        }
+    }
+    throw new Error("The data file must contain a JSON array of objects (or an object with a rows/items/data array), JSONL or CSV");
+};
+//# sourceMappingURL=util.js.map

package/dist/agent/tools/util.js.map

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

package/dist/agent/tools/web.d.ts

@@ -0,0 +1,24 @@
+import { Type } from "@earendil-works/pi-ai";
+import type { WebSearchConfig } from "../../config.ts";
+import { type ToolDeps } from "./util.ts";
+export declare const decodeEntities: (text: string) => string;
+export declare const htmlToText: (html: string) => {
+    title?: string;
+    text: string;
+};
+export interface WebToolDeps extends ToolDeps {
+    webSearch?: WebSearchConfig;
+    fetchImpl?: typeof fetch;
+}
+interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+export declare const runWebSearch: (cfg: WebSearchConfig, query: string, count: number, signal: AbortSignal | undefined, fetchImpl?: typeof fetch) => Promise<SearchResult[]>;
+export declare const createWebTools: (deps: WebToolDeps) => (import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+    url: Type.TString;
+    maxChars: Type.TOptional<Type.TInteger>;
+    raw: Type.TOptional<Type.TBoolean>;
+}>, import("../../index.ts").ToolDetails | undefined, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>)[];
+export {};