@agimon-ai/po-web-search 0.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vuong Ngo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,14 @@
+This package includes portions adapted from OpenAI Codex.
+Copyright 2025 OpenAI
+https://github.com/openai/codex
+Source revision: b56a579fc6
+
+Adapted files:
+- src/constants/webRun.ts: the web.run tool description (codex-rs/ext/web-search/web_run_description.md)
+- src/schemas/webRun.ts: the search command schema (codex-rs/codex-api/src/search.rs)
+- src/services/recentConversation/index.ts: the conversation tail (codex-rs/ext/web-search/src/history.rs, codex-rs/tools/src/response_history.rs)
+- src/extensions/workspaces/sessions/(frontend)/tool/_lib/webRunToolView.ts: the search action summary (codex-rs/ext/web-search/src/tool.rs, codex-rs/tui/src/history_cell/search.rs)
+
+These portions were modified for Po and are licensed under Apache-2.0.
+A copy is included in licenses/Codex-Apache-2.0.txt.
+The package's MIT license continues to apply to its original code.

package/README.md

@@ -0,0 +1,33 @@
+# @agimon-ai/po-web-search
+
+Search the web using the ChatGPT subscription sign-in that Po features share (Image generation, Web search, Voice). This is a port of Codex's standalone `web.run` tool. Credentials stay inside the Po host. No API-key fallback or automatic retries.
+
+## Activation
+
+This is an optional `web-search` layer. Register `@agimon-ai/po-web-search` under a layer's `packages` in your modes config, then include that layer in your chosen major mode. The repository's local `copilot` mode includes it for development; published starter configs do not.
+
+Sign in to **ChatGPT for Po features** under Settings > Providers (or with `/login`). Search entitlement and quota depend on your account. This uses the same private ChatGPT search endpoint as Codex (`backend-api/codex/alpha/search`), which may change without notice.
+
+## Tool
+
+`web_run` accepts the Codex search commands: `search_query`, `image_query`, `open`, `click`, `find`, `screenshot`, `finance`, `weather`, `sports`, `time`, and `response_length`. The schema is closed, so unknown fields are rejected before anything is sent.
+
+Access defaults to cached results (no live page fetch). Set `PO_WEB_SEARCH_ACCESS` in the session environment to `cached`, `indexed`, or `live`. Any other value fails the call before a request is sent.
+
+## What leaves Po
+
+Every call sends the search commands the model wrote, the session id, a model id, and the access mode. When the active chat model is a ChatGPT (`openai-codex`) model, the call also sends a short excerpt of recent conversation: the last two user text messages and up to 4,000 characters of assistant text between them. Tool output, file contents, images, reasoning, and injected context are never sent. Sessions on other providers send no conversation text.
+
+Search output is external, untrusted content that enters the model's context. Po's sandbox and approval layers still gate any action the model takes on it.
+
+Sign-in, account, quota, and network failures are returned without retrying. Cancelling propagates the abort signal. The tool is not available inside the sandbox container, where host OAuth is not mounted.
+
+## Structure and lifecycle
+
+The generated server entry discovers the routed `webRun.server.ts` tool. The web entry discovers its matching `webRun.web.tsx` renderer. Tool execution uses the host's provider-neutral `webSearch` capability; extensions never receive tokens or headers. The host guards readiness and disposal, and refreshes existing OAuth credentials per call.
+
+Portions are adapted from OpenAI Codex under Apache-2.0. See `NOTICE` and `licenses/`.
+
+## Development
+
+Run `pnpm exec nx run-many -t lint typecheck build test -p @agimon-ai/po-web-search` from the repository root. Renderer stories are deterministic. Their `mockup` status remains until human visual approval and runtime acceptance.

package/dist/apiContracts.cjs

@@ -0,0 +1,17 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = (0, require("@agimon-ai/po-core/apiContracts").defineApiContract)({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["defineApiContract"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;;;;AAGA,MAAa,gBAAA,4CAAeA,CAAAA,CAAAA,kBAAAA,CAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/apiContracts.d.mts

@@ -0,0 +1,53 @@
+//#region src/schemas/apiContracts.d.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAGa"}

package/dist/apiContracts.mjs

@@ -0,0 +1,13 @@
+import { defineApiContract } from "@agimon-ai/po-core/apiContracts";
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = defineApiContract({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+export { apiContracts, apiContracts as default };
+
+//# sourceMappingURL=apiContracts.mjs.map

package/dist/apiContracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAa,eAAe,kBAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/extensions/server.cjs

@@ -0,0 +1,26 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_webRunTool = require("../webRunTool-CuCm5OZL.cjs");
+let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+//#region src/extensions/workspaces/sessions/(backend)/tool/webRun.server.ts
+var webRun_server_default = (0, require("@agimon-ai/po-core/extensionFile").defineServerTool)(() => require_webRunTool.createWebRunTool());
+//#endregion
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
+	name: "@agimon-ai/po-web-search",
+	session: (context) => ({ get tools() {
+		return [via({ name: "web_run" }, at(webRun_server_default, context))];
+	} })
+});
+//#endregion
+exports.default = facet;
+exports.facet = facet;
+
+//# sourceMappingURL=server.cjs.map

package/dist/extensions/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","names":["defineServerTool","createWebRunTool","defineServerPlugin","toolWebRun"],"sources":["../../src/extensions/workspaces/sessions/(backend)/tool/webRun.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineServerTool } from '@agimon-ai/po-core/extensionFile';\n\nimport { createWebRunTool } from '../../../../../services/webRunTool';\n\nexport default defineServerTool(() => createWebRunTool());\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport toolWebRun from '../src/extensions/workspaces/sessions/(backend)/tool/webRun.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/po-web-search',\n  session: (context) => ({\n    get tools(): DoomServerSessionPlugin['tools'] { return [via({ name: 'web_run' }, at(toolWebRun, context))]; },\n  }),\n});\n\nexport default facet;\n"],"mappings":";;;;;;;AAIA,IAAA,yBAAA,6CAAeA,CAAAA,CAAAA,iBAAAA,OAAuBC,mBAAAA,iBAAiB,CAAC;;;ACExD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,SAAA,GAAQC,+BAAAA,mBAAAA,CAAmB;CACtC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,QAA0C;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,UAAU,GAAG,GAAGC,uBAAY,OAAO,CAAC,CAAC;CAAG,EAC9G;AACF,CAAC"}

package/dist/extensions/server.d.mts

@@ -0,0 +1,5 @@
+//#region generated/server.d.ts
+export declare const facet: import("@agimon-ai/po-core/serverFacet").DoomServerFacet;
+//#endregion
+export { facet as default };
+//# sourceMappingURL=server.d.mts.map

package/dist/extensions/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","names":[],"sources":["../../generated/server.ts"],"mappings":";qBAWa,gDAAK"}

package/dist/extensions/server.mjs

@@ -0,0 +1,22 @@
+import { t as createWebRunTool } from "../webRunTool-BkYexFJr.mjs";
+import { defineServerPlugin } from "@agimon-ai/po-core/serverFacet";
+import { defineServerTool } from "@agimon-ai/po-core/extensionFile";
+//#region src/extensions/workspaces/sessions/(backend)/tool/webRun.server.ts
+var webRun_server_default = defineServerTool(() => createWebRunTool());
+//#endregion
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const facet = defineServerPlugin({
+	name: "@agimon-ai/po-web-search",
+	session: (context) => ({ get tools() {
+		return [via({ name: "web_run" }, at(webRun_server_default, context))];
+	} })
+});
+//#endregion
+export { facet as default, facet };
+
+//# sourceMappingURL=server.mjs.map

package/dist/extensions/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":["toolWebRun"],"sources":["../../src/extensions/workspaces/sessions/(backend)/tool/webRun.server.ts","../../generated/server.ts"],"sourcesContent":["import { defineServerTool } from '@agimon-ai/po-core/extensionFile';\n\nimport { createWebRunTool } from '../../../../../services/webRunTool';\n\nexport default defineServerTool(() => createWebRunTool());\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport toolWebRun from '../src/extensions/workspaces/sessions/(backend)/tool/webRun.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/po-web-search',\n  session: (context) => ({\n    get tools(): DoomServerSessionPlugin['tools'] { return [via({ name: 'web_run' }, at(toolWebRun, context))]; },\n  }),\n});\n\nexport default facet;\n"],"mappings":";;;;AAIA,IAAA,wBAAe,uBAAuB,iBAAiB,CAAC;;;ACExD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,QAAQ,mBAAmB;CACtC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,QAA0C;EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,UAAU,GAAG,GAAGA,uBAAY,OAAO,CAAC,CAAC;CAAG,EAC9G;AACF,CAAC"}

package/dist/extensions/web.mjs

@@ -0,0 +1,159 @@
+import { defineToolRenderer, defineWebPlugin } from "@agimon-ai/po-core/web";
+import { MessageItem, MessageItemBody, MessageItemHeader, MessageItemStatus, resultTextLines, toolTone } from "@agimon-ai/po-web-components";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/extensions/workspaces/sessions/(frontend)/tool/_lib/webRunToolView.ts
+const ACCESS_LABELS = [
+	"cached",
+	"indexed",
+	"live"
+];
+const MAX_URL = 2048;
+function entries(value) {
+	return Array.isArray(value) ? value.filter((item) => typeof item === "object" && item !== null) : [];
+}
+function string(value) {
+	return typeof value === "string" ? value : "";
+}
+function literalUrl(refId) {
+	return URL.canParse(refId) ? refId : "";
+}
+function queryAction(value) {
+	const queries = entries(value).map((query) => string(query.q));
+	if (queries.length === 0) return void 0;
+	const first = queries[0];
+	return {
+		kind: "search",
+		detail: queries.length > 1 && first ? `${first} ...` : first
+	};
+}
+function action(args) {
+	const search = queryAction(args.search_query) ?? queryAction(args.image_query);
+	if (search) return search;
+	const url = literalUrl(string(entries(args.open)[0]?.ref_id));
+	if (url) return {
+		kind: "open",
+		detail: url
+	};
+	const find = entries(args.find)[0];
+	if (find) {
+		const pattern = string(find.pattern);
+		const page = literalUrl(string(find.ref_id));
+		return {
+			kind: "find",
+			detail: pattern && page ? `'${pattern}' in ${page}` : pattern ? `'${pattern}'` : page,
+			pattern: !!pattern
+		};
+	}
+	return { kind: "other" };
+}
+function summary(current, completed) {
+	if (current.kind === "open") return `${completed ? "Opened" : "Opening"} ${current.detail}`;
+	if (current.kind === "find") {
+		const verb = current.pattern ? completed ? "Searched for" : "Searching for" : completed ? "Searched page" : "Searching page";
+		return current.detail ? `${verb} ${current.detail}` : verb;
+	}
+	const detail = current.kind === "search" ? current.detail : "";
+	if (!detail) return completed ? "Searched the web" : current.kind === "other" ? "Browsing the web" : "Searching the web";
+	return `${completed ? "Searched the web" : "Searching the web"} for ${detail}`;
+}
+/** `details` is re-validated here: only http(s) URLs become links, everything else is ignored. */
+function sources(details) {
+	if (typeof details !== "object" || details === null) return [];
+	return entries(details.sources).flatMap((source) => {
+		const url = string(source.url);
+		if (url.length > MAX_URL || !URL.canParse(url)) return [];
+		const parsed = new URL(url);
+		if (parsed.protocol !== "https:" && parsed.protocol !== "http:") return [];
+		return [{
+			url: parsed.href,
+			label: string(source.title).trim() || parsed.hostname
+		}];
+	});
+}
+function webRunToolView({ args, result, running }) {
+	const details = result?.details;
+	const record = typeof details === "object" && details !== null ? details : {};
+	return {
+		summary: summary(action(args), !running),
+		access: ACCESS_LABELS.find((label) => label === record.access),
+		sharedConversation: record.sharedConversation === true,
+		sources: sources(details)
+	};
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/tool/_components/WebRunToolMessage.tsx
+/** Collapsed by default; `defaultExpanded` lets a story show the body. */
+function WebRunToolMessage(props) {
+	const { result, output, running, isError, defaultExpanded = false } = props;
+	const view = webRunToolView(props);
+	const label = view.access ? `${view.access}${view.sharedConversation ? " · with recent conversation" : ""}` : "";
+	return /* @__PURE__ */ jsx(MessageItem, {
+		tone: toolTone({
+			running,
+			isError
+		}),
+		expandable: true,
+		defaultExpanded,
+		children: ({ expanded }) => /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs(MessageItemHeader, {
+			title: "web search",
+			children: [/* @__PURE__ */ jsx("span", {
+				"data-testid": "tool-call-web_run",
+				className: "min-w-0 flex-1 truncate text-doom-text",
+				children: view.summary
+			}), label ? /* @__PURE__ */ jsx("span", {
+				className: "shrink-0 text-doom-faint",
+				children: label
+			}) : null]
+		}), expanded ? /* @__PURE__ */ jsxs(MessageItemBody, {
+			"data-testid": "tool-result-web_run",
+			className: "flex flex-col gap-2",
+			children: [
+				running ? /* @__PURE__ */ jsx(MessageItemStatus, {
+					tone: "running",
+					children: "searching"
+				}) : null,
+				isError ? /* @__PURE__ */ jsx(MessageItemStatus, {
+					tone: "error",
+					children: "failed"
+				}) : null,
+				!isError && view.sources.length > 0 ? /* @__PURE__ */ jsx("ul", {
+					"aria-label": "Sources",
+					className: "flex flex-col gap-1",
+					children: view.sources.map((source) => /* @__PURE__ */ jsx("li", {
+						className: "min-w-0 truncate",
+						children: /* @__PURE__ */ jsx("a", {
+							href: source.url,
+							target: "_blank",
+							rel: "noreferrer",
+							className: "text-doom-blue underline decoration-doom-blue/50",
+							children: source.label
+						})
+					}, source.url))
+				}) : null,
+				resultTextLines(result, output).map((line, index) => /* @__PURE__ */ jsx("span", {
+					className: `whitespace-pre-wrap break-words ${isError ? "text-doom-red" : "text-doom-dim"}`,
+					children: line
+				}, `${String(index)}-${line}`))
+			]
+		}) : null] })
+	});
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(frontend)/tool/webRun.web.tsx
+var webRun_web_default = defineToolRenderer({ message: WebRunToolMessage });
+//#endregion
+//#region generated/web.ts
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const webPlugin = defineWebPlugin({
+	id: "web-search",
+	session: { get toolRenderers() {
+		return [via({ tools: ["web_run"] }, webRun_web_default)];
+	} }
+});
+//#endregion
+export { webPlugin };
+
+//# sourceMappingURL=web.mjs.map

package/dist/extensions/web.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.mjs","names":["toolWebRun"],"sources":["../../src/extensions/workspaces/sessions/(frontend)/tool/_lib/webRunToolView.ts","../../src/extensions/workspaces/sessions/(frontend)/tool/_components/WebRunToolMessage.tsx","../../src/extensions/workspaces/sessions/(frontend)/tool/webRun.web.tsx","../../generated/web.ts"],"sourcesContent":["// Copyright 2025 OpenAI\n// SPDX-License-Identifier: Apache-2.0\n// Modified for Po from codex-rs ext/web-search/src/tool.rs (command_action), core/src/web_search.rs\n// (web_search_action_detail) and tui/src/history_cell/search.rs (summary wording).\n\nimport type { ToolMessageRenderProps } from '@agimon-ai/po-core/web';\n\ntype Action =\n  | { kind: 'search'; detail: string }\n  | { kind: 'open'; detail: string }\n  | { kind: 'find'; detail: string; pattern: boolean }\n  | { kind: 'other' };\n\nexport interface WebRunSourceView {\n  url: string;\n  label: string;\n}\n\nconst ACCESS_LABELS = ['cached', 'indexed', 'live'] as const;\nconst MAX_URL = 2048;\n\nfunction entries(value: unknown): Record<string, unknown>[] {\n  return Array.isArray(value)\n    ? value.filter((item): item is Record<string, unknown> => typeof item === 'object' && item !== null)\n    : [];\n}\n\nfunction string(value: unknown): string {\n  return typeof value === 'string' ? value : '';\n}\n\nfunction literalUrl(refId: string): string {\n  return URL.canParse(refId) ? refId : '';\n}\n\nfunction queryAction(value: unknown): Action | undefined {\n  const queries = entries(value).map((query) => string(query.q));\n  if (queries.length === 0) return undefined;\n  const first = queries[0]!;\n  return { kind: 'search', detail: queries.length > 1 && first ? `${first} ...` : first };\n}\n\nfunction action(args: Record<string, unknown>): Action {\n  const search = queryAction(args.search_query) ?? queryAction(args.image_query);\n  if (search) return search;\n  const url = literalUrl(string(entries(args.open)[0]?.ref_id));\n  if (url) return { kind: 'open', detail: url };\n  const find = entries(args.find)[0];\n  if (find) {\n    const pattern = string(find.pattern);\n    const page = literalUrl(string(find.ref_id));\n    const detail = pattern && page ? `'${pattern}' in ${page}` : pattern ? `'${pattern}'` : page;\n    return { kind: 'find', detail, pattern: !!pattern };\n  }\n  return { kind: 'other' };\n}\n\nfunction summary(current: Action, completed: boolean): string {\n  if (current.kind === 'open') return `${completed ? 'Opened' : 'Opening'} ${current.detail}`;\n  if (current.kind === 'find') {\n    const verb = current.pattern\n      ? completed\n        ? 'Searched for'\n        : 'Searching for'\n      : completed\n        ? 'Searched page'\n        : 'Searching page';\n    return current.detail ? `${verb} ${current.detail}` : verb;\n  }\n  const detail = current.kind === 'search' ? current.detail : '';\n  if (!detail)\n    return completed ? 'Searched the web' : current.kind === 'other' ? 'Browsing the web' : 'Searching the web';\n  return `${completed ? 'Searched the web' : 'Searching the web'} for ${detail}`;\n}\n\n/** `details` is re-validated here: only http(s) URLs become links, everything else is ignored. */\nfunction sources(details: unknown): WebRunSourceView[] {\n  if (typeof details !== 'object' || details === null) return [];\n  return entries((details as { sources?: unknown }).sources).flatMap((source) => {\n    const url = string(source.url);\n    if (url.length > MAX_URL || !URL.canParse(url)) return [];\n    const parsed = new URL(url);\n    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') return [];\n    return [{ url: parsed.href, label: string(source.title).trim() || parsed.hostname }];\n  });\n}\n\nexport function webRunToolView({ args, result, running }: Pick<ToolMessageRenderProps, 'args' | 'result' | 'running'>) {\n  const details: unknown = result?.details;\n  const record = typeof details === 'object' && details !== null ? (details as Record<string, unknown>) : {};\n  return {\n    summary: summary(action(args), !running),\n    access: ACCESS_LABELS.find((label) => label === record.access),\n    sharedConversation: record.sharedConversation === true,\n    sources: sources(details),\n  };\n}\n","import type { ToolMessageRenderProps } from '@agimon-ai/po-core/web';\nimport {\n  MessageItem,\n  MessageItemBody,\n  MessageItemHeader,\n  MessageItemStatus,\n  resultTextLines,\n  toolTone,\n} from '@agimon-ai/po-web-components';\n\nimport { webRunToolView } from '../_lib/webRunToolView';\n\n/** Collapsed by default; `defaultExpanded` lets a story show the body. */\nexport function WebRunToolMessage(props: ToolMessageRenderProps & { defaultExpanded?: boolean }) {\n  const { result, output, running, isError, defaultExpanded = false } = props;\n  const view = webRunToolView(props);\n  const label = view.access ? `${view.access}${view.sharedConversation ? ' · with recent conversation' : ''}` : '';\n  return (\n    <MessageItem tone={toolTone({ running, isError })} expandable defaultExpanded={defaultExpanded}>\n      {({ expanded }) => (\n        <>\n          <MessageItemHeader title=\"web search\">\n            <span data-testid=\"tool-call-web_run\" className=\"min-w-0 flex-1 truncate text-doom-text\">\n              {view.summary}\n            </span>\n            {label ? <span className=\"shrink-0 text-doom-faint\">{label}</span> : null}\n          </MessageItemHeader>\n          {expanded ? (\n            <MessageItemBody data-testid=\"tool-result-web_run\" className=\"flex flex-col gap-2\">\n              {running ? <MessageItemStatus tone=\"running\">searching</MessageItemStatus> : null}\n              {isError ? <MessageItemStatus tone=\"error\">failed</MessageItemStatus> : null}\n              {!isError && view.sources.length > 0 ? (\n                <ul aria-label=\"Sources\" className=\"flex flex-col gap-1\">\n                  {view.sources.map((source) => (\n                    <li key={source.url} className=\"min-w-0 truncate\">\n                      <a\n                        href={source.url}\n                        target=\"_blank\"\n                        rel=\"noreferrer\"\n                        className=\"text-doom-blue underline decoration-doom-blue/50\"\n                      >\n                        {source.label}\n                      </a>\n                    </li>\n                  ))}\n                </ul>\n              ) : null}\n              {resultTextLines(result, output).map((line, index) => (\n                <span\n                  key={`${String(index)}-${line}`}\n                  className={`whitespace-pre-wrap break-words ${isError ? 'text-doom-red' : 'text-doom-dim'}`}\n                >\n                  {line}\n                </span>\n              ))}\n            </MessageItemBody>\n          ) : null}\n        </>\n      )}\n    </MessageItem>\n  );\n}\n","import { defineToolRenderer } from '@agimon-ai/po-core/web';\n\nimport { WebRunToolMessage } from './_components/WebRunToolMessage';\n\nexport default defineToolRenderer({ message: WebRunToolMessage });\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineWebPlugin, type WebPluginContributions } from '@agimon-ai/po-core/web';\n\nimport toolWebRun from '../src/extensions/workspaces/sessions/(frontend)/tool/webRun.web';\n\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const webPlugin = defineWebPlugin({\n  id: 'web-search',\n  session: {\n    get toolRenderers(): WebPluginContributions['toolRenderers'] { return [via({ tools: ['web_run'] }, toolWebRun)]; },\n  },\n});\n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_webRunTool = require("./webRunTool-CuCm5OZL.cjs");
+exports.createWebRunTool = require_webRunTool.createWebRunTool;

package/dist/index.d.mts

@@ -0,0 +1,74 @@
+import { Type } from "typebox";
+import { DoomHeadlessTool } from "@agimon-ai/po-core/headless";
+//#region src/schemas/webRun.d.ts
+declare const WebRunParamsSchema: Type.TObject<{
+  search_query: Type.TOptional<Type.TArray<Type.TObject<{
+    q: Type.TString;
+    recency: Type.TOptional<Type.TInteger>;
+    domains: Type.TOptional<Type.TArray<Type.TString>>;
+  }>>>;
+  image_query: Type.TOptional<Type.TArray<Type.TObject<{
+    q: Type.TString;
+    recency: Type.TOptional<Type.TInteger>;
+    domains: Type.TOptional<Type.TArray<Type.TString>>;
+  }>>>;
+  open: Type.TOptional<Type.TArray<Type.TObject<{
+    ref_id: Type.TString;
+    lineno: Type.TOptional<Type.TInteger>;
+  }>>>;
+  click: Type.TOptional<Type.TArray<Type.TObject<{
+    ref_id: Type.TString;
+    id: Type.TInteger;
+  }>>>;
+  find: Type.TOptional<Type.TArray<Type.TObject<{
+    ref_id: Type.TString;
+    pattern: Type.TString;
+  }>>>;
+  screenshot: Type.TOptional<Type.TArray<Type.TObject<{
+    ref_id: Type.TString;
+    pageno: Type.TInteger;
+  }>>>;
+  finance: Type.TOptional<Type.TArray<Type.TObject<{
+    ticker: Type.TString;
+    type: Type.TUnion<Type.TLiteral<string>[]>;
+    market: Type.TOptional<Type.TString>;
+  }>>>;
+  weather: Type.TOptional<Type.TArray<Type.TObject<{
+    location: Type.TString;
+    start: Type.TOptional<Type.TString>;
+    duration: Type.TOptional<Type.TInteger>;
+  }>>>;
+  sports: Type.TOptional<Type.TArray<Type.TObject<{
+    tool: Type.TOptional<Type.TUnion<Type.TLiteral<string>[]>>;
+    fn: Type.TUnion<Type.TLiteral<string>[]>;
+    league: Type.TUnion<Type.TLiteral<string>[]>;
+    team: Type.TOptional<Type.TString>;
+    opponent: Type.TOptional<Type.TString>;
+    date_from: Type.TOptional<Type.TString>;
+    date_to: Type.TOptional<Type.TString>;
+    num_games: Type.TOptional<Type.TInteger>;
+    locale: Type.TOptional<Type.TString>;
+  }>>>;
+  time: Type.TOptional<Type.TArray<Type.TObject<{
+    utc_offset: Type.TString;
+  }>>>;
+  response_length: Type.TOptional<Type.TUnion<Type.TLiteral<string>[]>>;
+}>;
+//#endregion
+//#region src/services/webRunTool/index.d.ts
+export declare function createWebRunTool(): DoomHeadlessTool<typeof WebRunParamsSchema>;
+//#endregion
+//#region src/services/webRunTool/type.d.ts
+type WebSearchAccess = 'cached' | 'indexed' | 'live';
+interface WebRunSource {
+  url: string;
+  title?: string;
+}
+interface WebRunDetails {
+  access: WebSearchAccess;
+  sharedConversation: boolean;
+  sources: WebRunSource[];
+}
+//#endregion
+export type { WebRunDetails, WebRunSource };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/schemas/webRun.ts","../src/services/webRunTool/index.ts","../src/services/webRunTool/type.ts"],"mappings":";;;cAgCa,oBAAkB,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBCiBf,oBAAoB,wBAAwB;;;KCjDhD;UAEK;EACf;EACA;;UAGe;EACf,QAAQ;EACR;EACA,SAAS"}

package/dist/index.mjs

@@ -0,0 +1 @@
+export { t as createWebRunTool } from "./webRunTool-BkYexFJr.mjs";