@xyne/workflow-sdk 1.0.0

package/dist/agents/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Agent / LLM system types for the workflow SDK.
+ *
+ * Uses `@earendil-works/pi-agent-core` and `@earendil-works/pi-ai` as the
+ * base type system. This module re-exports the pi-mono types we use and
+ * defines SDK-specific types that augment them (pause protocol, capabilities,
+ * result shape, etc.).
+ *
+ * Only usable when pi-mono peer dependencies are installed.
+ */
+export type { AgentEvent, AgentTool, AgentToolResult, AgentToolUpdateCallback, AgentContext, AgentMessage, AgentLoopConfig, BeforeToolCallResult, AfterToolCallResult, BeforeToolCallContext, AfterToolCallContext, ThinkingLevel, } from '@earendil-works/pi-agent-core';
+export type { Message, UserMessage, AssistantMessage, ToolResultMessage, TextContent, ThinkingContent, ImageContent, ToolCall, Tool, Usage, Model, Context, StopReason, } from '@earendil-works/pi-ai';
+export type { TSchema, Static } from 'typebox';
+export { Type } from 'typebox';
+/** What capabilities a runtime implementation supports. */
+export interface AgentCapabilities {
+    /** Can yield token-level streaming events. */
+    streaming: boolean;
+    /** Can call tools. */
+    toolUse: boolean;
+    /** Supports beforeToolCall/afterToolCall hooks. */
+    hooks: boolean;
+    /** Can maintain conversation across multiple turns. */
+    multiTurn: boolean;
+}
+/**
+ * Hooks injected into the runtime by AgentStep.
+ * Mapped from the interceptor chain.
+ */
+export interface AgentHooks {
+    beforeToolCall?(tool: string, args: Record<string, unknown>): Promise<'allow' | 'deny' | 'pause'>;
+    afterToolCall?(tool: string, args: Record<string, unknown>, result: unknown): Promise<void>;
+}
+export type PauseRequestType = 'tool_approval' | 'input_required' | 'user_interrupted' | 'awaiting_feedback';
+/** Built by AgentStep when the agent needs to pause. */
+export interface PauseRequest {
+    type: PauseRequestType;
+    reason: string;
+    prompt: string;
+    /** Present for tool_approval pauses. */
+    tool?: {
+        name: string;
+        args: Record<string, unknown>;
+    };
+    /** Agent state to persist across the pause boundary. */
+    state: AgentPauseState;
+}
+export type { ResumePayload, ResumeAttachment, ResumeAction, } from '../common/resume-payload.js';
+/** Input to BaseAgentRuntime.execute(). */
+export interface AgentInput {
+    tools: import('@earendil-works/pi-agent-core').AgentTool[];
+    hooks: AgentHooks;
+    signal: AbortSignal;
+    /** Present when resuming from a pause. */
+    resume?: {
+        messages: import('@earendil-works/pi-agent-core').AgentMessage[];
+        payload: import('../common/resume-payload.js').ResumePayload;
+        pauseState: PauseRequest;
+    };
+}
+/** What the agent step persists across pause boundaries. */
+export interface AgentPauseState {
+    messages: import('@earendil-works/pi-agent-core').AgentMessage[];
+    pendingToolCalls?: import('@earendil-works/pi-ai').ToolCall[];
+    completedToolCallResults?: import('@earendil-works/pi-ai').ToolResultMessage[];
+    pausedAtToolIndex?: number;
+    currentTurn: number;
+    completedToolCalls: ToolCallRecord[];
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/** Record of a completed tool call with timing — written to workflow context. */
+export interface ToolCallRecord {
+    name: string;
+    args: Record<string, unknown>;
+    result: unknown;
+    durationMs: number;
+}
+/** Final output written to workflow context after agent execution. */
+export interface AgentResult extends Record<string, unknown> {
+    response: string;
+    toolCalls: ToolCallRecord[];
+    turnCount: number;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/agents/types.js

@@ -0,0 +1,12 @@
+/**
+ * Agent / LLM system types for the workflow SDK.
+ *
+ * Uses `@earendil-works/pi-agent-core` and `@earendil-works/pi-ai` as the
+ * base type system. This module re-exports the pi-mono types we use and
+ * defines SDK-specific types that augment them (pause protocol, capabilities,
+ * result shape, etc.).
+ *
+ * Only usable when pi-mono peer dependencies are installed.
+ */
+export { Type } from 'typebox';
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoCH,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC"}

package/dist/builder/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @xyne/workflow-sdk/builder — pure client-side utilities for workflow UIs.
+ *
+ * This subpath exports only the utilities needed to build workflow editors,
+ * variable pickers, condition builders, and schema-driven forms — without
+ * pulling in runtime, persistence, or server-side code.
+ *
+ * Usage:
+ * ```ts
+ * import {
+ *   tokenize, isPureRef, extractRefPath,
+ *   OPERATOR_DESCRIPTORS,
+ *   ConditionEvaluator,
+ *   zodToJsonSchemaRecord,
+ * } from '@xyne/workflow-sdk/builder';
+ * ```
+ */
+export { VARIABLE_REF_REGEX, VARIABLE_REF_DESCRIPTION_PREFIX, tokenize, isPureRef, extractRefPath, collectRefs, } from '../util/variable-ref.js';
+export type { VariableRefToken, FoundRef } from '../util/variable-ref.js';
+export { getAvailableContext } from '../engine/available-context.js';
+export type { AvailableContext } from '../engine/available-context.js';
+export { VariableResolver, resolvePath, stripNullForOptionalKeys, } from '../engine/variable-resolver.js';
+export { ConditionEvaluator } from '../engine/condition-evaluator.js';
+export { ConditionOperator, ConditionOperatorSchema, VALUE_LESS_OPERATORS, OPERATOR_DESCRIPTORS, } from '../types/operators.js';
+export type { OperatorDescriptor } from '../types/operators.js';
+export { variableRef, getVariableRefInnerSchema, LeafConditionSchema, ConditionSchema, readDottedPath, } from '../types/workflow-config.js';
+export type { LeafCondition, Condition, WorkflowStepConfig, WorkflowConfig, WorkflowSettings, } from '../types/workflow-config.js';
+export { zodToJsonSchemaRecord } from '../util/schema-convert.js';
+export type { TriggerContext, StepContextEntry, WorkflowContext, } from '../types/context.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAI1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAIvE,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AAIxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAItE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAIhE,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAIrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIlE,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,qBAAqB,CAAC"}

package/dist/builder/index.js

@@ -0,0 +1,32 @@
+/**
+ * @xyne/workflow-sdk/builder — pure client-side utilities for workflow UIs.
+ *
+ * This subpath exports only the utilities needed to build workflow editors,
+ * variable pickers, condition builders, and schema-driven forms — without
+ * pulling in runtime, persistence, or server-side code.
+ *
+ * Usage:
+ * ```ts
+ * import {
+ *   tokenize, isPureRef, extractRefPath,
+ *   OPERATOR_DESCRIPTORS,
+ *   ConditionEvaluator,
+ *   zodToJsonSchemaRecord,
+ * } from '@xyne/workflow-sdk/builder';
+ * ```
+ */
+// ─── Variable Reference Utilities ───
+export { VARIABLE_REF_REGEX, VARIABLE_REF_DESCRIPTION_PREFIX, tokenize, isPureRef, extractRefPath, collectRefs, } from '../util/variable-ref.js';
+// ─── Available Context ───
+export { getAvailableContext } from '../engine/available-context.js';
+// ─── Variable Resolution ───
+export { VariableResolver, resolvePath, stripNullForOptionalKeys, } from '../engine/variable-resolver.js';
+// ─── Condition Evaluation ───
+export { ConditionEvaluator } from '../engine/condition-evaluator.js';
+// ─── Operators ───
+export { ConditionOperator, ConditionOperatorSchema, VALUE_LESS_OPERATORS, OPERATOR_DESCRIPTORS, } from '../types/operators.js';
+// ─── Config Schema Helpers ───
+export { variableRef, getVariableRefInnerSchema, LeafConditionSchema, ConditionSchema, readDottedPath, } from '../types/workflow-config.js';
+// ─── Schema Conversion ───
+export { zodToJsonSchemaRecord } from '../util/schema-convert.js';
+//# sourceMappingURL=index.js.map

package/dist/builder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/builder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,uCAAuC;AAEvC,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,QAAQ,EACR,SAAS,EACT,cAAc,EACd,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAIjC,4BAA4B;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,8BAA8B;AAE9B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AAExC,+BAA+B;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,oBAAoB;AAEpB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAI/B,gCAAgC;AAEhC,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,6BAA6B,CAAC;AAUrC,4BAA4B;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @xyne/workflow-sdk/client — typed HTTP client for the workflow router.
+ *
+ * Usage:
+ * ```ts
+ * import { createWorkflowClient } from '@xyne/workflow-sdk/client';
+ *
+ * const client = createWorkflowClient({
+ *   baseUrl: '/api/workflows',
+ *   getHeaders: () => ({ Authorization: `Bearer ${token}` }),
+ * });
+ *
+ * const steps = await client.schema.steps();
+ * const result = await client.workflows.validate(config);
+ * ```
+ */
+export { createWorkflowClient, WorkflowClientError } from './workflow-client.js';
+export type { WorkflowClientConfig, WorkflowClient, SchemaClient, WorkflowsCrudClient, ExecutionsClient, CredentialsClient, UploadsClient, CreateWorkflowInput, UpdateWorkflowInput, ResumeInput, RerunInput, CreateCredentialInput, ExecutionListParams, ExecutionDetail, CredentialRecord, PaginatedList, WorkflowRecord, ExecutionRecord, StepRecord, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,YAAY,EAEV,oBAAoB,EAEpB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EAEb,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EAEnB,eAAe,EACf,gBAAgB,EAChB,aAAa,EAEb,cAAc,EACd,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,18 @@
+/**
+ * @xyne/workflow-sdk/client — typed HTTP client for the workflow router.
+ *
+ * Usage:
+ * ```ts
+ * import { createWorkflowClient } from '@xyne/workflow-sdk/client';
+ *
+ * const client = createWorkflowClient({
+ *   baseUrl: '/api/workflows',
+ *   getHeaders: () => ({ Authorization: `Bearer ${token}` }),
+ * });
+ *
+ * const steps = await client.schema.steps();
+ * const result = await client.workflows.validate(config);
+ * ```
+ */
+export { createWorkflowClient, WorkflowClientError } from './workflow-client.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/client/types.d.ts

@@ -0,0 +1,128 @@
+/**
+ * API contract types for the workflow client.
+ *
+ * These represent the request/response shapes for every router endpoint.
+ * Both the typed HTTP client and the UI hooks depend on these types.
+ * Persistence-level types (WorkflowRecord, ExecutionRecord, StepRecord)
+ * are re-exported from persistence/types.ts — single source of truth.
+ */
+import type { WorkflowConfig, WorkflowSettings } from '../types/workflow-config.js';
+import type { ValidationResult } from '../types/validation.js';
+import type { StepSummary, StepDescriptor } from '../steps/step-registry.js';
+import type { TriggerSummary, TriggerDescriptor } from '../triggers/trigger-registry.js';
+import type { OperatorDescriptor } from '../types/operators.js';
+import type { AvailableContext } from '../engine/available-context.js';
+import type { WorkflowRecord, ExecutionRecord, StepRecord } from '../persistence/types.js';
+import type { ResumePayload } from '../common/resume-payload.js';
+import type { Attachment } from '../common/attachment.js';
+export type { WorkflowRecord, ExecutionRecord, StepRecord, };
+export interface WorkflowClientConfig {
+    /** Base URL for the workflow router (e.g. "/api/workflows"). */
+    baseUrl: string;
+    /** Called per-request to get auth headers. Supports async for token rotation. */
+    getHeaders: () => Record<string, string> | Promise<Record<string, string>>;
+    /** Optional custom fetch — for interceptors, logging, test mocking, etc. */
+    fetch?: typeof globalThis.fetch;
+}
+export interface CreateWorkflowInput {
+    name: string;
+    config: WorkflowConfig;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateWorkflowInput {
+    name?: string;
+    config?: WorkflowConfig;
+    settings?: WorkflowSettings;
+    metadata?: Record<string, unknown>;
+}
+export interface ExecutionDetail extends ExecutionRecord {
+    steps: StepRecord[];
+    /** The workflow config snapshot at execution time. */
+    config?: WorkflowConfig;
+    /** Trigger payload that started this execution. */
+    triggerData?: Record<string, unknown>;
+}
+export interface ResumeInput {
+    data?: ResumePayload;
+    abort?: boolean;
+}
+export interface RerunInput {
+    fromStepId: string;
+    /** Overrides merged into the entry step's config before variable resolution. */
+    configOverrides?: Record<string, unknown>;
+    /** Defaults to true. When true, the entry step receives the source row's data as `priorState`. */
+    inheritStepState?: boolean;
+}
+export interface CredentialRecord {
+    name: string;
+    type: string;
+}
+export interface CreateCredentialInput {
+    name: string;
+    type: string;
+    data: Record<string, unknown>;
+}
+export interface PaginatedList<T> {
+    items: T[];
+    nextCursor?: string;
+}
+export interface ExecutionListParams {
+    workflowId?: string;
+    status?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface WorkflowClient {
+    /** Base URL for constructing SSE/EventSource URLs. */
+    readonly baseUrl: string;
+    readonly schema: SchemaClient;
+    readonly workflows: WorkflowsCrudClient;
+    readonly executions: ExecutionsClient;
+    readonly credentials: CredentialsClient;
+    readonly uploads: UploadsClient;
+}
+export interface SchemaClient {
+    steps(): Promise<StepSummary[]>;
+    step(type: string): Promise<StepDescriptor>;
+    triggers(): Promise<TriggerSummary[]>;
+    trigger(type: string): Promise<TriggerDescriptor>;
+    operators(): Promise<OperatorDescriptor[]>;
+    availableContext(config: WorkflowConfig, atStepId: string): Promise<AvailableContext | null>;
+}
+export interface WorkflowsCrudClient {
+    list(): Promise<WorkflowRecord[]>;
+    get(id: string): Promise<WorkflowRecord>;
+    create(input: CreateWorkflowInput): Promise<WorkflowRecord>;
+    update(id: string, input: UpdateWorkflowInput): Promise<WorkflowRecord>;
+    validate(config: WorkflowConfig): Promise<ValidationResult>;
+    activate(id: string): Promise<void>;
+    deactivate(id: string): Promise<void>;
+    trigger(id: string, payload?: Record<string, unknown>, attachments?: Attachment[]): Promise<{
+        executionId: string;
+    }>;
+}
+export interface UploadsClient {
+    /**
+     * Upload one or more files as multipart/form-data. The server stores them
+     * via its {@link StorageAdapter} and returns opaque {@link Attachment}
+     * references the caller can attach to a workflow trigger or resume payload.
+     */
+    create(files: File[] | Blob[]): Promise<{
+        attachments: Attachment[];
+    }>;
+}
+export interface ExecutionsClient {
+    list(params?: ExecutionListParams): Promise<PaginatedList<ExecutionRecord>>;
+    get(id: string): Promise<ExecutionDetail>;
+    resume(id: string, input?: ResumeInput): Promise<void>;
+    rerun(id: string, input: RerunInput): Promise<{
+        executionId: string;
+    }>;
+    cancel(id: string): Promise<void>;
+}
+export interface CredentialsClient {
+    list(): Promise<CredentialRecord[]>;
+    create(data: CreateCredentialInput): Promise<CredentialRecord>;
+    delete(name: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/client/types.js

@@ -0,0 +1,10 @@
+/**
+ * API contract types for the workflow client.
+ *
+ * These represent the request/response shapes for every router endpoint.
+ * Both the typed HTTP client and the UI hooks depend on these types.
+ * Persistence-level types (WorkflowRecord, ExecutionRecord, StepRecord)
+ * are re-exported from persistence/types.ts — single source of truth.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

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

package/dist/client/workflow-client.d.ts

@@ -0,0 +1,15 @@
+/**
+ * createWorkflowClient — typed HTTP client for the workflow router.
+ *
+ * Framework-agnostic: works in browsers, Node, Deno, Bun — anywhere
+ * that has a global `fetch`. The UI hooks wrap this with TanStack Query
+ * for caching/polling; this layer is pure fetch + type safety.
+ */
+import type { WorkflowClientConfig, WorkflowClient } from './types.js';
+export declare class WorkflowClientError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+export declare function createWorkflowClient(config: WorkflowClientConfig): WorkflowClient;
+//# sourceMappingURL=workflow-client.d.ts.map

package/dist/client/workflow-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-client.d.ts","sourceRoot":"","sources":["../../src/client/workflow-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EAiBf,MAAM,YAAY,CAAC;AAWpB,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,OAAO;gBAF7B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO;CAKhC;AA8UD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,GAC3B,cAAc,CAShB"}