@od-oneapp/ai-platform 0.1.0

package/dist/evaluator-optimizer-pattern-D1AJrzBD.d.mts

@@ -0,0 +1,72 @@
+//#region src/agents/patterns/evaluator-optimizer-pattern.d.ts
+interface PatternEvaluationResult {
+  score: number;
+  dimensions: {
+    name: string;
+    score: number;
+    feedback: string;
+  }[];
+  suggestions: string[];
+  shouldRetry: boolean;
+  assessment?: string;
+  strengths?: string[];
+  issues?: string[];
+}
+interface EvalContext {
+  request: string;
+  threshold?: number;
+  maxScore?: number;
+  focusAreas?: string[];
+  iterationNumber?: number;
+}
+interface EvaluatorOptimizerOptions {
+  evaluator: (output: string, context: EvalContext) => Promise<PatternEvaluationResult>;
+  optimizer: (output: string, evaluation: PatternEvaluationResult) => Promise<string>;
+  maxIterations?: number;
+  targetScore?: number;
+  enableLogging?: boolean;
+  stopOnThreshold?: boolean;
+  diminishingReturnThreshold?: number;
+}
+interface PatternOptimizedResult {
+  finalContent: string;
+  finalEvaluation: PatternEvaluationResult;
+  cyclesCompleted: number;
+  meetsThreshold: boolean;
+  scoreHistory: number[];
+  contentHistory: string[];
+  terminationReason: 'threshold_met' | 'max_iterations' | 'diminishing_returns' | 'error';
+  error?: string;
+  metadata?: {
+    startTime: string;
+    endTime: string;
+    processingTimeMs: number;
+    averageScoreImprovement: number;
+  };
+}
+declare class PatternEvaluatorOptimizer {
+  private options;
+  private logger;
+  constructor(options: EvaluatorOptimizerOptions);
+  run(initialContent: string, context: EvalContext): Promise<PatternOptimizedResult>;
+  private evaluateContent;
+  private optimizeContent;
+  private buildResult;
+}
+declare function createPatternEvaluatorOptimizer(options: EvaluatorOptimizerOptions): PatternEvaluatorOptimizer;
+declare const createEvaluatorOptimizer: typeof createPatternEvaluatorOptimizer;
+declare const evaluators: {
+  factuality: (threshold?: number) => (output: string, context: EvalContext) => Promise<PatternEvaluationResult>;
+  relevance: (threshold?: number) => (output: string, context: EvalContext) => Promise<PatternEvaluationResult>;
+  safety: (threshold?: number) => (output: string, context: EvalContext) => Promise<PatternEvaluationResult>;
+  quality: (threshold?: number) => (output: string, context: EvalContext) => Promise<PatternEvaluationResult>;
+};
+declare function runPatternFeedbackLoop(initialContent: string, context: EvalContext, options: EvaluatorOptimizerOptions): Promise<PatternOptimizedResult>;
+declare function normalizeScore(score: number, fromMax?: number, toMax?: number): number;
+declare function calculateAggregateScore(dimensions: PatternEvaluationResult['dimensions'], weights?: Record<string, number>): number;
+type EvaluationResult = PatternEvaluationResult;
+type OptimizedResult = PatternOptimizedResult;
+declare const runFeedbackLoop: typeof runPatternFeedbackLoop;
+//#endregion
+export { PatternEvaluationResult as a, calculateAggregateScore as c, evaluators as d, normalizeScore as f, OptimizedResult as i, createEvaluatorOptimizer as l, runPatternFeedbackLoop as m, EvaluationResult as n, PatternEvaluatorOptimizer as o, runFeedbackLoop as p, EvaluatorOptimizerOptions as r, PatternOptimizedResult as s, EvalContext as t, createPatternEvaluatorOptimizer as u };
+//# sourceMappingURL=evaluator-optimizer-pattern-D1AJrzBD.d.mts.map

package/dist/evaluator-optimizer-pattern-D1AJrzBD.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-optimizer-pattern-D1AJrzBD.d.mts","names":[],"sources":["../src/agents/patterns/evaluator-optimizer-pattern.ts"],"mappings":";UA0BiB,uBAAA;EAIf,KAAA;EAKA,UAAA;IACE,IAAA;IACA,KAAA;IACA,QAAA;EAAA;EAMF,WAAA;EAKA,WAAA;EAKA,UAAA;EAKA,SAAA;EAKA,MAAA;AAAA;AAAA,UAMe,WAAA;EACf,OAAA;EACA,SAAA;EACA,QAAA;EACA,UAAA;EACA,eAAA;AAAA;AAAA,UAMe,yBAAA;EAKf,SAAA,GAAY,MAAA,UAAgB,OAAA,EAAS,WAAA,KAAgB,OAAA,CAAQ,uBAAA;EAK7D,SAAA,GAAY,MAAA,UAAgB,UAAA,EAAY,uBAAA,KAA4B,OAAA;EAKpE,aAAA;EAKA,WAAA;EAKA,aAAA;EAKA,eAAA;EAKA,0BAAA;AAAA;AAAA,UAMe,sBAAA;EACf,YAAA;EACA,eAAA,EAAiB,uBAAA;EACjB,eAAA;EACA,cAAA;EACA,YAAA;EACA,cAAA;EACA,iBAAA;EACA,KAAA;EACA,QAAA;IACE,SAAA;IACA,OAAA;IACA,gBAAA;IACA,uBAAA;EAAA;AAAA;AAAA,cAQS,yBAAA;EAAA,QACH,OAAA;EAAA,QACA,MAAA;cAEI,OAAA,EAAS,yBAAA;EAqBf,GAAA,CAAI,cAAA,UAAwB,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,sBAAA;EAAA,QA6InD,eAAA;EAAA,QAyBA,eAAA;EAAA,QAUN,WAAA;AAAA;AAAA,iBA0EM,+BAAA,CACd,OAAA,EAAS,yBAAA,GACR,yBAAA;AAAA,cAOU,wBAAA,SAAwB,+BAAA;AAAA,cASxB,UAAA;uCAMK,MAAA,UAAgB,OAAA,EAAS,WAAA,KAAc,OAAA,CAAQ,uBAAA;sCA2B/C,MAAA,UAAgB,OAAA,EAAS,WAAA,KAAc,OAAA,CAAQ,uBAAA;mCA+B/C,MAAA,UAAgB,OAAA,EAAS,WAAA,KAAc,OAAA,CAAQ,uBAAA;oCA+B/C,MAAA,UAAgB,OAAA,EAAS,WAAA,KAAc,OAAA,CAAQ,uBAAA;AAAA;AAAA,iBAkE3C,sBAAA,CACpB,cAAA,UACA,OAAA,EAAS,WAAA,EACT,OAAA,EAAS,yBAAA,GACR,OAAA,CAAQ,sBAAA;AAAA,iBASK,cAAA,CAAe,KAAA,UAAe,OAAA,WAAsB,KAAA;AAAA,iBAQpD,uBAAA,CACd,UAAA,EAAY,uBAAA,gBACZ,OAAA,GAAU,MAAA;AAAA,KAsBA,gBAAA,GAAmB,uBAAA;AAAA,KAKnB,eAAA,GAAkB,sBAAA;AAAA,cAKjB,eAAA,SAAe,sBAAA"}

package/dist/factory-DP6VSl8C.mjs

@@ -0,0 +1,307 @@
+import { et as generateText } from "./ai-runtime-CDzQztTt.mjs";
+import { z } from "zod";
+
+//#region src/agents/base/types.ts
+/**
+* @fileoverview Base agent types and interfaces.
+* @module @od-oneapp/ai-platform/agents/base
+*
+* Types are aligned with AI SDK v6 where applicable.
+* Uses LanguageModel and Tool types directly from the SDK.
+*/
+/**
+* Agent configuration schema.
+*/
+const AgentConfigSchema = z.object({
+	id: z.string(),
+	name: z.string(),
+	description: z.string(),
+	systemPrompt: z.string(),
+	maxIterations: z.number().default(10),
+	maxTokens: z.number().optional(),
+	temperature: z.number().min(0).max(2).optional()
+});
+/**
+* Default stop conditions.
+*/
+const StopConditions = {
+	maxIterations: (max) => (state) => state.iteration >= max,
+	noToolCalls: () => (state) => {
+		if (state.iteration === 0) return false;
+		const previousToolCallCount = state.metadata.lastToolCallCount ?? 0;
+		return state.toolCalls.length === previousToolCallCount;
+	},
+	onToolCall: (toolName) => (state) => {
+		return state.toolCalls.some((call) => call.name === toolName);
+	},
+	onError: () => (state) => Boolean(state.error),
+	any: (...conditions) => (state) => {
+		return conditions.some((cond) => cond(state));
+	},
+	all: (...conditions) => (state) => {
+		return conditions.every((cond) => cond(state));
+	}
+};
+
+//#endregion
+//#region src/agents/base/factory.ts
+/**
+* @fileoverview Core agent factory and agentic loop runner.
+* @module @od-oneapp/ai-platform/agents/base
+*/
+function isTextPart(part) {
+	return part.type === "text";
+}
+function isFilePart(part) {
+	return part.type === "file";
+}
+function partsToText(parts) {
+	return parts.filter(isTextPart).map((part) => part.text).join("\n");
+}
+function isToolContent(parts) {
+	return parts.every((part) => part.type === "tool-result" || part.type === "tool-approval-response");
+}
+function isAssistantPart(part) {
+	return part.type === "text" || part.type === "tool-call";
+}
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isToolResultOutput(value) {
+	if (!isRecord(value)) return false;
+	return typeof value.type === "string";
+}
+/**
+* Creates initial agent state.
+*/
+function createInitialState(messages = []) {
+	return {
+		iteration: 0,
+		messages: [...messages],
+		toolCalls: [],
+		isComplete: false,
+		metadata: {}
+	};
+}
+/**
+* Executes a single agent step (shared logic for execute and stream).
+* Handles model call, message updates, and tool call processing.
+*
+* @remarks This function mutates `state` directly for performance.
+* It sets `state.metadata.lastToolCallCount` before each iteration
+* to enable the `StopConditions.noToolCalls()` stop condition.
+*
+* @internal
+*/
+async function executeAgentStep(state, config, options) {
+	state.metadata.lastToolCallCount = state.toolCalls.length;
+	state.iteration++;
+	try {
+		const result = await generateText({
+			model: options.model,
+			system: config.systemPrompt,
+			messages: state.messages.map((message) => {
+				if (message.role === "tool") {
+					const toolCallId = message.toolCallId ?? "unknown";
+					if (Array.isArray(message.content)) {
+						if (isToolContent(message.content)) return {
+							role: "tool",
+							content: message.content
+						};
+						return {
+							role: "tool",
+							content: [{
+								type: "tool-result",
+								toolCallId,
+								toolName: "unknown",
+								output: {
+									type: "text",
+									value: partsToText(message.content)
+								}
+							}]
+						};
+					}
+					return {
+						role: "tool",
+						content: [{
+							type: "tool-result",
+							toolCallId,
+							toolName: "unknown",
+							output: {
+								type: "text",
+								value: message.content
+							}
+						}]
+					};
+				}
+				if (message.role === "system") return {
+					role: "system",
+					content: typeof message.content === "string" ? message.content : partsToText(message.content)
+				};
+				if (message.role === "user") {
+					if (typeof message.content === "string") return {
+						role: "user",
+						content: message.content
+					};
+					const userParts = message.content.filter((part) => isTextPart(part) || isFilePart(part));
+					if (userParts.length === message.content.length) return {
+						role: "user",
+						content: userParts
+					};
+					return {
+						role: "user",
+						content: partsToText(message.content)
+					};
+				}
+				if (typeof message.content === "string") return {
+					role: "assistant",
+					content: message.content
+				};
+				const assistantParts = message.content.filter(isAssistantPart);
+				return {
+					role: "assistant",
+					content: assistantParts.length > 0 ? assistantParts : ""
+				};
+			}),
+			tools: options.tools,
+			temperature: config.temperature,
+			abortSignal: options.context?.abortSignal
+		});
+		state.messages.push({
+			role: "assistant",
+			content: result.text
+		});
+		if (result.toolCalls && result.toolCalls.length > 0) for (const toolCall of result.toolCalls) {
+			const toolResult = result.toolResults?.find((r) => r.toolCallId === toolCall.toolCallId);
+			const toolInput = isRecord(toolCall.input) ? toolCall.input : {};
+			const toolOutput = isToolResultOutput(toolResult?.output) ? toolResult?.output : void 0;
+			const record = {
+				id: toolCall.toolCallId,
+				name: toolCall.toolName,
+				input: toolInput,
+				result: toolOutput,
+				timestamp: Date.now()
+			};
+			state.toolCalls.push(record);
+			if (toolOutput !== void 0) state.messages.push({
+				role: "tool",
+				content: [{
+					type: "tool-result",
+					toolCallId: toolCall.toolCallId,
+					toolName: toolCall.toolName,
+					output: toolOutput
+				}],
+				toolCallId: toolCall.toolCallId
+			});
+			if (options.onToolCall) await options.onToolCall(record);
+		}
+		else {
+			state.isComplete = true;
+			state.result = result.text;
+		}
+	} catch (error) {
+		state.error = error instanceof Error ? error : new Error(String(error));
+		state.isComplete = true;
+	}
+	return state;
+}
+/**
+* Creates a basic agent with agentic loop execution.
+*
+* @param config - Agent configuration
+* @param stopCondition - Optional custom stop condition
+* @returns Agent instance
+*
+* @example
+* ```ts
+* const agent = createAgent({
+*   id: 'research-agent',
+*   name: 'Research Agent',
+*   description: 'Researches topics using web search',
+*   systemPrompt: 'You are a research assistant...',
+*   maxIterations: 5,
+* });
+*
+* const result = await agent.execute('Research AI trends', {
+*   model: openai('gpt-4o'),
+*   tools: { webSearch, summarize },
+* });
+* ```
+*/
+function createAgent(config, stopCondition) {
+	const defaultStopCondition = StopConditions.any(StopConditions.maxIterations(config.maxIterations), StopConditions.onError());
+	const stop = stopCondition ?? defaultStopCondition;
+	return {
+		config,
+		async execute(prompt, options) {
+			const state = createInitialState(options.messages);
+			state.messages.push({
+				role: "user",
+				content: prompt
+			});
+			while (!state.isComplete && !stop(state)) {
+				await executeAgentStep(state, config, options);
+				if (options.onStep) await options.onStep(state);
+			}
+			if (!state.isComplete) {
+				state.isComplete = true;
+				state.result = state.messages[state.messages.length - 1]?.content ?? "";
+			}
+			if (options.onComplete) await options.onComplete(state);
+			return state;
+		},
+		async *stream(prompt, options) {
+			const state = createInitialState(options.messages);
+			state.messages.push({
+				role: "user",
+				content: prompt
+			});
+			while (!state.isComplete && !stop(state)) {
+				await executeAgentStep(state, config, options);
+				yield state;
+			}
+			if (!state.isComplete) {
+				state.isComplete = true;
+				state.result = state.messages[state.messages.length - 1]?.content;
+				yield state;
+			}
+		}
+	};
+}
+/**
+* Runs an agentic loop with custom step function.
+*
+* @param options - Loop options
+* @returns Final state
+*
+* @remarks The `step` function MUST increment `state.iteration` to ensure
+* the `maxIterations` safety bound is respected. Failure to do so may result
+* in an infinite loop if `shouldStop` never returns true.
+*
+* @example
+* ```ts
+* const result = await runAgentLoop({
+*   maxIterations: 5,
+*   initialState: createInitialState(),
+*   step: async (state) => {
+*     // Custom step logic - MUST increment iteration
+*     return { ...state, iteration: state.iteration + 1 };
+*   },
+*   shouldStop: (state) => state.iteration >= 5,
+* });
+* ```
+*/
+async function runAgentLoop(options) {
+	let state = options.initialState;
+	while (state.iteration < options.maxIterations && !options.shouldStop(state)) {
+		state = await options.step(state);
+		if (options.onStep) await options.onStep(state);
+		if (state.error) break;
+	}
+	state.isComplete = true;
+	return state;
+}
+
+//#endregion
+export { StopConditions as a, AgentConfigSchema as i, createInitialState as n, runAgentLoop as r, createAgent as t };
+//# sourceMappingURL=factory-DP6VSl8C.mjs.map

package/dist/factory-DP6VSl8C.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-DP6VSl8C.mjs","names":[],"sources":["../src/agents/base/types.ts","../src/agents/base/factory.ts"],"sourcesContent":["/**\n * @fileoverview Base agent types and interfaces.\n * @module @od-oneapp/ai-platform/agents/base\n *\n * Types are aligned with AI SDK v6 where applicable.\n * Uses LanguageModel and Tool types directly from the SDK.\n */\n\nimport { z } from 'zod';\n\nimport type { SDKLanguageModel, SDKTool , MessageRole, SDKMessagePart } from '../../shared';\n\n/**\n * Agent configuration schema.\n */\nexport const AgentConfigSchema = z.object({\n  /** Unique agent identifier */\n  id: z.string(),\n  /** Human-readable agent name */\n  name: z.string(),\n  /** Agent description for routing/triage */\n  description: z.string(),\n  /** System prompt for the agent */\n  systemPrompt: z.string(),\n  /** Maximum iterations for agentic loops */\n  maxIterations: z.number().default(10),\n  /** Maximum tokens for response */\n  maxTokens: z.number().optional(),\n  /** Temperature for generation */\n  temperature: z.number().min(0).max(2).optional(),\n});\n\nexport type AgentConfig = z.infer<typeof AgentConfigSchema>;\n\n/**\n * Simple message type for agent state.\n * Uses SDK-aligned MessageRole type.\n */\nexport interface AgentMessage {\n  role: MessageRole;\n  content: string | SDKMessagePart[];\n  toolCallId?: string;\n}\n\n/**\n * Base agent state for tracking execution.\n */\nexport interface BaseAgentState {\n  /** Current iteration count */\n  iteration: number;\n  /** Accumulated messages */\n  messages: AgentMessage[];\n  /** Tool calls made */\n  toolCalls: ToolCallRecord[];\n  /** Whether agent is complete */\n  isComplete: boolean;\n  /** Final result if complete */\n  result?: unknown;\n  /** Error if failed */\n  error?: Error;\n  /** Custom state data */\n  metadata: Record<string, unknown>;\n}\n\n/**\n * Record of a tool call.\n */\nexport interface ToolCallRecord {\n  /** Tool call ID */\n  id: string;\n  /** Tool name */\n  name: string;\n  /** Tool input payload */\n  input: Record<string, unknown>;\n  /** Tool result */\n  result?: unknown;\n  /** Error if failed */\n  error?: string;\n  /** Timestamp */\n  timestamp: number;\n}\n\n/**\n * Agent execution context.\n */\nexport interface AgentContext {\n  /** User ID */\n  userId?: string;\n  /** Session ID */\n  sessionId?: string;\n  /** Request ID for tracing */\n  requestId?: string;\n  /** Abort signal */\n  abortSignal?: AbortSignal;\n  /** Additional context data */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Agent execution options.\n */\nexport interface AgentExecutionOptions {\n  /** Language model to use */\n  model: SDKLanguageModel;\n  /** Tools available to the agent */\n  tools?: Record<string, SDKTool>;\n  /** Initial messages */\n  messages?: AgentMessage[];\n  /** Execution context */\n  context?: AgentContext;\n  /** Callback on each step */\n  onStep?: (state: BaseAgentState) => void | Promise<void>;\n  /** Callback on tool call */\n  onToolCall?: (call: ToolCallRecord) => void | Promise<void>;\n  /** Callback on completion */\n  onComplete?: (state: BaseAgentState) => void | Promise<void>;\n}\n\n/**\n * Agent interface.\n */\nexport interface Agent {\n  /** Agent configuration */\n  readonly config: AgentConfig;\n  /** Execute the agent */\n  execute(prompt: string, options: AgentExecutionOptions): Promise<BaseAgentState>;\n  /** Stream execution */\n  stream?(prompt: string, options: AgentExecutionOptions): AsyncGenerator<BaseAgentState>;\n}\n\n/**\n * Agent factory function type.\n */\nexport type AgentFactory<TConfig extends AgentConfig = AgentConfig> = (config: TConfig) => Agent;\n\n/**\n * Stop condition for agent loops.\n */\nexport type StopCondition = (state: BaseAgentState) => boolean;\n\n/**\n * Default stop conditions.\n */\nexport const StopConditions = {\n  /** Stop after max iterations */\n  maxIterations:\n    (max: number): StopCondition =>\n    state =>\n      state.iteration >= max,\n\n  /**\n   * Stop when no tool calls were made in the last iteration.\n   * @remarks Requires the agent loop to set `state.metadata.lastToolCallCount`\n   * to `state.toolCalls.length` before each iteration. See `executeAgentStep` in factory.ts.\n   */\n  noToolCalls: (): StopCondition => state => {\n    // Only stop if we've completed at least one iteration and the last iteration had no tool calls\n    // We check this by comparing current tool calls count with the count from before the last iteration\n    // Since we check before each iteration, we need iteration > 0 to have completed at least one iteration\n    if (state.iteration === 0) {\n      return false;\n    }\n    // Check if the last iteration added any tool calls by comparing with previous count\n    // We store the previous tool call count in metadata to track this\n    const previousToolCallCount = (state.metadata.lastToolCallCount as number) ?? 0;\n    return state.toolCalls.length === previousToolCallCount;\n  },\n\n  /** Stop on specific tool call */\n  onToolCall:\n    (toolName: string): StopCondition =>\n    state => {\n      return state.toolCalls.some(call => call.name === toolName);\n    },\n\n  /** Stop on error */\n  onError: (): StopCondition => state => Boolean(state.error),\n\n  /** Combine multiple conditions with OR */\n  any:\n    (...conditions: StopCondition[]): StopCondition =>\n    state => {\n      return conditions.some(cond => cond(state));\n    },\n\n  /** Combine multiple conditions with AND */\n  all:\n    (...conditions: StopCondition[]): StopCondition =>\n    state => {\n      return conditions.every(cond => cond(state));\n    },\n};\n","/**\n * @fileoverview Core agent factory and agentic loop runner.\n * @module @od-oneapp/ai-platform/agents/base\n */\n\nimport { generateText } from '../../shared';\n\nimport { StopConditions } from './types';\n\nimport type {\n  Agent,\n  AgentConfig,\n  BaseAgentState,\n  AgentExecutionOptions,\n  AgentMessage,\n  StopCondition,\n  ToolCallRecord,\n} from './types';\nimport type {\n  SDKAssistantModelMessage as AssistantModelMessage,\n  SDKModelMessage as ModelMessage,\n  SDKSystemModelMessage as SystemModelMessage,\n  SDKToolModelMessage as ToolModelMessage,\n  SDKUserModelMessage as UserModelMessage,\n\n  SDKFilePart,\n  SDKMessagePart,\n  SDKTextPart,\n  SDKToolCallPart,\n  SDKToolResultOutput} from '../../shared';\n\n\ntype ToolContent = Array<\n  Extract<SDKMessagePart, { type: 'tool-result' | 'tool-approval-response' }>\n>;\n\ntype AssistantPart = SDKTextPart | SDKToolCallPart;\n\nfunction isTextPart(part: SDKMessagePart): part is SDKTextPart {\n  return part.type === 'text';\n}\n\nfunction isFilePart(part: SDKMessagePart): part is SDKFilePart {\n  return part.type === 'file';\n}\n\nfunction partsToText(parts: SDKMessagePart[]): string {\n  return parts\n    .filter(isTextPart)\n    .map(part => part.text)\n    .join('\\n');\n}\n\nfunction isToolContent(parts: SDKMessagePart[]): parts is ToolContent {\n  return parts.every(part => part.type === 'tool-result' || part.type === 'tool-approval-response');\n}\n\nfunction isAssistantPart(part: SDKMessagePart): part is AssistantPart {\n  return part.type === 'text' || part.type === 'tool-call';\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction isToolResultOutput(value: unknown): value is SDKToolResultOutput {\n  if (!isRecord(value)) return false;\n  return typeof value.type === 'string';\n}\n\n/**\n * Creates initial agent state.\n */\nexport function createInitialState(messages: AgentMessage[] = []): BaseAgentState {\n  return {\n    iteration: 0,\n    messages: [...messages],\n    toolCalls: [],\n    isComplete: false,\n    metadata: {},\n  };\n}\n\n/**\n * Executes a single agent step (shared logic for execute and stream).\n * Handles model call, message updates, and tool call processing.\n *\n * @remarks This function mutates `state` directly for performance.\n * It sets `state.metadata.lastToolCallCount` before each iteration\n * to enable the `StopConditions.noToolCalls()` stop condition.\n *\n * @internal\n */\nasync function executeAgentStep(\n  state: BaseAgentState,\n  config: AgentConfig,\n  options: AgentExecutionOptions,\n): Promise<BaseAgentState> {\n  // Track tool call count before this iteration for stop condition checks\n  // (required for StopConditions.noToolCalls() to work correctly)\n  state.metadata.lastToolCallCount = state.toolCalls.length;\n  state.iteration++;\n\n  try {\n    const result = await generateText({\n      model: options.model,\n      system: config.systemPrompt,\n      messages: state.messages.map<ModelMessage>(message => {\n        if (message.role === 'tool') {\n          const toolCallId = message.toolCallId ?? 'unknown';\n          if (Array.isArray(message.content)) {\n            if (isToolContent(message.content)) {\n              const toolMessage: ToolModelMessage = { role: 'tool', content: message.content };\n              return toolMessage;\n            }\n\n            const textValue = partsToText(message.content);\n            const toolMessage: ToolModelMessage = {\n              role: 'tool',\n              content: [\n                {\n                  type: 'tool-result' as const,\n                  toolCallId,\n                  toolName: 'unknown',\n                  output: { type: 'text', value: textValue },\n                },\n              ],\n            };\n            return toolMessage;\n          }\n\n          const toolMessage: ToolModelMessage = {\n            role: 'tool',\n            content: [\n              {\n                type: 'tool-result' as const,\n                toolCallId,\n                toolName: 'unknown',\n                output: { type: 'text', value: message.content },\n              },\n            ],\n          };\n          return toolMessage;\n        }\n\n        if (message.role === 'system') {\n          const systemMessage: SystemModelMessage = {\n            role: 'system',\n            content:\n              typeof message.content === 'string' ? message.content : partsToText(message.content),\n          };\n          return systemMessage;\n        }\n\n        if (message.role === 'user') {\n          if (typeof message.content === 'string') {\n            const userMessage: UserModelMessage = { role: 'user', content: message.content };\n            return userMessage;\n          }\n          const userParts = message.content.filter(part => isTextPart(part) || isFilePart(part));\n          if (userParts.length === message.content.length) {\n            const userMessage: UserModelMessage = { role: 'user', content: userParts };\n            return userMessage;\n          }\n          const userMessage: UserModelMessage = {\n            role: 'user',\n            content: partsToText(message.content),\n          };\n          return userMessage;\n        }\n\n        if (typeof message.content === 'string') {\n          const assistantMessage: AssistantModelMessage = {\n            role: 'assistant',\n            content: message.content,\n          };\n          return assistantMessage;\n        }\n\n        const assistantParts = message.content.filter(isAssistantPart);\n        const assistantMessage: AssistantModelMessage = {\n          role: 'assistant',\n          content: assistantParts.length > 0 ? assistantParts : '',\n        };\n        return assistantMessage;\n      }),\n      tools: options.tools,\n      temperature: config.temperature,\n      abortSignal: options.context?.abortSignal,\n    });\n\n    // Add assistant message\n    state.messages.push({\n      role: 'assistant',\n      content: result.text,\n    });\n\n    // Process tool calls\n    if (result.toolCalls && result.toolCalls.length > 0) {\n      for (const toolCall of result.toolCalls) {\n        const toolResult = result.toolResults?.find(r => r.toolCallId === toolCall.toolCallId);\n        const toolInput = isRecord(toolCall.input) ? toolCall.input : {};\n        const toolOutput = isToolResultOutput(toolResult?.output) ? toolResult?.output : undefined;\n        const record: ToolCallRecord = {\n          id: toolCall.toolCallId,\n          name: toolCall.toolName,\n          input: toolInput,\n          result: toolOutput,\n          timestamp: Date.now(),\n        };\n\n        state.toolCalls.push(record);\n\n        // Add tool result message for multi-turn tool-use loops\n        if (toolOutput !== undefined) {\n          state.messages.push({\n            role: 'tool',\n            content: [\n              {\n                type: 'tool-result',\n                toolCallId: toolCall.toolCallId,\n                toolName: toolCall.toolName,\n                output: toolOutput,\n              },\n            ],\n            toolCallId: toolCall.toolCallId,\n          });\n        }\n\n        if (options.onToolCall) {\n          await options.onToolCall(record);\n        }\n      }\n    } else {\n      // No tool calls means agent is done\n      state.isComplete = true;\n      state.result = result.text;\n    }\n  } catch (error) {\n    state.error = error instanceof Error ? error : new Error(String(error));\n    state.isComplete = true;\n  }\n\n  return state;\n}\n\n/**\n * Creates a basic agent with agentic loop execution.\n *\n * @param config - Agent configuration\n * @param stopCondition - Optional custom stop condition\n * @returns Agent instance\n *\n * @example\n * ```ts\n * const agent = createAgent({\n *   id: 'research-agent',\n *   name: 'Research Agent',\n *   description: 'Researches topics using web search',\n *   systemPrompt: 'You are a research assistant...',\n *   maxIterations: 5,\n * });\n *\n * const result = await agent.execute('Research AI trends', {\n *   model: openai('gpt-4o'),\n *   tools: { webSearch, summarize },\n * });\n * ```\n */\nexport function createAgent(config: AgentConfig, stopCondition?: StopCondition): Agent {\n  const defaultStopCondition = StopConditions.any(\n    StopConditions.maxIterations(config.maxIterations),\n    StopConditions.onError(),\n  );\n\n  const stop = stopCondition ?? defaultStopCondition;\n\n  return {\n    config,\n\n    async execute(prompt: string, options: AgentExecutionOptions): Promise<BaseAgentState> {\n      const state = createInitialState(options.messages);\n\n      // Add user message\n      state.messages.push({\n        role: 'user',\n        content: prompt,\n      });\n\n      // Run agentic loop using shared step execution\n      while (!state.isComplete && !stop(state)) {\n        await executeAgentStep(state, config, options);\n\n        if (options.onStep) {\n          await options.onStep(state);\n        }\n      }\n\n      // Mark complete if stopped by condition\n      if (!state.isComplete) {\n        state.isComplete = true;\n        state.result = state.messages[state.messages.length - 1]?.content ?? '';\n      }\n\n      if (options.onComplete) {\n        await options.onComplete(state);\n      }\n\n      return state;\n    },\n\n    async *stream(prompt: string, options: AgentExecutionOptions): AsyncGenerator<BaseAgentState> {\n      const state = createInitialState(options.messages);\n\n      state.messages.push({\n        role: 'user',\n        content: prompt,\n      });\n\n      // Run agentic loop using shared step execution\n      while (!state.isComplete && !stop(state)) {\n        await executeAgentStep(state, config, options);\n        yield state;\n      }\n\n      if (!state.isComplete) {\n        state.isComplete = true;\n        state.result = state.messages[state.messages.length - 1]?.content;\n        yield state;\n      }\n    },\n  };\n}\n\n/**\n * Runs an agentic loop with custom step function.\n *\n * @param options - Loop options\n * @returns Final state\n *\n * @remarks The `step` function MUST increment `state.iteration` to ensure\n * the `maxIterations` safety bound is respected. Failure to do so may result\n * in an infinite loop if `shouldStop` never returns true.\n *\n * @example\n * ```ts\n * const result = await runAgentLoop({\n *   maxIterations: 5,\n *   initialState: createInitialState(),\n *   step: async (state) => {\n *     // Custom step logic - MUST increment iteration\n *     return { ...state, iteration: state.iteration + 1 };\n *   },\n *   shouldStop: (state) => state.iteration >= 5,\n * });\n * ```\n */\nexport async function runAgentLoop(options: {\n  maxIterations: number;\n  initialState: BaseAgentState;\n  step: (state: BaseAgentState) => Promise<BaseAgentState>;\n  shouldStop: StopCondition;\n  onStep?: (state: BaseAgentState) => void | Promise<void>;\n}): Promise<BaseAgentState> {\n  let state = options.initialState;\n\n  // Note: maxIterations provides a safety limit; shouldStop handles custom conditions\n  while (state.iteration < options.maxIterations && !options.shouldStop(state)) {\n    state = await options.step(state);\n\n    if (options.onStep) {\n      await options.onStep(state);\n    }\n\n    if (state.error) {\n      break;\n    }\n  }\n\n  state.isComplete = true;\n  return state;\n}\n"],"mappings":"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"}

package/dist/generative-ui-catalog.d.mts

@@ -0,0 +1,8 @@
+import { CatalogComponent, EnterpriseCatalog, EnterpriseCatalogConfig } from "./generative-ui-types.mjs";
+
+//#region src/generative-ui/catalog.d.ts
+declare const BASE_CATALOG_COMPONENTS: readonly CatalogComponent[];
+declare function createEnterpriseCatalog(config: EnterpriseCatalogConfig): EnterpriseCatalog;
+//#endregion
+export { BASE_CATALOG_COMPONENTS, createEnterpriseCatalog };
+//# sourceMappingURL=generative-ui-catalog.d.mts.map

package/dist/generative-ui-catalog.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative-ui-catalog.d.mts","names":[],"sources":["../src/generative-ui/catalog.ts"],"mappings":";;;cAwEa,uBAAA,WAAkC,gBAAA;AAAA,iBA4gB/B,uBAAA,CAAwB,MAAA,EAAQ,uBAAA,GAA0B,iBAAA"}