@positronic/core 0.0.1

package/dist/types/dsl/json-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-patch.d.ts","sourceRoot":"","sources":["../../../src/dsl/json-patch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,SAAS,CAKzE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,KAAK,CAQlF"}

package/dist/types/dsl/types.d.ts

@@ -0,0 +1,14 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonArray = JsonValue[];
+export type JsonObject = {
+    [Key in string]?: JsonValue;
+};
+export type JsonValue = JsonPrimitive | JsonArray | JsonObject;
+export type State = JsonObject;
+export type JsonPatch = {
+    op: 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test';
+    path: string;
+    value?: JsonValue;
+    from?: string;
+}[];
+//# sourceMappingURL=types.d.ts.map

package/dist/types/dsl/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/dsl/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AACpC,MAAM,MAAM,UAAU,GAAG;KAAG,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,SAAS;CAAE,CAAC;AACzD,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC;AAE/B,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,EAAE,CAAC"}

package/dist/types/dsl/workflow-runner.d.ts

@@ -0,0 +1,28 @@
+import type { Adapter } from "../adapters/types";
+import type { FileStore } from "../file-stores/types";
+import type { SerializedStep, Workflow } from './workflow';
+import type { State } from './types';
+import type { PromptClient } from '../clients/types';
+interface Logger {
+    log(...args: any[]): void;
+}
+export declare class WorkflowRunner {
+    private options;
+    constructor(options: {
+        adapters: Adapter[];
+        fileStore: FileStore;
+        logger: Logger;
+        verbose: boolean;
+        client: PromptClient;
+    });
+    run<TOptions extends object = {}, TState extends State = {}>(workflow: Workflow<TOptions, TState>, { initialState, options, initialCompletedSteps, workflowRunId, endAfter }?: {
+        initialState?: TState;
+        options?: TOptions;
+        initialCompletedSteps?: SerializedStep[] | never;
+        workflowRunId?: string | never;
+        endAfter?: number;
+    }): Promise<void>;
+    private truncateDeep;
+}
+export {};
+//# sourceMappingURL=workflow-runner.d.ts.map

package/dist/types/dsl/workflow-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-runner.d.ts","sourceRoot":"","sources":["../../../src/dsl/workflow-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,UAAU,MAAM;IACd,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC3B;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE;QACf,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,SAAS,EAAE,SAAS,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,YAAY,CAAA;KACrB;IAGG,GAAG,CACP,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,KAAK,GAAG,EAAE,EAEzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,EACpC,EACE,YAA2B,EAC3B,OAAO,EACP,qBAAqB,EACrB,aAAa,EACb,QAAQ,EACT,GAAE;QACD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,qBAAqB,CAAC,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;QACjD,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;KACb;IAkER,OAAO,CAAC,YAAY;CAuCrB"}

package/dist/types/dsl/workflow.d.ts

@@ -0,0 +1,118 @@
+import { z } from "zod";
+import type { PromptClient } from "../clients/types";
+import type { State, JsonPatch } from "./types";
+import { STATUS, WORKFLOW_EVENTS } from './constants';
+import type { FileStore } from "../file-stores/types";
+export type SerializedError = {
+    name: string;
+    message: string;
+    stack?: string;
+};
+interface BaseEvent<TOptions extends object = {}> {
+    type: typeof WORKFLOW_EVENTS[keyof typeof WORKFLOW_EVENTS];
+    options: TOptions;
+    workflowRunId: string;
+}
+interface WorkflowBaseEvent<TOptions extends object = {}> extends BaseEvent<TOptions> {
+    workflowTitle: string;
+    workflowDescription?: string;
+}
+export interface WorkflowStartEvent<TOptions extends object = {}> extends WorkflowBaseEvent<TOptions> {
+    type: typeof WORKFLOW_EVENTS.START | typeof WORKFLOW_EVENTS.RESTART;
+    initialState: State;
+    status: typeof STATUS.RUNNING;
+}
+export interface WorkflowCompleteEvent<TOptions extends object = {}> extends WorkflowBaseEvent<TOptions> {
+    type: typeof WORKFLOW_EVENTS.COMPLETE;
+    status: typeof STATUS.COMPLETE;
+}
+export interface WorkflowErrorEvent<TOptions extends object = {}> extends WorkflowBaseEvent<TOptions> {
+    type: typeof WORKFLOW_EVENTS.ERROR;
+    status: typeof STATUS.ERROR;
+    error: SerializedError;
+}
+export interface StepStatusEvent<TOptions extends object = {}> extends BaseEvent<TOptions> {
+    type: typeof WORKFLOW_EVENTS.STEP_STATUS;
+    steps: SerializedStep[];
+}
+export interface StepStartedEvent<TOptions extends object = {}> extends BaseEvent<TOptions> {
+    type: typeof WORKFLOW_EVENTS.STEP_START;
+    status: typeof STATUS.RUNNING;
+    stepTitle: string;
+    stepId: string;
+}
+export interface StepCompletedEvent<TOptions extends object = {}> extends BaseEvent<TOptions> {
+    type: typeof WORKFLOW_EVENTS.STEP_COMPLETE;
+    status: typeof STATUS.RUNNING;
+    stepTitle: string;
+    stepId: string;
+    patch: JsonPatch;
+}
+export type WorkflowEvent<TOptions extends object = {}> = WorkflowStartEvent<TOptions> | WorkflowCompleteEvent<TOptions> | WorkflowErrorEvent<TOptions> | StepStatusEvent<TOptions> | StepStartedEvent<TOptions> | StepCompletedEvent<TOptions>;
+export interface SerializedStep {
+    title: string;
+    status: typeof STATUS[keyof typeof STATUS];
+    id: string;
+    patch?: JsonPatch;
+}
+interface BaseRunParams<TOptions extends object = {}> {
+    fileStore: FileStore;
+    client: PromptClient;
+    options?: TOptions;
+}
+export interface InitialRunParams<TOptions extends object = {}> extends BaseRunParams<TOptions> {
+    initialState?: State;
+    initialCompletedSteps?: never;
+    workflowRunId?: never;
+}
+export interface RerunParams<TOptions extends object = {}> extends BaseRunParams<TOptions> {
+    initialState: State;
+    initialCompletedSteps: SerializedStep[];
+    workflowRunId: string;
+}
+export declare class Workflow<TOptions extends object = {}, TState extends State = {}> {
+    readonly title: string;
+    private description?;
+    private blocks;
+    type: 'workflow';
+    constructor(title: string, description?: string | undefined);
+    step<TNewState extends State>(title: string, action: (params: {
+        state: TState;
+        options: TOptions;
+        client: PromptClient;
+        fileStore: FileStore;
+    }) => TNewState | Promise<TNewState>): Workflow<TOptions, TNewState>;
+    workflow<TInnerState extends State, TNewState extends State>(title: string, innerWorkflow: Workflow<TOptions, TInnerState>, action: (params: {
+        state: TState;
+        workflowState: TInnerState;
+    }) => TNewState, initialState?: State | ((state: TState) => State)): Workflow<TOptions, TNewState>;
+    prompt<TResponseKey extends string & {
+        readonly brand?: unique symbol;
+    }, TSchema extends z.ZodObject<any>, TNewState extends State = TState & {
+        [K in TResponseKey]: z.infer<TSchema>;
+    }>(title: string, config: {
+        template: (state: TState) => string;
+        responseModel: {
+            schema: TSchema;
+            name: TResponseKey & (string extends TResponseKey ? never : unknown);
+        };
+        client?: PromptClient;
+    }, reduce?: (params: {
+        state: TState;
+        response: z.infer<TSchema>;
+        options: TOptions;
+        prompt: string;
+    }) => TNewState | Promise<TNewState>): Workflow<TOptions, TNewState>;
+    run(params: InitialRunParams<TOptions>): AsyncGenerator<WorkflowEvent<TOptions>>;
+    run(params: RerunParams<TOptions>): AsyncGenerator<WorkflowEvent<TOptions>>;
+    private withBlocks;
+    private nextWorkflow;
+}
+export declare function disableWorkflowNameUniqueness(): void;
+export declare function enableWorkflowNameUniqueness(): void;
+export declare function workflow<TOptions extends object = {}, TState extends State = {}>(workflowConfig: string | {
+    title: string;
+    description?: string;
+}): Workflow<TOptions, TState>;
+export {};
+//# sourceMappingURL=workflow.d.ts.map

package/dist/types/dsl/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/dsl/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAA;AAID,UAAU,SAAS,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE;IAC9C,IAAI,EAAE,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;IAC3D,OAAO,EAAE,QAAQ,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAGD,UAAU,iBAAiB,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE,CAAE,SAAQ,SAAS,CAAC,QAAQ,CAAC;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE,CAAE,SAAQ,iBAAiB,CAAC,QAAQ,CAAC;IACnG,IAAI,EAAE,OAAO,eAAe,CAAC,KAAK,GAAG,OAAO,eAAe,CAAC,OAAO,CAAC;IACpE,YAAY,EAAE,KAAK,CAAC;IACpB,MAAM,EAAE,OAAO,MAAM,CAAC,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE,CAAE,SAAQ,iBAAiB,CAAC,QAAQ,CAAC;IACtG,IAAI,EAAE,OAAO,eAAe,CAAC,QAAQ,CAAC;IACtC,MAAM,EAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE,CAAE,SAAQ,iBAAiB,CAAC,QAAQ,CAAC;IACnG,IAAI,EAAE,OAAO,eAAe,CAAC,KAAK,CAAC;IACnC,MAAM,EAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IAC5B,KAAK,EAAE,eAAe,CAAC;CACxB;AAGD,MAAM,WAAW,eAAe,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE,CAAE,SAAQ,SAAS,CAAC,QAAQ,CAAC;IACxF,IAAI,EAAE,OAAO,eAAe,CAAC,WAAW,CAAC;IACzC,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAGD,MAAM,WAAW,gBAAgB,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE,CAAE,SAAQ,SAAS,CAAC,QAAQ,CAAC;IACzF,IAAI,EAAE,OAAO,eAAe,CAAC,UAAU,CAAC;IACxC,MAAM,EAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE,CAAE,SAAQ,SAAS,CAAC,QAAQ,CAAC;IAC3F,IAAI,EAAE,OAAO,eAAe,CAAC,aAAa,CAAC;IAC3C,MAAM,EAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;CAClB;AAGD,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE,IAClD,kBAAkB,CAAC,QAAQ,CAAC,GAC5B,qBAAqB,CAAC,QAAQ,CAAC,GAC/B,kBAAkB,CAAC,QAAQ,CAAC,GAC5B,eAAe,CAAC,QAAQ,CAAC,GACzB,gBAAgB,CAAC,QAAQ,CAAC,GAC1B,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AAEjC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AA8BD,UAAU,aAAa,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE;IAClD,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE,CAAE,SAAQ,aAAa,CAAC,QAAQ,CAAC;IAC7F,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,qBAAqB,CAAC,EAAE,KAAK,CAAC;IAC9B,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB;AAED,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE,CAAE,SAAQ,aAAa,CAAC,QAAQ,CAAC;IACxF,YAAY,EAAE,KAAK,CAAC;IACpB,qBAAqB,EAAE,cAAc,EAAE,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,QAAQ,CACnB,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,KAAK,GAAG,EAAE;aAMP,KAAK,EAAE,MAAM;IAC7B,OAAO,CAAC,WAAW,CAAC;IALtB,OAAO,CAAC,MAAM,CAAmC;IAC1C,IAAI,EAAE,UAAU,CAAc;gBAGnB,KAAK,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,YAAA;IAG9B,IAAI,CAAC,SAAS,SAAS,KAAK,EAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,QAAQ,CAAC;QAClB,MAAM,EAAE,YAAY,CAAC;QACrB,SAAS,EAAE,SAAS,CAAC;KACtB,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAWtC,QAAQ,CACN,WAAW,SAAS,KAAK,EACzB,SAAS,SAAS,KAAK,EAEvB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,EAC9C,MAAM,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,WAAW,CAAA;KAAE,KAAK,SAAS,EAC5E,YAAY,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC;IAsBnD,MAAM,CACJ,YAAY,SAAS,MAAM,GAAG;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,MAAM,CAAA;KAAE,EAChE,OAAO,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAChC,SAAS,SAAS,KAAK,GAAG,MAAM,GAAG;SAAG,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;KAAE,EAE5E,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;QACN,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;QACpC,aAAa,EAAE;YACb,MAAM,EAAE,OAAO,CAAC;YAChB,IAAI,EAAE,YAAY,GAAG,CAAC,MAAM,SAAS,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC,CAAC;SACtE,CAAC;QACF,MAAM,CAAC,EAAE,YAAY,CAAC;KACvB,EACD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,EAAE,QAAQ,CAAC;QAClB,MAAM,EAAE,MAAM,CAAA;KACf,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IA6BtC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChF,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAe3E,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,YAAY;CAMrB;AAwQD,wBAAgB,6BAA6B,SAE5C;AAED,wBAAgB,4BAA4B,SAE3C;AAGD,wBAAgB,QAAQ,CACtB,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,KAAK,GAAG,EAAE,EAEzB,cAAc,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,8BAWjE"}

package/dist/types/file-stores/local-file-store.d.ts

@@ -0,0 +1,7 @@
+import type { FileStore } from './types';
+export declare class LocalFileStore implements FileStore {
+    private baseDir;
+    constructor(baseDir: string);
+    readFile(path: string): Promise<string>;
+}
+//# sourceMappingURL=local-file-store.d.ts.map

package/dist/types/file-stores/local-file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-store.d.ts","sourceRoot":"","sources":["../../../src/file-stores/local-file-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,qBAAa,cAAe,YAAW,SAAS;IAClC,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAI9C"}

package/dist/types/file-stores/types.d.ts

@@ -0,0 +1,4 @@
+export interface FileStore {
+    readFile(path: string): Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/file-stores/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/file-stores/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzC"}

package/dist/types/index.d.ts

@@ -0,0 +1,12 @@
+export { Workflow, workflow } from "./dsl/workflow";
+export { WorkflowRunner } from "./dsl/workflow-runner";
+export { createExtension } from "./dsl/extensions";
+export { STATUS, WORKFLOW_EVENTS } from "./dsl/constants";
+export { Adapter } from "./adapters/types";
+export type { WorkflowEvent, SerializedStep, InitialRunParams, RerunParams, WorkflowStartEvent, WorkflowCompleteEvent, WorkflowErrorEvent, StepStatusEvent, StepStartedEvent, StepCompletedEvent } from "./dsl/workflow";
+export type { PromptClient, ResponseModel } from "./clients/types";
+export type { State } from "./dsl/types";
+export type { FileStore } from "./file-stores/types";
+export { createPatch, applyPatches } from "./dsl/json-patch";
+export { LocalFileStore } from "./file-stores/local-file-store";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,YAAY,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/types/utils/temp-files.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Writes content to a temporary file and opens it in cursor
+ */
+export declare function writeAndOpenTemp(content: string, prefix: string, extension?: string): Promise<string>;
+/**
+ * Writes both prompt and response to temp files and opens them in cursor
+ */
+export declare function writePromptAndResponse(prompt: string, response: unknown, prefix?: string): Promise<{
+    promptPath: string;
+    responsePath: string;
+}>;
+//# sourceMappingURL=temp-files.d.ts.map

package/dist/types/utils/temp-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temp-files.d.ts","sourceRoot":"","sources":["../../../src/utils/temp-files.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,MAAM,GAAE,MAAgB,GACvB,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CASvD"}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@positronic/core",
+  "version": "0.0.1",
+  "description": "A DSL for AI Workflows",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/types/index.d.ts",
+  "scripts": {
+    "tsc": "tsc --project tsconfig.json",
+    "build": "npm run tsc && swc src -d dist",
+    "clean": "rm -rf tsconfig.tsbuildinfo dist"
+  },
+  "dependencies": {
+    "fast-json-patch": "^3.1.1",
+    "uuid": "^11.0.5",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/uuid": "^10.0.0"
+  }
+}

package/src/adapters/types.ts

@@ -0,0 +1,24 @@
+import { WORKFLOW_EVENTS } from '../dsl/constants';
+import type { WorkflowEvent } from '../dsl/workflow';
+
+export abstract class Adapter<Options extends object = any> {
+  async started?(event: WorkflowEvent<Options>): Promise<void>;
+  async updated?(event: WorkflowEvent<Options>): Promise<void>;
+  async completed?(event: WorkflowEvent<Options>): Promise<void>;
+  async error?(event: WorkflowEvent<Options>): Promise<void>;
+  async restarted?(event: WorkflowEvent<Options>): Promise<void>;
+
+  async dispatch(event: WorkflowEvent<Options>) {
+    if (event.type === WORKFLOW_EVENTS.START && this.started) {
+      await this.started(event);
+    } else if (event.type === WORKFLOW_EVENTS.STEP_COMPLETE && this.updated) {
+      await this.updated(event);
+    } else if (event.type === WORKFLOW_EVENTS.COMPLETE && this.completed) {
+      await this.completed(event);
+    } else if (event.type === WORKFLOW_EVENTS.ERROR && this.error) {
+      await this.error(event);
+    } else if (event.type === WORKFLOW_EVENTS.RESTART && this.restarted) {
+      await this.restarted(event);
+    }
+  }
+}

package/src/clients/types.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+
+export type ResponseModel<T extends z.AnyZodObject> = {
+    schema: T;
+    name: string;
+    description?: string;
+}
+
+export interface PromptClient {
+  execute<T extends z.AnyZodObject>(
+    prompt: string,
+    responseModel: ResponseModel<T>,
+  ): Promise<z.infer<T>>;
+}

package/src/dsl/constants.ts

@@ -0,0 +1,16 @@
+export const WORKFLOW_EVENTS = {
+  START: 'workflow:start',
+  RESTART: 'workflow:restart',
+  STEP_START: 'step:start',
+  STEP_COMPLETE: 'step:complete',
+  STEP_STATUS: 'step:status',
+  ERROR: 'workflow:error',
+  COMPLETE: 'workflow:complete',
+} as const;
+
+export const STATUS = {
+  PENDING: 'pending',
+  RUNNING: 'running',
+  COMPLETE: 'complete',
+  ERROR: 'error',
+} as const;

package/src/dsl/extensions.ts

@@ -0,0 +1,58 @@
+import { Workflow } from "./workflow";
+import type { State } from "./types";
+
+type Expand<T> = T extends infer O ? { [K in keyof O]: O[K] } : never;
+
+type ExtensionMethods<
+  TExtension extends Record<string, any>,
+  TOptions extends object,
+  TState extends State
+> = TExtension extends ((...args: any[]) => any)
+  ? TExtension extends ((
+      this: any,
+      title: string,
+      config: infer TConfig
+    ) => Workflow<any, infer TReturnState>)
+    ? (
+        title: string,
+        config: TConfig extends ((ctx: any) => any)
+          ? { [P in keyof TConfig]: TConfig[P] extends Function ? ((ctx: TState) => any) : TConfig[P] }
+          : TConfig
+      ) => Workflow<TOptions, Expand<TState & TReturnState>>
+    : never
+  : {
+      [K in keyof TExtension]: TExtension[K] extends (
+        this: any,
+        title: string,
+        config: infer TConfig
+      ) => Workflow<any, infer TReturnState>
+        ? (
+            title: string,
+            config: TConfig extends ((ctx: any) => any)
+              ? { [P in keyof TConfig]: TConfig[P] extends Function ? ((ctx: TState) => any) : TConfig[P] }
+              : TConfig
+          ) => Workflow<TOptions, Expand<TState & TReturnState>>
+        : never;
+    };
+
+export function createExtension<
+  TExtensionKey extends string,
+  TExtension extends Record<string, any>
+>(key: TExtensionKey, extension: TExtension) {
+  return {
+    install() {
+      Object.defineProperty(Workflow.prototype, key, {
+        get() {
+          const boundMethods: Record<string, Function> = {};
+          for (const [methodKey, fn] of Object.entries(extension)) {
+            boundMethods[methodKey] = fn.bind(this);
+          }
+          return boundMethods;
+        }
+      });
+    },
+    augment<TOptions extends object, TState extends State>(): ExtensionMethods<TExtension, TOptions, TState> {
+      return {} as ExtensionMethods<TExtension, TOptions, TState>;
+    }
+  };
+}

package/src/dsl/json-patch.ts

@@ -0,0 +1,27 @@
+import pkg from 'fast-json-patch';
+const { compare, applyPatch } = pkg;
+import { JsonPatch, State } from './types';
+
+/**
+ * Creates a JSON Patch that describes the changes needed to transform prevState into nextState.
+ */
+export function createPatch(prevState: State, nextState: State): JsonPatch {
+  // Filter out non-standard operations and ensure type safety
+  return compare(prevState, nextState).filter(op =>
+    ['add', 'remove', 'replace', 'move', 'copy', 'test'].includes(op.op)
+  ) as JsonPatch;
+}
+
+/**
+ * Applies one or more JSON Patches to a state object and returns the resulting state.
+ * If multiple patches are provided, they are applied in sequence.
+ */
+export function applyPatches(state: State, patches: JsonPatch | JsonPatch[]): State {
+  const patchArray = Array.isArray(patches[0]) ? patches as JsonPatch[] : [patches as JsonPatch];
+
+  // Apply patches in sequence, creating a new state object each time
+  return patchArray.reduce((currentState, patch) => {
+    const { newDocument } = applyPatch(currentState, patch as any[], true, false);
+    return newDocument;
+  }, { ...state });
+}

package/src/dsl/types.ts

@@ -0,0 +1,13 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonArray = JsonValue[];
+export type JsonObject = { [Key in string]?: JsonValue };
+export type JsonValue = JsonPrimitive | JsonArray | JsonObject;
+
+export type State = JsonObject;
+
+export type JsonPatch = {
+  op: 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test';
+  path: string;
+  value?: JsonValue;
+  from?: string;
+}[];

package/src/dsl/workflow-runner.test.ts

@@ -0,0 +1,203 @@
+import { WorkflowRunner } from './workflow-runner';
+import { workflow } from './workflow';
+import { WORKFLOW_EVENTS, STATUS } from './constants';
+import type { FileStore } from '../file-stores/types';
+
+class TestFileStore implements FileStore {
+  async readFile(path: string) {
+    return Promise.resolve('');
+  }
+}
+
+describe('WorkflowRunner', () => {
+  const mockClient = {
+    execute: jest.fn()
+  };
+
+  const mockLogger = {
+    log: jest.fn()
+  };
+
+  const mockAdapter = {
+    dispatch: jest.fn()
+  };
+
+  const fileStore = new TestFileStore();
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('should run a workflow and dispatch events to adapters', async () => {
+    const runner = new WorkflowRunner({
+      adapters: [mockAdapter],
+      fileStore,
+      logger: mockLogger,
+      verbose: false,
+      client: mockClient
+    });
+
+    const testWorkflow = workflow('Test Workflow')
+      .step('First Step', () => ({ value: 42 }))
+      .step('Async Step', async ({ state}) => {
+        await new Promise(resolve => setTimeout(resolve, 10));
+        return { ...state, asyncValue: 'completed' };
+      })
+      .step('Final Step', ({ state }) => ({
+        ...state,
+        finalValue: state.value * 2
+      }));
+
+    await runner.run(testWorkflow);
+
+    // Verify adapter received all events in correct order
+    expect(mockAdapter.dispatch).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: WORKFLOW_EVENTS.START,
+        workflowTitle: 'Test Workflow'
+      })
+    );
+
+    expect(mockAdapter.dispatch).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: WORKFLOW_EVENTS.STEP_COMPLETE,
+        stepTitle: 'First Step'
+      })
+    );
+
+    expect(mockAdapter.dispatch).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: WORKFLOW_EVENTS.STEP_COMPLETE,
+        stepTitle: 'Async Step'
+      })
+    );
+
+    expect(mockAdapter.dispatch).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: WORKFLOW_EVENTS.STEP_COMPLETE,
+        stepTitle: 'Final Step'
+      })
+    );
+
+    expect(mockAdapter.dispatch).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: WORKFLOW_EVENTS.COMPLETE,
+        status: STATUS.COMPLETE
+      })
+    );
+
+    // Verify the order of events
+    const stepCompletions = mockAdapter.dispatch.mock.calls
+      .filter(call => call[0].type === WORKFLOW_EVENTS.STEP_COMPLETE)
+      .map(call => call[0].stepTitle);
+
+    expect(stepCompletions).toEqual([
+      'First Step',
+      'Async Step',
+      'Final Step'
+    ]);
+  });
+
+  it('should log final state when verbose is true', async () => {
+    const runner = new WorkflowRunner({
+      adapters: [],
+      fileStore,
+      logger: mockLogger,
+      verbose: true,
+      client: mockClient
+    });
+
+    const testWorkflow = workflow('Test Workflow')
+      .step('Test Step', () => ({ value: 42 }));
+
+    await runner.run(testWorkflow);
+
+    expect(mockLogger.log).toHaveBeenCalledWith(
+      expect.stringContaining('Workflow completed:')
+    );
+    expect(mockLogger.log).toHaveBeenCalledWith(
+      expect.stringContaining('"value": 42')
+    );
+  });
+
+  it('should handle workflow errors', async () => {
+    const runner = new WorkflowRunner({
+      adapters: [mockAdapter],
+      fileStore,
+      logger: mockLogger,
+      verbose: true,
+      client: mockClient
+    });
+
+    const errorWorkflow = workflow('Error Workflow')
+      .step('Error Step', () => {
+        throw new Error('Test error');
+      });
+
+    try {
+      await runner.run(errorWorkflow);
+    } catch (error) {
+      // Expected error
+    }
+
+    // Verify error event was dispatched
+    expect(mockAdapter.dispatch).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: WORKFLOW_EVENTS.ERROR,
+        error: expect.objectContaining({
+          message: 'Test error'
+        })
+      })
+    );
+  });
+
+  it('should truncate long values in verbose output', async () => {
+    const runner = new WorkflowRunner({
+      adapters: [],
+      fileStore,
+      logger: mockLogger,
+      verbose: true,
+      client: mockClient
+    });
+
+    const longString = 'a'.repeat(1000); // Make string much longer
+    const testWorkflow = workflow('Test Workflow')
+      .step('Test Step', () => ({
+        longString,
+        nested: { longString }
+      }));
+
+    await runner.run(testWorkflow);
+
+    const logCall = mockLogger.log.mock.calls.find(call =>
+      call[0].includes('Workflow completed:')
+    );
+
+    expect(logCall[0]).toContain('...');
+    expect(logCall[0].length).toBeLessThan(longString.length);
+  });
+
+  it('should maintain state between steps', async () => {
+    const runner = new WorkflowRunner({
+      adapters: [],
+      fileStore,
+      logger: mockLogger,
+      verbose: true,
+      client: mockClient
+    });
+
+    const testWorkflow = workflow('Test Workflow')
+      .step('First Step', () => ({ count: 1 }))
+      .step('Second Step', ({ state }) => ({
+        count: state.count + 1
+      }));
+
+    await runner.run(testWorkflow);
+
+    const finalLog = mockLogger.log.mock.calls.find(call =>
+      call[0].includes('Workflow completed:')
+    );
+
+    expect(finalLog[0]).toContain('"count": 2');
+  });
+});