@almadar/agent 1.3.3 → 1.6.1

package/dist/{interrupt-config-Bib_RCTB.d.ts → workflow-tool-wrapper-CXD0A7l3.d.ts}

@@ -1,5 +1,5 @@
 import { LLMProvider } from '@almadar/llm';
-import { S as SubagentEventCallback, O as OrbitalCompleteCallback, D as DomainOrbitalCompleteCallback } from './orbital-subagent-CCo-ONJY.js';
+import { S as SubagentEventCallback, O as OrbitalCompleteCallback, D as DomainOrbitalCompleteCallback } from './orbital-subagent-CHEeQQr_.js';
 import { BaseCheckpointSaver } from '@langchain/langgraph-checkpoint';
 import { P as PersistenceMode, F as FirestoreDb$1, S as SessionMetadata, a as SessionRecord } from './firestore-checkpointer-BkFR-sZM.js';
 import { OrbitalSchema } from '@almadar/core';
@@ -752,13 +752,49 @@ interface SkillAgentOptions {
     userId?: string;
     /** Optional: App ID for project context */
     appId?: string;
+    /** Optional: Tool wrapper for workflow execution (adds retry, telemetry) */
+    toolWrapper?: <T extends {
+        name: string;
+        invoke: (...args: any[]) => Promise<any>;
+    }>(tool: T) => T;
+    /** Optional: Use orchestrated generation/fixing with complexity-based routing */
+    useOrchestration?: boolean;
+}
+/**
+ * Agent interface with stream method (simplified from DeepAgent)
+ */
+interface SkillAgent {
+    stream: (input: {
+        messages: Array<{
+            role: string;
+            content: string;
+        }>;
+    }, config: {
+        configurable: {
+            thread_id: string;
+        };
+    }) => Promise<AsyncIterable<{
+        events?: Array<{
+            type: string;
+            [key: string]: unknown;
+        }>;
+        model_request?: {
+            messages?: Array<{
+                kwargs?: {
+                    content?: Array<{
+                        type: string;
+                    }>;
+                };
+            }>;
+        };
+    }>>;
 }
 /**
  * Result from creating a skill agent.
  */
 interface SkillAgentResult {
     /** The agent instance (from deepagents library) */
-    agent: any;
+    agent: SkillAgent;
     /** Thread ID for session resumption */
     threadId: string;
     /** The loaded skill(s) - primary skill when single, all skills when multiple */
@@ -838,6 +874,20 @@ declare function getBudgetWarningMessage(eventCount: number, budget: {
  * Interrupt Configuration
  *
  * Human-in-the-loop configuration for agent tools.
+ *
+ * Threshold-gated actions (require k-of-n approval):
+ *
+ * | Action                                       | Risk                  | Gate  |
+ * |----------------------------------------------|-----------------------|-------|
+ * | pnpm publish / npm publish                   | Irreversible registry | 2-of-2 |
+ * | git push to main / production deploy         | Live users affected   | 2-of-2 |
+ * | rm -rf / destructive file ops                | Data loss             | 2-of-2 |
+ * | Database migration / persist delete-all      | Production data       | 2-of-2 |
+ * | Read/write .env, secrets, service accounts   | Credential exposure   | 2-of-2 |
+ * | Cross-user data operations                   | Privacy violation     | 2-of-2 |
+ * | Schema deploy to production orbital          | Breaking change risk  | 1-of-2 |
+ *
+ * Routine actions (no gate): compile, validate, read files, npm install.
  */
 /**
  * Skill metadata (minimal interface for interrupt config).
@@ -846,6 +896,24 @@ interface SkillMeta {
     name: string;
     allowedTools?: string[];
 }
+/** Risk level of an agent action. */
+type ActionGate = 'none' | 'sensitive' | 'critical';
+/**
+ * Maps tool names / command patterns to their required approval gate.
+ * Used by the security layer to decide when ThresholdAuthorizer is needed.
+ */
+declare const TOOL_GATES: Record<string, ActionGate>;
+/**
+ * Command patterns that classify a shell command as critical.
+ * Matched against the command string before execution.
+ */
+declare const CRITICAL_COMMAND_PATTERNS: RegExp[];
+/**
+ * Classify a shell command's risk level.
+ * Returns 'critical' if the command matches any CRITICAL_COMMAND_PATTERNS,
+ * 'sensitive' otherwise.
+ */
+declare function classifyCommand(command: string): ActionGate;
 /**
  * Get interrupt configuration for a skill.
  *
@@ -854,4 +922,92 @@ interface SkillMeta {
  */
 declare function getInterruptConfig(_skill: SkillMeta): Record<string, boolean>;
 
-export { type CheckpointRecord as C, DEFAULT_COMPACTION_CONFIG as D, EVENT_BUDGETS as E, type GenerationSession as G, type InterruptRecord as I, MemoryManager as M, type PatternAffinity as P, SessionManager as S, type ToolApprovalPreference as T, type UserPreference as U, type SessionManagerOptions as a, type Skill as b, type SkillAgentOptions as c, type SkillAgentResult as d, type SkillLoader as e, type SkillMeta as f, type SkillRefLoader as g, createSkillAgent as h, getBudgetWarningMessage as i, getEventBudget as j, getInterruptConfig as k, type ContextCompactionConfig as l, type MemoryManagerOptions as m, MemoryOrbitalSchema as n, type ProjectContext as o, type UserFeedback as p, createSummaryPrompt as q, resumeSkillAgent as r, estimateTokens as s, needsCompaction as t };
+/**
+ * Workflow Tool Wrapper
+ *
+ * Wraps tool execution with workflow capabilities:
+ * - Retry on failure with exponential backoff
+ * - Per-tool telemetry (duration, retries, success/failure)
+ * - Timeout handling
+ *
+ * Usage:
+ * ```typescript
+ * const wrapper = createWorkflowToolWrapper({ maxRetries: 3 });
+ *
+ * const { agent } = await createSkillAgent({
+ *   skill: 'kflow-orbitals',
+ *   toolWrapper: wrapper.wrap,
+ * });
+ *
+ * // After execution
+ * const telemetry = wrapper.getTelemetry();
+ * ```
+ */
+interface WorkflowToolWrapperOptions {
+    /** Max retry attempts per tool (default: 3) */
+    maxRetries?: number;
+    /** Enable telemetry collection (default: true) */
+    enableTelemetry?: boolean;
+    /** Max execution time per tool in ms (default: 60000) */
+    timeoutMs?: number;
+    /** Initial backoff in ms (default: 1000) */
+    backoffMs?: number;
+}
+interface ToolTelemetry {
+    toolName: string;
+    durationMs: number;
+    retries: number;
+    success: boolean;
+    error?: string;
+}
+interface WorkflowToolWrapper {
+    /** Wrap a tool with retry/telemetry */
+    wrap<T extends {
+        name: string;
+        invoke: (...args: any[]) => Promise<any>;
+    }>(tool: T): T;
+    /** Get collected telemetry */
+    getTelemetry(): ToolTelemetry[];
+    /** Reset telemetry */
+    resetTelemetry(): void;
+}
+/**
+ * Create a workflow tool wrapper
+ *
+ * @param options - Wrapper configuration
+ * @returns Wrapper with wrap() and getTelemetry() methods
+ *
+ * @example
+ * ```typescript
+ * const workflow = createWorkflowToolWrapper({ maxRetries: 3 });
+ *
+ * const { agent } = await createSkillAgent({
+ *   skill: 'kflow-orbitals',
+ *   toolWrapper: workflow.wrap,
+ * });
+ *
+ * // Run agent...
+ *
+ * // Get results
+ * console.log(workflow.getTelemetry());
+ * // [{ toolName: 'generate_orbital', durationMs: 5000, retries: 1, success: true }]
+ * ```
+ */
+declare function createWorkflowToolWrapper(options?: WorkflowToolWrapperOptions): WorkflowToolWrapper;
+/**
+ * Create a workflow wrapper specifically for evaluation comparison
+ *
+ * This wrapper logs telemetry to console for debugging
+ */
+declare function createEvalWorkflowWrapper(options?: WorkflowToolWrapperOptions): {
+    wrap: <T extends {
+        name: string;
+        invoke: (...args: any[]) => Promise<any>;
+    }>(tool: T) => T;
+    /** Get collected telemetry */
+    getTelemetry(): ToolTelemetry[];
+    /** Reset telemetry */
+    resetTelemetry(): void;
+};
+
+export { type ActionGate as A, estimateTokens as B, CRITICAL_COMMAND_PATTERNS as C, DEFAULT_COMPACTION_CONFIG as D, EVENT_BUDGETS as E, needsCompaction as F, type GenerationSession as G, type InterruptRecord as I, MemoryManager as M, type PatternAffinity as P, SessionManager as S, type ToolTelemetry as T, type UserPreference as U, type WorkflowToolWrapper as W, type SessionManagerOptions as a, type Skill as b, type SkillAgent as c, type SkillAgentOptions as d, type SkillAgentResult as e, type SkillLoader as f, type SkillMeta as g, type SkillRefLoader as h, type WorkflowToolWrapperOptions as i, createEvalWorkflowWrapper as j, createSkillAgent as k, createWorkflowToolWrapper as l, getBudgetWarningMessage as m, getEventBudget as n, getInterruptConfig as o, type CheckpointRecord as p, type ContextCompactionConfig as q, resumeSkillAgent as r, type MemoryManagerOptions as s, MemoryOrbitalSchema as t, type ProjectContext as u, TOOL_GATES as v, type ToolApprovalPreference as w, type UserFeedback as x, classifyCommand as y, createSummaryPrompt as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/agent",
-  "version": "1.3.3",
+  "version": "1.6.1",
   "description": "AI agent infrastructure for Almadar orbital schema generation",
   "type": "module",
   "main": "./dist/index.js",
@@ -46,10 +46,10 @@
     "uuid": "^9.0.0",
     "zod": "^3.22.0",
     "@almadar/core": "1.0.17",
-    "@almadar/llm": "1.0.16",
     "@almadar/integrations": "1.0.15",
     "@almadar/patterns": "1.1.1",
-    "@almadar/skills": "1.2.2"
+    "@almadar/skills": "1.3.0",
+    "@almadar/llm": "1.0.17"
   },
   "peerDependencies": {
     "@langchain/core": ">=1.0.0",
@@ -71,8 +71,11 @@
       "optional": false
     }
   },
+  "optionalDependencies": {
+    "isolated-vm": "^4.7.2"
+  },
   "devDependencies": {
-    "@langchain/core": "^1.1.20",
+    "@langchain/core": "^1.1.26",
     "@langchain/langgraph": "^1.1.4",
     "@langchain/langgraph-checkpoint": "^1.0.0",
     "@types/uuid": "^9.0.0",