convex-effect-workflows 0.1.0

package/dist/component/spans.js

@@ -0,0 +1,190 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server.js";
+import { vSpanKind, vSpanStatus } from "../shared/validators.js";
+import { generateSpanId, nowTs } from "./utils.js";
+import { persistBoundedPayload } from "./payloads.js";
+import { MAX_SPAN_ATTR_BYTES } from "../shared/constants.js";
+async function getSpan(ctx, executionId, spanId) {
+    return await ctx.db
+        .query("spans")
+        .withIndex("by_execution_span", (q) => q.eq("executionId", executionId).eq("spanId", spanId))
+        .unique();
+}
+export const createSpan = mutation({
+    args: {
+        executionId: v.string(),
+        traceId: v.string(),
+        spanId: v.optional(v.string()),
+        parentSpanId: v.optional(v.string()),
+        stepNumber: v.optional(v.number()),
+        name: v.string(),
+        kind: vSpanKind,
+        attempt: v.optional(v.number()),
+        input: v.optional(v.any()),
+        attributes: v.optional(v.any()),
+    },
+    returns: v.object({ spanId: v.string(), created: v.boolean() }),
+    handler: async (ctx, args) => {
+        const spanId = args.spanId ?? generateSpanId();
+        const existing = await getSpan(ctx, args.executionId, spanId);
+        if (existing) {
+            return { spanId, created: false };
+        }
+        const inputPayload = args.input === undefined
+            ? { size: 0, ref: undefined, preview: undefined }
+            : await persistBoundedPayload(ctx, "spanInput", args.input);
+        const attrPayload = args.attributes === undefined
+            ? undefined
+            : await persistBoundedPayload(ctx, "logData", args.attributes, MAX_SPAN_ATTR_BYTES);
+        await ctx.db.insert("spans", {
+            executionId: args.executionId,
+            traceId: args.traceId,
+            spanId,
+            parentSpanId: args.parentSpanId,
+            stepNumber: args.stepNumber,
+            name: args.name,
+            kind: args.kind,
+            status: "started",
+            startTime: nowTs(),
+            attempt: args.attempt,
+            attributes: attrPayload?.preview,
+            inputRef: inputPayload.ref,
+            inputPreview: inputPayload.preview,
+            inputSize: inputPayload.size,
+        });
+        return { spanId, created: true };
+    },
+});
+export const endSpan = mutation({
+    args: {
+        executionId: v.string(),
+        spanId: v.string(),
+        output: v.optional(v.any()),
+        error: v.optional(v.string()),
+        attributes: v.optional(v.any()),
+    },
+    returns: v.object({ changed: v.boolean() }),
+    handler: async (ctx, args) => {
+        const span = await getSpan(ctx, args.executionId, args.spanId);
+        if (!span) {
+            throw new Error(`Span not found: ${args.executionId}/${args.spanId}`);
+        }
+        if (span.status === "ended") {
+            return { changed: false };
+        }
+        const outputPayload = args.output === undefined
+            ? { size: undefined, ref: undefined, preview: undefined }
+            : await persistBoundedPayload(ctx, "spanOutput", args.output);
+        const attrPayload = args.attributes === undefined
+            ? undefined
+            : await persistBoundedPayload(ctx, "logData", args.attributes, MAX_SPAN_ATTR_BYTES);
+        await ctx.db.patch(span._id, {
+            status: "ended",
+            endTime: nowTs(),
+            outputRef: outputPayload.ref,
+            outputPreview: outputPayload.preview,
+            outputSize: outputPayload.size,
+            attributes: attrPayload?.preview ?? span.attributes,
+            error: args.error,
+        });
+        return { changed: true };
+    },
+});
+export const getExecutionSpan = query({
+    args: {
+        executionId: v.string(),
+        spanId: v.string(),
+    },
+    returns: v.any(),
+    handler: async (ctx, args) => {
+        return await getSpan(ctx, args.executionId, args.spanId);
+    },
+});
+export const listExecutionSpans = query({
+    args: {
+        executionId: v.string(),
+        limit: v.number(),
+        afterStartTime: v.optional(v.number()),
+        kind: v.optional(vSpanKind),
+        status: v.optional(vSpanStatus),
+    },
+    returns: v.any(),
+    handler: async (ctx, args) => {
+        const limit = Math.max(1, Math.min(args.limit, 500));
+        let rows = await ctx.db
+            .query("spans")
+            .withIndex("by_execution_start", (q) => q.eq("executionId", args.executionId))
+            .take(limit + 200);
+        if (args.afterStartTime !== undefined) {
+            rows = rows.filter((row) => row.startTime > args.afterStartTime);
+        }
+        if (args.kind) {
+            rows = rows.filter((row) => row.kind === args.kind);
+        }
+        if (args.status) {
+            rows = rows.filter((row) => row.status === args.status);
+        }
+        rows.sort((a, b) => a.startTime - b.startTime);
+        const page = rows.slice(0, limit);
+        const nextAfterStartTime = rows.length > limit ? page[page.length - 1]?.startTime : undefined;
+        return { page, nextAfterStartTime };
+    },
+});
+/**
+ * Test helper for creating a span with full control over fields including status, startTime, and endTime.
+ */
+export const internalCreateSpan = mutation({
+    args: {
+        executionId: v.string(),
+        traceId: v.string(),
+        spanId: v.optional(v.string()),
+        parentSpanId: v.optional(v.string()),
+        stepNumber: v.optional(v.number()),
+        name: v.string(),
+        kind: vSpanKind,
+        status: vSpanStatus,
+        startTime: v.number(),
+        endTime: v.optional(v.number()),
+        attempt: v.optional(v.number()),
+        input: v.optional(v.any()),
+        output: v.optional(v.any()),
+        error: v.optional(v.string()),
+        attributes: v.optional(v.any()),
+    },
+    returns: v.object({ spanId: v.string() }),
+    handler: async (ctx, args) => {
+        const spanId = args.spanId ?? generateSpanId();
+        const inputPayload = args.input === undefined
+            ? { size: 0, ref: undefined, preview: undefined }
+            : await persistBoundedPayload(ctx, "spanInput", args.input);
+        const outputPayload = args.output === undefined
+            ? { size: undefined, ref: undefined, preview: undefined }
+            : await persistBoundedPayload(ctx, "spanOutput", args.output);
+        const attrPayload = args.attributes === undefined
+            ? undefined
+            : await persistBoundedPayload(ctx, "logData", args.attributes, MAX_SPAN_ATTR_BYTES);
+        await ctx.db.insert("spans", {
+            executionId: args.executionId,
+            traceId: args.traceId,
+            spanId,
+            parentSpanId: args.parentSpanId,
+            stepNumber: args.stepNumber,
+            name: args.name,
+            kind: args.kind,
+            status: args.status,
+            startTime: args.startTime,
+            endTime: args.endTime,
+            attempt: args.attempt,
+            attributes: attrPayload?.preview,
+            inputRef: inputPayload.ref,
+            inputPreview: inputPayload.preview,
+            inputSize: inputPayload.size,
+            outputRef: outputPayload.ref,
+            outputPreview: outputPayload.preview,
+            outputSize: outputPayload.size,
+            error: args.error,
+        });
+        return { spanId };
+    },
+});
+//# sourceMappingURL=spans.js.map

package/dist/component/spans.js.map

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

package/dist/component/utils.d.ts

@@ -0,0 +1,15 @@
+import { type Value } from "convex/values";
+export declare function nowTs(): number;
+export declare function randomHex(size?: number): string;
+export declare function generateTraceId(): string;
+export declare function generateSpanId(): string;
+type TruncatedPreview = {
+    _truncated: true;
+    preview: string;
+    originalSize?: number;
+};
+export declare function valueSize(value: unknown): number;
+export declare function toPreview(value: unknown, maxBytes?: number): Value | TruncatedPreview | undefined;
+export declare function shouldOffload(value: unknown, inlineLimit?: number): boolean;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/component/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/component/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAM1D,wBAAgB,KAAK,WAEpB;AAED,wBAAgB,SAAS,CAAC,IAAI,SAAK,GAAG,MAAM,CAI3C;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,KAAK,gBAAgB,GAAG;IACtB,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQhD;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,QAAQ,SAA2B,GAClC,KAAK,GAAG,gBAAgB,GAAG,SAAS,CAyBtC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,SAA2B,WAEnF"}

package/dist/component/utils.js

@@ -0,0 +1,53 @@
+import { getConvexSize } from "convex/values";
+import { MAX_INLINE_PAYLOAD_BYTES, MAX_PREVIEW_STRING_BYTES, } from "../shared/constants.js";
+export function nowTs() {
+    return Date.now();
+}
+export function randomHex(size = 16) {
+    const bytes = new Uint8Array(size);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+export function generateTraceId() {
+    return randomHex(16);
+}
+export function generateSpanId() {
+    return randomHex(8);
+}
+export function valueSize(value) {
+    try {
+        // Boundary note: getConvexSize validates Convex Value shape at runtime and
+        // throws for unsupported values, which we convert to size=0.
+        return getConvexSize((value ?? null));
+    }
+    catch {
+        return 0;
+    }
+}
+export function toPreview(value, maxBytes = MAX_PREVIEW_STRING_BYTES) {
+    if (value === undefined) {
+        return undefined;
+    }
+    let json;
+    try {
+        json = JSON.stringify(value);
+    }
+    catch {
+        return { _truncated: true, preview: "<non-serializable>" };
+    }
+    if (json === undefined) {
+        return { _truncated: true, preview: "<non-serializable>" };
+    }
+    if (json.length <= maxBytes) {
+        return value;
+    }
+    return {
+        _truncated: true,
+        preview: json.slice(0, maxBytes),
+        originalSize: json.length,
+    };
+}
+export function shouldOffload(value, inlineLimit = MAX_INLINE_PAYLOAD_BYTES) {
+    return valueSize(value) > inlineLimit;
+}
+//# sourceMappingURL=utils.js.map

package/dist/component/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/component/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAc,MAAM,eAAe,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,UAAU,KAAK;IACnB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAI,GAAG,EAAE;IACjC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAQD,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,CAAC;QACH,2EAA2E;QAC3E,6DAA6D;QAC7D,OAAO,aAAa,CAAC,CAAC,KAAK,IAAI,IAAI,CAAU,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,KAAc,EACd,QAAQ,GAAG,wBAAwB;IAEnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,IAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAC7D,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAC7D,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAc,CAAC;IACxB,CAAC;IAED,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;QAChC,YAAY,EAAE,IAAI,CAAC,MAAM;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,WAAW,GAAG,wBAAwB;IAClF,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC;AACxC,CAAC"}

package/dist/shared/constants.d.ts

@@ -0,0 +1,12 @@
+export declare const COMPONENT_NAME = "effectWorkflows";
+export declare const MAX_INLINE_PAYLOAD_BYTES = 256000;
+export declare const MAX_PREVIEW_STRING_BYTES = 4096;
+export declare const MAX_LOG_DATA_BYTES = 64000;
+export declare const MAX_SPAN_ATTR_BYTES = 64000;
+export declare const DEFAULT_EXECUTIONS_PAGE_SIZE = 50;
+export declare const DEFAULT_STEPS_PAGE_SIZE = 100;
+export declare const DEFAULT_SPANS_PAGE_SIZE = 200;
+export declare const DEFAULT_LOGS_PAGE_SIZE = 200;
+export declare const MAX_PAGE_SIZE = 500;
+export declare const DEFAULT_RETENTION_DAYS = 30;
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAChD,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,eAAO,MAAM,sBAAsB,KAAK,CAAC"}

package/dist/shared/constants.js

@@ -0,0 +1,12 @@
+export const COMPONENT_NAME = "effectWorkflows";
+export const MAX_INLINE_PAYLOAD_BYTES = 256_000;
+export const MAX_PREVIEW_STRING_BYTES = 4_096;
+export const MAX_LOG_DATA_BYTES = 64_000;
+export const MAX_SPAN_ATTR_BYTES = 64_000;
+export const DEFAULT_EXECUTIONS_PAGE_SIZE = 50;
+export const DEFAULT_STEPS_PAGE_SIZE = 100;
+export const DEFAULT_SPANS_PAGE_SIZE = 200;
+export const DEFAULT_LOGS_PAGE_SIZE = 200;
+export const MAX_PAGE_SIZE = 500;
+export const DEFAULT_RETENTION_DAYS = 30;
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAEhD,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAChD,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAC9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAC/C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC"}

package/dist/shared/validators.d.ts

@@ -0,0 +1,69 @@
+import { type Infer } from "convex/values";
+export declare const vExecutionStatus: import("convex/values").VUnion<"pending" | "running" | "suspended" | "completed" | "failed" | "interrupted", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"running", "required">, import("convex/values").VLiteral<"suspended", "required">, import("convex/values").VLiteral<"completed", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"interrupted", "required">], "required", never>;
+export type ExecutionStatus = Infer<typeof vExecutionStatus>;
+export declare const vStepKind: import("convex/values").VUnion<"activity" | "system" | "deferred" | "clock" | "nestedWorkflow", [import("convex/values").VLiteral<"activity", "required">, import("convex/values").VLiteral<"deferred", "required">, import("convex/values").VLiteral<"clock", "required">, import("convex/values").VLiteral<"nestedWorkflow", "required">, import("convex/values").VLiteral<"system", "required">], "required", never>;
+export type StepKind = Infer<typeof vStepKind>;
+export declare const vStepState: import("convex/values").VUnion<"suspended" | "completed" | "failed" | "started" | "canceled", [import("convex/values").VLiteral<"started", "required">, import("convex/values").VLiteral<"suspended", "required">, import("convex/values").VLiteral<"completed", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"canceled", "required">], "required", never>;
+export type StepState = Infer<typeof vStepState>;
+export declare const vResultEnvelope: import("convex/values").VUnion<{
+    valueRef?: import("convex/values").GenericId<"payloads"> | undefined;
+    valuePreview?: any;
+    kind: "success";
+} | {
+    valueRef?: import("convex/values").GenericId<"payloads"> | undefined;
+    valuePreview?: any;
+    error: string;
+    kind: "failed";
+} | {
+    kind: "canceled";
+}, [import("convex/values").VObject<{
+    valueRef?: import("convex/values").GenericId<"payloads"> | undefined;
+    valuePreview?: any;
+    kind: "success";
+}, {
+    kind: import("convex/values").VLiteral<"success", "required">;
+    valueRef: import("convex/values").VId<import("convex/values").GenericId<"payloads"> | undefined, "optional">;
+    valuePreview: import("convex/values").VAny<any, "optional", string>;
+}, "required", "kind" | "valueRef" | "valuePreview" | `valuePreview.${string}`>, import("convex/values").VObject<{
+    valueRef?: import("convex/values").GenericId<"payloads"> | undefined;
+    valuePreview?: any;
+    error: string;
+    kind: "failed";
+}, {
+    kind: import("convex/values").VLiteral<"failed", "required">;
+    error: import("convex/values").VString<string, "required">;
+    valueRef: import("convex/values").VId<import("convex/values").GenericId<"payloads"> | undefined, "optional">;
+    valuePreview: import("convex/values").VAny<any, "optional", string>;
+}, "required", "error" | "kind" | "valueRef" | "valuePreview" | `valuePreview.${string}`>, import("convex/values").VObject<{
+    kind: "canceled";
+}, {
+    kind: import("convex/values").VLiteral<"canceled", "required">;
+}, "required", "kind">], "required", "error" | "kind" | "valueRef" | "valuePreview" | `valuePreview.${string}`>;
+export type ResultEnvelope = Infer<typeof vResultEnvelope>;
+export declare const vDeterminismSignature: import("convex/values").VObject<{
+    attempt?: number | undefined;
+    scheduleMeta?: any;
+    schemaVersion?: number | undefined;
+    kind: "activity" | "system" | "deferred" | "clock" | "nestedWorkflow";
+    opName: string;
+}, {
+    kind: import("convex/values").VUnion<"activity" | "system" | "deferred" | "clock" | "nestedWorkflow", [import("convex/values").VLiteral<"activity", "required">, import("convex/values").VLiteral<"deferred", "required">, import("convex/values").VLiteral<"clock", "required">, import("convex/values").VLiteral<"nestedWorkflow", "required">, import("convex/values").VLiteral<"system", "required">], "required", never>;
+    opName: import("convex/values").VString<string, "required">;
+    attempt: import("convex/values").VFloat64<number | undefined, "optional">;
+    scheduleMeta: import("convex/values").VAny<any, "optional", string>;
+    schemaVersion: import("convex/values").VFloat64<number | undefined, "optional">;
+}, "required", "kind" | "attempt" | "opName" | "scheduleMeta" | "schemaVersion" | `scheduleMeta.${string}`>;
+export type DeterminismSignature = Infer<typeof vDeterminismSignature>;
+export declare const vSpanKind: import("convex/values").VUnion<"workflow" | "activity" | "system" | "deferred" | "clock", [import("convex/values").VLiteral<"workflow", "required">, import("convex/values").VLiteral<"activity", "required">, import("convex/values").VLiteral<"deferred", "required">, import("convex/values").VLiteral<"clock", "required">, import("convex/values").VLiteral<"system", "required">], "required", never>;
+export type SpanKind = Infer<typeof vSpanKind>;
+export declare const vSpanStatus: import("convex/values").VUnion<"started" | "ended", [import("convex/values").VLiteral<"started", "required">, import("convex/values").VLiteral<"ended", "required">], "required", never>;
+export type SpanStatus = Infer<typeof vSpanStatus>;
+export declare const vLogLevel: import("convex/values").VUnion<"debug" | "info" | "warn" | "error", [import("convex/values").VLiteral<"debug", "required">, import("convex/values").VLiteral<"info", "required">, import("convex/values").VLiteral<"warn", "required">, import("convex/values").VLiteral<"error", "required">], "required", never>;
+export type LogLevel = Infer<typeof vLogLevel>;
+export declare const vLogSource: import("convex/values").VUnion<"workflow" | "activity" | "engine" | "system", [import("convex/values").VLiteral<"workflow", "required">, import("convex/values").VLiteral<"activity", "required">, import("convex/values").VLiteral<"engine", "required">, import("convex/values").VLiteral<"system", "required">], "required", never>;
+export type LogSource = Infer<typeof vLogSource>;
+export declare const vSortOrder: import("convex/values").VUnion<"asc" | "desc", [import("convex/values").VLiteral<"asc", "required">, import("convex/values").VLiteral<"desc", "required">], "required", never>;
+export type SortOrder = Infer<typeof vSortOrder>;
+export declare const vPayloadKind: import("convex/values").VUnion<"executionPayload" | "stepInput" | "stepOutput" | "deferredExit" | "spanInput" | "spanOutput" | "logData", [import("convex/values").VLiteral<"executionPayload", "required">, import("convex/values").VLiteral<"stepInput", "required">, import("convex/values").VLiteral<"stepOutput", "required">, import("convex/values").VLiteral<"deferredExit", "required">, import("convex/values").VLiteral<"spanInput", "required">, import("convex/values").VLiteral<"spanOutput", "required">, import("convex/values").VLiteral<"logData", "required">], "required", never>;
+export type PayloadKind = Infer<typeof vPayloadKind>;
+//# sourceMappingURL=validators.d.ts.map

package/dist/shared/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/shared/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAE9C,eAAO,MAAM,gBAAgB,geAO5B,CAAC;AACF,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D,eAAO,MAAM,SAAS,yZAMrB,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE/C,eAAO,MAAM,UAAU,qZAMtB,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAIjD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+GAa3B,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE3D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;2GAMhC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEvE,eAAO,MAAM,SAAS,6YAMrB,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE/C,eAAO,MAAM,WAAW,0LAAoD,CAAC;AAC7E,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEnD,eAAO,MAAM,SAAS,oTAKrB,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE/C,eAAO,MAAM,UAAU,wUAKtB,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEjD,eAAO,MAAM,UAAU,gLAA+C,CAAC;AACvE,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEjD,eAAO,MAAM,YAAY,ukBAQxB,CAAC;AACF,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/shared/validators.js

@@ -0,0 +1,30 @@
+import { v } from "convex/values";
+export const vExecutionStatus = v.union(v.literal("pending"), v.literal("running"), v.literal("suspended"), v.literal("completed"), v.literal("failed"), v.literal("interrupted"));
+export const vStepKind = v.union(v.literal("activity"), v.literal("deferred"), v.literal("clock"), v.literal("nestedWorkflow"), v.literal("system"));
+export const vStepState = v.union(v.literal("started"), v.literal("suspended"), v.literal("completed"), v.literal("failed"), v.literal("canceled"));
+// valuePreview intentionally remains v.any(): previews can be raw inline values
+// or truncated preview envelopes for arbitrary user payloads.
+export const vResultEnvelope = v.union(v.object({
+    kind: v.literal("success"),
+    valueRef: v.optional(v.id("payloads")),
+    valuePreview: v.optional(v.any()),
+}), v.object({
+    kind: v.literal("failed"),
+    error: v.string(),
+    valueRef: v.optional(v.id("payloads")),
+    valuePreview: v.optional(v.any()),
+}), v.object({ kind: v.literal("canceled") }));
+export const vDeterminismSignature = v.object({
+    kind: vStepKind,
+    opName: v.string(),
+    attempt: v.optional(v.number()),
+    scheduleMeta: v.optional(v.any()),
+    schemaVersion: v.optional(v.number()),
+});
+export const vSpanKind = v.union(v.literal("workflow"), v.literal("activity"), v.literal("deferred"), v.literal("clock"), v.literal("system"));
+export const vSpanStatus = v.union(v.literal("started"), v.literal("ended"));
+export const vLogLevel = v.union(v.literal("debug"), v.literal("info"), v.literal("warn"), v.literal("error"));
+export const vLogSource = v.union(v.literal("workflow"), v.literal("activity"), v.literal("engine"), v.literal("system"));
+export const vSortOrder = v.union(v.literal("asc"), v.literal("desc"));
+export const vPayloadKind = v.union(v.literal("executionPayload"), v.literal("stepInput"), v.literal("stepOutput"), v.literal("deferredExit"), v.literal("spanInput"), v.literal("spanOutput"), v.literal("logData"));
+//# sourceMappingURL=validators.js.map

package/dist/shared/validators.js.map

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

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "convex-effect-workflows",
+  "version": "0.1.0",
+  "description": "Effect-native Convex workflow engine with durable observability",
+  "keywords": [
+    "convex",
+    "effect",
+    "workflow",
+    "durable-execution",
+    "observability"
+  ],
+  "homepage": "https://github.com/ebg1223/convex-effect-workflows",
+  "repository": "github:ebg1223/convex-effect-workflows",
+  "license": "Apache-2.0",
+  "type": "module",
+  "packageManager": "bun@1.3.10",
+  "scripts": {
+    "dev": "run-p -r 'dev:*'",
+    "dev:backend": "convex dev --typecheck-components",
+    "dev:example": "cd example/convex && convex dev --typecheck-components",
+    "dev:build": "chokidar 'tsconfig*.json' 'src/**/*.ts' -i '**/*.test.ts' -c 'bun run build:codegen' --initial",
+    "predev": "path-exists .env.local dist || (bun run build && convex dev --once)",
+    "build": "tsc --project ./tsconfig.build.json",
+    "build:codegen": "convex codegen --component-dir ./src/component && bun run build",
+    "build:clean": "rm -rf dist *.tsbuildinfo && bun run build:codegen",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "preversion": "bun install --frozen-lockfile && bun run build:clean && bun run test && bun run typecheck"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./test": "./src/test.ts",
+    "./_generated/component.js": {
+      "types": "./dist/component/_generated/component.d.ts"
+    },
+    "./convex.config": {
+      "types": "./dist/component/convex.config.d.ts",
+      "default": "./dist/component/convex.config.js"
+    },
+    "./convex.config.js": {
+      "types": "./dist/component/convex.config.d.ts",
+      "default": "./dist/component/convex.config.js"
+    }
+  },
+  "peerDependencies": {
+    "@convex-dev/workpool": "^0.4.0",
+    "@effect/workflow": "^0.16.0",
+    "convex": "^1.32.0",
+    "effect": "^3.19.0"
+  },
+  "devDependencies": {
+    "@convex-dev/workpool": "0.4.0",
+    "@types/node": "^24.10.0",
+    "chokidar-cli": "3.0.0",
+    "convex": "1.32.0",
+    "convex-helpers": "0.1.114",
+    "convex-test": "0.0.41",
+    "npm-run-all2": "8.0.4",
+    "path-exists-cli": "2.0.0",
+    "typescript": "5.9.3",
+    "vitest": "4.0.18"
+  },
+  "types": "./dist/client/index.d.ts",
+  "module": "./dist/client/index.js"
+}

package/src/client/ConvexCtx.ts

@@ -0,0 +1,21 @@
+import * as Context from "effect/Context";
+import type { GenericActionCtx, GenericDataModel, GenericMutationCtx } from "convex/server";
+
+export type ConvexWorkflowCtx = Pick<
+  GenericMutationCtx<GenericDataModel>,
+  "runMutation" | "runQuery" | "scheduler"
+>;
+
+export type ConvexWorkflowActionCtx = Pick<
+  GenericActionCtx<GenericDataModel>,
+  "runMutation" | "runQuery" | "runAction"
+>;
+
+export class ConvexCtx extends Context.Tag("convex-effect-workflows/ConvexCtx")<
+  ConvexCtx,
+  ConvexWorkflowCtx
+>() {}
+
+export class ConvexActionCtx extends Context.Tag(
+  "convex-effect-workflows/ConvexActionCtx",
+)<ConvexActionCtx, ConvexWorkflowActionCtx>() {}

package/src/client/ConvexLogger.ts

@@ -0,0 +1,52 @@
+import * as HashMap from "effect/HashMap";
+import * as List from "effect/List";
+import * as Logger from "effect/Logger";
+import * as Option from "effect/Option";
+import type { FiberId } from "effect/FiberId";
+import type { GenericMutationCtx, GenericDataModel } from "convex/server";
+import type { ComponentApi } from "../component/_generated/component.js";
+
+type MutationRunCtx = Pick<
+  GenericMutationCtx<GenericDataModel>,
+  "runMutation"
+>;
+
+function messageToString(message: unknown): string {
+  if (typeof message === "string") return message;
+  try {
+    return JSON.stringify(message);
+  } catch {
+    return String(message);
+  }
+}
+
+export function makeConvexLogger(
+  component: ComponentApi,
+  ctx: MutationRunCtx,
+  executionId: string,
+  traceId?: string,
+): Logger.Logger<unknown, void> {
+  return Logger.make((options) => {
+    const span = List.head(options.spans);
+    const spanId = Option.match(span, {
+      onNone: () => undefined,
+      onSome: (currentSpan) => currentSpan.label,
+    });
+
+    void ctx
+      .runMutation(component.logs.appendLog, {
+        executionId,
+        traceId,
+        spanId,
+        level: (options.logLevel.label.toLowerCase() as "debug" | "info" | "warn" | "error"),
+        source: "workflow",
+        message: messageToString(options.message),
+        data: {
+          annotations: HashMap.toEntries(options.annotations),
+        },
+      })
+      .catch(() => {
+        // Never fail the workflow because logging persistence fails.
+      });
+  });
+}