rhachet 1.17.0 → 1.18.0

package/dist/domain.operations/context/findBrainReplByRef.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findBrainReplByRef = void 0;
+const helpful_errors_1 = require("helpful-errors");
+/**
+ * .what = finds a brain repl by its unique reference
+ * .why = enables lookup of registered repls by { repo, slug }
+ */
+const findBrainReplByRef = (input) => {
+    // fail fast if no repls available
+    if (input.repls.length === 0)
+        throw new helpful_errors_1.BadRequestError('no repls available in context', {
+            ref: input.ref,
+        });
+    // lookup repl by ref
+    const replFound = input.repls.find((r) => r.repo === input.ref.repo && r.slug === input.ref.slug);
+    // fail if not found
+    if (!replFound)
+        throw new helpful_errors_1.BadRequestError('brain repl not found', { ref: input.ref });
+    return replFound;
+};
+exports.findBrainReplByRef = findBrainReplByRef;
+//# sourceMappingURL=findBrainReplByRef.js.map

package/dist/domain.operations/context/findBrainReplByRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findBrainReplByRef.js","sourceRoot":"","sources":["../../../src/domain.operations/context/findBrainReplByRef.ts"],"names":[],"mappings":";;;AACA,mDAAiD;AAIjD;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,KAGlC,EAAa,EAAE;IACd,kCAAkC;IAClC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM,IAAI,gCAAe,CAAC,+BAA+B,EAAE;YACzD,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC,CAAC;IAEL,qBAAqB;IACrB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,CAC9D,CAAC;IAEF,oBAAoB;IACpB,IAAI,CAAC,SAAS;QACZ,MAAM,IAAI,gCAAe,CAAC,sBAAsB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAExE,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AApBW,QAAA,kBAAkB,sBAoB7B"}

package/dist/domain.operations/context/genContextBrain.d.ts

@@ -0,0 +1,14 @@
+import type { BrainAtom } from '../../domain.objects/BrainAtom';
+import type { BrainRepl } from '../../domain.objects/BrainRepl';
+import type { ContextBrain } from '../../domain.objects/ContextBrain';
+/**
+ * .what = factory to create a brain context from plugin-provided atoms and repls
+ * .why =
+ *   - provides a clean entry point for context creation
+ *   - validates no duplicate { repo, slug } identifiers
+ *   - composes the context with lookup and delegation logic
+ */
+export declare const genContextBrain: (input: {
+    atoms?: BrainAtom[];
+    repls?: BrainRepl[];
+}) => ContextBrain;

package/dist/domain.operations/context/genContextBrain.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genContextBrain = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const findBrainAtomByRef_1 = require("./findBrainAtomByRef");
+const findBrainReplByRef_1 = require("./findBrainReplByRef");
+/**
+ * .what = factory to create a brain context from plugin-provided atoms and repls
+ * .why =
+ *   - provides a clean entry point for context creation
+ *   - validates no duplicate { repo, slug } identifiers
+ *   - composes the context with lookup and delegation logic
+ */
+const genContextBrain = (input) => {
+    // default to empty arrays
+    const atoms = input.atoms ?? [];
+    const repls = input.repls ?? [];
+    // validate no duplicate atoms
+    const atomKeys = atoms.map((a) => `${a.repo}:${a.slug}`);
+    const duplicateAtom = atomKeys.find((k, i) => atomKeys.indexOf(k) !== i);
+    if (duplicateAtom)
+        throw new helpful_errors_1.BadRequestError('duplicate atom identifier', { duplicateAtom });
+    // validate no duplicate repls
+    const replKeys = repls.map((r) => `${r.repo}:${r.slug}`);
+    const duplicateRepl = replKeys.find((k, i) => replKeys.indexOf(k) !== i);
+    if (duplicateRepl)
+        throw new helpful_errors_1.BadRequestError('duplicate repl identifier', { duplicateRepl });
+    // return context with lookup and delegation
+    return {
+        brain: {
+            atom: {
+                ask: async (askInput) => {
+                    const atom = (0, findBrainAtomByRef_1.findBrainAtomByRef)({ atoms, ref: askInput.brain });
+                    return atom.ask(askInput, {});
+                },
+            },
+            repl: {
+                ask: async (askInput) => {
+                    const repl = (0, findBrainReplByRef_1.findBrainReplByRef)({ repls, ref: askInput.brain });
+                    return repl.ask(askInput, {});
+                },
+                act: async (actInput) => {
+                    const repl = (0, findBrainReplByRef_1.findBrainReplByRef)({ repls, ref: actInput.brain });
+                    return repl.act(actInput, {});
+                },
+            },
+        },
+    };
+};
+exports.genContextBrain = genContextBrain;
+//# sourceMappingURL=genContextBrain.js.map

package/dist/domain.operations/context/genContextBrain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genContextBrain.js","sourceRoot":"","sources":["../../../src/domain.operations/context/genContextBrain.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAMjD,6DAA0D;AAC1D,6DAA0D;AAE1D;;;;;;GAMG;AACI,MAAM,eAAe,GAAG,CAAC,KAG/B,EAAgB,EAAE;IACjB,0BAA0B;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAEhC,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,IAAI,aAAa;QACf,MAAM,IAAI,gCAAe,CAAC,2BAA2B,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IAE5E,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,IAAI,aAAa;QACf,MAAM,IAAI,gCAAe,CAAC,2BAA2B,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IAE5E,4CAA4C;IAC5C,OAAO;QACL,KAAK,EAAE;YACL,IAAI,EAAE;gBACJ,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;oBACtB,MAAM,IAAI,GAAG,IAAA,uCAAkB,EAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;oBAChE,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAQ,CAAC;gBACvC,CAAC;aACF;YACD,IAAI,EAAE;gBACJ,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;oBACtB,MAAM,IAAI,GAAG,IAAA,uCAAkB,EAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;oBAChE,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAQ,CAAC;gBACvC,CAAC;gBACD,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;oBACtB,MAAM,IAAI,GAAG,IAAA,uCAAkB,EAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;oBAChE,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAQ,CAAC;gBACvC,CAAC;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AAzCW,QAAA,eAAe,mBAyC1B"}

package/dist/domain.operations/schema/castZodToJsonSchema.d.ts

@@ -0,0 +1,14 @@
+import type { z } from 'zod';
+/**
+ * .what = convert a zod schema to JSON schema for native SDK enforcement
+ * .why = enables native structured output support in SDKs, reducing
+ *   token waste on validation retries
+ *
+ * .note = different SDKs require different conversion options:
+ *   - claude-agent-sdk: { $refStrategy: 'root' }
+ *   - codex-sdk: { target: 'openAi' }
+ */
+export declare const castZodToJsonSchema: (input: {
+    schema: z.ZodSchema;
+    target: 'claude' | 'openai';
+}) => object;

package/dist/domain.operations/schema/castZodToJsonSchema.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.castZodToJsonSchema = void 0;
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+/**
+ * .what = convert a zod schema to JSON schema for native SDK enforcement
+ * .why = enables native structured output support in SDKs, reducing
+ *   token waste on validation retries
+ *
+ * .note = different SDKs require different conversion options:
+ *   - claude-agent-sdk: { $refStrategy: 'root' }
+ *   - codex-sdk: { target: 'openAi' }
+ */
+const castZodToJsonSchema = (input) => {
+    // convert based on target SDK
+    if (input.target === 'claude') {
+        return (0, zod_to_json_schema_1.zodToJsonSchema)(input.schema, { $refStrategy: 'root' });
+    }
+    // openai target
+    return (0, zod_to_json_schema_1.zodToJsonSchema)(input.schema, { target: 'openAi' });
+};
+exports.castZodToJsonSchema = castZodToJsonSchema;
+//# sourceMappingURL=castZodToJsonSchema.js.map

package/dist/domain.operations/schema/castZodToJsonSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"castZodToJsonSchema.js","sourceRoot":"","sources":["../../../src/domain.operations/schema/castZodToJsonSchema.ts"],"names":[],"mappings":";;;AACA,2DAAqD;AAErD;;;;;;;;GAQG;AACI,MAAM,mBAAmB,GAAG,CAAC,KAGnC,EAAU,EAAE;IACX,8BAA8B;IAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAA,oCAAe,EAAC,KAAK,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,gBAAgB;IAChB,OAAO,IAAA,oCAAe,EAAC,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7D,CAAC,CAAC;AAXW,QAAA,mBAAmB,uBAW9B"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet",
   "author": "ehmpathy",
   "description": "A framework for reliable, thorough thought. Weave threads of thought via stitches.",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "repository": "ehmpathy/rhachet",
   "homepage": "https://github.com/ehmpathy/rhachet",
   "keywords": [
@@ -54,6 +54,8 @@
     "prepare:rhachet": "rhachet init && rhachet roles link --repo ehmpathy --role mechanic && rhachet roles link --repo bhuild --role behaver && rhachet roles link --repo bhrain --role reviewer && rhachet roles init --role mechanic && rhachet roles init --role behaver"
   },
   "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.1.76",
+    "@anthropic-ai/sdk": "0.71.2",
     "@ehmpathy/uni-time": "1.9.0",
     "as-procedure": "1.1.6",
     "bottleneck": "2.19.5",
@@ -63,12 +65,15 @@
     "fast-glob": "3.3.3",
     "flattie": "1.1.1",
     "helpful-errors": "1.5.3",
+    "@openai/codex-sdk": "0.77.0",
     "openai": "5.8.2",
     "rhachet-artifact": "1.0.1",
     "rhachet-artifact-git": "1.1.3",
     "serde-fns": "1.3.1",
     "type-fns": "1.21.0",
-    "uuid-fns": "1.0.1"
+    "uuid-fns": "1.0.1",
+    "zod": "3.25.76",
+    "zod-to-json-schema": "3.25.1"
   },
   "devDependencies": {
     "@biomejs/biome": "2.3.8",