@xopcai/xopc 0.0.84 → 0.0.86

package/dist/src/agent/tools/create-share-tool.js

@@ -0,0 +1,237 @@
+import { resolvePathUnderWorkspace } from "./tool-paths.js";
+import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
+import { resolveShareConfig } from "../../share/share-config.js";
+import { mergeWithDefaults } from "../../share/site-share-config.js";
+import { getShareStore } from "../../share/share-store.js";
+import { getSiteShareStore } from "../../share/site-share-store.js";
+import { loadTunnelState } from "../../tunnel/tunnel-state.js";
+import { resolveShareUrl } from "../../share/share-url.js";
+import { audienceDefaults, decideShareKind, makeDescription, makeTitle, probeShareTarget, rememberStagedSite, stageSingleHtmlAsSite } from "../../share/share-auto.js";
+import { scheduleThumbnail } from "../../share/share-thumbnail.js";
+import { resolveToolLocale, shareToolErrorLine, shareToolSuccessLines } from "../../i18n/share-tool-bundle.js";
+import { createHash } from "node:crypto";
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/create-share-tool.ts
+/**
+* Agent tool: create_share
+*
+* Hands a generated artefact (file, folder, HTML site) to the share-auto
+* pipeline and returns a public URL the model can paste into its reply.
+*
+* This is the bridge between "agent produces files" and "user has something
+* to share with a friend on WeChat (or anywhere)" — the model itself decides
+* when to call it, with optional hints about audience.
+*/
+const CreateShareSchema = Type.Object({
+	filePath: Type.String({ description: "File or folder to share. Relative paths resolve under the agent workspace; absolute paths are used as given (must be inside the workspace)." }),
+	audience: Type.Optional(Type.Enum({
+		friend: "friend",
+		colleague: "colleague",
+		public: "public"
+	}, { description: "Who the recipient is — controls default TTL/view caps. friend=3d unlimited, colleague=7d unlimited, public=24h capped at 100 views. Default: friend." })),
+	title: Type.Optional(Type.String({ description: "Override title shown on the social card. Default: file basename without extension." })),
+	description: Type.Optional(Type.String({ description: "Optional 1-line description for the social card." })),
+	mode: Type.Optional(Type.Enum({
+		auto: "auto",
+		"force-file": "force-file",
+		"force-site": "force-site",
+		"force-zip": "force-zip"
+	}, { description: "Override routing. Default 'auto'. Use 'force-site' to publish a single HTML as a hosted page." }))
+});
+/**
+* Whether the create_share tool is worth registering. Returns false when:
+*  - no gateway config is present (sharing routes wouldn't be reachable anyway), or
+*  - BOTH file sharing (`gateway.share.enabled`) and site sharing
+*    (`gateway.siteShare.enabled`) are explicitly disabled.
+*
+* Reachability (`tunnel up?`) is intentionally NOT checked here — it is
+* runtime state, the tool surfaces it via the `reachability` field, and the
+* agent should still be able to create local-only shares when the user is
+* testing or on the same network.
+*/
+function isShareToolAvailable(cfg) {
+	if (!cfg || !cfg.gateway) return false;
+	const gw = cfg.gateway;
+	const fileEnabled = gw.share?.enabled !== false;
+	const siteEnabled = gw.siteShare?.enabled !== false;
+	return fileEnabled || siteEnabled;
+}
+function gatewayPortOf(cfg) {
+	return cfg?.gateway?.port ?? 18790;
+}
+function hashCreator(value) {
+	return createHash("sha256").update(value, "utf8").digest("hex").slice(0, 12);
+}
+function createCreateShareTool(deps) {
+	const { workspace, getConfig } = deps;
+	return {
+		name: "create_share",
+		description: "Create a public share link for a file or folder so it can be sent to a friend (e.g. via WeChat). Returns shareUrl + thumbnailUrl + expiry. HTML files are published as live pages (the recipient sees a rendered page, not a download).",
+		parameters: CreateShareSchema,
+		label: "🔗 Create Share",
+		async execute(_toolCallId, params, _signal) {
+			const p = params;
+			const audience = p.audience ?? "friend";
+			const mode = p.mode ?? "auto";
+			const locale = resolveToolLocale(deps.getLocale?.());
+			const cfg = getConfig();
+			const shareCfg = resolveShareConfig((cfg?.gateway)?.share);
+			const siteCfg = mergeWithDefaults((cfg?.gateway)?.siteShare);
+			const gatewayHost = cfg ? resolveGatewayEffectiveHost(cfg) : "127.0.0.1";
+			const gatewayPort = gatewayPortOf(cfg);
+			const tokenHash = hashCreator(deps.getAgentId?.() ?? "agent-tool");
+			const absolutePath = resolvePathUnderWorkspace(p.filePath, workspace);
+			if (!absolutePath.startsWith(workspace)) return errorResult(locale, "File must be inside the agent workspace.");
+			const relPath = absolutePath === workspace ? "" : absolutePath.slice(workspace.length).replace(/^[\\/]+/, "").replace(/\\/g, "/");
+			if (!relPath) return errorResult(locale, "Cannot share the workspace root itself.");
+			let probe;
+			try {
+				probe = await probeShareTarget(workspace, relPath);
+			} catch (err) {
+				return errorResult(locale, `Cannot read target: ${err instanceof Error ? err.message : String(err)}`);
+			}
+			let decision;
+			try {
+				decision = decideShareKind(probe, mode);
+			} catch (err) {
+				return errorResult(locale, err instanceof Error ? err.message : String(err));
+			}
+			const defaults = audienceDefaults(audience);
+			const ttlMs = defaults.ttlMs;
+			const maxViews = defaults.maxViews;
+			try {
+				const tunnelUp = !!loadTunnelState();
+				if (decision.kind === "site") {
+					const siteStore = getSiteShareStore(siteCfg);
+					let sitePath = relPath;
+					let stagedDir = null;
+					if (probe.kind === "file") {
+						const staged = await stageSingleHtmlAsSite(workspace, probe.absolutePath);
+						sitePath = staged.relativePath;
+						stagedDir = staged.stagingDir;
+					}
+					const siteRec = await siteStore.create({
+						kind: "static",
+						path: sitePath,
+						ttlMs,
+						description: p.description,
+						spaFallback: true,
+						rewriteMode: "html-css",
+						workspaceRoot: workspace,
+						gatewayTokenHash: tokenHash
+					});
+					if (stagedDir) rememberStagedSite(siteRec.id, stagedDir);
+					const label = siteRec.subdomain ?? siteRec.token;
+					const shareUrl = tunnelUp ? `https://${label}.${siteCfg.publicHostSuffix}/` : `http://${gatewayHost}:${gatewayPort}/site/${siteRec.token}/`;
+					const reachability = tunnelUp ? "public" : gatewayHost === "127.0.0.1" || gatewayHost === "localhost" || gatewayHost === "::1" ? "local-only" : "lan";
+					const thumbnailUrl = `${shareUrl.replace(/\/+$/, "")}/thumbnail`;
+					scheduleThumbnail({
+						scope: "site",
+						token: siteRec.token,
+						recordId: siteRec.id
+					}, {
+						config: shareCfg.thumbnail,
+						internalBaseUrl: shareCfg.thumbnail.internalGatewayUrl ?? `http://127.0.0.1:${gatewayPort}`
+					});
+					siteStore.setThumbnailStatus(siteRec.id, "pending");
+					return successResult(locale, {
+						kind: "site",
+						shareUrl,
+						thumbnailUrl,
+						reachability,
+						title: makeTitle(probe.kind === "directory" ? relPath.split("/").pop() || relPath : probe.absolutePath.split(/[\\/]/).pop() || relPath, p.title),
+						description: makeDescription({
+							audience,
+							expiresAt: siteRec.expiresAt,
+							override: p.description
+						}),
+						expiresAt: siteRec.expiresAt,
+						routing: {
+							reason: decision.reason,
+							hint: decision.hint
+						}
+					});
+				}
+				const fileStore = getShareStore(shareCfg);
+				const rec = await fileStore.create({
+					path: relPath,
+					workspaceRoot: workspace,
+					gatewayTokenHash: tokenHash,
+					ttlMs,
+					maxViews: maxViews === void 0 ? void 0 : maxViews,
+					description: p.description,
+					kind: probe.kind === "directory" ? "directory" : "file",
+					directoryMode: decision.kind === "zip" ? "zip-only" : probe.kind === "directory" ? "browse" : void 0
+				});
+				const resolved = resolveShareUrl(rec.token, {
+					gatewayHost,
+					gatewayPort
+				});
+				const thumbnailUrl = `${resolved.shareUrl}/thumbnail`;
+				scheduleThumbnail({
+					scope: "file",
+					token: rec.token,
+					recordId: rec.id
+				}, {
+					config: shareCfg.thumbnail,
+					internalBaseUrl: shareCfg.thumbnail.internalGatewayUrl ?? `http://127.0.0.1:${gatewayPort}`
+				});
+				fileStore.setThumbnailStatus(rec.id, "pending");
+				const titleOut = makeTitle(rec.fileName, p.title);
+				const descOut = makeDescription({
+					audience,
+					expiresAt: rec.expiresAt,
+					override: p.description
+				});
+				return successResult(locale, {
+					kind: decision.kind,
+					shareUrl: resolved.shareUrl,
+					thumbnailUrl,
+					reachability: resolved.reachability,
+					reachabilityHint: resolved.reachabilityHint,
+					title: titleOut,
+					description: descOut,
+					expiresAt: rec.expiresAt,
+					maxViews: rec.maxViews,
+					routing: {
+						reason: decision.reason,
+						hint: decision.hint
+					}
+				});
+			} catch (err) {
+				return errorResult(locale, err instanceof Error ? err.message : String(err));
+			}
+		}
+	};
+}
+function successResult(locale, payload) {
+	return {
+		content: [{
+			type: "text",
+			text: shareToolSuccessLines(locale, {
+				kind: String(payload.kind ?? ""),
+				shareUrl: String(payload.shareUrl ?? ""),
+				title: String(payload.title ?? ""),
+				expiresAt: String(payload.expiresAt ?? ""),
+				thumbnailUrl: String(payload.thumbnailUrl ?? ""),
+				reachability: String(payload.reachability ?? ""),
+				reachabilityHint: String(payload.reachabilityHint ?? ""),
+				isPublic: payload.reachability === "public"
+			}).filter(Boolean).join("\n")
+		}],
+		details: payload
+	};
+}
+function errorResult(locale, message) {
+	return {
+		content: [{
+			type: "text",
+			text: shareToolErrorLine(locale, message)
+		}],
+		details: { error: message }
+	};
+}
+//#endregion
+export { createCreateShareTool, isShareToolAvailable };
+
+//# sourceMappingURL=create-share-tool.js.map

package/dist/src/agent/tools/create-share-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-share-tool.js","names":["resolveSiteShareConfigFromRaw"],"sources":["../../../../src/agent/tools/create-share-tool.ts"],"sourcesContent":["/**\n * Agent tool: create_share\n *\n * Hands a generated artefact (file, folder, HTML site) to the share-auto\n * pipeline and returns a public URL the model can paste into its reply.\n *\n * This is the bridge between \"agent produces files\" and \"user has something\n * to share with a friend on WeChat (or anywhere)\" — the model itself decides\n * when to call it, with optional hints about audience.\n */\nimport { Type } from '@sinclair/typebox';\nimport { createHash } from 'node:crypto';\nimport { AgentTool, type AgentToolResult } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport { resolveGatewayEffectiveHost } from '../../config/gateway-bind.js';\nimport { resolveShareConfig } from '../../share/share-config.js';\nimport { mergeWithDefaults as resolveSiteShareConfigFromRaw } from '../../share/site-share-config.js';\nimport { getShareStore } from '../../share/share-store.js';\nimport { getSiteShareStore } from '../../share/site-share-store.js';\nimport { resolveShareUrl } from '../../share/share-url.js';\nimport { loadTunnelState } from '../../tunnel/tunnel-state.js';\nimport {\n  audienceDefaults,\n  decideShareKind,\n  makeDescription,\n  makeTitle,\n  probeShareTarget,\n  rememberStagedSite,\n  stageSingleHtmlAsSite,\n  type ShareAudience,\n  type ShareAutoMode,\n} from '../../share/share-auto.js';\nimport { scheduleThumbnail } from '../../share/share-thumbnail.js';\nimport {\n  resolveToolLocale,\n  shareToolErrorLine,\n  shareToolSuccessLines,\n} from '../../i18n/share-tool-bundle.js';\nimport { resolvePathUnderWorkspace } from './tool-paths.js';\n\nconst CreateShareSchema = Type.Object({\n  filePath: Type.String({\n    description:\n      'File or folder to share. Relative paths resolve under the agent workspace; absolute paths are used as given (must be inside the workspace).',\n  }),\n  audience: Type.Optional(Type.Enum(\n    { friend: 'friend', colleague: 'colleague', public: 'public' },\n    {\n      description:\n        'Who the recipient is — controls default TTL/view caps. friend=3d unlimited, colleague=7d unlimited, public=24h capped at 100 views. Default: friend.',\n    },\n  )),\n  title: Type.Optional(Type.String({ description: 'Override title shown on the social card. Default: file basename without extension.' })),\n  description: Type.Optional(Type.String({ description: 'Optional 1-line description for the social card.' })),\n  mode: Type.Optional(Type.Enum(\n    { auto: 'auto', 'force-file': 'force-file', 'force-site': 'force-site', 'force-zip': 'force-zip' },\n    { description: \"Override routing. Default 'auto'. Use 'force-site' to publish a single HTML as a hosted page.\" },\n  )),\n});\n\ntype CreateShareParams = {\n  filePath: string;\n  audience?: ShareAudience;\n  title?: string;\n  description?: string;\n  mode?: ShareAutoMode;\n};\n\nexport interface CreateShareToolDeps {\n  workspace: string;\n  getConfig: () => Config | undefined;\n  /** Optional agent id for workspace resolution audit (currently unused but kept for parity with /api/shares). */\n  getAgentId?: () => string | undefined;\n  /**\n   * Optional user-facing locale ('en' / 'zh' / etc.). Falls back to env LANG\n   * → DEFAULT_SERVER_LOCALE when unset. Returned text follows this locale;\n   * the structured `details` payload stays language-neutral.\n   */\n  getLocale?: () => string | undefined;\n}\n\n/**\n * Whether the create_share tool is worth registering. Returns false when:\n *  - no gateway config is present (sharing routes wouldn't be reachable anyway), or\n *  - BOTH file sharing (`gateway.share.enabled`) and site sharing\n *    (`gateway.siteShare.enabled`) are explicitly disabled.\n *\n * Reachability (`tunnel up?`) is intentionally NOT checked here — it is\n * runtime state, the tool surfaces it via the `reachability` field, and the\n * agent should still be able to create local-only shares when the user is\n * testing or on the same network.\n */\nexport function isShareToolAvailable(cfg: Config | undefined): boolean {\n  if (!cfg || !cfg.gateway) return false;\n  const gw = cfg.gateway as Record<string, unknown>;\n  const fileEnabled = (gw.share as { enabled?: boolean } | undefined)?.enabled !== false;\n  const siteEnabled = (gw.siteShare as { enabled?: boolean } | undefined)?.enabled !== false;\n  return fileEnabled || siteEnabled;\n}\n\nfunction gatewayPortOf(cfg: Config | undefined): number {\n  return cfg?.gateway?.port ?? 18790;\n}\n\nfunction hashCreator(value: string): string {\n  return createHash('sha256').update(value, 'utf8').digest('hex').slice(0, 12);\n}\n\nexport function createCreateShareTool(deps: CreateShareToolDeps): AgentTool {\n  const { workspace, getConfig } = deps;\n\n  return {\n    name: 'create_share',\n    description:\n      'Create a public share link for a file or folder so it can be sent to a friend (e.g. via WeChat). Returns shareUrl + thumbnailUrl + expiry. HTML files are published as live pages (the recipient sees a rendered page, not a download).',\n    parameters: CreateShareSchema,\n    label: '🔗 Create Share',\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<Record<string, unknown>>> {\n      const p = params as CreateShareParams;\n      const audience: ShareAudience = p.audience ?? 'friend';\n      const mode: ShareAutoMode = p.mode ?? 'auto';\n      const locale = resolveToolLocale(deps.getLocale?.());\n\n      const cfg = getConfig();\n      const shareCfg = resolveShareConfig(\n        (cfg?.gateway as Record<string, unknown> | undefined)?.share,\n      );\n      const siteCfg = resolveSiteShareConfigFromRaw(\n        (cfg?.gateway as Record<string, unknown> | undefined)?.siteShare,\n      );\n      const gatewayHost = cfg ? resolveGatewayEffectiveHost(cfg) : '127.0.0.1';\n      const gatewayPort = gatewayPortOf(cfg);\n      const tokenHash = hashCreator(deps.getAgentId?.() ?? 'agent-tool');\n\n      // Resolve absolute path + verify it sits under the workspace root.\n      const absolutePath = resolvePathUnderWorkspace(p.filePath, workspace);\n      if (!absolutePath.startsWith(workspace)) {\n        return errorResult(locale,'File must be inside the agent workspace.');\n      }\n      const relPath = absolutePath === workspace\n        ? ''\n        : absolutePath.slice(workspace.length).replace(/^[\\\\/]+/, '').replace(/\\\\/g, '/');\n      if (!relPath) {\n        return errorResult(locale,'Cannot share the workspace root itself.');\n      }\n\n      let probe;\n      try {\n        probe = await probeShareTarget(workspace, relPath);\n      } catch (err) {\n        return errorResult(locale,`Cannot read target: ${err instanceof Error ? err.message : String(err)}`);\n      }\n\n      let decision;\n      try {\n        decision = decideShareKind(probe, mode);\n      } catch (err) {\n        return errorResult(locale,err instanceof Error ? err.message : String(err));\n      }\n\n      const defaults = audienceDefaults(audience);\n      const ttlMs = defaults.ttlMs;\n      const maxViews = defaults.maxViews;\n\n      try {\n        const tunnelUp = !!loadTunnelState();\n        if (decision.kind === 'site') {\n          const siteStore = getSiteShareStore(siteCfg);\n          let sitePath = relPath;\n          let stagedDir: string | null = null;\n          if (probe.kind === 'file') {\n            const staged = await stageSingleHtmlAsSite(workspace, probe.absolutePath);\n            sitePath = staged.relativePath;\n            stagedDir = staged.stagingDir;\n          }\n          const siteRec = await siteStore.create({\n            kind: 'static',\n            path: sitePath,\n            ttlMs,\n            description: p.description,\n            spaFallback: true,\n            rewriteMode: 'html-css',\n            workspaceRoot: workspace,\n            gatewayTokenHash: tokenHash,\n          });\n          if (stagedDir) rememberStagedSite(siteRec.id, stagedDir);\n\n          const label = siteRec.subdomain ?? siteRec.token;\n          const shareUrl = tunnelUp\n            ? `https://${label}.${siteCfg.publicHostSuffix}/`\n            : `http://${gatewayHost}:${gatewayPort}/site/${siteRec.token}/`;\n          const reachability = tunnelUp\n            ? 'public'\n            : (gatewayHost === '127.0.0.1' || gatewayHost === 'localhost' || gatewayHost === '::1' ? 'local-only' : 'lan');\n          const thumbnailUrl = `${shareUrl.replace(/\\/+$/, '')}/thumbnail`;\n          scheduleThumbnail(\n            { scope: 'site', token: siteRec.token, recordId: siteRec.id },\n            {\n              config: shareCfg.thumbnail,\n              internalBaseUrl: shareCfg.thumbnail.internalGatewayUrl ?? `http://127.0.0.1:${gatewayPort}`,\n            },\n          );\n          siteStore.setThumbnailStatus(siteRec.id, 'pending');\n\n          const titleOut = makeTitle(probe.kind === 'directory' ? (relPath.split('/').pop() || relPath) : (probe.absolutePath.split(/[\\\\/]/).pop() || relPath), p.title);\n          const descOut = makeDescription({ audience, expiresAt: siteRec.expiresAt, override: p.description });\n\n          return successResult(locale, {\n            kind: 'site',\n            shareUrl,\n            thumbnailUrl,\n            reachability,\n            title: titleOut,\n            description: descOut,\n            expiresAt: siteRec.expiresAt,\n            routing: { reason: decision.reason, hint: decision.hint },\n          });\n        }\n\n        // file or zip — uses ShareStore\n        const fileStore = getShareStore(shareCfg);\n        const rec = await fileStore.create({\n          path: relPath,\n          workspaceRoot: workspace,\n          gatewayTokenHash: tokenHash,\n          ttlMs,\n          maxViews: maxViews === undefined ? undefined : maxViews,\n          description: p.description,\n          kind: probe.kind === 'directory' ? 'directory' : 'file',\n          directoryMode: decision.kind === 'zip' ? 'zip-only' : (probe.kind === 'directory' ? 'browse' : undefined),\n        });\n        const resolved = resolveShareUrl(rec.token, { gatewayHost, gatewayPort });\n        const thumbnailUrl = `${resolved.shareUrl}/thumbnail`;\n        scheduleThumbnail(\n          { scope: 'file', token: rec.token, recordId: rec.id },\n          {\n            config: shareCfg.thumbnail,\n            internalBaseUrl: shareCfg.thumbnail.internalGatewayUrl ?? `http://127.0.0.1:${gatewayPort}`,\n          },\n        );\n        fileStore.setThumbnailStatus(rec.id, 'pending');\n        const titleOut = makeTitle(rec.fileName, p.title);\n        const descOut = makeDescription({ audience, expiresAt: rec.expiresAt, override: p.description });\n\n        return successResult(locale, {\n          kind: decision.kind,\n          shareUrl: resolved.shareUrl,\n          thumbnailUrl,\n          reachability: resolved.reachability,\n          reachabilityHint: resolved.reachabilityHint,\n          title: titleOut,\n          description: descOut,\n          expiresAt: rec.expiresAt,\n          maxViews: rec.maxViews,\n          routing: { reason: decision.reason, hint: decision.hint },\n        });\n      } catch (err) {\n        return errorResult(locale,err instanceof Error ? err.message : String(err));\n      }\n    },\n  } as any;\n}\n\nfunction successResult(\n  locale: ReturnType<typeof resolveToolLocale>,\n  payload: Record<string, unknown>,\n): AgentToolResult<Record<string, unknown>> {\n  const lines = shareToolSuccessLines(locale, {\n    kind: String(payload.kind ?? ''),\n    shareUrl: String(payload.shareUrl ?? ''),\n    title: String(payload.title ?? ''),\n    expiresAt: String(payload.expiresAt ?? ''),\n    thumbnailUrl: String(payload.thumbnailUrl ?? ''),\n    reachability: String(payload.reachability ?? ''),\n    reachabilityHint: String(payload.reachabilityHint ?? ''),\n    isPublic: payload.reachability === 'public',\n  }).filter(Boolean);\n  return {\n    content: [{ type: 'text', text: lines.join('\\n') }],\n    details: payload,\n  };\n}\n\nfunction errorResult(\n  locale: ReturnType<typeof resolveToolLocale>,\n  message: string,\n): AgentToolResult<Record<string, unknown>> {\n  return {\n    content: [{ type: 'text', text: shareToolErrorLine(locale, message) }],\n    details: { error: message },\n  };\n}\n"],"mappings":"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"}

package/dist/src/agent/tools/dreaming-tool.js

@@ -3,8 +3,8 @@ import { init_logger } from "../../utils/logger.js";
 import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE } from "../memory/dreaming/constants.js";
 import { loadDreamingStore, saveDreamingStore } from "../memory/dreaming/short-term-store.js";
 import { resolveDreamingConfig } from "../memory/dreaming/config.js";
-import fs from "node:fs/promises";
 import path from "node:path";
+import fs from "node:fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/dreaming-tool.ts
 init_logger();

package/dist/src/agent/tools/factory.js

@@ -1,6 +1,6 @@
+import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
 import { createEditFileTool } from "./edit.js";
@@ -15,6 +15,7 @@ import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { createWebExtractTool } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
 import { createSendMediaTool } from "./send-media.js";
+import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
 import { createTodoTool } from "./todo-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createDreamingTool } from "./dreaming-tool.js";
@@ -26,6 +27,8 @@ import { checkBrowserReadiness } from "../../browser/readiness.js";
 import { CdpSupervisor } from "../../browser/cdp-supervisor.js";
 import "../../browser/index.js";
 import { createDelegateTool } from "./delegate-tool.js";
+import { createWorkflowCatalog } from "../workflow/catalog.js";
+import { createWorkflowTool } from "./workflow-tool.js";
 import { buildSandboxToolMap, createExecuteCodeTool } from "./execute-code-tool.js";
 import { createCronjobTool } from "./cronjob-tool.js";
 import { createSkillViewTool, createSkillsListTool } from "./skills-tools.js";
@@ -218,6 +221,10 @@ var AgentToolsFactory = class AgentToolsFactory {
 				getConfig: () => this.deps.getConfig?.()
 			})] : [],
 			createSendMediaTool(workspace, bus, () => this.deps.getCurrentContext()),
+			...isShareToolAvailable(cfg) ? [createCreateShareTool({
+				workspace,
+				getConfig: () => this.deps.getConfig?.()
+			})] : [],
 			createMemorySearchTool({
 				workspaceDir: workspace,
 				memoriesDir
@@ -247,6 +254,33 @@ var AgentToolsFactory = class AgentToolsFactory {
 					this.browserTaskSupervisors.delete(taskId);
 				}
 			})] : [],
+			...cfg?.agents?.defaults?.workflow?.enabled !== false && primary ? [createWorkflowTool({
+				workspace,
+				bus: this.deps.bus,
+				getConfig: () => this.deps.getConfig?.(),
+				catalog: createWorkflowCatalog(),
+				getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
+				getSubagentModel: () => {
+					const m = (options?.getPrimaryModel ?? this.deps.getPrimaryModel)?.();
+					if (!m) throw new Error("No primary model configured for workflow");
+					return m;
+				},
+				toolExecutorConfig: this.deps.toolExecutorConfig,
+				buildChildTools: (childOpts) => {
+					return new AgentToolsFactory({
+						workspace: childOpts.workspace,
+						bus: childOpts.bus,
+						getCurrentContext: () => null,
+						getConfig: childOpts.getConfig,
+						getPrimaryModel: () => childOpts.model,
+						toolExecutorConfig: childOpts.toolExecutorConfig
+					}).createAllTools({
+						workspace: childOpts.workspace,
+						getPrimaryModel: () => childOpts.model,
+						disabledTools: new Set(["extensions"])
+					});
+				}
+			})] : [],
 			...cfg?.agents?.defaults?.delegate?.enabled === true && primary ? [createDelegateTool({
 				workspace,
 				getSubagentModel: () => {

package/dist/src/agent/tools/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","names":["parseRoutingSessionKey"],"sources":["../../../../src/agent/tools/factory.ts"],"sourcesContent":["/**\n * Agent Tools Factory - Creates and configures agent tools\n *\n * Centralizes tool creation logic to keep service.ts focused on orchestration.\n *\n * TTS: auto TTS is applied at the ChannelManager via maybeApplyTtsToPayload().\n * Optional \\`text_to_speech\\` tool sends explicit voice when TTS is enabled.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\nimport type { Page } from 'playwright-core';\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport {\n  createReadFileTool,\n  createWriteFileTool,\n  createEditFileTool,\n  createListDirTool,\n  createGrepTool,\n  createFindTool,\n  createShellTool,\n  createWebSearchTool,\n  createWebFetchTool,\n  createWebExtractTool,\n  createMessageTool,\n  createSendMediaTool,\n  createMemorySearchTool,\n  createMemoryGetTool,\n  createTodoTool,\n  createSessionStatusTool,\n  createDreamingTool,\n  createClarifyTool,\n} from './index.js';\nimport { createCuratedMemoryTool } from './curated-memory-tool.js';\nimport { createSessionSearchTool } from './session-search-tool.js';\nimport type { BuiltinMemoryStore } from '../memory/builtin-memory-store.js';\nimport type { MemoryManager } from '../memory/manager.js';\nimport { shouldRegisterCuratedMemoryTool } from '../memory/memory-config.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { parseSessionKey as parseRoutingSessionKey } from '../../routing/session-key.js';\nimport type { GatewayClarifyRequestFn } from './clarify-tool.js';\nimport { createImageTool } from './image-tool.js';\nimport { createImageGenerateTool } from './image-generate-tool.js';\nimport {\n  BrowserManager,\n  BrowserNotReadyError,\n  CdpSupervisor,\n  checkBrowserReadiness,\n  resolveBrowserBackendFromConfig,\n} from '../../browser/index.js';\nimport { createBrowserUseTool } from './browser/tool/browser-use-tool.js';\nimport { createDelegateTool } from './delegate-tool.js';\nimport { buildSandboxToolMap, createExecuteCodeTool } from './execute-code-tool.js';\nimport { createCronjobTool } from './cronjob-tool.js';\nimport type { CronService } from '../../cron/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { SkillManager } from '../skills/skill-manager.js';\nimport { wrapToolsWithProtection, type ToolExecutorConfig } from './executor.js';\nimport { createSkillsListTool, createSkillViewTool } from './skills-tools.js';\nimport { createSkillManageTool } from './skill-manage-tool.js';\nimport { createTextToSpeechTool } from './tts-tool.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\n\nconst log = createLogger('AgentToolsFactory');\n\n/** Channels where `clarify` can block for a user answer (web UI, Telegram, CLI readline). */\nconst CLARIFY_SUPPORTED_CHANNELS = new Set(['webchat', 'telegram', 'cli']);\n\nfunction clarifyTransportSource(sessionKey: string): string | undefined {\n  const parsed = parseRoutingSessionKey(sessionKey);\n  if (parsed) return parsed.source;\n  // Fallback for simple `<channel>:<chatId>` keys used by webchat and CLI.\n  const first = sessionKey.split(':').filter(Boolean)[0] ?? '';\n  if (first === 'cli' || first === 'webchat') return first;\n  return undefined;\n}\n\nexport interface ToolFactoryDeps {\n  workspace: string;\n  extensionRegistry?: any;\n  getCurrentContext: () => { channel: string; chatId: string; sessionKey: string } | null;\n  hookRunner?: import('../../extensions/index.js').ExtensionHookRunner;\n  bus: MessageBus;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /** Agent defaults (image tools, etc.); use getter so hot-reloaded config applies. */\n  getConfig?: () => Config | undefined;\n  /** Session / default chat model for vision tool description. */\n  getPrimaryModel?: () => Model<Api>;\n  /** Built-in curated memory store (agent home `memories/`). */\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  /** Memory orchestration (prefetch/sync + external tools). */\n  getMemoryManager?: () => MemoryManager;\n  /** Session store for `session_search`. */\n  getSessionStore?: () => SessionStore;\n  /** When set (gateway webchat), enables the `clarify` tool. */\n  gatewayClarify?: { requestClarification: GatewayClarifyRequestFn };\n  /** Gateway: enables the `cronjob` tool. */\n  getCronService?: () => CronService | undefined;\n  /** Current session skill indexing (tool gating + allowlist); used by skills_list / skill_view. */\n  getSkillIndexingContext?: () =>\n    | { registeredToolNames: string[]; skillAllowlist?: string[] }\n    | undefined;\n  /** After skill_manage mutates disk, reload skills + refresh agent prompts (optional). */\n  onSkillsFilesystemMutate?: () => void;\n  /** Names registered via skill_view for shell env passthrough. */\n  getSkillPassthroughEnvVarNames?: () => string[];\n  /** Add declared env names for the current session (no values stored). */\n  registerSkillEnvPassthrough?: (names: string[]) => void;\n}\n\nexport interface CreateCoreToolsOptions {\n  /** Workspace root for file/shell tools (defaults to factory workspace). */\n  workspace?: string;\n  /** Canonical `agents/<id>/profile/`: bare SOUL.md / IDENTITY.md resolve here after the workspace. */\n  profileMarkdownRoot?: string;\n  /** Tool `name` values to omit (e.g. `shell`, `extensions` for extension tools). */\n  disabledTools?: Set<string>;\n  /** Optional primary model for image tool heuristics. */\n  getPrimaryModel?: () => Model<Api>;\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  getMemoryManager?: () => MemoryManager;\n  /** When set, registers `skills_list` and `skill_view` bound to this workspace\\'s skills. */\n  getSkillManager?: () => SkillManager;\n}\n\nexport class AgentToolsFactory {\n  private browserManager: BrowserManager | null = null;\n  /** One dialog/console supervisor per chat session (browser tab). */\n  private readonly browserTaskSupervisors = new Map<string, CdpSupervisor>();\n  /** Cached readiness probe — keyed by backend mode + extension host:port. */\n  private browserReadinessCache: {\n    key: string;\n    expiresAt: number;\n    inflight?: Promise<BrowserNotReadyError | null>;\n    result?: BrowserNotReadyError | null;\n  } | null = null;\n\n  constructor(private deps: ToolFactoryDeps) {}\n\n  private browserReadinessKey(): string {\n    const cfg = this.deps.getConfig?.();\n    const backend = resolveBrowserBackendFromConfig(cfg);\n    const ext = cfg?.agents?.defaults?.browser?.extension;\n    const host = typeof ext?.host === 'string' && ext.host.trim() ? ext.host.trim() : '127.0.0.1';\n    const port = typeof ext?.port === 'number' ? ext.port : 19820;\n    const cdpUrl = backend.mode === 'cdp' ? backend.config.wsEndpoint : '';\n    const cloudKind = backend.mode === 'cloud' ? backend.config.type : '';\n    return `${backend.mode}@${host}:${port}|${cdpUrl}|${cloudKind}`;\n  }\n\n  private async checkBrowserReadinessCached(): Promise<BrowserNotReadyError | null> {\n    const key = this.browserReadinessKey();\n    const now = Date.now();\n    const cached = this.browserReadinessCache;\n    if (cached && cached.key === key && cached.expiresAt > now && cached.inflight === undefined) {\n      return cached.result ?? null;\n    }\n    if (cached && cached.key === key && cached.inflight) {\n      return cached.inflight;\n    }\n    const inflight = checkBrowserReadiness(this.deps.getConfig?.());\n    this.browserReadinessCache = { key, expiresAt: now + 30_000, inflight };\n    try {\n      const result = await inflight;\n      this.browserReadinessCache = { key, expiresAt: Date.now() + 30_000, result };\n      return result;\n    } catch (e) {\n      // Probe should never throw, but if it does we just bypass the cache.\n      this.browserReadinessCache = null;\n      log.warn({ err: e }, 'browserReadiness probe failed');\n      return null;\n    }\n  }\n\n  /** Invalidate the readiness cache (config hot-reload, settings-page save, etc.). */\n  invalidateBrowserReadinessCache(): void {\n    this.browserReadinessCache = null;\n  }\n\n  private browserSupervisorForTask(taskId: string): CdpSupervisor {\n    let s = this.browserTaskSupervisors.get(taskId);\n    if (!s) {\n      const b = this.deps.getConfig?.()?.agents?.defaults?.browser;\n      const dialogPolicy =\n        b?.dialogPolicy === 'must_respond' || b?.dialogPolicy === 'auto_accept' || b?.dialogPolicy === 'auto_dismiss'\n          ? b.dialogPolicy\n          : 'auto_dismiss';\n      const dialogTimeoutSeconds =\n        typeof b?.dialogTimeoutSeconds === 'number' &&\n        Number.isFinite(b.dialogTimeoutSeconds) &&\n        b.dialogTimeoutSeconds >= 1\n          ? Math.floor(b.dialogTimeoutSeconds)\n          : 300;\n      s = new CdpSupervisor({ dialogPolicy, dialogTimeoutSeconds });\n      this.browserTaskSupervisors.set(taskId, s);\n    }\n    return s;\n  }\n\n  private async acquireBrowserPage(): Promise<Page> {\n    const taskId = this.deps.getCurrentContext()?.sessionKey ?? 'default';\n    const mgr = this.ensureBrowserManager();\n    await mgr.ensureConnected();\n    if (mgr.getExtensionProvider()) {\n      return null as unknown as Page;\n    }\n    const page = await mgr.getPage(taskId);\n    this.browserSupervisorForTask(taskId).attach(page);\n    return page;\n  }\n\n  private ensureBrowserManager(): BrowserManager {\n    if (!this.browserManager) {\n      this.browserManager = new BrowserManager({\n        getHeadless: () => this.deps.getConfig?.()?.agents?.defaults?.browser?.headless === true,\n        getBackend: () => resolveBrowserBackendFromConfig(this.deps.getConfig?.()),\n      });\n    }\n    return this.browserManager;\n  }\n\n  /** Close Playwright and all pages (gateway stop, agent manager dispose, or config hot-reload). */\n  async shutdownBrowser(): Promise<void> {\n    this.browserReadinessCache = null;\n    if (!this.browserManager) {\n      return;\n    }\n    await this.browserManager.shutdown();\n    this.browserManager = null;\n    this.browserTaskSupervisors.clear();\n  }\n\n  /** Drop the tab for a session when its agent instance is removed. */\n  async closeBrowserPageForSession(sessionKey: string): Promise<void> {\n    this.browserTaskSupervisors.delete(sessionKey);\n    await this.browserManager?.closePage(sessionKey);\n  }\n\n  createCoreTools(options?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const workspace = options?.workspace ?? this.deps.workspace;\n    const { bus } = this.deps;\n    const getPrimary = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n    const getBuiltin = options?.getBuiltinMemoryStore ?? this.deps.getBuiltinMemoryStore;\n    const builtinStore = getBuiltin?.();\n    const memoriesDir = builtinStore?.memoriesDir;\n    const getMemMgr = options?.getMemoryManager ?? this.deps.getMemoryManager;\n    const getSkillMgr = options?.getSkillManager;\n    const disabled = options?.disabledTools;\n\n    const primary = getPrimary?.();\n    const modelHasVision = primary?.input?.includes('image') ?? false;\n    const cfg = this.deps.getConfig?.();\n    const imageTool = createImageTool({\n      config: cfg,\n      workspace,\n      modelHasVision,\n    });\n    const imageGenerateTool = createImageGenerateTool({\n      config: cfg,\n      workspace,\n    });\n\n    const optionalTools = [imageTool, imageGenerateTool].filter((t) => t != null) as any[];\n\n    const readTool = createReadFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n    });\n    const writeTool = createWriteFileTool(workspace);\n    const editTool = createEditFileTool(workspace);\n    const listDir = createListDirTool(workspace);\n    const grep = createGrepTool(workspace);\n    const find = createFindTool(workspace);\n\n    const core: AgentTool<any, any>[] = [\n      createSessionStatusTool(),\n      createDreamingTool({\n        getWorkspace: () => workspace,\n        getConfig: () => this.deps.getConfig?.(),\n      }),\n      createClarifyTool({\n        resolveAskUser: () => {\n          const req = this.deps.gatewayClarify?.requestClarification;\n          if (!req) return null;\n          const ctx = this.deps.getCurrentContext();\n          if (!ctx?.sessionKey) return null;\n          const source = clarifyTransportSource(ctx.sessionKey);\n          if (!source || !CLARIFY_SUPPORTED_CHANNELS.has(source)) return null;\n          return (r) => req(ctx.sessionKey, r);\n        },\n      }),\n      createTodoTool({\n        getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\n      ...(getSkillMgr\n        ? [\n            createSkillsListTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n            }),\n            createSkillViewTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n              registerSkillEnvPassthrough: this.deps.registerSkillEnvPassthrough,\n            }),\n            createSkillManageTool({\n              getSkillManager: getSkillMgr,\n              getWorkspace: () => workspace,\n              onSkillsFilesystemMutate: this.deps.onSkillsFilesystemMutate,\n            }),\n          ]\n        : []),\n      readTool,\n      writeTool,\n      editTool,\n      listDir,\n      grep,\n      find,\n      createShellTool(workspace, {\n        getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,\n      }),\n      createWebSearchTool(() => this.deps.getConfig?.()),\n      createWebFetchTool(() => this.deps.getConfig?.()),\n      createWebExtractTool({ getConfig: () => this.deps.getConfig?.() }),\n      // Note: TTS is NOT handled by send_message tool anymore\n      // TTS is applied at the ChannelManager dispatch layer\n      createMessageTool(bus, () => this.deps.getCurrentContext()),\n      ...(mergeTtsConfigFromAppConfig(cfg?.messages?.tts).enabled\n        ? [\n            createTextToSpeechTool({\n              bus,\n              getContext: () => this.deps.getCurrentContext(),\n              getConfig: () => this.deps.getConfig?.(),\n            }),\n          ]\n        : []),\n      createSendMediaTool(workspace, bus, () => this.deps.getCurrentContext()),\n      createMemorySearchTool({ workspaceDir: workspace, memoriesDir }),\n      createMemoryGetTool({ workspaceDir: workspace, memoriesDir }),\n      ...(getBuiltin && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.())\n        ? [\n            createCuratedMemoryTool(getBuiltin, {\n              onMemoryWrite: (action, target, content) => {\n                getMemMgr?.().onMemoryWrite(action, target, content);\n              },\n            }),\n          ]\n        : []),\n      ...(getMemMgr?.().getAdditionalTools() ?? []),\n      ...(this.deps.getSessionStore\n        ? [\n            createSessionSearchTool({\n              getSessionStore: this.deps.getSessionStore,\n              getConfig: this.deps.getConfig,\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n            }),\n          ]\n        : []),\n      ...(this.deps.getCronService\n        ? [\n            createCronjobTool({\n              getCronService: this.deps.getCronService,\n            }),\n          ]\n        : []),\n      ...(cfg?.agents?.defaults?.browser?.enabled !== false\n        ? [\n            createBrowserUseTool({\n              getManager: () => this.ensureBrowserManager(),\n              getPageForTask: () => this.acquireBrowserPage(),\n              getTaskId: () => this.deps.getCurrentContext()?.sessionKey ?? 'default',\n              getConfig: () => this.deps.getConfig?.(),\n              getReadiness: () => this.checkBrowserReadinessCached(),\n              getSupervisor: () =>\n                this.browserSupervisorForTask(this.deps.getCurrentContext()?.sessionKey ?? 'default'),\n              notifyBrowserPageClosed: (taskId) => {\n                this.browserTaskSupervisors.delete(taskId);\n              },\n            }),\n          ]\n        : []),\n      ...(cfg?.agents?.defaults?.delegate?.enabled === true && primary\n        ? [\n            createDelegateTool({\n              workspace,\n              getSubagentModel: () => {\n                const gp = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n                const m = gp?.();\n                if (!m) {\n                  throw new Error('No primary model configured for delegate_task');\n                }\n                return m;\n              },\n              bus: this.deps.bus,\n              getConfig: () => this.deps.getConfig?.(),\n              getCurrentContext: () => this.deps.getCurrentContext?.() ?? null,\n              hookRunner: this.deps.hookRunner,\n              toolExecutorConfig: this.deps.toolExecutorConfig,\n              // Injected so `child-agent-factory.ts` does not need to import\n              // `AgentToolsFactory` directly (which would form a cycle).\n              buildChildTools: (childOpts) => {\n                const childFactory = new AgentToolsFactory({\n                  workspace: childOpts.workspace,\n                  bus: childOpts.bus,\n                  getCurrentContext: () => null,\n                  getConfig: childOpts.getConfig,\n                  getPrimaryModel: () => childOpts.model,\n                  toolExecutorConfig: childOpts.toolExecutorConfig,\n                });\n                return childFactory.createAllTools({\n                  workspace: childOpts.workspace,\n                  getPrimaryModel: () => childOpts.model,\n                  disabledTools: new Set(['extensions']),\n                });\n              },\n            }),\n          ]\n        : []),\n      ...optionalTools,\n    ];\n\n    return filterToolsByDisabledSet(core, disabled);\n  }\n\n  createAllTools(coreOptions?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const coreTools = this.createCoreTools(coreOptions);\n    const disableExtensions = coreOptions?.disabledTools?.has('extensions');\n    const cfg = this.deps.getConfig?.();\n\n    let bundled: AgentTool<any, any>[];\n    if (!this.deps.extensionRegistry || disableExtensions) {\n      bundled = coreTools;\n    } else {\n      const extensionTools = this.deps.extensionRegistry.getAllTools();\n      log.info({ count: extensionTools.length }, 'Loaded extension tools');\n      bundled = [...coreTools, ...extensionTools];\n    }\n\n    const wrapped = wrapToolsWithProtection(bundled, this.deps.toolExecutorConfig);\n\n    const executeEnabled =\n      cfg?.agents?.defaults?.executeCode?.enabled === true &&\n      !coreOptions?.disabledTools?.has('execute_code');\n\n    if (executeEnabled) {\n      const sandboxMap = buildSandboxToolMap(wrapped);\n      const executeTool = createExecuteCodeTool({ getSandboxToolMap: () => sandboxMap });\n      const wrappedExecute = wrapToolsWithProtection([executeTool as any], this.deps.toolExecutorConfig);\n      return [...wrapped, ...wrappedExecute];\n    }\n\n    return wrapped;\n  }\n}\n\nfunction filterToolsByDisabledSet(\n  tools: any[],\n  disabled: Set<string> | undefined,\n): any[] {\n  if (!disabled || disabled.size === 0) {\n    return tools;\n  }\n  return tools.filter((t) => !disabled.has(t.name));\n}\n"],"mappings":"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"}
+{"version":3,"file":"factory.js","names":["parseRoutingSessionKey"],"sources":["../../../../src/agent/tools/factory.ts"],"sourcesContent":["/**\n * Agent Tools Factory - Creates and configures agent tools\n *\n * Centralizes tool creation logic to keep service.ts focused on orchestration.\n *\n * TTS: auto TTS is applied at the ChannelManager via maybeApplyTtsToPayload().\n * Optional \\`text_to_speech\\` tool sends explicit voice when TTS is enabled.\n */\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { Model, Api } from '@earendil-works/pi-ai';\nimport type { Page } from 'playwright-core';\nimport type { Config } from '../../config/schema.js';\nimport type { MessageBus } from '../../infra/bus/index.js';\nimport {\n  createReadFileTool,\n  createWriteFileTool,\n  createEditFileTool,\n  createListDirTool,\n  createGrepTool,\n  createFindTool,\n  createShellTool,\n  createWebSearchTool,\n  createWebFetchTool,\n  createWebExtractTool,\n  createMessageTool,\n  createSendMediaTool,\n  createCreateShareTool,\n  isShareToolAvailable,\n  createMemorySearchTool,\n  createMemoryGetTool,\n  createTodoTool,\n  createSessionStatusTool,\n  createDreamingTool,\n  createClarifyTool,\n} from './index.js';\nimport { createCuratedMemoryTool } from './curated-memory-tool.js';\nimport { createSessionSearchTool } from './session-search-tool.js';\nimport type { BuiltinMemoryStore } from '../memory/builtin-memory-store.js';\nimport type { MemoryManager } from '../memory/manager.js';\nimport { shouldRegisterCuratedMemoryTool } from '../memory/memory-config.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { parseSessionKey as parseRoutingSessionKey } from '../../routing/session-key.js';\nimport type { GatewayClarifyRequestFn } from './clarify-tool.js';\nimport { createImageTool } from './image-tool.js';\nimport { createImageGenerateTool } from './image-generate-tool.js';\nimport {\n  BrowserManager,\n  BrowserNotReadyError,\n  CdpSupervisor,\n  checkBrowserReadiness,\n  resolveBrowserBackendFromConfig,\n} from '../../browser/index.js';\nimport { createBrowserUseTool } from './browser/tool/browser-use-tool.js';\nimport { createDelegateTool } from './delegate-tool.js';\nimport { createWorkflowTool } from './workflow-tool.js';\nimport { createWorkflowCatalog } from '../workflow/catalog.js';\nimport { buildSandboxToolMap, createExecuteCodeTool } from './execute-code-tool.js';\nimport { createCronjobTool } from './cronjob-tool.js';\nimport type { CronService } from '../../cron/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { SkillManager } from '../skills/skill-manager.js';\nimport { wrapToolsWithProtection, type ToolExecutorConfig } from './executor.js';\nimport { createSkillsListTool, createSkillViewTool } from './skills-tools.js';\nimport { createSkillManageTool } from './skill-manage-tool.js';\nimport { createTextToSpeechTool } from './tts-tool.js';\nimport { mergeTtsConfigFromAppConfig } from '../../voice/tts/merge-config.js';\n\nconst log = createLogger('AgentToolsFactory');\n\n/** Channels where `clarify` can block for a user answer (web UI, Telegram, CLI readline). */\nconst CLARIFY_SUPPORTED_CHANNELS = new Set(['webchat', 'telegram', 'cli']);\n\nfunction clarifyTransportSource(sessionKey: string): string | undefined {\n  const parsed = parseRoutingSessionKey(sessionKey);\n  if (parsed) return parsed.source;\n  // Fallback for simple `<channel>:<chatId>` keys used by webchat and CLI.\n  const first = sessionKey.split(':').filter(Boolean)[0] ?? '';\n  if (first === 'cli' || first === 'webchat') return first;\n  return undefined;\n}\n\nexport interface ToolFactoryDeps {\n  workspace: string;\n  extensionRegistry?: any;\n  getCurrentContext: () => { channel: string; chatId: string; sessionKey: string } | null;\n  hookRunner?: import('../../extensions/index.js').ExtensionHookRunner;\n  bus: MessageBus;\n  toolExecutorConfig?: Partial<ToolExecutorConfig>;\n  /** Agent defaults (image tools, etc.); use getter so hot-reloaded config applies. */\n  getConfig?: () => Config | undefined;\n  /** Session / default chat model for vision tool description. */\n  getPrimaryModel?: () => Model<Api>;\n  /** Built-in curated memory store (agent home `memories/`). */\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  /** Memory orchestration (prefetch/sync + external tools). */\n  getMemoryManager?: () => MemoryManager;\n  /** Session store for `session_search`. */\n  getSessionStore?: () => SessionStore;\n  /** When set (gateway webchat), enables the `clarify` tool. */\n  gatewayClarify?: { requestClarification: GatewayClarifyRequestFn };\n  /** Gateway: enables the `cronjob` tool. */\n  getCronService?: () => CronService | undefined;\n  /** Current session skill indexing (tool gating + allowlist); used by skills_list / skill_view. */\n  getSkillIndexingContext?: () =>\n    | { registeredToolNames: string[]; skillAllowlist?: string[] }\n    | undefined;\n  /** After skill_manage mutates disk, reload skills + refresh agent prompts (optional). */\n  onSkillsFilesystemMutate?: () => void;\n  /** Names registered via skill_view for shell env passthrough. */\n  getSkillPassthroughEnvVarNames?: () => string[];\n  /** Add declared env names for the current session (no values stored). */\n  registerSkillEnvPassthrough?: (names: string[]) => void;\n}\n\nexport interface CreateCoreToolsOptions {\n  /** Workspace root for file/shell tools (defaults to factory workspace). */\n  workspace?: string;\n  /** Canonical `agents/<id>/profile/`: bare SOUL.md / IDENTITY.md resolve here after the workspace. */\n  profileMarkdownRoot?: string;\n  /** Tool `name` values to omit (e.g. `shell`, `extensions` for extension tools). */\n  disabledTools?: Set<string>;\n  /** Optional primary model for image tool heuristics. */\n  getPrimaryModel?: () => Model<Api>;\n  getBuiltinMemoryStore?: () => BuiltinMemoryStore;\n  getMemoryManager?: () => MemoryManager;\n  /** When set, registers `skills_list` and `skill_view` bound to this workspace\\'s skills. */\n  getSkillManager?: () => SkillManager;\n}\n\nexport class AgentToolsFactory {\n  private browserManager: BrowserManager | null = null;\n  /** One dialog/console supervisor per chat session (browser tab). */\n  private readonly browserTaskSupervisors = new Map<string, CdpSupervisor>();\n  /** Cached readiness probe — keyed by backend mode + extension host:port. */\n  private browserReadinessCache: {\n    key: string;\n    expiresAt: number;\n    inflight?: Promise<BrowserNotReadyError | null>;\n    result?: BrowserNotReadyError | null;\n  } | null = null;\n\n  constructor(private deps: ToolFactoryDeps) {}\n\n  private browserReadinessKey(): string {\n    const cfg = this.deps.getConfig?.();\n    const backend = resolveBrowserBackendFromConfig(cfg);\n    const ext = cfg?.agents?.defaults?.browser?.extension;\n    const host = typeof ext?.host === 'string' && ext.host.trim() ? ext.host.trim() : '127.0.0.1';\n    const port = typeof ext?.port === 'number' ? ext.port : 19820;\n    const cdpUrl = backend.mode === 'cdp' ? backend.config.wsEndpoint : '';\n    const cloudKind = backend.mode === 'cloud' ? backend.config.type : '';\n    return `${backend.mode}@${host}:${port}|${cdpUrl}|${cloudKind}`;\n  }\n\n  private async checkBrowserReadinessCached(): Promise<BrowserNotReadyError | null> {\n    const key = this.browserReadinessKey();\n    const now = Date.now();\n    const cached = this.browserReadinessCache;\n    if (cached && cached.key === key && cached.expiresAt > now && cached.inflight === undefined) {\n      return cached.result ?? null;\n    }\n    if (cached && cached.key === key && cached.inflight) {\n      return cached.inflight;\n    }\n    const inflight = checkBrowserReadiness(this.deps.getConfig?.());\n    this.browserReadinessCache = { key, expiresAt: now + 30_000, inflight };\n    try {\n      const result = await inflight;\n      this.browserReadinessCache = { key, expiresAt: Date.now() + 30_000, result };\n      return result;\n    } catch (e) {\n      // Probe should never throw, but if it does we just bypass the cache.\n      this.browserReadinessCache = null;\n      log.warn({ err: e }, 'browserReadiness probe failed');\n      return null;\n    }\n  }\n\n  /** Invalidate the readiness cache (config hot-reload, settings-page save, etc.). */\n  invalidateBrowserReadinessCache(): void {\n    this.browserReadinessCache = null;\n  }\n\n  private browserSupervisorForTask(taskId: string): CdpSupervisor {\n    let s = this.browserTaskSupervisors.get(taskId);\n    if (!s) {\n      const b = this.deps.getConfig?.()?.agents?.defaults?.browser;\n      const dialogPolicy =\n        b?.dialogPolicy === 'must_respond' || b?.dialogPolicy === 'auto_accept' || b?.dialogPolicy === 'auto_dismiss'\n          ? b.dialogPolicy\n          : 'auto_dismiss';\n      const dialogTimeoutSeconds =\n        typeof b?.dialogTimeoutSeconds === 'number' &&\n        Number.isFinite(b.dialogTimeoutSeconds) &&\n        b.dialogTimeoutSeconds >= 1\n          ? Math.floor(b.dialogTimeoutSeconds)\n          : 300;\n      s = new CdpSupervisor({ dialogPolicy, dialogTimeoutSeconds });\n      this.browserTaskSupervisors.set(taskId, s);\n    }\n    return s;\n  }\n\n  private async acquireBrowserPage(): Promise<Page> {\n    const taskId = this.deps.getCurrentContext()?.sessionKey ?? 'default';\n    const mgr = this.ensureBrowserManager();\n    await mgr.ensureConnected();\n    if (mgr.getExtensionProvider()) {\n      return null as unknown as Page;\n    }\n    const page = await mgr.getPage(taskId);\n    this.browserSupervisorForTask(taskId).attach(page);\n    return page;\n  }\n\n  private ensureBrowserManager(): BrowserManager {\n    if (!this.browserManager) {\n      this.browserManager = new BrowserManager({\n        getHeadless: () => this.deps.getConfig?.()?.agents?.defaults?.browser?.headless === true,\n        getBackend: () => resolveBrowserBackendFromConfig(this.deps.getConfig?.()),\n      });\n    }\n    return this.browserManager;\n  }\n\n  /** Close Playwright and all pages (gateway stop, agent manager dispose, or config hot-reload). */\n  async shutdownBrowser(): Promise<void> {\n    this.browserReadinessCache = null;\n    if (!this.browserManager) {\n      return;\n    }\n    await this.browserManager.shutdown();\n    this.browserManager = null;\n    this.browserTaskSupervisors.clear();\n  }\n\n  /** Drop the tab for a session when its agent instance is removed. */\n  async closeBrowserPageForSession(sessionKey: string): Promise<void> {\n    this.browserTaskSupervisors.delete(sessionKey);\n    await this.browserManager?.closePage(sessionKey);\n  }\n\n  createCoreTools(options?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const workspace = options?.workspace ?? this.deps.workspace;\n    const { bus } = this.deps;\n    const getPrimary = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n    const getBuiltin = options?.getBuiltinMemoryStore ?? this.deps.getBuiltinMemoryStore;\n    const builtinStore = getBuiltin?.();\n    const memoriesDir = builtinStore?.memoriesDir;\n    const getMemMgr = options?.getMemoryManager ?? this.deps.getMemoryManager;\n    const getSkillMgr = options?.getSkillManager;\n    const disabled = options?.disabledTools;\n\n    const primary = getPrimary?.();\n    const modelHasVision = primary?.input?.includes('image') ?? false;\n    const cfg = this.deps.getConfig?.();\n    const imageTool = createImageTool({\n      config: cfg,\n      workspace,\n      modelHasVision,\n    });\n    const imageGenerateTool = createImageGenerateTool({\n      config: cfg,\n      workspace,\n    });\n\n    const optionalTools = [imageTool, imageGenerateTool].filter((t) => t != null) as any[];\n\n    const readTool = createReadFileTool(workspace, {\n      profileMarkdownRoot: options?.profileMarkdownRoot,\n    });\n    const writeTool = createWriteFileTool(workspace);\n    const editTool = createEditFileTool(workspace);\n    const listDir = createListDirTool(workspace);\n    const grep = createGrepTool(workspace);\n    const find = createFindTool(workspace);\n\n    const core: AgentTool<any, any>[] = [\n      createSessionStatusTool(),\n      createDreamingTool({\n        getWorkspace: () => workspace,\n        getConfig: () => this.deps.getConfig?.(),\n      }),\n      createClarifyTool({\n        resolveAskUser: () => {\n          const req = this.deps.gatewayClarify?.requestClarification;\n          if (!req) return null;\n          const ctx = this.deps.getCurrentContext();\n          if (!ctx?.sessionKey) return null;\n          const source = clarifyTransportSource(ctx.sessionKey);\n          if (!source || !CLARIFY_SUPPORTED_CHANNELS.has(source)) return null;\n          return (r) => req(ctx.sessionKey, r);\n        },\n      }),\n      createTodoTool({\n        getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n      }),\n      ...(getSkillMgr\n        ? [\n            createSkillsListTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n            }),\n            createSkillViewTool({\n              getSkillManager: getSkillMgr,\n              getSkillIndexingContext: this.deps.getSkillIndexingContext,\n              registerSkillEnvPassthrough: this.deps.registerSkillEnvPassthrough,\n            }),\n            createSkillManageTool({\n              getSkillManager: getSkillMgr,\n              getWorkspace: () => workspace,\n              onSkillsFilesystemMutate: this.deps.onSkillsFilesystemMutate,\n            }),\n          ]\n        : []),\n      readTool,\n      writeTool,\n      editTool,\n      listDir,\n      grep,\n      find,\n      createShellTool(workspace, {\n        getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,\n      }),\n      createWebSearchTool(() => this.deps.getConfig?.()),\n      createWebFetchTool(() => this.deps.getConfig?.()),\n      createWebExtractTool({ getConfig: () => this.deps.getConfig?.() }),\n      // Note: TTS is NOT handled by send_message tool anymore\n      // TTS is applied at the ChannelManager dispatch layer\n      createMessageTool(bus, () => this.deps.getCurrentContext()),\n      ...(mergeTtsConfigFromAppConfig(cfg?.messages?.tts).enabled\n        ? [\n            createTextToSpeechTool({\n              bus,\n              getContext: () => this.deps.getCurrentContext(),\n              getConfig: () => this.deps.getConfig?.(),\n            }),\n          ]\n        : []),\n      createSendMediaTool(workspace, bus, () => this.deps.getCurrentContext()),\n      ...(isShareToolAvailable(cfg)\n        ? [\n            createCreateShareTool({\n              workspace,\n              getConfig: () => this.deps.getConfig?.(),\n            }),\n          ]\n        : []),\n      createMemorySearchTool({ workspaceDir: workspace, memoriesDir }),\n      createMemoryGetTool({ workspaceDir: workspace, memoriesDir }),\n      ...(getBuiltin && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.())\n        ? [\n            createCuratedMemoryTool(getBuiltin, {\n              onMemoryWrite: (action, target, content) => {\n                getMemMgr?.().onMemoryWrite(action, target, content);\n              },\n            }),\n          ]\n        : []),\n      ...(getMemMgr?.().getAdditionalTools() ?? []),\n      ...(this.deps.getSessionStore\n        ? [\n            createSessionSearchTool({\n              getSessionStore: this.deps.getSessionStore,\n              getConfig: this.deps.getConfig,\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n            }),\n          ]\n        : []),\n      ...(this.deps.getCronService\n        ? [\n            createCronjobTool({\n              getCronService: this.deps.getCronService,\n            }),\n          ]\n        : []),\n      ...(cfg?.agents?.defaults?.browser?.enabled !== false\n        ? [\n            createBrowserUseTool({\n              getManager: () => this.ensureBrowserManager(),\n              getPageForTask: () => this.acquireBrowserPage(),\n              getTaskId: () => this.deps.getCurrentContext()?.sessionKey ?? 'default',\n              getConfig: () => this.deps.getConfig?.(),\n              getReadiness: () => this.checkBrowserReadinessCached(),\n              getSupervisor: () =>\n                this.browserSupervisorForTask(this.deps.getCurrentContext()?.sessionKey ?? 'default'),\n              notifyBrowserPageClosed: (taskId) => {\n                this.browserTaskSupervisors.delete(taskId);\n              },\n            }),\n          ]\n        : []),\n      ...(cfg?.agents?.defaults?.workflow?.enabled !== false && primary\n        ? [\n            createWorkflowTool({\n              workspace,\n              bus: this.deps.bus,\n              getConfig: () => this.deps.getConfig?.(),\n              catalog: createWorkflowCatalog(),\n              getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,\n              getSubagentModel: () => {\n                const gp = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n                const m = gp?.();\n                if (!m) {\n                  throw new Error('No primary model configured for workflow');\n                }\n                return m;\n              },\n              toolExecutorConfig: this.deps.toolExecutorConfig,\n              // Injected so `subagent-runner.ts` doesn't import `AgentToolsFactory`\n              // (which would form the same cycle delegate-tool was carved out to avoid).\n              buildChildTools: (childOpts) => {\n                const childFactory = new AgentToolsFactory({\n                  workspace: childOpts.workspace,\n                  bus: childOpts.bus,\n                  getCurrentContext: () => null,\n                  getConfig: childOpts.getConfig,\n                  getPrimaryModel: () => childOpts.model,\n                  toolExecutorConfig: childOpts.toolExecutorConfig,\n                });\n                return childFactory.createAllTools({\n                  workspace: childOpts.workspace,\n                  getPrimaryModel: () => childOpts.model,\n                  disabledTools: new Set(['extensions']),\n                });\n              },\n            }),\n          ]\n        : []),\n      ...(cfg?.agents?.defaults?.delegate?.enabled === true && primary\n        ? [\n            createDelegateTool({\n              workspace,\n              getSubagentModel: () => {\n                const gp = options?.getPrimaryModel ?? this.deps.getPrimaryModel;\n                const m = gp?.();\n                if (!m) {\n                  throw new Error('No primary model configured for delegate_task');\n                }\n                return m;\n              },\n              bus: this.deps.bus,\n              getConfig: () => this.deps.getConfig?.(),\n              getCurrentContext: () => this.deps.getCurrentContext?.() ?? null,\n              hookRunner: this.deps.hookRunner,\n              toolExecutorConfig: this.deps.toolExecutorConfig,\n              // Injected so `child-agent-factory.ts` does not need to import\n              // `AgentToolsFactory` directly (which would form a cycle).\n              buildChildTools: (childOpts) => {\n                const childFactory = new AgentToolsFactory({\n                  workspace: childOpts.workspace,\n                  bus: childOpts.bus,\n                  getCurrentContext: () => null,\n                  getConfig: childOpts.getConfig,\n                  getPrimaryModel: () => childOpts.model,\n                  toolExecutorConfig: childOpts.toolExecutorConfig,\n                });\n                return childFactory.createAllTools({\n                  workspace: childOpts.workspace,\n                  getPrimaryModel: () => childOpts.model,\n                  disabledTools: new Set(['extensions']),\n                });\n              },\n            }),\n          ]\n        : []),\n      ...optionalTools,\n    ];\n\n    return filterToolsByDisabledSet(core, disabled);\n  }\n\n  createAllTools(coreOptions?: CreateCoreToolsOptions): AgentTool<any, any>[] {\n    const coreTools = this.createCoreTools(coreOptions);\n    const disableExtensions = coreOptions?.disabledTools?.has('extensions');\n    const cfg = this.deps.getConfig?.();\n\n    let bundled: AgentTool<any, any>[];\n    if (!this.deps.extensionRegistry || disableExtensions) {\n      bundled = coreTools;\n    } else {\n      const extensionTools = this.deps.extensionRegistry.getAllTools();\n      log.info({ count: extensionTools.length }, 'Loaded extension tools');\n      bundled = [...coreTools, ...extensionTools];\n    }\n\n    const wrapped = wrapToolsWithProtection(bundled, this.deps.toolExecutorConfig);\n\n    const executeEnabled =\n      cfg?.agents?.defaults?.executeCode?.enabled === true &&\n      !coreOptions?.disabledTools?.has('execute_code');\n\n    if (executeEnabled) {\n      const sandboxMap = buildSandboxToolMap(wrapped);\n      const executeTool = createExecuteCodeTool({ getSandboxToolMap: () => sandboxMap });\n      const wrappedExecute = wrapToolsWithProtection([executeTool as any], this.deps.toolExecutorConfig);\n      return [...wrapped, ...wrappedExecute];\n    }\n\n    return wrapped;\n  }\n}\n\nfunction filterToolsByDisabledSet(\n  tools: any[],\n  disabled: Set<string> | undefined,\n): any[] {\n  if (!disabled || disabled.size === 0) {\n    return tools;\n  }\n  return tools.filter((t) => !disabled.has(t.name));\n}\n"],"mappings":"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"}

package/dist/src/agent/tools/image-generate-tool.js

@@ -4,9 +4,9 @@ import { isFailoverError } from "../failover-error.js";
 import { imageAssetFromDataUrl, imageFileExtensionForMimeType, mimeTypeFromFileName, parseImageDataUrl, sniffImageMimeType } from "../image/generation/image-assets.js";
 import { getImageGenerationProvider } from "../image/generation/provider-registry.js";
 import { generateImage, listImageGenerationProvidersSummary } from "../image/generation/runtime.js";
+import path from "node:path";
 import { randomBytes } from "node:crypto";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/image-generate-tool.ts
 const DEFAULT_COUNT = 1;

package/dist/src/agent/tools/index.d.ts

@@ -13,6 +13,7 @@ export { createWebSearchTool, createWebFetchTool } from './web.js';
 export { createWebExtractTool, stripHtmlBoilerplate, DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, } from './web-extract.js';
 export { createMessageTool } from './communication.js';
 export { createSendMediaTool } from './send-media.js';
+export { createCreateShareTool, isShareToolAvailable, type CreateShareToolDeps, } from './create-share-tool.js';
 export { createTodoTool, TodoStore, type TodoItem, type TodoStatus } from './todo-tool.js';
 export { createSessionStatusTool } from './session-status-tool.js';
 export { createDreamingTool, type DreamingToolDeps } from './dreaming-tool.js';
@@ -20,6 +21,7 @@ export { createClarifyTool, type ClarifyRequestPayload, type GatewayClarifyReque
 export { createBrowserTools, type CreateBrowserToolsDeps } from './browser-legacy-tools.js';
 export { BrowserManager, assertBrowserUrlAllowed } from '../../browser/index.js';
 export { createDelegateTool, DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, } from './delegate-tool.js';
+export { createWorkflowTool, type WorkflowToolDeps, type WorkflowToolInput } from './workflow-tool.js';
 export { createExecuteCodeTool, buildSandboxToolMap, SANDBOX_ALLOWED_TOOLS, } from './execute-code-tool.js';
 export { createCronjobTool, scanCronPrompt } from './cronjob-tool.js';
 export { createSkillsListTool, createSkillViewTool, type SkillsToolsDeps } from './skills-tools.js';

package/dist/src/agent/tools/index.js

@@ -15,6 +15,7 @@ import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, createWebExtractTool, stripHtmlBoilerplate } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
 import { createSendMediaTool } from "./send-media.js";
+import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
 import { TodoStore, createTodoTool } from "./todo-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
 import { createDreamingTool } from "./dreaming-tool.js";
@@ -26,9 +27,10 @@ import { createBrowserTools } from "./browser-legacy-tools.js";
 import { BrowserManager } from "../../browser/manager.js";
 import "../../browser/index.js";
 import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, createDelegateTool } from "./delegate-tool.js";
+import { createWorkflowTool } from "./workflow-tool.js";
 import { SANDBOX_ALLOWED_TOOLS, buildSandboxToolMap, createExecuteCodeTool } from "./execute-code-tool.js";
 import { createCronjobTool, scanCronPrompt } from "./cronjob-tool.js";
 import { createSkillViewTool, createSkillsListTool } from "./skills-tools.js";
 import { createSkillManageTool } from "./skill-manage-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
-export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, assertBrowserUrlAllowed, buildSandboxToolMap, createBrowserTools, createClarifyTool, createCronjobTool, createCuratedMemoryTool, createDelegateTool, createDreamingTool, createEditFileTool, createExecuteCodeTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createShellTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createTodoTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, editFileTool, findTool, formatSize, fuzzyFindText, generateDiffString, grepTool, invalidateSessionSearchIndexCache, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, restoreLineEndings, scanCronPrompt, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserManager, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, SANDBOX_ALLOWED_TOOLS, TodoStore, assertBrowserUrlAllowed, buildSandboxToolMap, createBrowserTools, createClarifyTool, createCreateShareTool, createCronjobTool, createCuratedMemoryTool, createDelegateTool, createDreamingTool, createEditFileTool, createExecuteCodeTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createShellTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createTodoTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, editFileTool, findTool, formatSize, fuzzyFindText, generateDiffString, grepTool, invalidateSessionSearchIndexCache, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, restoreLineEndings, scanCronPrompt, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };

package/dist/src/agent/tools/send-media.js

@@ -1,7 +1,7 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
-import { readFile } from "fs/promises";
 import { basename } from "node:path";
+import { readFile } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/send-media.ts
 const SendMediaSchema = Type.Object({

package/dist/src/agent/tools/skill-manage-tool.js

@@ -2,9 +2,9 @@ import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
 import { createSkillConfigManager } from "../skills/config.js";
 import { applyPatchToContent, atomicWriteUtf8, effectiveAgentWritePolicy, ensureCategorySegment, isPathInsideDir, maxSkillMdChars, maxSupportFileBytes, mutatableSkillOrNull, resolveCreateSkillDir, scanSkillDirOrError, validateSkillMdContent, validateSkillNameSegment, validateSupportingRelativePath } from "../skills/skill-manage-ops.js";
-import { readFile, rm } from "fs/promises";
 import { join } from "path";
 import { existsSync, rmSync } from "fs";
+import { readFile, rm } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/skill-manage-tool.ts
 init_paths();

package/dist/src/agent/tools/workflow-tool.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `workflow` — the AgentTool the parent model calls to spawn a fan-out run.
+ *
+ * Shape mirrors `delegate-tool`: factory builds a closure over deps; `execute`
+ * parses the script, instantiates the {@link DelegateSubagentRunner}, drives the
+ * {@link runWorkflow} runtime, and pushes a live text snapshot through
+ * `onUpdate` for streaming UIs (TUI, gateway console).
+ *
+ * Why this lives in `src/agent/tools/` (not under `src/agent/workflow/`):
+ * the runtime is reusable infrastructure; the AgentTool wrapping is a
+ * presentation concern that depends on the AgentToolsFactory wiring. Keeping
+ * the wrapper here matches how `delegate-tool` and `execute-code-tool` are
+ * organised today.
+ */
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { Api, Model } from '@earendil-works/pi-ai';
+import type { Config } from '../../config/schema.js';
+import type { MessageBus } from '../../infra/bus/index.js';
+import type { BuildChildToolsOptions } from '../child-agent-factory.js';
+import { type WorkflowCatalog } from '../workflow/index.js';
+import type { ToolExecutorConfig } from './executor.js';
+export type WorkflowToolInput = {
+    name?: string;
+    script?: string;
+    args?: unknown;
+};
+export interface WorkflowToolDeps {
+    workspace: string;
+    bus: MessageBus;
+    /** Returns the parent agent's primary model — subagents default to this. */
+    getSubagentModel: () => Model<Api>;
+    getConfig: () => Config | undefined;
+    /** Same injection point delegate-tool uses; supplied by AgentToolsFactory. */
+    buildChildTools: (opts: BuildChildToolsOptions) => AgentTool<any, any>[];
+    toolExecutorConfig?: Partial<ToolExecutorConfig>;
+    /** Catalog for `name` lookups (built-in + ~/.xopc/workflows/). */
+    catalog: WorkflowCatalog;
+    /** Per-call sessionKey lookup — used to record "last successful workflow" for /workflow save. */
+    getCurrentSessionKey?: () => string | undefined;
+}
+export declare function createWorkflowTool(deps: WorkflowToolDeps): AgentTool;