@prompty/core 2.0.0-alpha.4 → 2.0.0-alpha.5

package/dist/index.d.cts

@@ -2141,7 +2141,7 @@ declare function load(path: string): Prompty;
  * Four-step execution pipeline.
  *
  * ```
- * execute(prompt, inputs)              → top-level orchestrator
+ * invoke(prompt, inputs)               → top-level orchestrator
  *   ├── prepare(agent, inputs)         → template → wire format
  *   │     ├── render(agent, inputs)    → template + inputs → rendered string
  *   │     └── parse(agent, rendered)   → rendered string → Message[]
@@ -2191,7 +2191,7 @@ declare function run(agent: Prompty, messages: Message[], options?: {
 /**
  * Full pipeline: load → prepare → run.
  */
-declare function execute(prompt: string | Prompty, inputs?: Record<string, unknown>, options?: {
+declare function invoke(prompt: string | Prompty, inputs?: Record<string, unknown>, options?: {
     raw?: boolean;
 }): Promise<unknown>;
 /**
@@ -2204,12 +2204,11 @@ declare function resolveBindings(agent: Prompty, toolName: string, args: Record<
 /**
  * Run a prompt with automatic tool-call execution loop.
  */
-declare function executeAgent(prompt: string | Prompty, inputs?: Record<string, unknown>, options?: {
+declare function invokeAgent(prompt: string | Prompty, inputs?: Record<string, unknown>, options?: {
     tools?: Record<string, (...args: unknown[]) => unknown>;
     maxIterations?: number;
     raw?: boolean;
 }): Promise<unknown>;
-declare const runAgent: typeof executeAgent;
 
 /**
  * Nunjucks renderer — Jinja2-compatible template rendering for TypeScript.
@@ -2470,4 +2469,4 @@ interface OtelTracerOptions {
  */
 declare function otelTracer(api: OtelApi, options?: OtelTracerOptions): TracerFactory;
 
-export { Prompty as AgentDefinition, AnonymousConnection, ApiKeyConnection, ArrayProperty, type AudioPart, Binding, Connection, type ContentPart, CustomTool, type Executor, type FilePart, FormatConfig, FoundryConnection, FunctionTool, type ImagePart, InvokerError, LoadContext, McpApprovalMode, McpTool, Message, Model, ModelOptions, MustacheRenderer, NunjucksRenderer, OAuthConnection, ObjectProperty, OpenApiTool, type OtelApi, type OtelTracerOptions, type Parser, ParserConfig, type Processor, Prompty as PromptAgent, Prompty, PromptyChatParser, PromptyStream, PromptyTool, PromptyTracer, Property, RICH_KINDS, ROLES, ReferenceConnection, RemoteConnection, type Renderer, type Role, SaveContext, type SpanEmitter, Template, type TextPart, ThreadMarker, Tool, type ToolCall, Tracer, type TracerBackend, type TracerFactory, clearCache, clearConnections, consoleTracer, dictContentToPart, dictToMessage, execute, executeAgent, getConnection, getExecutor, getParser, getProcessor, getRenderer, load, otelTracer, parse, prepare, process, registerConnection, registerExecutor, registerParser, registerProcessor, registerRenderer, render, resolveBindings, run, runAgent, sanitizeValue, text, textMessage, toSerializable, trace, traceMethod, traceSpan, validateInputs };
+export { Prompty as AgentDefinition, AnonymousConnection, ApiKeyConnection, ArrayProperty, type AudioPart, Binding, Connection, type ContentPart, CustomTool, type Executor, type FilePart, FormatConfig, FoundryConnection, FunctionTool, type ImagePart, InvokerError, LoadContext, McpApprovalMode, McpTool, Message, Model, ModelOptions, MustacheRenderer, NunjucksRenderer, OAuthConnection, ObjectProperty, OpenApiTool, type OtelApi, type OtelTracerOptions, type Parser, ParserConfig, type Processor, Prompty as PromptAgent, Prompty, PromptyChatParser, PromptyStream, PromptyTool, PromptyTracer, Property, RICH_KINDS, ROLES, ReferenceConnection, RemoteConnection, type Renderer, type Role, SaveContext, type SpanEmitter, Template, type TextPart, ThreadMarker, Tool, type ToolCall, Tracer, type TracerBackend, type TracerFactory, clearCache, clearConnections, consoleTracer, dictContentToPart, dictToMessage, getConnection, getExecutor, getParser, getProcessor, getRenderer, invoke, invokeAgent, load, otelTracer, parse, prepare, process, registerConnection, registerExecutor, registerParser, registerProcessor, registerRenderer, render, resolveBindings, run, sanitizeValue, text, textMessage, toSerializable, trace, traceMethod, traceSpan, validateInputs };

package/dist/index.d.ts

@@ -2141,7 +2141,7 @@ declare function load(path: string): Prompty;
  * Four-step execution pipeline.
  *
  * ```
- * execute(prompt, inputs)              → top-level orchestrator
+ * invoke(prompt, inputs)               → top-level orchestrator
  *   ├── prepare(agent, inputs)         → template → wire format
  *   │     ├── render(agent, inputs)    → template + inputs → rendered string
  *   │     └── parse(agent, rendered)   → rendered string → Message[]
@@ -2191,7 +2191,7 @@ declare function run(agent: Prompty, messages: Message[], options?: {
 /**
  * Full pipeline: load → prepare → run.
  */
-declare function execute(prompt: string | Prompty, inputs?: Record<string, unknown>, options?: {
+declare function invoke(prompt: string | Prompty, inputs?: Record<string, unknown>, options?: {
     raw?: boolean;
 }): Promise<unknown>;
 /**
@@ -2204,12 +2204,11 @@ declare function resolveBindings(agent: Prompty, toolName: string, args: Record<
 /**
  * Run a prompt with automatic tool-call execution loop.
  */
-declare function executeAgent(prompt: string | Prompty, inputs?: Record<string, unknown>, options?: {
+declare function invokeAgent(prompt: string | Prompty, inputs?: Record<string, unknown>, options?: {
     tools?: Record<string, (...args: unknown[]) => unknown>;
     maxIterations?: number;
     raw?: boolean;
 }): Promise<unknown>;
-declare const runAgent: typeof executeAgent;
 
 /**
  * Nunjucks renderer — Jinja2-compatible template rendering for TypeScript.
@@ -2470,4 +2469,4 @@ interface OtelTracerOptions {
  */
 declare function otelTracer(api: OtelApi, options?: OtelTracerOptions): TracerFactory;
 
-export { Prompty as AgentDefinition, AnonymousConnection, ApiKeyConnection, ArrayProperty, type AudioPart, Binding, Connection, type ContentPart, CustomTool, type Executor, type FilePart, FormatConfig, FoundryConnection, FunctionTool, type ImagePart, InvokerError, LoadContext, McpApprovalMode, McpTool, Message, Model, ModelOptions, MustacheRenderer, NunjucksRenderer, OAuthConnection, ObjectProperty, OpenApiTool, type OtelApi, type OtelTracerOptions, type Parser, ParserConfig, type Processor, Prompty as PromptAgent, Prompty, PromptyChatParser, PromptyStream, PromptyTool, PromptyTracer, Property, RICH_KINDS, ROLES, ReferenceConnection, RemoteConnection, type Renderer, type Role, SaveContext, type SpanEmitter, Template, type TextPart, ThreadMarker, Tool, type ToolCall, Tracer, type TracerBackend, type TracerFactory, clearCache, clearConnections, consoleTracer, dictContentToPart, dictToMessage, execute, executeAgent, getConnection, getExecutor, getParser, getProcessor, getRenderer, load, otelTracer, parse, prepare, process, registerConnection, registerExecutor, registerParser, registerProcessor, registerRenderer, render, resolveBindings, run, runAgent, sanitizeValue, text, textMessage, toSerializable, trace, traceMethod, traceSpan, validateInputs };
+export { Prompty as AgentDefinition, AnonymousConnection, ApiKeyConnection, ArrayProperty, type AudioPart, Binding, Connection, type ContentPart, CustomTool, type Executor, type FilePart, FormatConfig, FoundryConnection, FunctionTool, type ImagePart, InvokerError, LoadContext, McpApprovalMode, McpTool, Message, Model, ModelOptions, MustacheRenderer, NunjucksRenderer, OAuthConnection, ObjectProperty, OpenApiTool, type OtelApi, type OtelTracerOptions, type Parser, ParserConfig, type Processor, Prompty as PromptAgent, Prompty, PromptyChatParser, PromptyStream, PromptyTool, PromptyTracer, Property, RICH_KINDS, ROLES, ReferenceConnection, RemoteConnection, type Renderer, type Role, SaveContext, type SpanEmitter, Template, type TextPart, ThreadMarker, Tool, type ToolCall, Tracer, type TracerBackend, type TracerFactory, clearCache, clearConnections, consoleTracer, dictContentToPart, dictToMessage, getConnection, getExecutor, getParser, getProcessor, getRenderer, invoke, invokeAgent, load, otelTracer, parse, prepare, process, registerConnection, registerExecutor, registerParser, registerProcessor, registerRenderer, render, resolveBindings, run, sanitizeValue, text, textMessage, toSerializable, trace, traceMethod, traceSpan, validateInputs };

package/dist/index.js

@@ -4567,14 +4567,14 @@ var init_tool_dispatch = __esm({
       async executeTool(tool, _args, _agent, _parentInputs) {
         const name = tool.name ?? "unknown";
         throw new Error(
-          `Function tool '${name}' declared but no callable provided. Pass it via tools: { '${name}': fn } in executeAgent().`
+          `Function tool '${name}' declared but no callable provided. Pass it via tools: { '${name}': fn } in invokeAgent().`
         );
       }
     };
     PromptyToolHandler = class {
       async executeTool(tool, args, agent, _parentInputs) {
         const { load: load2 } = await Promise.resolve().then(() => (init_loader(), loader_exports));
-        const { prepare: prepare2, run: run2, executeAgent: executeAgent2 } = await Promise.resolve().then(() => (init_pipeline(), pipeline_exports));
+        const { prepare: prepare2, run: run2, invokeAgent: invokeAgent2 } = await Promise.resolve().then(() => (init_pipeline(), pipeline_exports));
         const parentPath = (agent.metadata ?? {}).__source_path;
         if (!parentPath) {
           return `Error: cannot resolve PromptyTool '${tool.name}': parent has no __source_path`;
@@ -4593,7 +4593,7 @@ var init_tool_dispatch = __esm({
           child.metadata.__prompty_tool_stack = [...stack, parentPath];
           const mode = tool.mode ?? "single";
           if (mode === "agentic") {
-            const result = await executeAgent2(child, args);
+            const result = await invokeAgent2(child, args);
             return typeof result === "string" ? result : JSON.stringify(result);
           } else {
             const messages = await prepare2(child, args);
@@ -4631,15 +4631,14 @@ var init_tool_dispatch = __esm({
 // src/core/pipeline.ts
 var pipeline_exports = {};
 __export(pipeline_exports, {
-  execute: () => execute,
-  executeAgent: () => executeAgent,
+  invoke: () => invoke,
+  invokeAgent: () => invokeAgent,
   parse: () => parse,
   prepare: () => prepare,
   process: () => process2,
   render: () => render,
   resolveBindings: () => resolveBindings,
   run: () => run,
-  runAgent: () => runAgent,
   validateInputs: () => validateInputs
 });
 function sanitizeNonces(value) {
@@ -4816,8 +4815,8 @@ async function run(agent, messages, options) {
     return result;
   });
 }
-async function execute(prompt, inputs, options) {
-  return traceSpan("execute", async (emit) => {
+async function invoke(prompt, inputs, options) {
+  return traceSpan("invoke", async (emit) => {
     const agent = typeof prompt === "string" ? await traceSpan("load", async (loadEmit) => {
       loadEmit("signature", "prompty.load");
       loadEmit("description", "Load a prompty file.");
@@ -4826,8 +4825,8 @@ async function execute(prompt, inputs, options) {
       loadEmit("result", serializeAgent(loaded));
       return loaded;
     }) : prompt;
-    emit("signature", "prompty.execute");
-    emit("description", "Execute a prompty");
+    emit("signature", "prompty.invoke");
+    emit("description", "Invoke a prompty");
     emit("inputs", { prompt: serializeAgent(agent), inputs: inputs ?? {} });
     const messages = await prepare(agent, inputs);
     const result = await run(agent, messages, options);
@@ -4951,8 +4950,8 @@ async function buildToolMessagesFromCalls(toolCalls, textContent, tools, agent,
   }
   return messages;
 }
-async function executeAgent(prompt, inputs, options) {
-  return traceSpan("executeAgent", async (emit) => {
+async function invokeAgent(prompt, inputs, options) {
+  return traceSpan("invokeAgent", async (emit) => {
     const agent = typeof prompt === "string" ? await traceSpan("load", async (loadEmit) => {
       loadEmit("signature", "prompty.load");
       loadEmit("description", "Load a prompty file.");
@@ -4963,8 +4962,8 @@ async function executeAgent(prompt, inputs, options) {
     }) : prompt;
     const tools = options?.tools ?? {};
     const maxIterations = options?.maxIterations ?? DEFAULT_MAX_ITERATIONS;
-    emit("signature", "prompty.executeAgent");
-    emit("description", "Execute a prompty with tool calling");
+    emit("signature", "prompty.invokeAgent");
+    emit("description", "Invoke a prompty with tool calling");
     emit("inputs", { prompt: serializeAgent(agent), tools: Object.keys(tools), inputs: inputs ?? {} });
     const messages = await prepare(agent, inputs);
     const parentInputs = inputs ?? {};
@@ -4987,7 +4986,7 @@ async function executeAgent(prompt, inputs, options) {
           );
         }
         const toolMessages2 = await traceSpan("toolCalls", async (toolEmit) => {
-          toolEmit("signature", "prompty.executeAgent.toolCalls");
+          toolEmit("signature", "prompty.invokeAgent.toolCalls");
           toolEmit("description", `Tool call round ${iteration}`);
           const result2 = await buildToolMessagesFromCalls(toolCalls, content, tools, agent, parentInputs, toolEmit);
           toolEmit("result", result2.map((m) => ({ role: m.role, content: m.parts.map((p) => p.value ?? "").join(""), metadata: m.metadata })));
@@ -5005,7 +5004,7 @@ async function executeAgent(prompt, inputs, options) {
         );
       }
       const toolMessages = await traceSpan("toolCalls", async (toolEmit) => {
-        toolEmit("signature", "prompty.executeAgent.toolCalls");
+        toolEmit("signature", "prompty.invokeAgent.toolCalls");
         toolEmit("description", `Tool call round ${iteration}`);
         const result2 = await buildToolResultMessages(response, tools, agent, parentInputs, toolEmit);
         toolEmit("result", result2.map((m) => ({ role: m.role, content: m.parts.map((p) => p.value ?? "").join(""), metadata: m.metadata })));
@@ -5244,7 +5243,7 @@ async function buildResponsesToolResultMessages(r, tools, agent, parentInputs, p
   }
   return messages;
 }
-var DEFAULT_FORMAT, DEFAULT_PARSER, DEFAULT_PROVIDER, DEFAULT_MAX_ITERATIONS, runAgent;
+var DEFAULT_FORMAT, DEFAULT_PARSER, DEFAULT_PROVIDER, DEFAULT_MAX_ITERATIONS;
 var init_pipeline = __esm({
   "src/core/pipeline.ts"() {
     "use strict";
@@ -5258,7 +5257,6 @@ var init_pipeline = __esm({
     DEFAULT_PARSER = "prompty";
     DEFAULT_PROVIDER = "openai";
     DEFAULT_MAX_ITERATIONS = 10;
-    runAgent = executeAgent;
   }
 });
 
@@ -5719,13 +5717,13 @@ export {
   consoleTracer,
   dictContentToPart,
   dictToMessage,
-  execute,
-  executeAgent,
   getConnection,
   getExecutor,
   getParser,
   getProcessor,
   getRenderer,
+  invoke,
+  invokeAgent,
   load,
   otelTracer,
   parse,
@@ -5739,7 +5737,6 @@ export {
   render,
   resolveBindings,
   run,
-  runAgent,
   sanitizeValue,
   text,
   textMessage,