agent-bober 0.15.0 → 0.17.0

package/dist/providers/factory.js

@@ -2,6 +2,8 @@ import { AnthropicAdapter } from "./anthropic.js";
 import { OpenAIAdapter } from "./openai.js";
 import { GoogleAdapter } from "./google.js";
 import { OpenAICompatAdapter } from "./openai-compat.js";
+import { ClaudeCodeAdapter } from "./claude-code.js";
+import { execa } from "execa";
 import { resolveProviderModel } from "../orchestrator/model-resolver.js";
 // ── Deterministic stub (BOBER_TEST_DETERMINISTIC) ─────────────────────────────
 //
@@ -26,15 +28,39 @@ class DeterministicStubClient {
         };
     }
 }
+const defaultBinaryProbe = async (binary) => {
+    try {
+        const r = await execa(binary, ["--version"], { reject: false, timeout: 5_000 });
+        return r.exitCode === 0;
+    }
+    catch {
+        return false; // ENOENT → not on PATH
+    }
+};
+/**
+ * Verify the claude CLI binary is on PATH. Throws an Error naming the binary
+ * when it is absent. Call this before using the claude-code provider.
+ *
+ * @param binary - CLI binary name/path (default "claude").
+ * @param probe - Injectable PATH-check function (default uses execa; override in tests).
+ */
+export async function preflightClaudeBinary(binary = "claude", probe = defaultBinaryProbe) {
+    const ok = await probe(binary);
+    if (!ok) {
+        throw new Error(`The "${binary}" CLI was not found on PATH. The claude-code provider ` +
+            `requires the Claude Code CLI. Install it and ensure "${binary}" is on your PATH.`);
+    }
+}
 /**
  * Validate that the required API key environment variable is set for a given provider.
  *
  * @param resolvedProvider - The resolved provider name.
  * @param role - Optional role label (e.g. "Planner", "Generator", "Evaluator") for the error message.
  * @param apiKey - Optional explicit API key from providerConfig (skips env var check if set).
+ * @param endpoint - Optional endpoint URL used to distinguish DeepSeek from other openai-compat servers.
  * @throws If the required environment variable is missing and no explicit apiKey was provided.
  */
-export function validateApiKey(resolvedProvider, role, apiKey) {
+export function validateApiKey(resolvedProvider, role, apiKey, endpoint) {
     const roleLabel = role ?? resolvedProvider;
     switch (resolvedProvider) {
         case "anthropic": {
@@ -64,7 +90,19 @@ export function validateApiKey(resolvedProvider, role, apiKey) {
             break;
         }
         case "openai-compat":
-            // API key is optional for Ollama and other local servers — skip validation.
+            // API key is optional for Ollama and other local servers.
+            // DeepSeek (api.deepseek.com) requires a key — check specifically for it.
+            if (endpoint?.includes("api.deepseek.com")) {
+                const key = apiKey ?? process.env["DEEPSEEK_API_KEY"];
+                if (!key) {
+                    throw new Error(`${roleLabel} is configured to use DeepSeek but neither providerConfig.apiKey nor DEEPSEEK_API_KEY is set. ` +
+                        `Set the DEEPSEEK_API_KEY environment variable and try again.`);
+                }
+            }
+            break;
+        case "claude-code":
+            // Subscription provider: no API key is read or required. The `claude`
+            // binary PATH preflight is async and runs via preflightClaudeBinary().
             break;
         default:
             // Unknown providers: no validation, let createClient handle the error.
@@ -115,8 +153,16 @@ export function createClient(provider, endpoint, providerConfig, model, role) {
     const apiKey = typeof providerConfig?.["apiKey"] === "string"
         ? providerConfig["apiKey"]
         : undefined;
+    // Hoist endpoint resolution so validateApiKey can distinguish DeepSeek from
+    // other openai-compat servers (e.g. Ollama). Explicit arg wins, then model
+    // resolution (for deepseek/ and ollama/ shorthands), then providerConfig.
+    const resolvedEndpoint = endpoint ??
+        (!provider && model ? resolveProviderModel(model).endpoint : undefined) ??
+        (typeof providerConfig?.["endpoint"] === "string"
+            ? providerConfig["endpoint"]
+            : undefined);
     // Validate API key before constructing the adapter.
-    validateApiKey(resolvedProvider, role, apiKey);
+    validateApiKey(resolvedProvider, role, apiKey, resolvedEndpoint);
     // Resolve the model ID (for cases where provider was inferred from shorthand)
     const resolvedModelId = !provider && model
         ? resolveProviderModel(model).modelId
@@ -133,20 +179,28 @@ export function createClient(provider, endpoint, providerConfig, model, role) {
         case "google":
             return new GoogleAdapter(resolvedModelId, apiKey ?? process.env["GOOGLE_API_KEY"] ?? process.env["GEMINI_API_KEY"]);
         case "openai-compat": {
-            // Resolve endpoint: explicit arg wins, then model resolution (for ollama/ prefix),
-            // then providerConfig, then error.
-            const resolvedEndpoint = endpoint ??
-                (!provider && model ? resolveProviderModel(model).endpoint : undefined) ??
-                (typeof providerConfig?.["endpoint"] === "string"
-                    ? providerConfig["endpoint"]
-                    : undefined);
             if (!resolvedEndpoint) {
                 throw new Error('OpenAI-compatible provider requires an endpoint. Set endpoint in provider config or use the "ollama/" model prefix.');
             }
-            return new OpenAICompatAdapter(resolvedEndpoint, resolvedModelId, apiKey);
+            // Inject DEEPSEEK_API_KEY env fallback only for the api.deepseek.com endpoint.
+            // Ollama and other openai-compat endpoints keep the no-key (not-needed) behavior.
+            const compatKey = apiKey ??
+                (resolvedEndpoint.includes("api.deepseek.com")
+                    ? process.env["DEEPSEEK_API_KEY"]
+                    : undefined);
+            return new OpenAICompatAdapter(resolvedEndpoint, resolvedModelId, compatKey);
+        }
+        case "claude-code": {
+            const binary = typeof providerConfig?.["binary"] === "string"
+                ? providerConfig["binary"]
+                : "claude";
+            const timeoutMs = typeof providerConfig?.["timeoutMs"] === "number"
+                ? providerConfig["timeoutMs"]
+                : 180_000;
+            return new ClaudeCodeAdapter(binary, timeoutMs);
         }
         default:
-            throw new Error(`Unsupported provider: "${resolvedProvider}". Supported providers: anthropic, openai, google, openai-compat.`);
+            throw new Error(`Unsupported provider: "${resolvedProvider}". Supported providers: anthropic, openai, google, openai-compat, claude-code.`);
     }
 }
 //# sourceMappingURL=factory.js.map

package/dist/providers/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAOzE,iFAAiF;AACjF,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,sEAAsE;AACtE,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,uEAAuE;AACvE,wBAAwB;AACxB,EAAE;AACF,iCAAiC;AAEjC,MAAM,uBAAuB;IAC3B,KAAK,CAAC,IAAI,CAAC,OAAmB;QAC5B,OAAO;YACL,IAAI,EAAE,mEAAmE;YACzE,SAAS,EAAE,EAAE;YACb,UAAU,EAAE,UAAU;YACtB,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;SAC3C,CAAC;IACJ,CAAC;CACF;AAUD,MAAM,kBAAkB,GAAgB,KAAK,EAAE,MAAM,EAAE,EAAE;IACvD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAChF,OAAO,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC,CAAC,uBAAuB;IACvC,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAM,GAAG,QAAQ,EACjB,QAAqB,kBAAkB;IAEvC,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CACb,QAAQ,MAAM,wDAAwD;YACpE,wDAAwD,MAAM,oBAAoB,CACrF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,gBAAwB,EACxB,IAAa,EACb,MAAe,EACf,QAAiB;IAEjB,MAAM,SAAS,GAAG,IAAI,IAAI,gBAAgB,CAAC;IAE3C,QAAQ,gBAAgB,EAAE,CAAC;QACzB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YACvD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,oEAAoE;oBAC9E,+DAA+D,CAClE,CAAC;YACJ,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YACpD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,8DAA8D;oBACxE,4DAA4D,CAC/D,CAAC;YACJ,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,GAAG,GACP,MAAM;gBACN,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAChC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,4FAA4F;oBACtG,uDAAuD,CAC1D,CAAC;YACJ,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,eAAe;YAClB,0DAA0D;YAC1D,0EAA0E;YAC1E,IAAI,QAAQ,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC3C,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBACtD,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,gGAAgG;wBAC1G,8DAA8D,CACjE,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,MAAM;QACR,KAAK,aAAa;YAChB,sEAAsE;YACtE,uEAAuE;YACvE,MAAM;QACR;YACE,uEAAuE;YACvE,MAAM;IACV,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAwB,EACxB,QAAwB,EACxB,cAAwC,EACxC,KAAc,EACd,IAAa;IAEb,sEAAsE;IACtE,mEAAmE;IACnE,8EAA8E;IAC9E,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,KAAK,GAAG,EAAE,CAAC;QACpD,OAAO,IAAI,uBAAuB,EAAE,CAAC;IACvC,CAAC;IAED,sEAAsE;IAEtE,wEAAwE;IACxE,IAAI,gBAAwB,CAAC;IAE7B,IAAI,QAAQ,EAAE,CAAC;QACb,gBAAgB,GAAG,QAAQ,CAAC;IAC9B,CAAC;SAAM,IAAI,KAAK,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC7C,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,gBAAgB,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GACV,OAAO,cAAc,EAAE,CAAC,QAAQ,CAAC,KAAK,QAAQ;QAC5C,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC;QAC1B,CAAC,CAAC,SAAS,CAAC;IAEhB,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E;IAC1E,MAAM,gBAAgB,GACpB,QAAQ;QACR,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,CAAC,OAAO,cAAc,EAAE,CAAC,UAAU,CAAC,KAAK,QAAQ;YAC/C,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC;YAC5B,CAAC,CAAC,SAAS,CAAC,CAAC;IAEjB,oDAAoD;IACpD,cAAc,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAEjE,8EAA8E;IAC9E,MAAM,eAAe,GACnB,CAAC,QAAQ,IAAI,KAAK;QAChB,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,OAAO;QACrC,CAAC,CAAC,KAAK,IAAI,gBAAgB,CAAC;IAEhC,QAAQ,gBAAgB,EAAE,CAAC;QACzB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,aAAa,GACjB,OAAO,cAAc,EAAE,CAAC,eAAe,CAAC,KAAK,SAAS;gBACpD,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC;gBACjC,CAAC,CAAC,IAAI,CAAC;YACX,OAAO,IAAI,gBAAgB,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CACtB,eAAe,EACf,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EACvC,QAAQ,IAAI,SAAS,EACrB,cAAc,CACf,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CACtB,eAAe,EACf,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CACzE,CAAC;QACJ,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,qHAAqH,CACtH,CAAC;YACJ,CAAC;YAED,+EAA+E;YAC/E,kFAAkF;YAClF,MAAM,SAAS,GACb,MAAM;gBACN,CAAC,gBAAgB,CAAC,QAAQ,CAAC,kBAAkB,CAAC;oBAC5C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;oBACjC,CAAC,CAAC,SAAS,CAAC,CAAC;YAEjB,OAAO,IAAI,mBAAmB,CAAC,gBAAgB,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,MAAM,GACV,OAAO,cAAc,EAAE,CAAC,QAAQ,CAAC,KAAK,QAAQ;gBAC5C,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC;gBAC1B,CAAC,CAAC,QAAQ,CAAC;YACf,MAAM,SAAS,GACb,OAAO,cAAc,EAAE,CAAC,WAAW,CAAC,KAAK,QAAQ;gBAC/C,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC;gBAC7B,CAAC,CAAC,OAAO,CAAC;YACd,OAAO,IAAI,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAClD,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CACb,0BAA0B,gBAAgB,gFAAgF,CAC3H,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/providers/google.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AA2LpB;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,4DAA4D;IAC5D,OAAO,CAAC,KAAK,CAAmC;gBAEpC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAK1C;;;;;OAKG;YACW,QAAQ;IAmChB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CAkDtD"}
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AA6MpB;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,4DAA4D;IAC5D,OAAO,CAAC,KAAK,CAAmC;gBAEpC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAK1C;;;;;OAKG;YACW,QAAQ;IAmChB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CAuEtD"}

package/dist/providers/google.js

@@ -21,6 +21,17 @@ function toGeminiTool(tools) {
         })),
     };
 }
+/**
+ * Sanitize a JSON Schema for Gemini's `responseSchema`.
+ *
+ * Gemini rejects the JSON-Schema keyword `additionalProperties`, so we return a
+ * shallow copy of the schema with the top-level `additionalProperties` key
+ * removed. A shallow strip is sufficient for the flat schemas we use.
+ */
+function sanitizeGeminiResponseSchema(schema) {
+    const { additionalProperties: _additionalProperties, ...rest } = schema;
+    return rest;
+}
 /**
  * Normalize a Gemini finishReason to our StopReason type.
  */
@@ -157,17 +168,30 @@ export class GoogleAdapter {
         return this.genAI;
     }
     async chat(params) {
-        const { model, system, messages, tools, maxTokens: _maxTokens = 16384 } = params;
+        const { model, system, messages, tools, responseSchema, maxTokens: _maxTokens = 16384, } = params;
         const genAI = await this.getGenAI();
+        // When a responseSchema is set, request Gemini's native structured output.
+        // Gemini rejects `additionalProperties`, so strip it before forwarding.
+        const generationConfig = responseSchema
+            ? {
+                responseMimeType: "application/json",
+                responseSchema: sanitizeGeminiResponseSchema(responseSchema),
+            }
+            : undefined;
         // Get the generative model — system instruction set at model config level
         const generativeModel = genAI.getGenerativeModel({
             model: model || this.model,
             ...(system ? { systemInstruction: system } : {}),
+            ...(generationConfig ? { generationConfig } : {}),
         });
         // Convert provider-agnostic Message[] to Gemini contents format
         const contents = messages.flatMap(toGeminiContents);
-        // Convert ToolDef[] to Gemini tools format (all declarations in one tool)
-        const geminiTools = tools && tools.length > 0 ? [toGeminiTool(tools)] : undefined;
+        // Convert ToolDef[] to Gemini tools format (all declarations in one tool).
+        // responseSchema is mutually exclusive with tools — when set, user tools
+        // are NOT forwarded (structured output wins).
+        const geminiTools = !responseSchema && tools && tools.length > 0
+            ? [toGeminiTool(tools)]
+            : undefined;
         const result = await generativeModel.generateContent({
             contents,
             ...(geminiTools ? { tools: geminiTools } : {}),

package/dist/providers/google.js.map

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

package/dist/providers/index.d.ts

@@ -3,5 +3,7 @@ export { AnthropicAdapter } from "./anthropic.js";
 export { OpenAIAdapter } from "./openai.js";
 export { GoogleAdapter } from "./google.js";
 export { OpenAICompatAdapter } from "./openai-compat.js";
-export { createClient, type ProviderName } from "./factory.js";
+export { ClaudeCodeAdapter } from "./claude-code.js";
+export { createClient, validateApiKey, preflightClaudeBinary, type ProviderName, type BinaryProbe } from "./factory.js";
+export { coerceJson, zodValidator, runStructuredAgent, JsonCoercionError, StructuredOutputError, type Validator, type ValidationResult, type SafeParseable, type RunStructuredAgentOptions, type StructuredAgentResult, } from "./structured.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,OAAO,EACP,UAAU,EACV,YAAY,EACZ,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,OAAO,EACP,UAAU,EACV,YAAY,EACZ,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAExH,OAAO,EACL,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC"}

package/dist/providers/index.js

@@ -2,5 +2,7 @@ export { AnthropicAdapter } from "./anthropic.js";
 export { OpenAIAdapter } from "./openai.js";
 export { GoogleAdapter } from "./google.js";
 export { OpenAICompatAdapter } from "./openai-compat.js";
-export { createClient } from "./factory.js";
+export { ClaudeCodeAdapter } from "./claude-code.js";
+export { createClient, validateApiKey, preflightClaudeBinary } from "./factory.js";
+export { coerceJson, zodValidator, runStructuredAgent, JsonCoercionError, StructuredOutputError, } from "./structured.js";
 //# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAqB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAuC,MAAM,cAAc,CAAC;AAExH,OAAO,EACL,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GAMtB,MAAM,iBAAiB,CAAC"}

package/dist/providers/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAKb,MAAM,YAAY,CAAC;AA+MpB;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;IAErE,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAA8B;gBAG1C,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQ1C;;;;OAIG;YACW,SAAS;IAqCjB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CA8CtD"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAKb,MAAM,YAAY,CAAC;AAyNpB;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;IAErE,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAA8B;gBAG1C,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQ1C;;;;OAIG;YACW,SAAS;IAqCjB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CAqEtD"}

package/dist/providers/openai.js

@@ -168,19 +168,40 @@ export class OpenAIAdapter {
         return this.client;
     }
     async chat(params) {
-        const { model, system, messages, tools, maxTokens = 16384 } = params;
+        const { model, system, messages, tools, maxTokens = 16384, responseSchema, jsonObjectMode } = params;
         const client = await this.getClient();
         // Build the messages array: system message first, then conversation
         const oaiMessages = [
             { role: "system", content: system },
             ...messages.flatMap(toOpenAIMessages),
         ];
-        // Convert ToolDef[] to OpenAI tools format
-        const oaiTools = tools && tools.length > 0 ? tools.map(toOpenAITool) : undefined;
+        // Structured output via response_format. `responseSchema` (strict json_schema)
+        // wins when set; otherwise `jsonObjectMode` requests the loose json_object
+        // mode (broadly supported, incl. DeepSeek, which rejects json_schema).
+        // Both disable tool forwarding (mutually exclusive with structured output).
+        // strict:false maximises compatibility; the caller validates/repairs output.
+        const responseFormat = responseSchema
+            ? {
+                type: "json_schema",
+                json_schema: {
+                    name: "structured_output",
+                    schema: responseSchema,
+                    strict: false,
+                },
+            }
+            : jsonObjectMode
+                ? { type: "json_object" }
+                : undefined;
+        // Convert ToolDef[] to OpenAI tools format. Skipped entirely when structured
+        // output (responseSchema or json_object mode) is requested.
+        const oaiTools = !responseSchema && !jsonObjectMode && tools && tools.length > 0
+            ? tools.map(toOpenAITool)
+            : undefined;
         const response = await client.chat.completions.create({
             model: model || this.model,
             messages: oaiMessages,
             ...(oaiTools ? { tools: oaiTools } : {}),
+            ...(responseFormat ? { response_format: responseFormat } : {}),
             max_tokens: maxTokens,
         });
         const choice = response.choices[0];

package/dist/providers/openai.js.map

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

package/dist/providers/preflight.d.ts

@@ -0,0 +1,22 @@
+import type { BoberConfig } from "../config/schema.js";
+/** The actionable hint string. MUST contain 'npm install openai'. */
+export declare const OPENAI_PEER_HINT: string;
+/**
+ * Injectable importer so tests can simulate openai present/absent without
+ * touching the real module graph. Mirrors the getClient() pattern in openai.ts.
+ */
+export type OpenaiImporter = () => Promise<unknown>;
+/** Returns true if any configured role resolves to an openai-family provider. */
+export declare function usesOpenaiFamily(config: Partial<BoberConfig>): boolean;
+/**
+ * Preflight: if an openai-family provider is configured but the openai package
+ * is absent, emit an install hint via logger.warn and return the hint string.
+ * If openai is installed OR no openai-family role is configured, return null.
+ * NEVER throws — this is a warning/hint only.
+ *
+ * @param config - The bober config (or partial). Scans planner/curator/generator/evaluator/codeReview roles.
+ * @param importer - Injectable importer for testability (default: dynamic import("openai")).
+ * @returns The hint string (contains 'npm install openai') if missing, otherwise null.
+ */
+export declare function preflightOpenaiPeer(config: Partial<BoberConfig>, importer?: OpenaiImporter): Promise<string | null>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/providers/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/providers/preflight.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,QAEkD,CAAC;AAEhF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;AASpD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAiBtE;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAC5B,QAAQ,GAAE,cAAgC,GACzC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB"}

package/dist/providers/preflight.js

@@ -0,0 +1,54 @@
+import { resolveProviderModel } from "../orchestrator/model-resolver.js";
+import { logger } from "../utils/logger.js";
+/** Providers that require the optional `openai` peer package. */
+const OPENAI_FAMILY = new Set(["openai", "openai-compat"]);
+/** The actionable hint string. MUST contain 'npm install openai'. */
+export const OPENAI_PEER_HINT = 'A configured role uses an OpenAI-family provider (openai/openai-compat/DeepSeek), ' +
+    'but the optional "openai" package is not installed. Run: npm install openai';
+const defaultImporter = () => {
+    // Construct the specifier at runtime so TypeScript does not attempt
+    // to statically resolve the optional peer dependency at compile time.
+    const specifier = "openai";
+    return import(/* @vite-ignore */ specifier);
+};
+/** Returns true if any configured role resolves to an openai-family provider. */
+export function usesOpenaiFamily(config) {
+    const sections = [
+        config.planner,
+        config.curator,
+        config.generator,
+        config.evaluator,
+        config.codeReview,
+    ];
+    for (const section of sections) {
+        if (!section?.model)
+            continue;
+        const { provider } = resolveProviderModel(section.model, section.provider);
+        if (OPENAI_FAMILY.has(provider))
+            return true;
+    }
+    return false;
+}
+/**
+ * Preflight: if an openai-family provider is configured but the openai package
+ * is absent, emit an install hint via logger.warn and return the hint string.
+ * If openai is installed OR no openai-family role is configured, return null.
+ * NEVER throws — this is a warning/hint only.
+ *
+ * @param config - The bober config (or partial). Scans planner/curator/generator/evaluator/codeReview roles.
+ * @param importer - Injectable importer for testability (default: dynamic import("openai")).
+ * @returns The hint string (contains 'npm install openai') if missing, otherwise null.
+ */
+export async function preflightOpenaiPeer(config, importer = defaultImporter) {
+    if (!usesOpenaiFamily(config))
+        return null; // sc-3-4: anthropic-only => null
+    try {
+        await importer(); // sc-3-3: openai present => no hint
+        return null;
+    }
+    catch {
+        logger.warn(OPENAI_PEER_HINT); // sc-3-2: openai absent => emit hint
+        return OPENAI_PEER_HINT;
+    }
+}
+//# sourceMappingURL=preflight.js.map

package/dist/providers/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/providers/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,iEAAiE;AACjE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC;AAE3D,qEAAqE;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAC3B,oFAAoF;IACpF,6EAA6E,CAAC;AAQhF,MAAM,eAAe,GAAmB,GAAG,EAAE;IAC3C,oEAAoE;IACpE,sEAAsE;IACtE,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC3B,OAAO,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,MAA4B;IAC3D,MAAM,QAAQ,GAAG;QACf,MAAM,CAAC,OAAO;QACd,MAAM,CAAC,OAAO;QACd,MAAM,CAAC,SAAS;QAChB,MAAM,CAAC,SAAS;QAChB,MAAM,CAAC,UAAU;KAClB,CAAC;IACF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,EAAE,KAAK;YAAE,SAAS;QAC9B,MAAM,EAAE,QAAQ,EAAE,GAAG,oBAAoB,CACvC,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,QAAQ,CACjB,CAAC;QACF,IAAI,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAA4B,EAC5B,WAA2B,eAAe;IAE1C,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,iCAAiC;IAC7E,IAAI,CAAC;QACH,MAAM,QAAQ,EAAE,CAAC,CAAC,oCAAoC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,qCAAqC;QACpE,OAAO,gBAAgB,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/providers/structured.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Schema-constrained ("structured") output utilities.
+ *
+ * Provides a provider-agnostic single-shot structured call that makes JSON
+ * output reliable even on small local models (DeepSeek / Ollama / LM Studio),
+ * where the server may not honor a strict schema. It:
+ *
+ *   1. requests native structured output (`ChatParams.responseSchema`) AND
+ *      injects the schema into the system prompt — belt-and-suspenders for
+ *      models that ignore the native knob;
+ *   2. coerces the model's raw text into JSON, tolerating the failure modes
+ *      7B-class models exhibit (markdown fences, surrounding prose);
+ *   3. validates the parsed value against a caller-supplied validator
+ *      (typically backed by a Zod schema); and
+ *   4. on failure, performs up to `maxRepairs` repair round-trips, feeding the
+ *      validation error back to the model.
+ *
+ * See structured.test.ts for the recovery-rate fixture suite that pins the
+ * single-shot + one-repair reliability target.
+ */
+import type { LLMClient, JsonSchemaObject } from "./types.js";
+/** Raised by {@link coerceJson} when no JSON value can be extracted from text. */
+export declare class JsonCoercionError extends Error {
+    /** The raw model text that could not be coerced. */
+    readonly raw: string;
+    constructor(message: string, 
+    /** The raw model text that could not be coerced. */
+    raw: string);
+}
+/** Raised by {@link runStructuredAgent} when every attempt fails validation. */
+export declare class StructuredOutputError extends Error {
+    /** The last raw model text seen. */
+    readonly raw: string;
+    /** Total chat calls made before giving up. */
+    readonly attempts: number;
+    constructor(message: string, 
+    /** The last raw model text seen. */
+    raw: string, 
+    /** Total chat calls made before giving up. */
+    attempts: number);
+}
+export type ValidationResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+};
+/** Validates and narrows a coerced JSON value to `T`. */
+export type Validator<T> = (raw: unknown) => ValidationResult<T>;
+/**
+ * Structural shape of a Zod schema's `safeParse`. Declared here (instead of
+ * importing `zod`) so this module stays dependency-pure and accepts any
+ * validator exposing the same surface.
+ */
+export interface SafeParseable<T> {
+    safeParse(data: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: {
+            issues: ReadonlyArray<{
+                path: ReadonlyArray<PropertyKey>;
+                message: string;
+            }>;
+        };
+    };
+}
+/**
+ * Build a {@link Validator} from a Zod schema (or anything exposing
+ * `safeParse`). Flattens issues into one human-readable string the model can
+ * act on during a repair round-trip.
+ */
+export declare function zodValidator<T>(schema: SafeParseable<T>): Validator<T>;
+/**
+ * Extract a JSON value from a model's raw text response.
+ *
+ * Handles the common local-model failure modes, in order:
+ *   1. direct `JSON.parse` (well-behaved providers / strict json mode);
+ *   2. strip a leading/trailing markdown code fence, then parse;
+ *   3. extract the substring spanning the first `{`/`[` to the matching last
+ *      `}`/`]` (drops surrounding prose), then parse.
+ *
+ * @throws {JsonCoercionError} if nothing parses.
+ */
+export declare function coerceJson(text: string): unknown;
+export interface RunStructuredAgentOptions<T> {
+    /** Provider-agnostic LLM client (any adapter from the provider factory). */
+    client: LLMClient;
+    /** Model ID (resolved via the factory / model-resolver). */
+    model: string;
+    /** Base system prompt. The schema instruction is appended automatically. */
+    system: string;
+    /** The task / user message. */
+    prompt: string;
+    /** Provider-facing JSON Schema (also injected into the system prompt). */
+    schema: JsonSchemaObject;
+    /** Validates + narrows the coerced JSON. Typically `zodValidator(SomeSchema)`. */
+    validate: Validator<T>;
+    /** Max repair round-trips after the first attempt. Default 1. */
+    maxRepairs?: number;
+    /** Per-call max tokens. */
+    maxTokens?: number;
+}
+export interface StructuredAgentResult<T> {
+    /** The validated, typed value. */
+    value: T;
+    /** Total chat calls made (1 = first-try success). */
+    attempts: number;
+    /** True if any repair round-trip was needed. */
+    repaired: boolean;
+    /** Cumulative token usage across all attempts. */
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/**
+ * Run a single-shot structured-output call with coercion, validation, and
+ * bounded repair. Returns a validated, typed value.
+ *
+ * The returned `ChatResponse.text` is parsed via {@link coerceJson} and checked
+ * with `validate`. If either fails and repairs remain, the bad output and the
+ * error are fed back as a follow-up turn.
+ *
+ * @throws {StructuredOutputError} if no attempt produces a schema-valid value.
+ */
+export declare function runStructuredAgent<T>(opts: RunStructuredAgentOptions<T>): Promise<StructuredAgentResult<T>>;
+//# sourceMappingURL=structured.d.ts.map

package/dist/providers/structured.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured.d.ts","sourceRoot":"","sources":["../../src/providers/structured.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAW,MAAM,YAAY,CAAC;AAIvE,kFAAkF;AAClF,qBAAa,iBAAkB,SAAQ,KAAK;IAGxC,oDAAoD;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM;gBAFpB,OAAO,EAAE,MAAM;IACf,oDAAoD;IAC3C,GAAG,EAAE,MAAM;CAKvB;AAED,gFAAgF;AAChF,qBAAa,qBAAsB,SAAQ,KAAK;IAG5C,oCAAoC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBAJzB,OAAO,EAAE,MAAM;IACf,oCAAoC;IAC3B,GAAG,EAAE,MAAM;IACpB,8CAA8C;IACrC,QAAQ,EAAE,MAAM;CAK5B;AAID,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,yDAAyD;AACzD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,SAAS,CAAC,IAAI,EAAE,OAAO,GACnB;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,GAC1B;QACE,OAAO,EAAE,KAAK,CAAC;QACf,KAAK,EAAE;YAAE,MAAM,EAAE,aAAa,CAAC;gBAAE,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;KACzF,CAAC;CACP;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAWtE;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAoBhD;AAyCD,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,4EAA4E;IAC5E,MAAM,EAAE,SAAS,CAAC;IAClB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,MAAM,EAAE,gBAAgB,CAAC;IACzB,kFAAkF;IAClF,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACvB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,kCAAkC;IAClC,KAAK,EAAE,CAAC,CAAC;IACT,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAOD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,IAAI,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAwDnC"}