@almadar/agent 2.0.2 → 2.0.3

package/dist/agent/session-manager.d.ts

@@ -52,7 +52,7 @@ export declare class SessionManager {
     /**
      * Get or create a checkpointer for a session.
      */
-    getCheckpointer(threadId: string): BaseCheckpointSaver<any>;
+    getCheckpointer(threadId: string): BaseCheckpointSaver;
     /**
      * Store session metadata.
      */

package/dist/contracts.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Service Contracts for @almadar/agent
+ *
+ * Typed contracts for agent services callable from .orb schemas via
+ * `["call-service", "serviceName", "action", { params }]`.
+ *
+ * @packageDocumentation
+ */
+import type { ServiceAction, ServiceContract, ServiceEvents } from '@almadar/core';
+/** Actions available on the Session service. */
+export type SessionActions = {
+    create: {
+        params: {
+            threadId: string;
+            userId?: string;
+        };
+        result: {
+            threadId: string;
+            created: boolean;
+        };
+    };
+    get: {
+        params: {
+            threadId: string;
+        };
+        result: {
+            session: Record<string, unknown> | null;
+        };
+    };
+    list: {
+        params: {
+            userId?: string;
+        };
+        result: {
+            sessions: Array<{
+                threadId: string;
+                createdAt: number;
+            }>;
+        };
+    };
+    clear: {
+        params: {
+            threadId: string;
+        };
+        result: {
+            cleared: boolean;
+        };
+    };
+};
+/** Service contract for session management. */
+export type SessionServiceContract = ServiceContract<SessionActions>;
+/** Actions available on the Memory service. */
+export type MemoryActions = {
+    getUserPreferences: {
+        params: {
+            userId: string;
+        };
+        result: {
+            preferences: Record<string, unknown> | null;
+        };
+    };
+    updateUserPreferences: {
+        params: {
+            userId: string;
+            preferences: Record<string, unknown>;
+        };
+        result: {
+            updated: boolean;
+        };
+    };
+    recordGeneration: {
+        params: {
+            userId: string;
+            prompt: string;
+            result: string;
+            skill?: string;
+        };
+        result: {
+            sessionId: string;
+        };
+    };
+    getGenerationHistory: {
+        params: {
+            userId: string;
+            limit?: number;
+        };
+        result: {
+            sessions: Array<{
+                id: string;
+                prompt: string;
+                createdAt: number;
+            }>;
+        };
+    };
+};
+/** Service contract for user memory and generation history. */
+export type MemoryServiceContract = ServiceContract<MemoryActions>;
+/** Actions available on the Agent service. */
+export type AgentActions = {
+    sendMessage: {
+        params: {
+            message: string;
+            threadId?: string;
+            skill?: string;
+            context?: Record<string, unknown>;
+        };
+        result: {
+            response: string;
+            threadId: string;
+            toolCalls: unknown[];
+        };
+    };
+    cancelGeneration: {
+        params: {
+            threadId: string;
+        };
+        result: {
+            cancelled: boolean;
+        };
+    };
+};
+/** Service contract for the AI agent itself. */
+export type AgentServiceContract = ServiceContract<AgentActions>;
+/** Events emitted by the state sync manager. */
+export type StateSyncEventMap = {
+    STATE_CHANGE: {
+        path: string;
+        value: unknown;
+        source: string;
+        timestamp: number;
+    };
+    STATE_RECONCILED: {
+        path: string;
+        resolvedValue: unknown;
+        strategy: string;
+    };
+    CONFLICT_DETECTED: {
+        path: string;
+        localValue: unknown;
+        remoteValue: unknown;
+    };
+    REMOTE_CHANGE: {
+        path: string;
+        value: unknown;
+        source: string;
+        timestamp: number;
+    };
+    CONFIG_UPDATED: {
+        syncInterval: number;
+        conflictResolution: string;
+    };
+    SYNC_REQUIRED: {
+        pendingChanges: number;
+    };
+};
+/** Events emitted by the online eval sampler. */
+export type EvalSamplerEventMap = {
+    EVAL_SAMPLE_DROPPED: {
+        reason: string;
+    };
+    EVAL_SAMPLE_COLLECTED: {
+        sampleId: string;
+        category: string;
+    };
+    EVAL_SAMPLE_VALIDATED: {
+        sampleId: string;
+        passed: boolean;
+        score: number;
+    };
+    EVAL_VALIDATION_ERROR: {
+        sampleId: string;
+        error: string;
+    };
+    EVAL_ALERT: {
+        type: string;
+        message: string;
+        threshold: number;
+        actual: number;
+    };
+};
+/** Events emitted by agent sessions. */
+export type AgentSessionEventMap = {
+    SESSION_CREATED: {
+        threadId: string;
+        userId: string;
+    };
+    SESSION_COMPACTED: {
+        threadId: string;
+        messagesBefore: number;
+        messagesAfter: number;
+    };
+    SESSION_CLEARED: {
+        threadId: string;
+    };
+    AGENT_MESSAGE_SENT: {
+        threadId: string;
+        messageLength: number;
+    };
+    AGENT_RESPONSE_RECEIVED: {
+        threadId: string;
+        tokensUsed: number;
+        latencyMs: number;
+    };
+    AGENT_GENERATION_CANCELLED: {
+        threadId: string;
+    };
+};
+/** Combined event map for all agent events. */
+export type AgentEventMap = StateSyncEventMap & EvalSamplerEventMap & AgentSessionEventMap;
+/** Typed event emitter for agent events. */
+export type AgentServiceEvents = ServiceEvents<AgentEventMap>;
+/** All agent service contracts grouped by service name. */
+export interface AgentServiceContracts {
+    session: SessionServiceContract;
+    memory: MemoryServiceContract;
+    agent: AgentServiceContract;
+}
+export type { ServiceAction, ServiceContract };

package/dist/index.d.ts

@@ -57,3 +57,4 @@ export { executeSandboxed } from './tools/sandbox-executor.js';
 export type { SandboxOptions, SandboxResult } from './tools/sandbox-executor.js';
 export { classifyCommand, TOOL_GATES, CRITICAL_COMMAND_PATTERNS } from './agent/interrupt-config.js';
 export type { ActionGate } from './agent/interrupt-config.js';
+export type { SessionActions, SessionServiceContract, MemoryActions, MemoryServiceContract, AgentActions, AgentServiceContract, AgentServiceContracts, } from './contracts.js';

package/dist/index.js

@@ -1151,14 +1151,15 @@ function createOrbitalBatchSubagentTool(options = {}) {
     }
   };
   const batchTool = tool(
-    async ({ orbitals, options: batchOptions }) => {
-      if (!orbitals || orbitals.length === 0) {
+    async ({ orbitals: rawOrbitals, options: batchOptions }) => {
+      if (!rawOrbitals || rawOrbitals.length === 0) {
         return JSON.stringify({
           success: false,
           error: "No orbitals provided for batch generation.",
           orbitals: []
         });
       }
+      const orbitals = rawOrbitals;
       console.log(`[OrbitalBatchSubagent] Starting batch generation for ${orbitals.length} orbitals`);
       try {
         emitEvent("batch", 0, 1, "message", {
@@ -1288,8 +1289,7 @@ var init_orbital_batch_subagent = __esm({
     init_shared();
     init_batch();
     OrbitalBatchInputSchema = z.object({
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      orbitals: z.array(z.any()).describe("Array of OrbitalUnits to generate"),
+      orbitals: z.array(z.record(z.unknown())).describe("Array of OrbitalUnits to generate"),
       options: z.object({
         mode: z.enum(["single-call", "parallel-individual", "adaptive"]).optional().default("adaptive"),
         batchSize: z.number().optional(),
@@ -6068,7 +6068,6 @@ var SessionManager = class {
   /**
    * Get or create a checkpointer for a session.
    */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   getCheckpointer(threadId) {
     if (this.mode === "firestore" && this.firestoreCheckpointer) {
       return this.firestoreCheckpointer;