@hold-rein/cli 0.0.0

package/dist/runtime/api/modules/agents/model/resolver.js

@@ -0,0 +1,17 @@
+import { getModels } from "@earendil-works/pi-ai";
+export async function resolveAgentModel(provider, modelId, getCustomModel) {
+    const builtInModel = findBuiltInModel(provider, modelId);
+    if (builtInModel) {
+        return builtInModel;
+    }
+    return (await getCustomModel?.(provider, modelId)) ?? null;
+}
+function findBuiltInModel(provider, modelId) {
+    try {
+        return (getModels(provider).find((model) => model.id === modelId) ??
+            null);
+    }
+    catch {
+        return null;
+    }
+}

package/dist/runtime/api/modules/agents/router/browser-tool-result.d.ts

@@ -0,0 +1,8 @@
+import type { AgentsService } from "../service";
+interface BrowserToolResultBody {
+    content?: unknown;
+    isError?: unknown;
+}
+export declare function parseBrowserToolResultBody(body: BrowserToolResultBody, agentId: string, toolCallId: string): Parameters<AgentsService["submitBrowserToolResult"]>[0] | null;
+export {};
+//# sourceMappingURL=browser-tool-result.d.ts.map

package/dist/runtime/api/modules/agents/router/browser-tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tool-result.d.ts","sourceRoot":"","sources":["../../../../src/modules/agents/router/browser-tool-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,UAAU,qBAAqB;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,UAAU,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAYhE"}

package/dist/runtime/api/modules/agents/router/browser-tool-result.js

@@ -0,0 +1,35 @@
+export function parseBrowserToolResultBody(body, agentId, toolCallId) {
+    if (body.isError !== undefined && typeof body.isError !== "boolean") {
+        return null;
+    }
+    const content = parseBrowserToolResultContent(body.content);
+    if (!content)
+        return null;
+    return {
+        agentId,
+        content,
+        ...(body.isError === undefined ? {} : { isError: body.isError }),
+        toolCallId
+    };
+}
+function parseBrowserToolResultContent(value) {
+    if (typeof value === "string" && value.length <= 100_000)
+        return value;
+    if (!Array.isArray(value) || value.length > 64)
+        return null;
+    const items = [];
+    for (const item of value) {
+        if (!isTextContent(item))
+            return null;
+        items.push({ text: item.text, type: "text" });
+    }
+    return items;
+}
+function isTextContent(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        value.type === "text" &&
+        typeof value.text === "string" &&
+        value.text.length <= 100_000);
+}

package/dist/runtime/api/modules/agents/router/index.d.ts

@@ -0,0 +1,10 @@
+import { Router } from "express";
+import { type SkillsService } from "../../skills";
+import type { AgentsService } from "../service";
+export interface CreateAgentsRouterOptions {
+    agentsService?: AgentsService;
+    skillDirs?: string[];
+    skillsService?: SkillsService;
+}
+export declare function createAgentsRouter(options?: CreateAgentsRouterOptions): Router;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/api/modules/agents/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/agents/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAC;AAI9D,OAAO,EAA2B,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAI3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAoBhD,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,MAAM,CA8XR"}

package/dist/runtime/api/modules/agents/router/index.js

@@ -0,0 +1,210 @@
+import { Router } from "express";
+import { sendError, sendSuccess } from "../../../response/index.js";
+import { RESPONSE_CODE_DEFINITIONS } from "../../../response/response-codes.js";
+import { getDefaultSkillsService } from "../../skills/index.js";
+import { listWorkspaceSkills } from "../runtime/support.js";
+import { getDefaultAgentsService } from "../service/default.js";
+import { getRequiredQueryString, parseAfterSequence, parseContinueTaskBody, parseStartAgentBody } from "./request-parsing.js";
+import { parseBrowserToolResultBody } from "./browser-tool-result.js";
+export function createAgentsRouter(options = {}) {
+    const router = Router();
+    const getService = () => options.agentsService ?? getDefaultAgentsService();
+    const getSkillsService = () => options.skillsService ?? getDefaultSkillsService();
+    router.post("/agents/start", (request, response) => {
+        const input = parseStartAgentBody(request.body);
+        if (!input) {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "workspacePath, provider, modelId and prompt must be strings; runtimeContributions must be valid when provided");
+            return;
+        }
+        void getService()
+            .startAgent(input)
+            .then((result) => {
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to start agent");
+        });
+    });
+    router.get("/agents/skills", (request, response) => {
+        const workspacePath = getRequiredQueryString(request.query.workspacePath);
+        if (workspacePath === null) {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "workspacePath must be a string");
+            return;
+        }
+        void listWorkspaceSkills(workspacePath, options.skillDirs, getSkillsService())
+            .then((skills) => {
+            sendSuccess(response, { skills });
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to list skills");
+        });
+    });
+    router.get("/agents/tasks/:taskId/messages", (request, response) => {
+        void getService()
+            .listTaskMessages({ taskId: request.params.taskId })
+            .then((messages) => sendSuccess(response, messages))
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to load task messages");
+        });
+    });
+    router.patch("/agents/tasks/:taskId", (request, response) => {
+        const title = typeof request.body.title === "string" ? request.body.title.trim() : "";
+        if (!title) {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "title must be a non-empty string");
+            return;
+        }
+        void getService()
+            .renameTask({ taskId: request.params.taskId, title })
+            .then((result) => {
+            if (!result) {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, "Unknown task");
+                return;
+            }
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to rename task");
+        });
+    });
+    router.delete("/agents/tasks/:taskId", (request, response) => {
+        void getService()
+            .deleteTask({ taskId: request.params.taskId })
+            .then((result) => {
+            if (result.status === "not_found") {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, "Unknown task");
+                return;
+            }
+            if (result.status === "running") {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.conflict, "Task is running");
+                return;
+            }
+            sendSuccess(response, { taskId: result.taskId });
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to delete task");
+        });
+    });
+    router.post("/agents/tasks/:taskId/continue", (request, response) => {
+        const input = parseContinueTaskBody(request.body, request.params.taskId);
+        if (!input) {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "prompt must be a string, provider and modelId must both be strings when provided, and runtimeContributions must be valid when provided");
+            return;
+        }
+        void getService()
+            .continueTask(input)
+            .then((result) => {
+            if (!result) {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, "Unknown task");
+                return;
+            }
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to continue task");
+        });
+    });
+    router.post("/agents/tasks/:taskId/interrupt", (request, response) => {
+        void getService()
+            .interruptTask({ taskId: request.params.taskId })
+            .then((result) => {
+            if (result.status === "not_found") {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, "Unknown task");
+                return;
+            }
+            if (result.status === "not_running") {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.conflict, "Task is not running");
+                return;
+            }
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to interrupt task");
+        });
+    });
+    router.get("/agents/tasks/:taskId/title", (request, response) => {
+        void getService()
+            .getTaskTitle({ taskId: request.params.taskId })
+            .then((result) => {
+            if (!result) {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, "Unknown task");
+                return;
+            }
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error ? error.message : "Failed to get task title");
+        });
+    });
+    router.get("/agents/:agentId/events", (request, response) => {
+        const afterSequence = parseAfterSequence(request.query.afterSequence);
+        if (afterSequence === null) {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "afterSequence must be a non-negative integer");
+            return;
+        }
+        response.status(200);
+        response.setHeader("Content-Type", "application/x-ndjson");
+        response.setHeader("Cache-Control", "no-cache");
+        response.setHeader("Connection", "keep-alive");
+        response.flushHeaders();
+        const subscription = getService().subscribeToAgentEvents({
+            ...(afterSequence === undefined ? {} : { afterSequence }),
+            agentId: request.params.agentId
+        }, (event) => {
+            writeNdjsonEvent(response, event);
+        });
+        request.on("close", () => {
+            subscription.unsubscribe();
+        });
+    });
+    router.post("/agents/:agentId/approvals/:approvalId", (request, response) => {
+        if (typeof request.body.approved !== "boolean") {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "approved must be a boolean");
+            return;
+        }
+        if (request.body.reason !== undefined &&
+            typeof request.body.reason !== "string") {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "reason must be a string");
+            return;
+        }
+        void getService()
+            .approveAgentAction({
+            agentId: request.params.agentId,
+            approvalId: request.params.approvalId,
+            approved: request.body.approved,
+            ...(request.body.reason === undefined
+                ? {}
+                : { reason: request.body.reason })
+        })
+            .then((result) => {
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, error instanceof Error ? error.message : "Unknown approval request");
+        });
+    });
+    router.post("/agents/:agentId/browser-tools/:toolCallId/result", (request, response) => {
+        const input = parseBrowserToolResultBody(request.body, request.params.agentId, request.params.toolCallId);
+        if (!input) {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, "content must be a string or text content array");
+            return;
+        }
+        void getService()
+            .submitBrowserToolResult(input)
+            .then((result) => {
+            if (!result) {
+                sendError(response, RESPONSE_CODE_DEFINITIONS.notFound, "Unknown browser tool call");
+                return;
+            }
+            sendSuccess(response, result);
+        })
+            .catch((error) => {
+            sendError(response, RESPONSE_CODE_DEFINITIONS.badRequest, error instanceof Error
+                ? error.message
+                : "Failed to submit browser tool result");
+        });
+    });
+    return router;
+}
+function writeNdjsonEvent(response, event) {
+    response.write(`${JSON.stringify(event)}\n`);
+}

package/dist/runtime/api/modules/agents/router/request-parsing.d.ts

@@ -0,0 +1,24 @@
+import type { StartAgentInput } from "../agent-types";
+import type { AgentsService } from "../service";
+export interface StartAgentBody {
+    approvalPolicy?: unknown;
+    modelId?: string;
+    prompt?: string;
+    provider?: string;
+    runtimeContributions?: unknown;
+    thinkingLevel?: unknown;
+    workspacePath?: string;
+}
+export interface ContinueTaskBody {
+    approvalPolicy?: unknown;
+    modelId?: string;
+    prompt?: string;
+    provider?: string;
+    runtimeContributions?: unknown;
+    thinkingLevel?: unknown;
+}
+export declare function parseContinueTaskBody(body: ContinueTaskBody, taskId: string): Parameters<AgentsService["continueTask"]>[0] | null;
+export declare function parseStartAgentBody(body: StartAgentBody): StartAgentInput | null;
+export declare function parseAfterSequence(value: unknown): number | undefined | null;
+export declare function getRequiredQueryString(value: unknown): string | null;
+//# sourceMappingURL=request-parsing.d.ts.map

package/dist/runtime/api/modules/agents/router/request-parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-parsing.d.ts","sourceRoot":"","sources":["../../../../src/modules/agents/router/request-parsing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb,UAAU,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAiCrD;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,GACnB,eAAe,GAAG,IAAI,CA2BxB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAU5E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEpE"}

package/dist/runtime/api/modules/agents/router/request-parsing.js

@@ -0,0 +1,78 @@
+import { parseBrowserRuntimeContributions } from "../runtime/browser-runtime-contributions.js";
+export function parseContinueTaskBody(body, taskId) {
+    if (typeof body.prompt !== "string") {
+        return null;
+    }
+    const options = parseTaskRunOptions(body);
+    const runtimeContributions = parseBrowserRuntimeContributions(body.runtimeContributions);
+    if (!options || runtimeContributions === null) {
+        return null;
+    }
+    const contributionInput = runtimeContributions === undefined ? {} : { runtimeContributions };
+    if (body.provider === undefined && body.modelId === undefined) {
+        return { ...options, ...contributionInput, prompt: body.prompt, taskId };
+    }
+    if (typeof body.provider !== "string" || typeof body.modelId !== "string") {
+        return null;
+    }
+    return {
+        ...options,
+        ...contributionInput,
+        modelId: body.modelId,
+        prompt: body.prompt,
+        provider: body.provider,
+        taskId
+    };
+}
+export function parseStartAgentBody(body) {
+    if (typeof body.workspacePath !== "string" ||
+        typeof body.provider !== "string" ||
+        typeof body.modelId !== "string" ||
+        typeof body.prompt !== "string") {
+        return null;
+    }
+    const options = parseTaskRunOptions(body);
+    const runtimeContributions = parseBrowserRuntimeContributions(body.runtimeContributions);
+    if (!options || runtimeContributions === null) {
+        return null;
+    }
+    return {
+        ...options,
+        ...(runtimeContributions === undefined ? {} : { runtimeContributions }),
+        modelId: body.modelId,
+        prompt: body.prompt,
+        provider: body.provider,
+        workspacePath: body.workspacePath
+    };
+}
+export function parseAfterSequence(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "string" || !/^\d+$/.test(value)) {
+        return null;
+    }
+    return Number(value);
+}
+export function getRequiredQueryString(value) {
+    return typeof value === "string" ? value : null;
+}
+function parseTaskRunOptions(body) {
+    const approvalPolicy = body.approvalPolicy ?? "approval";
+    const thinkingLevel = body.thinkingLevel ?? "medium";
+    if (approvalPolicy !== "approval" && approvalPolicy !== "run_all") {
+        return null;
+    }
+    if (!isThinkingLevel(thinkingLevel)) {
+        return null;
+    }
+    return { approvalPolicy, thinkingLevel };
+}
+function isThinkingLevel(value) {
+    return (value === "off" ||
+        value === "minimal" ||
+        value === "low" ||
+        value === "medium" ||
+        value === "high" ||
+        value === "xhigh");
+}

package/dist/runtime/api/modules/agents/runtime/browser-runtime-contributions.d.ts

@@ -0,0 +1,5 @@
+import type { Skill } from "@earendil-works/pi-agent-core";
+import type { BrowserRuntimeContributions, BrowserRuntimeSkill } from "../agent-types";
+export declare function parseBrowserRuntimeContributions(value: unknown): BrowserRuntimeContributions | undefined | null;
+export declare function toRuntimeSkills(skills: readonly BrowserRuntimeSkill[] | undefined): Skill[];
+//# sourceMappingURL=browser-runtime-contributions.d.ts.map

package/dist/runtime/api/modules/agents/runtime/browser-runtime-contributions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-runtime-contributions.d.ts","sourceRoot":"","sources":["../../../../src/modules/agents/runtime/browser-runtime-contributions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAE3D,OAAO,KAAK,EACV,2BAA2B,EAC3B,mBAAmB,EAEpB,MAAM,gBAAgB,CAAC;AAUxB,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,OAAO,GACb,2BAA2B,GAAG,SAAS,GAAG,IAAI,CAehD;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,GACjD,KAAK,EAAE,CAOT"}

package/dist/runtime/api/modules/agents/runtime/browser-runtime-contributions.js

@@ -0,0 +1,115 @@
+const MAX_TOOLS = 16;
+const MAX_SKILLS = 16;
+const MAX_SYSTEM_PROMPTS = 16;
+const MAX_NAME_LENGTH = 80;
+const MAX_DESCRIPTION_LENGTH = 1000;
+const MAX_SKILL_CONTENT_LENGTH = 20_000;
+const MAX_SYSTEM_PROMPT_LENGTH = 20_000;
+export function parseBrowserRuntimeContributions(value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        return null;
+    const tools = parseTools(value.tools);
+    const skills = parseSkills(value.skills);
+    const systemPrompts = parseSystemPrompts(value.systemPrompts);
+    if (tools === null || skills === null || systemPrompts === null)
+        return null;
+    return {
+        ...(skills === undefined ? {} : { skills }),
+        ...(systemPrompts === undefined ? {} : { systemPrompts }),
+        ...(tools === undefined ? {} : { tools })
+    };
+}
+export function toRuntimeSkills(skills) {
+    return (skills ?? []).map((skill) => ({
+        content: skill.content,
+        description: skill.description ?? "",
+        filePath: `browser-runtime://${skill.name}/SKILL.md`,
+        name: skill.name
+    }));
+}
+function parseTools(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value) || value.length > MAX_TOOLS)
+        return null;
+    const names = new Set();
+    const tools = [];
+    for (const item of value) {
+        if (!isRecord(item))
+            return null;
+        const name = parseName(item.name);
+        const description = parseOptionalString(item.description, MAX_DESCRIPTION_LENGTH);
+        if (!name || description === null || item.inputSchema === undefined) {
+            return null;
+        }
+        if (names.has(name))
+            return null;
+        names.add(name);
+        tools.push({
+            ...(description === undefined ? {} : { description }),
+            inputSchema: item.inputSchema,
+            name
+        });
+    }
+    return tools;
+}
+function parseSkills(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value) || value.length > MAX_SKILLS)
+        return null;
+    const skills = [];
+    for (const item of value) {
+        if (!isRecord(item))
+            return null;
+        const name = parseName(item.name);
+        const description = parseOptionalString(item.description, MAX_DESCRIPTION_LENGTH);
+        const content = parseRequiredString(item.content, MAX_SKILL_CONTENT_LENGTH);
+        if (!name || description === null || content === null)
+            return null;
+        skills.push({
+            content,
+            ...(description === undefined ? {} : { description }),
+            name
+        });
+    }
+    return skills;
+}
+function parseSystemPrompts(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value) || value.length > MAX_SYSTEM_PROMPTS)
+        return null;
+    const prompts = [];
+    for (const item of value) {
+        const prompt = parseRequiredString(item, MAX_SYSTEM_PROMPT_LENGTH);
+        if (prompt === null)
+            return null;
+        prompts.push(prompt);
+    }
+    return prompts;
+}
+function parseName(value) {
+    const name = parseRequiredString(value, MAX_NAME_LENGTH);
+    if (!name)
+        return null;
+    return /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(name) ? name : null;
+}
+function parseRequiredString(value, maxLength) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.length > maxLength)
+        return null;
+    return trimmed;
+}
+function parseOptionalString(value, maxLength) {
+    if (value === undefined)
+        return undefined;
+    return parseRequiredString(value, maxLength);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}

package/dist/runtime/api/modules/agents/runtime/browser-runtime-tools.d.ts

@@ -0,0 +1,13 @@
+import type { ServerPlugin } from "@hold-rein/plugin-server";
+import type { BrowserRuntimeToolSchema } from "../agent-types";
+import type { AgentEventBus } from "../event/event-bus";
+import type { BrowserToolCallStore } from "./browser-tool-call-store";
+interface CreateBrowserRuntimeToolsInput {
+    agentId: string;
+    eventBus: AgentEventBus;
+    store: BrowserToolCallStore;
+    tools: readonly BrowserRuntimeToolSchema[] | undefined;
+}
+export declare function createBrowserRuntimeTools(input: CreateBrowserRuntimeToolsInput): ServerPlugin.PluginTool[];
+export {};
+//# sourceMappingURL=browser-runtime-tools.d.ts.map

package/dist/runtime/api/modules/agents/runtime/browser-runtime-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-runtime-tools.d.ts","sourceRoot":"","sources":["../../../../src/modules/agents/runtime/browser-runtime-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,UAAU,8BAA8B;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,KAAK,EAAE,SAAS,wBAAwB,EAAE,GAAG,SAAS,CAAC;CACxD;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GACpC,YAAY,CAAC,UAAU,EAAE,CAyB3B"}

package/dist/runtime/api/modules/agents/runtime/browser-runtime-tools.js

@@ -0,0 +1,31 @@
+export function createBrowserRuntimeTools(input) {
+    return (input.tools ?? []).map((tool) => ({
+        description: tool.description ?? tool.name,
+        execute: (toolCallId, toolInput) => {
+            const args = toArgumentsRecord(toolInput);
+            input.eventBus.emit({
+                agentId: input.agentId,
+                payload: {
+                    arguments: args,
+                    toolCallId,
+                    toolName: tool.name
+                },
+                type: "browser_tool_call_requested"
+            });
+            return input.store.createCall({
+                agentId: input.agentId,
+                arguments: args,
+                toolCallId,
+                toolName: tool.name
+            });
+        },
+        label: tool.name,
+        name: tool.name,
+        parameters: tool.inputSchema
+    }));
+}
+function toArgumentsRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : {};
+}

package/dist/runtime/api/modules/agents/runtime/browser-tool-call-store.d.ts

@@ -0,0 +1,21 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import type { BrowserToolResultInput } from "../agent-types";
+export interface BrowserToolCallRequest {
+    agentId: string;
+    arguments: Record<string, unknown>;
+    toolCallId: string;
+    toolName: string;
+}
+export interface BrowserToolCallStore {
+    clearAgent: (agentId: string) => void;
+    createCall: (request: BrowserToolCallRequest) => Promise<BrowserToolResult>;
+    submitResult: (input: BrowserToolResultInput) => boolean;
+}
+type BrowserToolResult = AgentToolResult<{
+    toolName?: string;
+}> & {
+    isError?: boolean;
+};
+export declare function createBrowserToolCallStore(timeoutMs?: number): BrowserToolCallStore;
+export {};
+//# sourceMappingURL=browser-tool-call-store.d.ts.map

package/dist/runtime/api/modules/agents/runtime/browser-tool-call-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tool-call-store.d.ts","sourceRoot":"","sources":["../../../../src/modules/agents/runtime/browser-tool-call-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,UAAU,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5E,YAAY,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC;CAC1D;AAED,KAAK,iBAAiB,GAAG,eAAe,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,SAAS,SAAS,GACjB,oBAAoB,CAkEtB"}