@jamesaphoenix/tx-core 0.4.5 → 0.5.1

package/dist/services/llm-service.js

@@ -1,45 +1,67 @@
-import { Context, Effect, Layer, Config, Option, Schema } from "effect";
-import { LlmUnavailableError } from "../errors.js";
-/**
- * Options for LLM text completion.
- */
-export const LlmOptionsSchema = Schema.Struct({
-    /** Model to use (default varies by backend) */
-    model: Schema.optional(Schema.String),
-    /** Maximum tokens in response */
-    maxTokens: Schema.optional(Schema.Number),
-    /** Temperature for generation (0-1) */
-    temperature: Schema.optional(Schema.Number)
-});
 /**
- * LlmService provides centralized LLM text completion with swappable backends.
+ * LlmService — Centralized LLM completion service
+ *
+ * Provides a unified Effect interface for text completions, used by
+ * CompactionService, QueryExpansionService, CandidateExtractorService, etc.
  *
  * Backends:
- * - claude-agent-sdk: Uses @anthropic-ai/claude-agent-sdk query() (primary)
- * - anthropic-sdk: Uses @anthropic-ai/sdk messages.create() (fallback)
- * - noop: Returns empty string (tests, core commands)
+ * - AgentSdk: Uses Claude Agent SDK query() with maxTurns=1, no tools (no API key needed)
+ * - Anthropic: Direct @anthropic-ai/sdk messages.create() (needs ANTHROPIC_API_KEY)
+ * - Noop: Returns failures gracefully (tests, minimal layer)
+ * - Auto: Agent SDK → Anthropic → Noop
+ */
+import { Context, Effect, Layer, Config, Option } from "effect";
+import { LlmUnavailableError } from "../errors.js";
+// =============================================================================
+// Service Definition
+// =============================================================================
+/**
+ * LlmService provides text completions from an LLM backend.
  *
- * Design: See DD-022 for full specification.
+ * This is the single point of contact for all LLM completion calls in tx.
+ * Services like CompactionService, QueryExpansionService, and
+ * CandidateExtractorService depend on this instead of managing their own
+ * SDK clients.
  */
 export class LlmService extends Context.Tag("LlmService")() {
 }
+// =============================================================================
+// Model Mapping
+// =============================================================================
 /**
- * Noop implementation — returns empty string for all completions.
- * Used in test layers and core commands where no LLM is needed.
+ * Map full Anthropic model IDs to Agent SDK shorthands.
+ * Agent SDK uses "haiku", "sonnet", "opus" rather than full IDs.
+ */
+const toAgentSdkModel = (model) => {
+    if (model.includes("haiku"))
+        return "haiku";
+    if (model.includes("sonnet"))
+        return "sonnet";
+    if (model.includes("opus"))
+        return "opus";
+    return undefined;
+};
+// =============================================================================
+// Noop Implementation
+// =============================================================================
+/**
+ * Noop implementation — returns failures for all completions.
+ * Used in test layers and minimal layers where no LLM is needed.
  */
 export const LlmServiceNoop = Layer.succeed(LlmService, {
-    complete: (_prompt, _options) => Effect.succeed(""),
+    complete: (_request) => Effect.fail(new LlmUnavailableError({ reason: "No LLM backend configured" })),
     isAvailable: () => Effect.succeed(false),
-    backend: () => "noop"
 });
+// =============================================================================
+// Agent SDK Implementation
+// =============================================================================
 /**
- * Claude Agent SDK implementation.
- * Uses query() from @anthropic-ai/claude-agent-sdk with maxTurns: 1 and no tools
- * for single-turn text completion.
+ * Agent SDK implementation using Claude Agent SDK query() with maxTurns=1.
  *
- * Reads ANTHROPIC_API_KEY automatically from environment.
+ * Self-contained: dynamically imports @anthropic-ai/claude-agent-sdk directly.
+ * No ANTHROPIC_API_KEY required — uses Claude Code's built-in authentication.
  */
-export const LlmServiceClaudeAgentSdk = Layer.effect(LlmService, Effect.gen(function* () {
+export const LlmServiceAgentSdk = Layer.effect(LlmService, Effect.gen(function* () {
     // Dynamic import of Claude Agent SDK (optional peer dependency)
     const queryFn = yield* Effect.tryPromise({
         try: async () => {
@@ -48,125 +70,191 @@ export const LlmServiceClaudeAgentSdk = Layer.effect(LlmService, Effect.gen(func
             return mod.query;
         },
         catch: (e) => new LlmUnavailableError({
-            reason: `@anthropic-ai/claude-agent-sdk not installed: ${e instanceof Error ? e.message : String(e)}`
-        })
+            reason: `@anthropic-ai/claude-agent-sdk not installed: ${e instanceof Error ? e.message : String(e)}`,
+        }),
     });
     return {
-        complete: (prompt, options) => Effect.tryPromise({
-            try: async () => {
-                let result = "";
-                let errorMessage = null;
-                for await (const message of queryFn({
-                    prompt,
-                    options: {
-                        maxTurns: 1,
-                        allowedTools: [],
-                        ...(options?.model ? { model: options.model } : {})
+        complete: (request) => Effect.gen(function* () {
+            const startTime = Date.now();
+            const model = request.model ?? "claude-haiku-4-20250514";
+            const text = yield* Effect.tryPromise({
+                try: async () => {
+                    let resultText = "";
+                    let assistantText = "";
+                    let errorMessage = null;
+                    // Build options — structured output may need multiple turns
+                    const options = {
+                        model: toAgentSdkModel(model),
+                    };
+                    if (request.jsonSchema) {
+                        options.outputFormat = {
+                            type: "json_schema",
+                            schema: request.jsonSchema,
+                        };
                     }
-                })) {
-                    if (message.type === "result") {
-                        if (message.subtype === "success" && message.result) {
-                            result = message.result;
+                    else {
+                        // For plain text completions, restrict to 1 turn
+                        options.maxTurns = 1;
+                    }
+                    for await (const message of queryFn({
+                        prompt: request.prompt,
+                        options,
+                    })) {
+                        const msg = message;
+                        // Capture assistant text from message.message.content blocks
+                        if (msg.type === "assistant" && msg.message) {
+                            const inner = msg.message;
+                            if (inner.content) {
+                                for (const block of inner.content) {
+                                    if (block.type === "text" && block.text) {
+                                        assistantText = block.text;
+                                    }
+                                }
+                            }
                         }
-                        else if (message.subtype !== "success") {
-                            errorMessage = message.errors?.join(", ") ?? message.subtype ?? "unknown error";
+                        if (msg.type === "result") {
+                            if (msg.subtype === "success") {
+                                // Prefer structured_output (already parsed) when using jsonSchema
+                                if (msg.structured_output) {
+                                    resultText = JSON.stringify(msg.structured_output);
+                                }
+                                else if (typeof msg.result === "string") {
+                                    resultText = msg.result;
+                                }
+                            }
+                            else {
+                                const errors = msg.errors;
+                                errorMessage =
+                                    errors?.join(", ") ?? String(msg.subtype ?? "unknown error");
+                            }
                         }
                     }
-                }
-                if (errorMessage) {
-                    return Promise.reject(new Error(`Agent SDK error: ${errorMessage}`));
-                }
-                return result;
-            },
-            catch: (e) => new LlmUnavailableError({
-                reason: `Claude Agent SDK call failed: ${e instanceof Error ? e.message : String(e)}`
-            })
+                    if (errorMessage) {
+                        return Promise.reject(new Error(`Agent SDK error: ${errorMessage}`));
+                    }
+                    // Fall back to assistant text if result was empty
+                    return resultText || assistantText;
+                },
+                catch: (e) => new LlmUnavailableError({
+                    reason: `Agent SDK completion failed: ${e instanceof Error ? e.message : String(e)}`,
+                }),
+            });
+            return {
+                text,
+                model,
+                durationMs: Date.now() - startTime,
+            };
         }),
         isAvailable: () => Effect.succeed(true),
-        backend: () => "claude-agent-sdk"
     };
 }));
+// =============================================================================
+// Anthropic SDK Implementation
+// =============================================================================
 /**
- * Anthropic SDK implementation.
- * Uses client.messages.create() from @anthropic-ai/sdk.
- * Extracted from the original QueryExpansionServiceLive.
+ * Direct Anthropic SDK implementation.
  *
- * Requires ANTHROPIC_API_KEY environment variable.
+ * Uses @anthropic-ai/sdk with ANTHROPIC_API_KEY for environments without
+ * Agent SDK access (e.g., standalone servers, CI pipelines).
  */
-export const LlmServiceAnthropicSdk = Layer.effect(LlmService, Effect.gen(function* () {
+export const LlmServiceAnthropic = Layer.effect(LlmService, Effect.gen(function* () {
     // Read API key from environment
     const apiKey = yield* Config.string("ANTHROPIC_API_KEY").pipe(Effect.mapError(() => new LlmUnavailableError({
-        reason: "ANTHROPIC_API_KEY environment variable is not set"
+        reason: "ANTHROPIC_API_KEY environment variable is not set",
     })));
-    // Eagerly initialize the client during layer construction.
-    // This avoids a mutable closure variable that is not fiber-safe.
-    const Anthropic = yield* Effect.tryPromise({
-        try: async () => {
-            // @ts-ignore - @anthropic-ai/sdk is an optional peer dependency
-            const mod = await import("@anthropic-ai/sdk");
-            return mod.default;
-        },
-        catch: (e) => new LlmUnavailableError({
-            reason: `@anthropic-ai/sdk not installed: ${e instanceof Error ? e.message : String(e)}`
-        })
+    // Lazy-load client
+    let client = null;
+    const ensureClient = Effect.gen(function* () {
+        if (client)
+            return client;
+        const Anthropic = yield* Effect.tryPromise({
+            try: async () => {
+                // @ts-ignore - @anthropic-ai/sdk is an optional peer dependency
+                const mod = await import("@anthropic-ai/sdk");
+                return mod.default;
+            },
+            catch: () => new LlmUnavailableError({
+                reason: "@anthropic-ai/sdk is not installed",
+            }),
+        });
+        // Cast required: SDK's overloaded create() signatures are structurally
+        // incompatible with our simplified AnthropicClient interface
+        client = new Anthropic({ apiKey });
+        return client;
     });
-    const anthropicClient = new Anthropic({ apiKey });
     return {
-        complete: (prompt, options) => Effect.gen(function* () {
-            const anthropic = anthropicClient;
+        complete: (request) => Effect.gen(function* () {
+            const startTime = Date.now();
+            const anthropic = yield* ensureClient;
+            const model = request.model ?? "claude-haiku-4-20250514";
             const response = yield* Effect.tryPromise({
                 try: () => anthropic.messages.create({
-                    model: options?.model ?? "claude-haiku-4-5-20251001",
-                    max_tokens: options?.maxTokens ?? 1024,
-                    messages: [{ role: "user", content: prompt }]
+                    model,
+                    max_tokens: request.maxTokens ?? 2048,
+                    messages: [
+                        {
+                            role: "user",
+                            content: request.prompt,
+                        },
+                    ],
+                    ...(request.jsonSchema ? {
+                        output_config: {
+                            format: {
+                                type: "json_schema",
+                                schema: request.jsonSchema,
+                            },
+                        },
+                    } : {}),
                 }),
                 catch: (e) => new LlmUnavailableError({
-                    reason: `Anthropic API call failed: ${e instanceof Error ? e.message : String(e)}`
-                })
+                    reason: `Anthropic API call failed: ${String(e)}`,
+                }),
             });
-            const textContent = response.content.find(c => c.type === "text");
-            return textContent?.text ?? "";
+            const textContent = response.content.find((c) => c.type === "text");
+            return {
+                text: textContent?.text ?? "",
+                model,
+                tokensUsed: (response.usage?.input_tokens ?? 0) +
+                    (response.usage?.output_tokens ?? 0),
+                durationMs: Date.now() - startTime,
+            };
         }),
         isAvailable: () => Effect.succeed(true),
-        backend: () => "anthropic-sdk"
     };
 }));
+// =============================================================================
+// Auto-Detecting Implementation
+// =============================================================================
 /**
- * Auto-detecting layer.
- * Priority: TX_LLM_BACKEND env override > Claude Agent SDK > Anthropic SDK > Noop.
+ * Auto-detecting layer that selects the best available LLM backend.
+ *
+ * Priority:
+ * 1. Agent SDK available → LlmServiceAgentSdk (no API key needed)
+ * 2. ANTHROPIC_API_KEY set → LlmServiceAnthropic
+ * 3. Neither → LlmServiceNoop (graceful degradation)
  */
 export const LlmServiceAuto = Layer.unwrapEffect(Effect.gen(function* () {
-    // Check for explicit backend override
-    const backendOverride = yield* Config.string("TX_LLM_BACKEND").pipe(Effect.option);
-    if (Option.isSome(backendOverride)) {
-        const backend = backendOverride.value.trim().toLowerCase();
-        switch (backend) {
-            case "claude-agent-sdk":
-                return LlmServiceClaudeAgentSdk;
-            case "anthropic-sdk":
-                return LlmServiceAnthropicSdk;
-            case "noop":
-                return LlmServiceNoop;
-        }
-    }
-    // Auto-detect: try Claude Agent SDK first
-    const agentSdkAvailable = yield* Effect.tryPromise(
-    // @ts-ignore - @anthropic-ai/claude-agent-sdk is an optional peer dependency
-    () => import("@anthropic-ai/claude-agent-sdk").then(() => true)).pipe(Effect.orElseSucceed(() => false));
+    // Priority 1: Try Agent SDK (no API key required)
+    const agentSdkAvailable = yield* Effect.tryPromise({
+        try: async () => {
+            // @ts-ignore - @anthropic-ai/claude-agent-sdk is an optional peer dependency
+            await import("@anthropic-ai/claude-agent-sdk");
+            return true;
+        },
+        catch: () => false,
+    }).pipe(Effect.catchAll(() => Effect.succeed(false)));
     if (agentSdkAvailable) {
-        return LlmServiceClaudeAgentSdk;
+        yield* Effect.logDebug("LlmService: Using Agent SDK (no API key required)");
+        return LlmServiceAgentSdk;
     }
-    // Try Anthropic SDK (needs API key + package)
-    const apiKey = yield* Config.string("ANTHROPIC_API_KEY").pipe(Effect.option);
-    if (Option.isSome(apiKey) && apiKey.value.trim().length > 0) {
-        const anthropicAvailable = yield* Effect.tryPromise(
-        // @ts-ignore - @anthropic-ai/sdk is an optional peer dependency
-        () => import("@anthropic-ai/sdk").then(() => true)).pipe(Effect.orElseSucceed(() => false));
-        if (anthropicAvailable) {
-            return LlmServiceAnthropicSdk;
-        }
+    // Priority 2: Anthropic SDK with API key
+    const anthropicKey = yield* Config.string("ANTHROPIC_API_KEY").pipe(Effect.option);
+    if (Option.isSome(anthropicKey) && anthropicKey.value.trim().length > 0) {
+        yield* Effect.logDebug("LlmService: Using Anthropic SDK (ANTHROPIC_API_KEY detected)");
+        return LlmServiceAnthropic;
     }
-    // Fallback to noop
+    // Priority 3: Noop fallback
+    yield* Effect.logDebug("LlmService: Using noop (no LLM backend available)");
     return LlmServiceNoop;
 }));
 //# sourceMappingURL=llm-service.js.map

package/dist/services/llm-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm-service.js","sourceRoot":"","sources":["../../src/services/llm-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"llm-service.js","sourceRoot":"","sources":["../../src/services/llm-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AA0DlD,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,OAAO,UAAW,SAAQ,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAQtD;CAAG;AAEN,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,eAAe,GAAG,CAAC,KAAa,EAAsB,EAAE;IAC5D,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAA;IAC7C,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IACzC,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE;IACtD,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CACrB,MAAM,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC,CAAC;IAC/E,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;CACzC,CAAC,CAAA;AAEF,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAC5C,UAAU,EACV,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,gEAAgE;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACvC,GAAG,EAAE,KAAK,IAAI,EAAE;YACd,6EAA6E;YAC7E,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAA;YAC1D,OAAO,GAAG,CAAC,KAAgF,CAAA;QAC7F,CAAC;QACD,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,IAAI,mBAAmB,CAAC;YACtB,MAAM,EAAE,iDAAiD,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;SACtG,CAAC;KACL,CAAC,CAAA;IAEF,OAAO;QACL,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CACpB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,yBAAyB,CAAA;YAExD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;gBACpC,GAAG,EAAE,KAAK,IAAI,EAAE;oBACd,IAAI,UAAU,GAAG,EAAE,CAAA;oBACnB,IAAI,aAAa,GAAG,EAAE,CAAA;oBACtB,IAAI,YAAY,GAAkB,IAAI,CAAA;oBAEtC,4DAA4D;oBAC5D,MAAM,OAAO,GAA4B;wBACvC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC;qBAC9B,CAAA;oBACD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;wBACvB,OAAO,CAAC,YAAY,GAAG;4BACrB,IAAI,EAAE,aAAa;4BACnB,MAAM,EAAE,OAAO,CAAC,UAAU;yBAC3B,CAAA;oBACH,CAAC;yBAAM,CAAC;wBACN,iDAAiD;wBACjD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;oBACtB,CAAC;oBAED,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,OAAO,CAAC;wBAClC,MAAM,EAAE,OAAO,CAAC,MAAM;wBACtB,OAAO;qBACR,CAAC,EAAE,CAAC;wBACH,MAAM,GAAG,GAAG,OAAkC,CAAA;wBAE9C,6DAA6D;wBAC7D,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;4BAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,OAA+D,CAAA;4BACjF,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gCAClB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oCAClC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;wCACxC,aAAa,GAAG,KAAK,CAAC,IAAI,CAAA;oCAC5B,CAAC;gCACH,CAAC;4BACH,CAAC;wBACH,CAAC;wBAED,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;4BAC1B,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gCAC9B,kEAAkE;gCAClE,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC;oCAC1B,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,iBAA4C,CAAC,CAAA;gCAC/E,CAAC;qCAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oCAC1C,UAAU,GAAG,GAAG,CAAC,MAAM,CAAA;gCACzB,CAAC;4BACH,CAAC;iCAAM,CAAC;gCACN,MAAM,MAAM,GAAG,GAAG,CAAC,MAA8B,CAAA;gCACjD,YAAY;oCACV,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,eAAe,CAAC,CAAA;4BAChE,CAAC;wBACH,CAAC;oBACH,CAAC;oBAED,IAAI,YAAY,EAAE,CAAC;wBACjB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,YAAY,EAAE,CAAC,CAAC,CAAA;oBACtE,CAAC;oBAED,kDAAkD;oBAClD,OAAO,UAAU,IAAI,aAAa,CAAA;gBACpC,CAAC;gBACD,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,IAAI,mBAAmB,CAAC;oBACtB,MAAM,EAAE,gCAAgC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;iBACrF,CAAC;aACL,CAAC,CAAA;YAEF,OAAO;gBACL,IAAI;gBACJ,KAAK;gBACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAA;QACH,CAAC,CAAC;QAEJ,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;KACxC,CAAA;AACH,CAAC,CAAC,CACH,CAAA;AAED,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC,MAAM,CAC7C,UAAU,EACV,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,gCAAgC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAC3D,MAAM,CAAC,QAAQ,CACb,GAAG,EAAE,CACH,IAAI,mBAAmB,CAAC;QACtB,MAAM,EAAE,mDAAmD;KAC5D,CAAC,CACL,CACF,CAAA;IAED,mBAAmB;IACnB,IAAI,MAAM,GAA2B,IAAI,CAAA;IAEzC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACvC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QAEzB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YACzC,GAAG,EAAE,KAAK,IAAI,EAAE;gBACd,gEAAgE;gBAChE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAA;gBAC7C,OAAO,GAAG,CAAC,OAAO,CAAA;YACpB,CAAC;YACD,KAAK,EAAE,GAAG,EAAE,CACV,IAAI,mBAAmB,CAAC;gBACtB,MAAM,EAAE,oCAAoC;aAC7C,CAAC;SACL,CAAC,CAAA;QAEF,uEAAuE;QACvE,6DAA6D;QAC7D,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAA+B,CAAA;QAChE,OAAO,MAAM,CAAA;IACf,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CACpB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,YAAY,CAAA;YACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,yBAAyB,CAAA;YAExD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;gBACxC,GAAG,EAAE,GAAG,EAAE,CACR,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACxB,KAAK;oBACL,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;oBACrC,QAAQ,EAAE;wBACR;4BACE,IAAI,EAAE,MAAM;4BACZ,OAAO,EAAE,OAAO,CAAC,MAAM;yBACxB;qBACF;oBACD,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;wBACvB,aAAa,EAAE;4BACb,MAAM,EAAE;gCACN,IAAI,EAAE,aAAa;gCACnB,MAAM,EAAE,OAAO,CAAC,UAAU;6BAC3B;yBACF;qBACF,CAAC,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC;gBACJ,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,IAAI,mBAAmB,CAAC;oBACtB,MAAM,EAAE,8BAA8B,MAAM,CAAC,CAAC,CAAC,EAAE;iBAClD,CAAC;aACL,CAAC,CAAA;YAEF,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;YACnE,OAAO;gBACL,IAAI,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE;gBAC7B,KAAK;gBACL,UAAU,EACR,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;oBACnC,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC,CAAC;gBACtC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAA;QACH,CAAC,CAAC;QAEJ,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;KACxC,CAAA;AACH,CAAC,CAAC,CACH,CAAA;AAED,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,YAAY,CAC9C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,kDAAkD;IAClD,MAAM,iBAAiB,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACjD,GAAG,EAAE,KAAK,IAAI,EAAE;YACd,6EAA6E;YAC7E,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAA;YAC9C,OAAO,IAAI,CAAA;QACb,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK;KACnB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAErD,IAAI,iBAAiB,EAAE,CAAC;QACtB,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,mDAAmD,CAAC,CAAA;QAC3E,OAAO,kBAAkB,CAAA;IAC3B,CAAC;IAED,yCAAyC;IACzC,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CACjE,MAAM,CAAC,MAAM,CACd,CAAA;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxE,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CACpB,8DAA8D,CAC/D,CAAA;QACD,OAAO,mBAAmB,CAAA;IAC5B,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CACpB,mDAAmD,CACpD,CAAA;IACD,OAAO,cAAc,CAAA;AACvB,CAAC,CAAC,CACH,CAAA"}

package/dist/services/message-service.d.ts

@@ -0,0 +1,57 @@
+/**
+ * MessageService - PRD-024 Agent Outbox
+ *
+ * Service layer for agent-to-agent messaging.
+ * Read-only inbox (no side effects on read), explicit ack, cursor-based fan-out.
+ */
+import { Context, Effect, Layer } from "effect";
+import { MessageRepository } from "../repo/message-repo.js";
+import { DatabaseError, MessageNotFoundError, MessageAlreadyAckedError, ValidationError } from "../errors.js";
+import type { Message, SendMessageInput, InboxFilter } from "@jamesaphoenix/tx-types";
+declare const MessageService_base: Context.TagClass<MessageService, "MessageService", {
+    /**
+     * Send a message to a channel.
+     * Returns the created message.
+     */
+    readonly send: (input: SendMessageInput) => Effect.Effect<Message, ValidationError | DatabaseError>;
+    /**
+     * Read messages from a channel's inbox.
+     * This is a pure read — no side effects, no status changes.
+     * Use afterId for cursor-based reading (Kafka-style fan-out).
+     */
+    readonly inbox: (filter: InboxFilter) => Effect.Effect<readonly Message[], DatabaseError>;
+    /**
+     * Acknowledge a single message by ID.
+     * Transitions from pending to acked.
+     */
+    readonly ack: (id: number) => Effect.Effect<Message, MessageNotFoundError | MessageAlreadyAckedError | DatabaseError>;
+    /**
+     * Acknowledge all pending messages on a channel.
+     * Returns the number of messages acked.
+     */
+    readonly ackAll: (channel: string) => Effect.Effect<number, DatabaseError>;
+    /**
+     * Count pending (unacked) messages on a channel.
+     */
+    readonly pending: (channel: string) => Effect.Effect<number, DatabaseError>;
+    /**
+     * Garbage collect old messages.
+     * Deletes expired messages and optionally acked messages older than a threshold.
+     */
+    readonly gc: (options?: {
+        ackedOlderThanHours?: number;
+    }) => Effect.Effect<{
+        expired: number;
+        acked: number;
+    }, DatabaseError>;
+    /**
+     * Find all messages with a given correlation ID.
+     * Used for request/reply patterns.
+     */
+    readonly findReplies: (correlationId: string) => Effect.Effect<readonly Message[], DatabaseError>;
+}>;
+export declare class MessageService extends MessageService_base {
+}
+export declare const MessageServiceLive: Layer.Layer<MessageService, never, MessageRepository>;
+export {};
+//# sourceMappingURL=message-service.d.ts.map

package/dist/services/message-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-service.d.ts","sourceRoot":"","sources":["../../src/services/message-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EAChB,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;;IAKjF;;;OAGG;mBACY,CACb,KAAK,EAAE,gBAAgB,KACpB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAAC;IAE5D;;;;OAIG;oBACa,CACd,MAAM,EAAE,WAAW,KAChB,MAAM,CAAC,MAAM,CAAC,SAAS,OAAO,EAAE,EAAE,aAAa,CAAC;IAErD;;;OAGG;kBACW,CACZ,EAAE,EAAE,MAAM,KACP,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,wBAAwB,GAAG,aAAa,CAAC;IAE5F;;;OAGG;qBACc,CACf,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;IAEzC;;OAEG;sBACe,CAChB,OAAO,EAAE,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;IAEzC;;;OAGG;iBACU,CAAC,OAAO,CAAC,EAAE;QACtB,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAC7B,KAAK,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,aAAa,CAAC;IAEtE;;;OAGG;0BACmB,CACpB,aAAa,EAAE,MAAM,KAClB,MAAM,CAAC,MAAM,CAAC,SAAS,OAAO,EAAE,EAAE,aAAa,CAAC;;AAzDzD,qBAAa,cAAe,SAAQ,mBA2DjC;CAAG;AAEN,eAAO,MAAM,kBAAkB,uDAwF9B,CAAA"}

package/dist/services/message-service.js

@@ -0,0 +1,78 @@
+/**
+ * MessageService - PRD-024 Agent Outbox
+ *
+ * Service layer for agent-to-agent messaging.
+ * Read-only inbox (no side effects on read), explicit ack, cursor-based fan-out.
+ */
+import { Context, Effect, Layer } from "effect";
+import { MessageRepository } from "../repo/message-repo.js";
+import { MessageNotFoundError, MessageAlreadyAckedError, ValidationError } from "../errors.js";
+export class MessageService extends Context.Tag("MessageService")() {
+}
+export const MessageServiceLive = Layer.effect(MessageService, Effect.gen(function* () {
+    const repo = yield* MessageRepository;
+    return {
+        send: (input) => Effect.gen(function* () {
+            if (input.ttlSeconds !== undefined && input.ttlSeconds <= 0) {
+                return yield* Effect.fail(new ValidationError({ reason: "ttlSeconds must be positive" }));
+            }
+            const now = new Date();
+            const expiresAt = input.ttlSeconds
+                ? new Date(now.getTime() + input.ttlSeconds * 1000)
+                : null;
+            return yield* repo.insert({
+                channel: input.channel,
+                sender: input.sender,
+                content: input.content,
+                correlationId: input.correlationId ?? null,
+                taskId: input.taskId ?? null,
+                metadata: JSON.stringify(input.metadata ?? {}),
+                createdAt: now.toISOString(),
+                expiresAt: expiresAt?.toISOString() ?? null
+            });
+        }),
+        inbox: (filter) => repo.findByChannel({
+            channel: filter.channel,
+            afterId: filter.afterId,
+            limit: filter.limit,
+            sender: filter.sender,
+            correlationId: filter.correlationId,
+            includeAcked: filter.includeAcked,
+            excludeExpired: filter.excludeExpired
+        }),
+        ack: (id) => Effect.gen(function* () {
+            const message = yield* repo.findById(id);
+            if (!message) {
+                return yield* Effect.fail(new MessageNotFoundError({ id }));
+            }
+            if (message.status === "acked") {
+                return yield* Effect.fail(new MessageAlreadyAckedError({ id }));
+            }
+            const ackedAt = new Date().toISOString();
+            yield* repo.markAcked(id, ackedAt);
+            // Re-fetch to return updated message
+            const updated = yield* repo.findById(id);
+            if (!updated) {
+                return yield* Effect.fail(new MessageNotFoundError({ id }));
+            }
+            return updated;
+        }),
+        ackAll: (channel) => repo.markAckedByChannel(channel, new Date().toISOString()),
+        pending: (channel) => repo.countPending(channel),
+        gc: (options) => Effect.gen(function* () {
+            const now = new Date();
+            // Delete expired messages
+            const expired = yield* repo.deleteExpired(now.toISOString());
+            // Delete old acked messages if threshold provided
+            let acked = 0;
+            const hours = options?.ackedOlderThanHours;
+            if (hours !== undefined && hours >= 0) {
+                const threshold = new Date(now.getTime() - hours * 60 * 60 * 1000);
+                acked = yield* repo.deleteAcked(threshold.toISOString());
+            }
+            return { expired, acked };
+        }),
+        findReplies: (correlationId) => repo.findByCorrelationId(correlationId)
+    };
+}));
+//# sourceMappingURL=message-service.js.map

package/dist/services/message-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-service.js","sourceRoot":"","sources":["../../src/services/message-service.ts"],"names":[],"mappings":"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"}

package/dist/services/orchestrator-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator-service.d.ts","sourceRoot":"","sources":["../../src/services/orchestrator-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAQ,KAAK,EAAE,MAAM,QAAQ,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAEnF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAC1C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;;IAiBG;;;OAGG;oBACa,CACd,MAAM,CAAC,EAAE,kBAAkB,KACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC;IAE3D;;;OAGG;mBACY,CACb,QAAQ,EAAE,OAAO,KACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC;IAE3D;;OAEG;qBACc,MAAM,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,aAAa,CAAC;IAEtE;;;;OAIG;wBACiB,MAAM,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,aAAa,GAAG,iBAAiB,CAAC;;AA7BpG,qBAAa,mBAAoB,SAAQ,wBA+BtC;CAAG;AAEN,eAAO,MAAM,uBAAuB,uJAmTnC,CAAA"}
+{"version":3,"file":"orchestrator-service.d.ts","sourceRoot":"","sources":["../../src/services/orchestrator-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAQ,KAAK,EAAE,MAAM,QAAQ,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAEnF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAC1C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;;IAiBG;;;OAGG;oBACa,CACd,MAAM,CAAC,EAAE,kBAAkB,KACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC;IAE3D;;;OAGG;mBACY,CACb,QAAQ,EAAE,OAAO,KACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC;IAE3D;;OAEG;qBACc,MAAM,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,aAAa,CAAC;IAEtE;;;;OAIG;wBACiB,MAAM,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,aAAa,GAAG,iBAAiB,CAAC;;AA7BpG,qBAAa,mBAAoB,SAAQ,wBA+BtC;CAAG;AAEN,eAAO,MAAM,uBAAuB,uJAiSnC,CAAA"}