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

package/dist/index.cjs

@@ -4584,14 +4584,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`;
@@ -4610,7 +4610,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);
@@ -4648,15 +4648,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) {
@@ -4833,8 +4832,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.");
@@ -4843,8 +4842,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);
@@ -4968,8 +4967,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.");
@@ -4980,8 +4979,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 ?? {};
@@ -5004,7 +5003,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 })));
@@ -5022,7 +5021,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 })));
@@ -5261,7 +5260,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";
@@ -5275,7 +5274,6 @@ var init_pipeline = __esm({
     DEFAULT_PARSER = "prompty";
     DEFAULT_PROVIDER = "openai";
     DEFAULT_MAX_ITERATIONS = 10;
-    runAgent = executeAgent;
   }
 });
 
@@ -5326,13 +5324,13 @@ __export(index_exports, {
   consoleTracer: () => consoleTracer,
   dictContentToPart: () => dictContentToPart,
   dictToMessage: () => dictToMessage,
-  execute: () => execute,
-  executeAgent: () => executeAgent,
   getConnection: () => getConnection,
   getExecutor: () => getExecutor,
   getParser: () => getParser,
   getProcessor: () => getProcessor,
   getRenderer: () => getRenderer,
+  invoke: () => invoke,
+  invokeAgent: () => invokeAgent,
   load: () => load,
   otelTracer: () => otelTracer,
   parse: () => parse,
@@ -5346,7 +5344,6 @@ __export(index_exports, {
   render: () => render,
   resolveBindings: () => resolveBindings,
   run: () => run,
-  runAgent: () => runAgent,
   sanitizeValue: () => sanitizeValue,
   text: () => text,
   textMessage: () => textMessage,
@@ -5816,13 +5813,13 @@ registerParser("prompty", new PromptyChatParser());
   consoleTracer,
   dictContentToPart,
   dictToMessage,
-  execute,
-  executeAgent,
   getConnection,
   getExecutor,
   getParser,
   getProcessor,
   getRenderer,
+  invoke,
+  invokeAgent,
   load,
   otelTracer,
   parse,
@@ -5836,7 +5833,6 @@ registerParser("prompty", new PromptyChatParser());
   render,
   resolveBindings,
   run,
-  runAgent,
   sanitizeValue,
   text,
   textMessage,