@yugenlab/vaayu 0.1.3 → 0.1.5

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="assets/logos/vaayu-logo.png" alt="Vaayu Logo" width="360" />
+</p>
+
 # VAAYU (वायु)
 
 **Like wind — swift, everywhere, carrying what matters.**
@@ -93,6 +97,22 @@ flowchart TB
 
 For full ASCII flow/state diagrams and concrete examples, see `docs/architecture.md`.
 
+### English-First Naming
+
+For public docs and onboarding, use English names first:
+
+| English (preferred) | Internal codename |
+|------|------|
+| NLU Engine | Saraswati |
+| Planner | Brahma |
+| Policy Gateway | Hanuman |
+| Guardrail Manager | Vyasa |
+| Tool Executor | Vishwakarma |
+| Memory System | Smriti |
+| Multi-Agent Broker | Kaala |
+
+Full map (including Chitragupta names): `docs/aliases.md`.
+
 ---
 
 ## Quick Start

package/chunks/agentic-tool-loop-2FZK72JO.js

@@ -0,0 +1,147 @@
+import "./chunk-IGKYKEKT.js";
+
+// apps/gateway/dist/agent/agentic-tool-loop.js
+async function runAgenticToolLoop(params) {
+  const { initialContent, initialModel, contextMessages, tools, getToolRegistration, isToolAllowed, reChat, maxIterations, signal, logger, sessionId } = params;
+  let currentToolCalls = params.toolCalls;
+  let allToolResults = [];
+  const accumulatedMessages = [...contextMessages];
+  let finalContent = initialContent;
+  let finalModel = initialModel;
+  let iteration = 0;
+  while (currentToolCalls.length > 0 && iteration < maxIterations) {
+    iteration++;
+    if (signal?.aborted) {
+      logger.info("agentic_loop_aborted", { sessionId, iteration });
+      break;
+    }
+    accumulatedMessages.push({
+      role: "assistant",
+      content: finalContent,
+      toolCalls: currentToolCalls
+    });
+    const iterationResults = [];
+    for (const call of currentToolCalls) {
+      const callId = call.id ?? `call_${call.name}_${iteration}`;
+      if (!isToolAllowed(call.name)) {
+        const errorMsg = `Tool "${call.name}" is not allowed by current policy.`;
+        logger.warn("agentic_tool_blocked", { sessionId, tool: call.name, iteration });
+        iterationResults.push({
+          name: call.name,
+          input: call.input,
+          output: { error: errorMsg },
+          ok: false,
+          callId
+        });
+        accumulatedMessages.push({
+          role: "tool",
+          content: JSON.stringify({ error: errorMsg }),
+          name: call.name,
+          toolCallId: callId
+        });
+        continue;
+      }
+      const registration = getToolRegistration(call.name);
+      if (!registration) {
+        const errorMsg = `Tool "${call.name}" not found in registry.`;
+        logger.warn("agentic_tool_not_found", { sessionId, tool: call.name, iteration });
+        iterationResults.push({
+          name: call.name,
+          input: call.input,
+          output: { error: errorMsg },
+          ok: false,
+          callId
+        });
+        accumulatedMessages.push({
+          role: "tool",
+          content: JSON.stringify({ error: errorMsg }),
+          name: call.name,
+          toolCallId: callId
+        });
+        continue;
+      }
+      try {
+        const ctx = {
+          sessionId,
+          signal
+        };
+        const result = await registration.handler(call.input, ctx);
+        const output = result.ok ? result.output : result.error;
+        iterationResults.push({
+          name: call.name,
+          input: call.input,
+          output,
+          ok: result.ok,
+          callId
+        });
+        accumulatedMessages.push({
+          role: "tool",
+          content: JSON.stringify(result.ok ? result.output : { error: result.error }),
+          name: call.name,
+          toolCallId: callId
+        });
+        logger.info("agentic_tool_executed", {
+          sessionId,
+          tool: call.name,
+          ok: result.ok,
+          iteration
+        });
+      } catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        logger.warn("agentic_tool_error", {
+          sessionId,
+          tool: call.name,
+          error: errorMsg,
+          iteration
+        });
+        iterationResults.push({
+          name: call.name,
+          input: call.input,
+          output: { error: errorMsg },
+          ok: false,
+          callId
+        });
+        accumulatedMessages.push({
+          role: "tool",
+          content: JSON.stringify({ error: errorMsg }),
+          name: call.name,
+          toolCallId: callId
+        });
+      }
+    }
+    allToolResults = [...allToolResults, ...iterationResults];
+    try {
+      const response = await reChat(accumulatedMessages, tools);
+      finalContent = response.content;
+      finalModel = response.model;
+      currentToolCalls = response.toolCalls ?? [];
+    } catch (error) {
+      logger.warn("agentic_rechat_failed", {
+        sessionId,
+        iteration,
+        error: error instanceof Error ? error.message : String(error)
+      });
+      if (!finalContent && allToolResults.length > 0) {
+        finalContent = allToolResults.map((r) => `${r.name}: ${r.ok ? JSON.stringify(r.output) : `Error: ${JSON.stringify(r.output)}`}`).join("\n");
+      }
+      break;
+    }
+  }
+  if (iteration >= maxIterations && currentToolCalls.length > 0) {
+    logger.warn("agentic_loop_max_iterations", {
+      sessionId,
+      maxIterations,
+      remainingToolCalls: currentToolCalls.length
+    });
+  }
+  return {
+    finalContent,
+    toolResults: allToolResults,
+    iterations: iteration,
+    finalModel
+  };
+}
+export {
+  runAgenticToolLoop
+};
+//# sourceMappingURL=agentic-tool-loop-2FZK72JO.js.map