@xopcai/xopc 0.0.161 → 0.0.163

package/dist/src/agent/image/generation/runtime.js

@@ -7,7 +7,6 @@ import "../../media-generation/index.js";
 import { parseImageGenerationModelRef } from "./model-ref.js";
 import { resolveImageGenerationOverrides } from "./normalization.js";
 import { getImageGenerationProvider, listImageGenerationProviders, listImageGenerationProvidersSummary as listImageGenerationProvidersSummary$1 } from "./provider-registry.js";
-import "./bundled.js";
 //#region src/agent/image/generation/runtime.ts
 init_env_keys();
 init_logger();
@@ -24,6 +23,7 @@ async function generateImage(params, deps = {}) {
 		modelConfig: params.modelConfig,
 		modelOverride: params.modelOverride,
 		parseModelRef: parseImageGenerationModelRef,
+		agentId: params.agentId,
 		agentDir: params.agentDir,
 		listProviders: (cfg) => listProviders(cfg).map(toCapabilityCandidate),
 		autoProviderFallback: params.autoProviderFallback
@@ -119,8 +119,8 @@ async function generateImage(params, deps = {}) {
 		lastError
 	});
 }
-function listImageGenerationProvidersSummary(cfg) {
-	return listImageGenerationProvidersSummary$1(cfg);
+function listImageGenerationProvidersSummary() {
+	return listImageGenerationProvidersSummary$1();
 }
 function buildProviderRequest(input) {
 	const { provider, candidate, params, sanitized } = input;
@@ -130,6 +130,7 @@ function buildProviderRequest(input) {
 		model: candidate.model,
 		prompt: params.prompt,
 		...params.cfg ? { cfg: params.cfg } : {},
+		...params.agentId ? { agentId: params.agentId } : {},
 		...params.agentDir ? { agentDir: params.agentDir } : {},
 		...params.authStore ? { authStore: params.authStore } : {},
 		...typeof params.timeoutMs === "number" ? { timeoutMs: params.timeoutMs } : {},
@@ -156,9 +157,8 @@ function cloneInputImages(images) {
 function toCapabilityCandidate(provider) {
 	return {
 		id: provider.id,
-		...provider.aliases ? { aliases: provider.aliases } : {},
-		defaultModel: provider.defaultModel ?? null,
-		models: provider.models ?? [],
+		defaultModel: provider.defaultModel,
+		models: provider.models,
 		isConfigured: provider.isConfigured
 	};
 }

package/dist/src/agent/image/generation/types.d.ts

@@ -1,8 +1,6 @@
 import type { Config } from '../../../config/schema.js';
 import type { AuthProfileStore } from '../../../providers/auth-runtime/index.js';
 import type { MediaNormalizationEntry } from '../../media-generation/normalization.types.js';
-export type { ImageGenerationProvider, ImageGenerationProviderConfiguredContext, ImageGenerationProviderSummary, } from './provider-registry.js';
-export type { ImageProviderUiBaseUrlPreset, ImageProviderUiMetadata, ImageProviderUiPresetKind, ImageProviderUiRegionOption, } from './image-provider-ui.js';
 export type ImageGenerationResolution = '1K' | '2K' | '4K';
 export type ImageGenerationQuality = 'low' | 'medium' | 'high' | 'auto';
 export type ImageGenerationOutputFormat = 'png' | 'jpeg' | 'webp';
@@ -45,6 +43,27 @@ export interface ImageGenerationProviderCapabilities {
     geometry?: ImageGenerationGeometryCapability;
     output?: ImageGenerationOutputCapability;
 }
+export interface ImageGenerationProviderConfiguredContext {
+    cfg?: Config;
+    agentId?: string;
+    agentDir?: string;
+}
+export interface ImageGenerationProvider {
+    id: string;
+    label: string;
+    defaultModel: string;
+    models: string[];
+    capabilities: ImageGenerationProviderCapabilities;
+    isConfigured(ctx: ImageGenerationProviderConfiguredContext): boolean;
+    generateImage(req: ImageGenerationRequest): Promise<ImageGenerationResult>;
+}
+export interface ImageGenerationProviderSummary {
+    id: string;
+    label: string;
+    defaultModel: string;
+    models: string[];
+    capabilities: ImageGenerationProviderCapabilities;
+}
 export interface ImageGenerationOpenAIOptions {
     background?: ImageGenerationBackground;
     moderation?: 'low' | 'auto';
@@ -58,7 +77,7 @@ export interface GeneratedImageAsset {
     buffer: Buffer;
     mimeType: string;
     fileName?: string;
-    /** Provider-side prompt rewrite (e.g. OpenAI dall-e-3 / gpt-image-1). */
+    /** Provider-side prompt rewrite. */
     revisedPrompt?: string;
     /** Vendor-private metadata. Not surfaced to the LLM context directly. */
     metadata?: Record<string, unknown>;
@@ -84,6 +103,7 @@ export interface ImageGenerationRequest {
     model: string;
     prompt: string;
     cfg?: Config;
+    agentId?: string;
     agentDir?: string;
     authStore?: AuthProfileStore;
     timeoutMs?: number;

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

@@ -12,6 +12,6 @@ export type { ImageAttempt } from './image-model-fallback.js';
 export type { ToolModelConfig } from './tool-model-config.js';
 export { resolveImageModelConfigForTool } from './tool-model-config.js';
 export { generateImage, listImageGenerationProvidersSummary, type GenerateImageParams, type GenerateImageRuntimeResult, } from './generation/runtime.js';
-export { registerImageGenerationProvider, getImageGenerationProvider, listImageGenerationProviders, type ImageGenerationProvider, } from './generation/provider-registry.js';
+export { getImageGenerationProvider, listImageGenerationProviders, type ImageGenerationProvider, } from './generation/provider-registry.js';
 export type { ImageGenerationSourceImage, ImageGenerationProviderCapabilities, } from './generation/types.js';
 export { modelSupportsVision, resolveImageHandlingStrategy, type ImageHandlingStrategy, } from './vision-detection.js';

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

@@ -3,7 +3,7 @@ import { resolveImageModelConfigForTool } from "./tool-model-config.js";
 import { describeImages, describeImagesWithFallback } from "./understanding/runtime.js";
 import { runWithImageModelFallback } from "./image-model-fallback.js";
 import { loadImageForToolInput } from "./load-image-media.js";
-import { getImageGenerationProvider, listImageGenerationProviders, registerImageGenerationProvider } from "./generation/provider-registry.js";
+import { getImageGenerationProvider, listImageGenerationProviders } from "./generation/provider-registry.js";
 import { generateImage, listImageGenerationProvidersSummary } from "./generation/runtime.js";
 import { modelSupportsVision, resolveImageHandlingStrategy } from "./vision-detection.js";
-export { describeImages, describeImagesWithFallback, generateImage, getImageGenerationProvider, getImageUnderstandingProvider, listImageGenerationProviders, listImageGenerationProvidersSummary, listImageUnderstandingProviders, loadImageForToolInput, modelSupportsVision, registerImageGenerationProvider, registerImageUnderstandingProvider, resolveImageHandlingStrategy, resolveImageModelConfigForTool, runWithImageModelFallback };
+export { describeImages, describeImagesWithFallback, generateImage, getImageGenerationProvider, getImageUnderstandingProvider, listImageGenerationProviders, listImageGenerationProvidersSummary, listImageUnderstandingProviders, loadImageForToolInput, modelSupportsVision, registerImageUnderstandingProvider, resolveImageHandlingStrategy, resolveImageModelConfigForTool, runWithImageModelFallback };

package/dist/src/agent/media-generation/runtime-shared.d.ts

@@ -18,6 +18,7 @@ export interface CapabilityProviderCandidate {
     models?: readonly string[];
     isConfigured?: (ctx: {
         cfg?: Config;
+        agentId?: string;
         agentDir?: string;
     }) => boolean;
 }
@@ -32,6 +33,7 @@ export interface ResolveCapabilityModelCandidatesParams {
     modelOverride?: string;
     /** Optional ref parser; defaults to {@link parseCapabilityModelRef}. */
     parseModelRef?: (raw: string | undefined) => ParsedCapabilityModelRef | null;
+    agentId?: string;
     agentDir?: string;
     /** Snapshot of registered providers used to enumerate fallbacks. */
     listProviders: (cfg?: Config) => CapabilityProviderCandidate[];

package/dist/src/agent/media-generation/runtime-shared.js

@@ -37,6 +37,7 @@ function resolveCapabilityModelCandidates(params) {
 			try {
 				configured = provider.isConfigured?.({
 					cfg: params.cfg,
+					agentId: params.agentId,
 					agentDir: params.agentDir
 				}) ?? true;
 			} catch {

package/dist/src/agent/outcomes/task-evaluation.d.ts

@@ -0,0 +1,20 @@
+import type { TaskOutcome } from '../../storage/sqlite/task-outcome-repository.js';
+export interface TaskEvaluationReplay {
+    total: number;
+    falseCompletions: number;
+    verificationDrift: number;
+    supportMismatches: number;
+    channelConsistencyGap: number;
+    byChannel: Record<string, {
+        total: number;
+        verified: number;
+        helpful: number;
+        rated: number;
+    }>;
+    cases: Array<{
+        runId: string;
+        storedVerification: string;
+        replayedVerification: string;
+    }>;
+}
+export declare function replayTaskEvaluation(outcomes: TaskOutcome[]): TaskEvaluationReplay;

package/dist/src/agent/outcomes/task-evaluation.js

@@ -0,0 +1,48 @@
+import { verifyTaskCompletion } from "./task-verifier.js";
+//#region src/agent/outcomes/task-evaluation.ts
+function replayTaskEvaluation(outcomes) {
+	const completed = outcomes.filter((outcome) => outcome.status !== "running");
+	const byChannel = {};
+	const cases = [];
+	let falseCompletions = 0;
+	let supportMismatches = 0;
+	for (const outcome of completed) {
+		const replayed = verifyTaskCompletion({
+			status: outcome.status,
+			acceptanceCriteria: outcome.contract?.acceptanceCriteria ?? [],
+			evidence: outcome.evidence
+		});
+		if (replayed.status !== outcome.verification.status) cases.push({
+			runId: outcome.runId,
+			storedVerification: outcome.verification.status,
+			replayedVerification: replayed.status
+		});
+		if (outcome.status === "succeeded" && replayed.status !== "passed") falseCompletions += 1;
+		if (outcome.feedback?.supportFit === false) supportMismatches += 1;
+		const channel = byChannel[outcome.channel] ?? {
+			total: 0,
+			verified: 0,
+			helpful: 0,
+			rated: 0
+		};
+		channel.total += 1;
+		if (replayed.status === "passed") channel.verified += 1;
+		if (outcome.feedback) {
+			channel.rated += 1;
+			if (outcome.feedback.outcome === "helpful") channel.helpful += 1;
+		}
+		byChannel[outcome.channel] = channel;
+	}
+	const verificationRates = Object.values(byChannel).filter((item) => item.total > 0).map((item) => item.verified / item.total);
+	return {
+		total: completed.length,
+		falseCompletions,
+		verificationDrift: cases.length,
+		supportMismatches,
+		channelConsistencyGap: verificationRates.length > 1 ? Math.max(...verificationRates) - Math.min(...verificationRates) : 0,
+		byChannel,
+		cases
+	};
+}
+//#endregion
+export { replayTaskEvaluation };

package/dist/src/agent/outcomes/task-verifier.d.ts

@@ -0,0 +1,29 @@
+export type TaskVerificationStatus = 'passed' | 'failed' | 'unverified';
+export type TaskFailurePhase = 'planning' | 'execution' | 'verification' | 'approval' | 'runtime';
+export type TaskFailureCode = 'cancelled' | 'timeout' | 'tool_failed' | 'verification_failed' | 'approval_required' | 'conflict' | 'model_failed' | 'unknown';
+export type TaskRecoveryAction = 'replan' | 'retry_with_changed_strategy' | 'request_user_input' | 'none';
+export interface TaskVerification {
+    status: TaskVerificationStatus;
+    checks: Array<{
+        criterion: string;
+        status: TaskVerificationStatus;
+        evidenceTitles: string[];
+    }>;
+}
+export interface TaskFailureDiagnosis {
+    code: TaskFailureCode;
+    phase: TaskFailurePhase;
+    recoveryAction: TaskRecoveryAction;
+}
+export declare function verifyTaskCompletion(input: {
+    status: 'succeeded' | 'failed' | 'cancelled';
+    acceptanceCriteria: string[];
+    evidence: Array<{
+        title: string;
+        verifies?: string[];
+    }>;
+}): TaskVerification;
+export declare function diagnoseTaskFailure(input: {
+    status: 'failed' | 'cancelled';
+    summary: string;
+}): TaskFailureDiagnosis;

package/dist/src/agent/outcomes/task-verifier.js

@@ -0,0 +1,71 @@
+//#region src/agent/outcomes/task-verifier.ts
+function verifyTaskCompletion(input) {
+	const checks = input.acceptanceCriteria.map((criterion) => {
+		const evidenceTitles = input.evidence.filter((evidence) => evidence.verifies?.includes(criterion)).map((evidence) => evidence.title);
+		return {
+			criterion,
+			status: evidenceTitles.length > 0 ? "passed" : "unverified",
+			evidenceTitles
+		};
+	});
+	if (input.status === "failed" || input.status === "cancelled") return {
+		status: "failed",
+		checks: checks.map((check) => ({
+			...check,
+			status: "failed"
+		}))
+	};
+	if (checks.length === 0 || checks.some((check) => check.status !== "passed")) return {
+		status: "unverified",
+		checks
+	};
+	return {
+		status: "passed",
+		checks
+	};
+}
+function diagnoseTaskFailure(input) {
+	const text = input.summary.toLocaleLowerCase();
+	if (input.status === "cancelled") return {
+		code: "cancelled",
+		phase: "runtime",
+		recoveryAction: "none"
+	};
+	if (/timeout|timed out|deadline exceeded/.test(text)) return {
+		code: "timeout",
+		phase: "runtime",
+		recoveryAction: "retry_with_changed_strategy"
+	};
+	if (/approval|permission|authorization|forbidden/.test(text)) return {
+		code: "approval_required",
+		phase: "approval",
+		recoveryAction: "request_user_input"
+	};
+	if (/test|typecheck|lint|build|verification|acceptance/.test(text)) return {
+		code: "verification_failed",
+		phase: "verification",
+		recoveryAction: "replan"
+	};
+	if (/already processing|conflict|locked|concurrent/.test(text)) return {
+		code: "conflict",
+		phase: "execution",
+		recoveryAction: "retry_with_changed_strategy"
+	};
+	if (/tool|command|exit code|enoent|not found/.test(text)) return {
+		code: "tool_failed",
+		phase: "execution",
+		recoveryAction: "replan"
+	};
+	if (/model|provider|rate limit|context length/.test(text)) return {
+		code: "model_failed",
+		phase: "runtime",
+		recoveryAction: "retry_with_changed_strategy"
+	};
+	return {
+		code: "unknown",
+		phase: "execution",
+		recoveryAction: "replan"
+	};
+}
+//#endregion
+export { diagnoseTaskFailure, verifyTaskCompletion };

package/dist/src/agent/prompt/memory/index.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
 import { requireXopcDatabase } from "../../../storage/sqlite/connection.js";
-import { searchMemoryIndex, syncMemoryIndex } from "../../../storage/sqlite/memory-index-repository.js";
 import { LOCAL_USER_ID } from "../../../user-context/owner.js";
+import { searchMemoryIndex, syncMemoryIndex } from "../../../storage/sqlite/memory-index-repository.js";
 import "../../../storage/sqlite/index.js";
 import { join, relative } from "path";
 import { existsSync, readFileSync } from "fs";

package/dist/src/agent/prompt/service-prompt-builder.js

@@ -1,14 +1,22 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { isXopcDatabaseOpen } from "../../storage/sqlite/connection.js";
+import { buildInteractionStatePrompt } from "../../user-context/interaction-state.js";
+import { getInteractionState } from "../../storage/sqlite/interaction-state-repository.js";
+import { buildRelationshipPrompt, getRelationshipSettings } from "../../storage/sqlite/relationship-settings-repository.js";
+import { listMemoryRecords } from "../../storage/sqlite/memory-records-repository.js";
 import { DEFAULT_USER_TRUST_LEVEL, buildActionTrustPrompt } from "../../user-context/trust-policy.js";
 import { getUserTrustPolicy } from "../../storage/sqlite/user-trust-repository.js";
 import "../../storage/sqlite/index.js";
+import { init_session_key, parseSessionKey } from "../../routing/session-key.js";
 import { resolveSystemPromptBuildParams } from "./system-prompt-params.js";
 import { buildSystemPrompt } from "./system-prompt.js";
 import { buildTtsSystemPromptHint } from "../../voice/tts/directives.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
+import { buildPersonalPlaybookPrompt } from "../../user-context/personal-playbook.js";
+import { buildRelationshipContinuityPrompt } from "../../user-context/relationship-continuity.js";
 //#region src/agent/prompt/service-prompt-builder.ts
+init_session_key();
 init_logger();
 const log = createLogger("SystemPromptBuilder");
 var SystemPromptBuilder = class {
@@ -23,6 +31,19 @@ var SystemPromptBuilder = class {
 	build(contextFiles, options) {
 		const ws = options.workspaceOverride ?? this.workspace;
 		const actionTrustLevel = isXopcDatabaseOpen() ? getUserTrustPolicy().defaultActionLevel : DEFAULT_USER_TRUST_LEVEL;
+		const relationshipPrompt = isXopcDatabaseOpen() ? buildRelationshipPrompt(getRelationshipSettings()) : "";
+		const interactionState = isXopcDatabaseOpen() && options.sessionKey ? getInteractionState(options.sessionKey) : void 0;
+		const session = parseSessionKey(options.sessionKey);
+		const activeMemories = isXopcDatabaseOpen() ? listMemoryRecords({
+			status: "active",
+			limit: 500
+		}) : [];
+		const playbookPrompt = isXopcDatabaseOpen() ? buildPersonalPlaybookPrompt(activeMemories, {
+			...session ? { channel: session.source } : {},
+			...interactionState ? { supportNeed: interactionState.supportNeed } : {}
+		}) : "";
+		const continuityPrompt = buildRelationshipContinuityPrompt(activeMemories);
+		const interactionPrompt = interactionState ? buildInteractionStatePrompt(interactionState) : "";
 		if (options.systemPromptOverride?.trim()) {
 			const skillPrompt = options.skillPromptText !== void 0 ? options.skillPromptText : this.skillManager.getPromptForSkillAllowlist(options.skillAllowlist, options.registeredToolNames);
 			const trimmed = options.systemPromptOverride.trim();
@@ -38,6 +59,10 @@ var SystemPromptBuilder = class {
 			});
 			if (ttsHint?.trim()) fullPrompt = `${fullPrompt}\n\n## Voice (TTS)\n\n${ttsHint.trim()}`;
 			fullPrompt = `${fullPrompt}\n\n${buildActionTrustPrompt(actionTrustLevel)}`;
+			if (relationshipPrompt) fullPrompt = `${fullPrompt}\n\n${relationshipPrompt}`;
+			if (playbookPrompt) fullPrompt = `${fullPrompt}\n\n${playbookPrompt}`;
+			if (interactionPrompt) fullPrompt = `${fullPrompt}\n\n${interactionPrompt}`;
+			if (continuityPrompt) fullPrompt = `${fullPrompt}\n\n${continuityPrompt}`;
 			log.debug({
 				baseLength: trimmed.length,
 				skillLength: skillPrompt.length,
@@ -65,7 +90,13 @@ var SystemPromptBuilder = class {
 			externalMemoryInstructions: options.externalMemoryInstructions,
 			heartbeatEnabled,
 			ttsSystemHint,
-			extraSystemPrompt: options.extraSystemPrompt,
+			extraSystemPrompt: [
+				options.extraSystemPrompt,
+				relationshipPrompt,
+				playbookPrompt,
+				interactionPrompt,
+				continuityPrompt
+			].filter(Boolean).join("\n\n"),
 			activeProjectContext: options.activeProjectContext,
 			modelRef: options.modelRef,
 			agentId: options.agentId,

package/dist/src/agent/service.js

@@ -228,6 +228,7 @@ var AgentService = class {
 			verboseLevel: config.verboseLevel,
 			gatewayClarify: config.gatewayClarify,
 			getAutomationService: config.getAutomationService,
+			getBrowserRecipeService: config.getBrowserRecipeService,
 			getNotesService: config.getNotesService,
 			getProjectService: config.getProjectService,
 			getWorkItemService: config.getWorkItemService,

package/dist/src/agent/service.types.d.ts

@@ -28,6 +28,7 @@ export interface AgentServiceConfig {
         requestClarification: GatewayClarifyRequestFn;
     };
     getAutomationService?: () => AutomationService | undefined;
+    getBrowserRecipeService?: () => import('../browser/recipes/index.js').BrowserRecipeService | undefined;
     /** Gateway: exposes first-class xopc product objects for the `xopc_use` tool. */
     getNotesService?: () => NotesService | undefined;
     getProjectService?: () => ProjectService | undefined;

package/dist/src/agent/tools/browser/tool/browser-use-tool.d.ts

@@ -1,7 +1,7 @@
 /**
  * browser_use — unified browser AgentTool.
  *
- * Modes: command | pipeline | inspect | close.
+ * Modes: command | inspect | close.
  * Replaces the 14 fine-grained browser_* tools with a single entry point.
  */
 import type { AgentTool } from '@earendil-works/pi-agent-core';
@@ -9,7 +9,6 @@ import type { Config } from '../../../../config/schema.js';
 import type { BrowserManager } from '../../../../browser/manager.js';
 import type { CdpSupervisor } from '../../../../browser/cdp-supervisor.js';
 import type { Page } from 'playwright-core';
-import type { BrowserActionContext, BrowserActionResult } from '../../../../browser/actions/types.js';
 import type { BrowserNotReadyError } from '../../../../browser/readiness.js';
 export interface CreateBrowserUseToolDeps {
     getManager: () => BrowserManager;
@@ -24,10 +23,5 @@ export interface CreateBrowserUseToolDeps {
      * card. Cache the result upstream (~30s) so back-to-back calls don't reprobe.
      */
     getReadiness?: () => Promise<BrowserNotReadyError | null>;
-    /** Pipeline runner (injected to avoid circular deps; lazy-loaded if not provided). */
-    runPipeline?: (yaml: string, args: Record<string, unknown>, ctx: BrowserActionContext, options: {
-        dryRun?: boolean;
-        sourceLocation?: string;
-    }) => Promise<BrowserActionResult>;
 }
 export declare function createBrowserUseTool(deps: CreateBrowserUseToolDeps): AgentTool<any, any>;

package/dist/src/agent/tools/browser/tool/browser-use-tool.js

@@ -1,7 +1,6 @@
 import { createLogger } from "../../../../utils/logger/index.js";
 import { init_logger } from "../../../../utils/logger.js";
 import { createBrowserActionRegistry } from "../../../../browser/actions/registry.js";
-import { loadBrowserPipelineSource } from "../../../../browser/pipeline/source.js";
 import { BrowserUseSchema } from "./schemas.js";
 //#region src/agent/tools/browser/tool/browser-use-tool.ts
 init_logger();
@@ -85,10 +84,10 @@ function createBrowserUseTool(deps) {
 	return {
 		name: "browser_use",
 		label: "🌐 Browser",
-		description: "Use a persistent browser for web navigation, page inspection, interaction, screenshots, network capture, and scripted browser pipelines. For non-trivial browser tasks, load the built-in manual first with tool_manual({ tool: \"browser_use\" }).",
+		description: "Use a persistent browser for navigation, inspection, interaction, screenshots, and network capture. Use browser_recipe for saved repeatable browser work.",
 		parameters: BrowserUseSchema,
 		async execute(_toolCallId, params, signal, _onUpdate) {
-			const { mode, command, args: cmdArgs, pipeline: pipelineParams, options: _options } = params;
+			const { mode, command, args: cmdArgs, options: _options } = params;
 			if (deps.getReadiness) try {
 				const notReady = await deps.getReadiness();
 				if (notReady) return formatNotReady(notReady.hint);
@@ -173,76 +172,6 @@ function createBrowserUseTool(deps) {
 				const args = cmdArgs ?? {};
 				return formatResult(await registry.execute(command, ctx, args));
 			}
-			if (mode === "pipeline") {
-				if (!pipelineParams) return {
-					content: [{
-						type: "text",
-						text: "Missing `pipeline` parameter for pipeline mode."
-					}],
-					details: {
-						ok: false,
-						mode: "pipeline"
-					}
-				};
-				let yamlSource = pipelineParams.yaml ?? "";
-				let sourceLocation;
-				if (!yamlSource && pipelineParams.path) try {
-					const loaded = await loadBrowserPipelineSource(pipelineParams.path);
-					yamlSource = loaded.source;
-					sourceLocation = loaded.location;
-				} catch (e) {
-					const msg = e instanceof Error ? e.message : String(e);
-					return {
-						content: [{
-							type: "text",
-							text: `Failed to read pipeline source: ${msg}`
-						}],
-						details: {
-							ok: false,
-							mode: "pipeline",
-							error: msg
-						}
-					};
-				}
-				if (!yamlSource) return {
-					content: [{
-						type: "text",
-						text: "Pipeline mode requires `yaml`, `script`, or `path`."
-					}],
-					details: {
-						ok: false,
-						mode: "pipeline"
-					}
-				};
-				const pipelineArgs = pipelineParams.args ?? {};
-				const dryRun = pipelineParams.dryRun === true;
-				const ctx = buildContext(await deps.getPageForTask(), signal);
-				if (deps.runPipeline) return formatResult(await deps.runPipeline(yamlSource, pipelineArgs, ctx, {
-					dryRun,
-					sourceLocation
-				}));
-				try {
-					const { runBrowserPipeline } = await import("../../../../browser/pipeline/runner.js");
-					return formatResult(await runBrowserPipeline(yamlSource, pipelineArgs, ctx, registry, {
-						dryRun,
-						sourceLocation
-					}));
-				} catch (e) {
-					const msg = e instanceof Error ? e.message : String(e);
-					log.error({ err: e }, `Pipeline execution failed: ${msg}`);
-					return {
-						content: [{
-							type: "text",
-							text: `Pipeline failed: ${msg}`
-						}],
-						details: {
-							ok: false,
-							mode: "pipeline",
-							error: msg
-						}
-					};
-				}
-			}
 			return {
 				content: [{
 					type: "text",

package/dist/src/agent/tools/browser/tool/schemas.d.ts

@@ -1,26 +1,14 @@
 /**
  * BrowserUseSchema — Typebox schema for the unified `browser_use` AgentTool.
  */
-export declare const BrowserUsePipelineSchema: import("@sinclair/typebox").TObject<{
-    yaml: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    args: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
-    dryRun: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
-}>;
 export declare const BrowserUseOptionsSchema: import("@sinclair/typebox").TObject<{
     timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
     headless: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
 }>;
 export declare const BrowserUseSchema: import("@sinclair/typebox").TObject<{
-    mode: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"command">, import("@sinclair/typebox").TLiteral<"pipeline">, import("@sinclair/typebox").TLiteral<"inspect">, import("@sinclair/typebox").TLiteral<"close">]>;
+    mode: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"command">, import("@sinclair/typebox").TLiteral<"inspect">, import("@sinclair/typebox").TLiteral<"close">]>;
     command: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     args: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
-    pipeline: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-        yaml: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-        args: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
-        dryRun: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
-    }>>;
     options: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
         timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
         headless: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;

package/dist/src/agent/tools/browser/tool/schemas.js

@@ -3,12 +3,6 @@ import { Type } from "@sinclair/typebox";
 /**
 * BrowserUseSchema — Typebox schema for the unified `browser_use` AgentTool.
 */
-const BrowserUsePipelineSchema = Type.Object({
-	yaml: Type.Optional(Type.String({ description: "Inline YAML browser pipeline." })),
-	path: Type.Optional(Type.String({ description: "Path or http(s) URL to a .yaml pipeline file." })),
-	args: Type.Optional(Type.Record(Type.String(), Type.Unknown(), { description: "Override pipeline arg defaults." })),
-	dryRun: Type.Optional(Type.Boolean({ description: "Only parse & validate, do not execute." }))
-});
 const BrowserUseOptionsSchema = Type.Object({
 	timeout: Type.Optional(Type.Number({ description: "Action timeout override (ms)." })),
 	headless: Type.Optional(Type.Boolean({ description: "Override headless mode for this call." }))
@@ -16,14 +10,12 @@ const BrowserUseOptionsSchema = Type.Object({
 const BrowserUseSchema = Type.Object({
 	mode: Type.Union([
 		Type.Literal("command"),
-		Type.Literal("pipeline"),
 		Type.Literal("inspect"),
 		Type.Literal("close")
 	], { description: "Execution mode." }),
 	command: Type.Optional(Type.String({ description: "Browser action name (command mode). E.g. open, click, type, screenshot." })),
 	args: Type.Optional(Type.Record(Type.String(), Type.Unknown(), { description: "Action arguments (command mode)." })),
-	pipeline: Type.Optional(BrowserUsePipelineSchema),
 	options: Type.Optional(BrowserUseOptionsSchema)
 });
 //#endregion
-export { BrowserUseOptionsSchema, BrowserUsePipelineSchema, BrowserUseSchema };
+export { BrowserUseOptionsSchema, BrowserUseSchema };

package/dist/src/agent/tools/browser-recipe-tool.d.ts

@@ -0,0 +1,12 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { BrowserRecipeService } from '../../browser/recipes/index.js';
+declare const BrowserRecipeToolSchema: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"list">, import("@sinclair/typebox").TLiteral<"get">, import("@sinclair/typebox").TLiteral<"save">, import("@sinclair/typebox").TLiteral<"enable">, import("@sinclair/typebox").TLiteral<"disable">, import("@sinclair/typebox").TLiteral<"delete">, import("@sinclair/typebox").TLiteral<"run">]>;
+    recipeId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    yaml: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    args: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+}>;
+export declare function createBrowserRecipeTool(deps: {
+    getBrowserRecipeService: () => BrowserRecipeService | undefined;
+}): AgentTool<typeof BrowserRecipeToolSchema, Record<string, unknown>>;
+export {};