rhachet 1.1.0

package/dist/domain/objects/Stitcher.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asStitcherDesc = exports.isOfStitcherForm = exports.StitcherForm = void 0;
+const type_fns_1 = require("type-fns");
+/**
+ * .what = the canonical set of stitcher forms
+ */
+var StitcherForm;
+(function (StitcherForm) {
+    /**
+     * .what = a stitch step executed via computation of procedural logic
+     */
+    StitcherForm["COMPUTE"] = "COMPUTE";
+    /**
+     * .what = a stitch step executed via imagination of an llm
+     */
+    StitcherForm["IMAGINE"] = "IMAGINE";
+    /**
+     * .what = a stitch combo via linear sequence
+     */
+    StitcherForm["ROUTE"] = "ROUTE";
+    /**
+     * .what = a stitch combo via parallel fanout + fanin
+     */
+    StitcherForm["FANOUT"] = "FANOUT";
+    /**
+     * .what = a stitch combo via conditional stitcher selection
+     */
+    StitcherForm["CHOICE"] = "CHOICE";
+    /**
+     * .what = a stitch combo via repetition of stitchers
+     */
+    StitcherForm["CYCLE"] = "CYCLE";
+    /**
+     * .what = a stitch combo which gracefully awaits some condition to be satisfied
+     */
+    StitcherForm["AWAIT"] = "AWAIT";
+})(StitcherForm || (exports.StitcherForm = StitcherForm = {}));
+exports.isOfStitcherForm = (0, type_fns_1.createIsOfEnum)(StitcherForm);
+/**
+ * .what = converts a full stitcher into a StitcherDesc
+ * .why = used for observability and trail markers
+ */
+const asStitcherDesc = (input) => {
+    const { slug, readme, form } = input.stitcher;
+    return { form, slug, readme };
+};
+exports.asStitcherDesc = asStitcherDesc;
+//# sourceMappingURL=Stitcher.js.map

package/dist/domain/objects/Stitcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stitcher.js","sourceRoot":"","sources":["../../../src/domain/objects/Stitcher.ts"],"names":[],"mappings":";;;AACA,uCAAsD;AAwBtD;;GAEG;AACH,IAAY,YAmCX;AAnCD,WAAY,YAAY;IACtB;;OAEG;IACH,mCAAmB,CAAA;IAEnB;;OAEG;IACH,mCAAmB,CAAA;IAEnB;;OAEG;IACH,+BAAe,CAAA;IAEf;;OAEG;IACH,iCAAiB,CAAA;IAEjB;;OAEG;IACH,iCAAiB,CAAA;IAEjB;;OAEG;IACH,+BAAe,CAAA;IAEf;;OAEG;IACH,+BAAe,CAAA;AACjB,CAAC,EAnCW,YAAY,4BAAZ,YAAY,QAmCvB;AACY,QAAA,gBAAgB,GAAG,IAAA,yBAAc,EAAC,YAAY,CAAC,CAAC;AA8D7D;;;GAGG;AACI,MAAM,cAAc,GAAG,CAAsC,KAEnE,EAAmC,EAAE;IACpC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC9C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC,CAAC;AALW,QAAA,cAAc,kBAKzB"}

package/dist/domain/objects/Stitcher.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/domain/objects/Stitcher.test.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * example thread builder
+ */
+const genThread = (ctx) => ({
+    context: ctx,
+    stitches: [],
+});
+/**
+ * Compile-time test suite using Jest
+ */
+describe('GStitcher', () => {
+    it('accepts single-threaded Threads', () => {
+        const stitcher = {
+            threads: {
+                artist: genThread({ role: 'artist', name: 'Zane' }),
+            },
+            context: {
+                stitch: { trail: [] },
+                log: console,
+            },
+            output: 'done',
+        };
+        expect(stitcher.output).toBe('done');
+    });
+    it('accepts multi-threaded Threads using Threads<..., "multiple">', () => {
+        const stitcher = {
+            threads: {
+                artist: {
+                    seed: genThread({ role: 'artist', name: 'Zane' }),
+                    peers: [genThread({ role: 'artist', name: 'Zane' })],
+                },
+            },
+            context: {
+                stitch: { trail: [] },
+                log: console,
+            },
+            output: 'done',
+        };
+        expect(stitcher.threads.artist.peers[0]?.context.name).toBe('Zane');
+    });
+    it('rejects invalid thread shape', () => {
+        // @ts-expect-error - artist must be a Thread or Thread[]
+        const stitcher = {
+            threads: {
+                artist: 'not-a-thread',
+            },
+            context: {
+                stitch: { trail: [] },
+                log: console,
+            },
+            output: 'fail',
+        };
+        expect(stitcher);
+    });
+    describe('Stitcher<GStitcher>', () => {
+        // ✅ Positive, single
+        it('should allow Stitcher<GStitcher> with Threads<..., "single">', () => {
+            const assert = null;
+            expect(assert).toBeNull();
+        });
+        // ✅ Positive, multiple
+        it('only allow StitchStep<GStitcher> with Threads<..., "multiple">', () => {
+            const assert = null;
+            expect(assert).toBeNull();
+        });
+        // ❌ Negative, single
+        it('should reject Stitcher<GStitcher> with non-Thread single shape', () => {
+            expect(true).toBe(true);
+        });
+        // ❌ Negative, multiple
+        it('should reject Stitcher<GStitcher> with non-Thread[] multiple shape', () => {
+            expect(true).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=Stitcher.test.js.map

package/dist/domain/objects/Stitcher.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stitcher.test.js","sourceRoot":"","sources":["../../../src/domain/objects/Stitcher.test.ts"],"names":[],"mappings":";;AAUA;;GAEG;AACH,MAAM,SAAS,GAAG,CAAI,GAAM,EAAa,EAAE,CAAC,CAAC;IAC3C,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC;AAEH;;GAEG;AACH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IAGzB,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAGzC,MAAM,QAAQ,GAAkD;YAC9D,OAAO,EAAE;gBACP,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;aAC7D;YACD,OAAO,EAAE;gBACP,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBACrB,GAAG,EAAE,OAAO;aACb;YACD,MAAM,EAAE,MAAM;SACf,CAAC;QAEF,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QAGvE,MAAM,QAAQ,GAAiD;YAC7D,OAAO,EAAE;gBACP,MAAM,EAAE;oBACN,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBACjD,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;iBACrD;aACF;YACD,OAAO,EAAE;gBACP,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBACrB,GAAG,EAAE,OAAO;aACb;YACD,MAAM,EAAE,MAAM;SACf,CAAC;QAEF,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QAKtC,yDAAyD;QACzD,MAAM,QAAQ,GAAmD;YAC/D,OAAO,EAAE;gBACP,MAAM,EAAE,cAAc;aACvB;YACD,OAAO,EAAE;gBACP,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBACrB,GAAG,EAAE,OAAO;aACb;YACD,MAAM,EAAE,MAAM;SACf,CAAC;QACF,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,qBAAqB;QACrB,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;YAMtE,MAAM,MAAM,GAAa,IAAI,CAAC;YAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YAMxE,MAAM,MAAM,GAAa,IAAI,CAAC;YAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,qBAAqB;QACrB,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YAQxE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;YAQ5E,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/domain/objects/Thread.d.ts

@@ -0,0 +1,31 @@
+import { DomainLiteral } from 'domain-objects';
+import { Stitch } from './Stitch';
+import { StitchSetEvent } from './StitchSetEvent';
+/**
+ * .what = a declaration of a thought thread
+ */
+export interface Thread<TThreadContext> {
+    /**
+     * the context accumulated for this thread so far
+     */
+    context: TThreadContext;
+    /**
+     * .what = the stitches that were executed with this thread so far
+     */
+    stitches: Stitch<any>[];
+    /**
+     * .what = the history that produced the state of this thread
+     * .note =
+     *   - history should only be used for observability
+     *   - should expect it to be optional, (e.g., only in prep environments, rarely in prod)
+     *      - due to the size (lots of repeated data)
+     *      - due to alt prod observability tools
+     * .todo
+     *   - decide if still needed now that stitch was improved
+     */
+    history?: StitchSetEvent<any, any>[];
+}
+export declare class Thread<TThreadContext> extends DomainLiteral<Thread<TThreadContext>> implements Thread<TThreadContext> {
+}
+export type ThreadOmitHistory<TThread extends Thread<any>> = Omit<TThread, 'history'>;
+export declare const threadOmitHistory: <TThread extends Thread<any>>(thread: TThread) => ThreadOmitHistory<TThread>;

package/dist/domain/objects/Thread.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.threadOmitHistory = exports.Thread = void 0;
+const domain_objects_1 = require("domain-objects");
+const type_fns_1 = require("type-fns");
+class Thread extends domain_objects_1.DomainLiteral {
+}
+exports.Thread = Thread;
+const threadOmitHistory = (thread) => (0, type_fns_1.omit)(thread, ['history']);
+exports.threadOmitHistory = threadOmitHistory;
+//# sourceMappingURL=Thread.js.map

package/dist/domain/objects/Thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Thread.js","sourceRoot":"","sources":["../../../src/domain/objects/Thread.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAC/C,uCAAgC;AA+BhC,MAAa,MACX,SAAQ,8BAAqC;CACT;AAFtC,wBAEsC;AAM/B,MAAM,iBAAiB,GAAG,CAC/B,MAAe,EACa,EAAE,CAAC,IAAA,eAAI,EAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AAF9C,QAAA,iBAAiB,qBAE6B"}

package/dist/domain/objects/Threads.d.ts

@@ -0,0 +1,56 @@
+import { Empty } from 'type-fns';
+import { Thread, ThreadOmitHistory } from './Thread';
+/**
+ * .what = a slug that uniquely identifies a role a thread can have
+ */
+export type ThreadRole = string;
+/**
+ * .what = a declaration of a role assigned to a thread
+ * .note =
+ *   - a core goal of rhachet is to make it easy to leverage roles in thought branches
+ *   - given that each thread of thought is heavily contextualized based on its "role", .role is a core primitive of a thought thread, in reality
+ */
+export type ThreadContextRole<TThreadRole extends ThreadRole> = {
+    role: TThreadRole;
+};
+/**
+ * .what = a declaration of the available threads and their contexts
+ * .note
+ *   - supports both single and multiple threads per role
+ *   - enables lookup of a thread by .role
+ */
+export type Threads<TContextDict extends Record<string, object> = Record<never, never>, TMultiplicity extends 'single' | 'multiple' = 'single'> = {
+    [K in keyof TContextDict & string]: TMultiplicity extends 'multiple' ? {
+        /**
+         * .what = the seed thread from which the peers originated
+         * .why =
+         *   - fanin operations need to know which thread to merge back into
+         */
+        seed: Thread<TContextDict[K] extends Empty ? ThreadContextRole<K> : ThreadContextRole<K> & TContextDict[K]>;
+        /**
+         * .what = the peer threads which multiplied from the seed
+         * .why =
+         *   - carries the thread history of the peer threads to the consumer (e.g., fanin)
+         */
+        peers: Thread<TContextDict[K] extends Empty ? ThreadContextRole<K> : ThreadContextRole<K> & TContextDict[K]>[];
+    } : Thread<TContextDict[K] extends Empty ? ThreadContextRole<K> : ThreadContextRole<K> & TContextDict[K]>;
+};
+/**
+ * .what = assures that .history is undefined from threads
+ */
+type ThreadsOmitHistory<TThreads extends Threads<any, any>> = {
+    [K in keyof TThreads]: TThreads[K] extends {
+        seed: infer TSeed extends Thread<any>;
+        peers: Array<infer TPeer extends Thread<any>>;
+    } ? {
+        seed: ThreadOmitHistory<TSeed>;
+        peers: ThreadOmitHistory<TPeer>[];
+    } : TThreads[K] extends Thread<any> ? ThreadOmitHistory<TThreads[K]> : never;
+};
+/**
+ * .what = assures that .history is undefined from threads
+ */
+export declare const threadsOmitHistory: <TThreads extends Threads<any, any>>(input: {
+    threads: TThreads;
+}) => ThreadsOmitHistory<TThreads>;
+export {};

package/dist/domain/objects/Threads.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.threadsOmitHistory = void 0;
+const Thread_1 = require("./Thread");
+/**
+ * .what = assures that .history is undefined from threads
+ */
+const threadsOmitHistory = (input) => {
+    const result = Object.fromEntries(Object.entries(input.threads).map(([role, value]) => {
+        if ('seed' in value && 'peers' in value) {
+            return [
+                role,
+                {
+                    seed: (0, Thread_1.threadOmitHistory)(value.seed),
+                    peers: value.peers.map(Thread_1.threadOmitHistory),
+                },
+            ];
+        }
+        else {
+            return [role, (0, Thread_1.threadOmitHistory)(value)];
+        }
+    }));
+    return result;
+};
+exports.threadsOmitHistory = threadsOmitHistory;
+//# sourceMappingURL=Threads.js.map

package/dist/domain/objects/Threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Threads.js","sourceRoot":"","sources":["../../../src/domain/objects/Threads.ts"],"names":[],"mappings":";;;AAEA,qCAAwE;AA2ExE;;GAEG;AACI,MAAM,kBAAkB,GAAG,CAAqC,KAEtE,EAAgC,EAAE;IACjC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC/B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QAClD,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;YACxC,OAAO;gBACL,IAAI;gBACJ;oBACE,IAAI,EAAE,IAAA,0BAAiB,EAAC,KAAK,CAAC,IAAI,CAAC;oBACnC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,0BAAiB,CAAC;iBAC1C;aACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,EAAE,IAAA,0BAAiB,EAAC,KAAoB,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,MAAsC,CAAC;AAChD,CAAC,CAAC;AApBW,QAAA,kBAAkB,sBAoB7B"}

package/dist/domain/objects/Weave.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=Weave.js.map

package/dist/domain/objects/Weave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Weave.js","sourceRoot":"","sources":["../../../src/domain/objects/Weave.ts"],"names":[],"mappings":""}

package/dist/domain/objects/Weaver.d.ts

@@ -0,0 +1,5 @@
+/**
+ * .what = a strategy via which to weave
+ * .note =
+ *   - given a weaver is a strategy, it measures it's success against the objective && fails fast if progress has slippage (rhachet guarantee)
+ */

package/dist/domain/objects/Weaver.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * .what = a strategy via which to weave
+ * .note =
+ *   - given a weaver is a strategy, it measures it's success against the objective && fails fast if progress has slippage (rhachet guarantee)
+ */
+//# sourceMappingURL=Weaver.js.map

package/dist/domain/objects/Weaver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Weaver.js","sourceRoot":"","sources":["../../../src/domain/objects/Weaver.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/domain/objects/index.d.ts

@@ -0,0 +1,11 @@
+export * from './Stitch';
+export * from './StitchChoice';
+export * from './StitchCycle';
+export * from './Stitcher';
+export * from './StitchFanout';
+export * from './StitchRoute';
+export * from './StitchSetEvent';
+export * from './StitchStep';
+export * from './StitchTrail';
+export * from './Thread';
+export * from './Threads';

package/dist/domain/objects/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Stitch"), exports);
+__exportStar(require("./StitchChoice"), exports);
+__exportStar(require("./StitchCycle"), exports);
+__exportStar(require("./Stitcher"), exports);
+__exportStar(require("./StitchFanout"), exports);
+__exportStar(require("./StitchRoute"), exports);
+__exportStar(require("./StitchSetEvent"), exports);
+__exportStar(require("./StitchStep"), exports);
+__exportStar(require("./StitchTrail"), exports);
+__exportStar(require("./Thread"), exports);
+__exportStar(require("./Threads"), exports);
+// export * from './Weave';
+// export * from './Weaver';
+//# sourceMappingURL=index.js.map

package/dist/domain/objects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/objects/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,iDAA+B;AAC/B,gDAA8B;AAC9B,6CAA2B;AAC3B,iDAA+B;AAC/B,gDAA8B;AAC9B,mDAAiC;AACjC,+CAA6B;AAC7B,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAC1B,2BAA2B;AAC3B,4BAA4B"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './contract/sdk';

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./contract/sdk"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}

package/dist/logic/stitch/adapters/imagineViaOpenAI.d.ts

@@ -0,0 +1,13 @@
+import { ChatModel } from 'openai/resources/shared';
+export interface ContextOpenAI {
+    openai: {
+        auth: {
+            key: string;
+        };
+        llm: {
+            model: ChatModel;
+            output: 'words' | 'json';
+        };
+    };
+}
+export declare const imagineViaOpenAI: (input: string, context: ContextOpenAI) => Promise<string>;

package/dist/logic/stitch/adapters/imagineViaOpenAI.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.imagineViaOpenAI = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const openai_1 = __importDefault(require("openai"));
+const imagineViaOpenAI = async (input, context) => {
+    const openai = new openai_1.default({
+        apiKey: context.openai.auth.key,
+    });
+    const response = await openai.chat.completions.create({
+        response_format: context.openai.llm.output === 'json'
+            ? { type: 'json_object' }
+            : undefined,
+        messages: [
+            {
+                role: 'user',
+                content: input,
+            },
+        ],
+        model: context.openai.llm.model,
+    });
+    if (!response.choices[0])
+        throw new helpful_errors_1.UnexpectedCodePathError('at least one response choice should be provided', { response });
+    if (response.choices.length > 1)
+        throw new helpful_errors_1.UnexpectedCodePathError('more than one response.choice provided', { response });
+    if (!response.choices[0].message.content)
+        throw new helpful_errors_1.UnexpectedCodePathError('no content provided in response', {
+            response,
+        });
+    return response.choices[0].message.content;
+};
+exports.imagineViaOpenAI = imagineViaOpenAI;
+//# sourceMappingURL=imagineViaOpenAI.js.map

package/dist/logic/stitch/adapters/imagineViaOpenAI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imagineViaOpenAI.js","sourceRoot":"","sources":["../../../../src/logic/stitch/adapters/imagineViaOpenAI.ts"],"names":[],"mappings":";;;;;;AAAA,mDAAyD;AACzD,oDAA4B;AAerB,MAAM,gBAAgB,GAAG,KAAK,EACnC,KAAa,EACb,OAAsB,EACL,EAAE;IACnB,MAAM,MAAM,GAAG,IAAI,gBAAM,CAAC;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;KAChC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACpD,eAAe,EACb,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;YAClC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE;YACzB,CAAC,CAAC,SAAS;QACf,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,KAAK;aACf;SACF;QACD,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK;KAChC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACtB,MAAM,IAAI,wCAAuB,CAC/B,iDAAiD,EACjD,EAAE,QAAQ,EAAE,CACb,CAAC;IACJ,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAC7B,MAAM,IAAI,wCAAuB,CAC/B,wCAAwC,EACxC,EAAE,QAAQ,EAAE,CACb,CAAC;IACJ,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;QACtC,MAAM,IAAI,wCAAuB,CAAC,iCAAiC,EAAE;YACnE,QAAQ;SACT,CAAC,CAAC;IACL,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;AAC7C,CAAC,CAAC;AAnCW,QAAA,gBAAgB,oBAmC3B"}

package/dist/logic/stitch/enstitch.d.ts

@@ -0,0 +1,27 @@
+import { StitchSetEvent } from '../../domain/objects/StitchSetEvent';
+import { StitchStep } from '../../domain/objects/StitchStep';
+import { GStitcher } from '../../domain/objects/Stitcher';
+import { Thread } from '../../domain/objects/Thread';
+import { Threads } from '../../domain/objects/Threads';
+/**
+ * .what = extracts the base thread to stitch into
+ * .why  = handles both single and multiple thread formats
+ */
+export declare const getStitchee: <T>(thread: Thread<T> | {
+    seed: Thread<T>;
+    peers: Thread<T>[];
+}) => Thread<T>;
+/**
+ * .what = normalizes a threads object to the 'single' shape
+ * .why = simplifies downstream usage that expects Threads<any, 'single'>
+ */
+export declare const normThreadsToSingle: <TThreads extends Threads<any, any>>(input: TThreads) => ReqThreadsSingle<TThreads>;
+type ReqThreadsSingle<T> = T extends Threads<infer TContextDict, any> ? Threads<TContextDict, 'single'> : never;
+/**
+ * .what = enstitche a single stitch step to produce a stitch
+ */
+export declare const enstitch: <TStitcher extends GStitcher<Threads<any, any>, any, any>>(input: {
+    stitcher: StitchStep<TStitcher>;
+    threads: TStitcher['threads'];
+}, context: TStitcher['context']) => Promise<StitchSetEvent<ReqThreadsSingle<TStitcher['threads']>, TStitcher['output']>>;
+export {};

package/dist/logic/stitch/enstitch.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enstitch = exports.normThreadsToSingle = exports.getStitchee = void 0;
+const uni_time_1 = require("@ehmpathy/uni-time");
+const helpful_errors_1 = require("helpful-errors");
+const uuid_fns_1 = require("uuid-fns");
+const Stitch_1 = require("../../domain/objects/Stitch");
+const StitchSetEvent_1 = require("../../domain/objects/StitchSetEvent");
+const StitchTrail_1 = require("../../domain/objects/StitchTrail");
+const Stitcher_1 = require("../../domain/objects/Stitcher");
+const Thread_1 = require("../../domain/objects/Thread");
+const invokeImagineStitcher_1 = require("./invokeImagineStitcher");
+/**
+ * .what = extracts the base thread to stitch into
+ * .why  = handles both single and multiple thread formats
+ */
+const getStitchee = (thread) => {
+    if ('seed' in thread && 'peers' in thread) {
+        return thread.seed;
+    }
+    return thread;
+};
+exports.getStitchee = getStitchee;
+/**
+ * .what = normalizes a threads object to the 'single' shape
+ * .why = simplifies downstream usage that expects Threads<any, 'single'>
+ */
+const normThreadsToSingle = (input) => {
+    const result = {};
+    for (const key in input) {
+        const value = input[key];
+        result[key] =
+            'seed' in value && 'peers' in value
+                ? value.seed // reduce multiple to seed
+                : value; // already single
+    }
+    return result;
+};
+exports.normThreadsToSingle = normThreadsToSingle;
+/**
+ * .what = enstitche a single stitch step to produce a stitch
+ */
+const enstitch = async (input, context) => {
+    // enstitch the output
+    const result = await (() => {
+        // if the stitcher is of type "compute", then execute the computation; // todo: add observability on duration
+        if (input.stitcher.form === 'COMPUTE')
+            return input.stitcher.invoke({ threads: input.threads }, context);
+        // if the stitcher is of type "imagine", then execute the imagination // todo: add observability
+        if (input.stitcher.form === 'IMAGINE')
+            return (0, invokeImagineStitcher_1.invokeImagineStitcher)({ stitcher: input.stitcher, threads: input.threads }, context);
+        // otherwise, unsupported and unexpected; should have been compiletime prevented
+        throw new helpful_errors_1.UnexpectedCodePathError('why did we get an unsupported stitcher.form?', { stitcher: input.stitcher });
+    })();
+    const stitchUuid = (0, uuid_fns_1.getUuid)();
+    const stitch = Stitch_1.Stitch.build({
+        uuid: stitchUuid,
+        createdAt: (0, uni_time_1.asUniDateTime)(new Date()),
+        stitcher: (0, Stitcher_1.asStitcherDesc)({ stitcher: input.stitcher }),
+        trail: {
+            desc: (0, StitchTrail_1.asStitchTrailDesc)({
+                trail: [
+                    ...context.stitch.trail,
+                    StitchTrail_1.StitchTrailMarker.build({
+                        stitchUuid,
+                        stitcherSlug: input.stitcher.slug,
+                    }),
+                ],
+            }),
+            // markers: context.stitch.trail, // todo: enable via context verbosity control
+        },
+        input: result.input,
+        output: result.output,
+    });
+    // mutate the input thread to attach the new stitch
+    const stitcheeKey = input.stitcher.stitchee;
+    const stitcheeBefore = Thread_1.Thread.build((0, exports.getStitchee)(input.threads[stitcheeKey] ??
+        helpful_errors_1.UnexpectedCodePathError.throw('could not find stitchee from input.threads')));
+    const stitcheeAfter = stitcheeBefore.clone({
+        stitches: [...stitcheeBefore.stitches, stitch], // append the latest stitch
+    });
+    // declare that this stitch has been set into "the fabric of reality"; energy => stitch
+    const event = StitchSetEvent_1.StitchSetEvent.build({
+        occurredAt: (0, uni_time_1.asUniDateTime)(new Date()),
+        stitch,
+        threads: (0, exports.normThreadsToSingle)({
+            ...input.threads,
+            [stitcheeKey]: stitcheeAfter,
+        }),
+    });
+    // emit the event
+    // todo: emit events via withStitchTrail
+    // and bubble it up
+    return event;
+};
+exports.enstitch = enstitch;
+//# sourceMappingURL=enstitch.js.map

package/dist/logic/stitch/enstitch.js.map

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

package/dist/logic/stitch/enstitch.test.d.ts

@@ -0,0 +1 @@
+export {};