@agnt5/sdk 0.2.1

package/dist/events.d.ts

@@ -0,0 +1,285 @@
+/**
+ * Event types for platform lifecycle tracking and streaming.
+ *
+ * Event hierarchy via correlation IDs:
+ *   RunStarted
+ *     → FunctionStarted / WorkflowStarted / AgentStarted / ToolStarted
+ *       → (component-specific events)
+ *     → FunctionCompleted / WorkflowCompleted / AgentCompleted / ToolCompleted
+ *   RunCompleted | RunFailed
+ *
+ * Two routing paths (matching Rust core's JournalEventMessage classification):
+ *   - Checkpoint events (lifecycle): persisted via WriteCheckpoint gRPC
+ *   - SSE-only events (streaming): queued → flush task → EventStream
+ */
+export interface BaseEvent {
+    /** Human-readable event name */
+    name: string;
+    /** Correlation ID linking related events */
+    correlationId: string;
+    /** Parent correlation ID for event hierarchy */
+    parentCorrelationId: string | null;
+    /** Unique event ID */
+    eventId: string;
+    /** Timestamp in nanoseconds */
+    timestampNs: bigint;
+    /** Discriminator for the event type */
+    eventType: string;
+    /** Arbitrary metadata */
+    metadata: Record<string, any>;
+}
+export interface AgentStarted extends BaseEvent {
+    eventType: 'agent.started';
+    agentName: string;
+    agentModel: string;
+    toolNames: string[];
+    maxIterations: number;
+}
+export interface AgentCompleted extends BaseEvent {
+    eventType: 'agent.completed';
+    agentName: string;
+    iterations: number;
+    toolCallsCount: number;
+    handoffTo: string | null;
+    outputLength: number;
+}
+export interface AgentFailed extends BaseEvent {
+    eventType: 'agent.failed';
+    agentName: string;
+    iterations: number;
+    error: string;
+}
+export interface AgentIterationStarted extends BaseEvent {
+    eventType: 'agent.iteration.started';
+    iteration: number;
+    maxIterations: number;
+}
+export interface AgentIterationCompleted extends BaseEvent {
+    eventType: 'agent.iteration.completed';
+    iteration: number;
+    hasToolCalls: boolean;
+    toolCallsCount: number;
+}
+export interface ToolCallStarted extends BaseEvent {
+    eventType: 'tool_call.started';
+    toolName: string;
+    toolCallId: string;
+}
+export interface ToolCallCompleted extends BaseEvent {
+    eventType: 'tool_call.completed';
+    toolName: string;
+    toolCallId: string;
+}
+export interface ToolCallFailed extends BaseEvent {
+    eventType: 'tool_call.failed';
+    toolName: string;
+    toolCallId: string;
+    error: string;
+}
+export type AgentEvent = AgentStarted | AgentCompleted | AgentFailed | AgentIterationStarted | AgentIterationCompleted | ToolCallStarted | ToolCallCompleted | ToolCallFailed;
+export declare function agentStarted(agentName: string, correlationId: string, opts: {
+    agentModel: string;
+    toolNames: string[];
+    maxIterations: number;
+}): AgentStarted;
+export declare function agentCompleted(agentName: string, correlationId: string, opts: {
+    iterations: number;
+    toolCallsCount: number;
+    handoffTo: string | null;
+    outputLength: number;
+}): AgentCompleted;
+export declare function agentFailed(agentName: string, correlationId: string, opts: {
+    iterations: number;
+    error: string;
+}): AgentFailed;
+export declare function iterationStarted(correlationId: string, parentCorrelationId: string, opts: {
+    iteration: number;
+    maxIterations: number;
+}): AgentIterationStarted;
+export declare function iterationCompleted(correlationId: string, parentCorrelationId: string, opts: {
+    iteration: number;
+    hasToolCalls: boolean;
+    toolCallsCount: number;
+}): AgentIterationCompleted;
+export declare function toolCallStarted(correlationId: string, parentCorrelationId: string, opts: {
+    toolName: string;
+    toolCallId: string;
+}): ToolCallStarted;
+export declare function toolCallCompleted(correlationId: string, parentCorrelationId: string, opts: {
+    toolName: string;
+    toolCallId: string;
+}): ToolCallCompleted;
+export declare function toolCallFailed(correlationId: string, parentCorrelationId: string, opts: {
+    toolName: string;
+    toolCallId: string;
+    error: string;
+}): ToolCallFailed;
+/**
+ * SSE-only events are ephemeral streaming/observability events.
+ * They are NOT persisted and flow through the journal queue flush task.
+ */
+export declare function isSseOnlyEvent(eventType: string): boolean;
+/**
+ * Checkpoint events are persisted lifecycle events that require sync acknowledgement.
+ * They flow through the WriteCheckpoint gRPC RPC.
+ */
+export declare function isCheckpointEvent(eventType: string): boolean;
+export interface RunStarted extends BaseEvent {
+    eventType: 'run.started';
+    inputData: any;
+    attempt: number;
+}
+export interface RunCompleted extends BaseEvent {
+    eventType: 'run.completed';
+    outputData: any;
+}
+export interface RunFailed extends BaseEvent {
+    eventType: 'run.failed';
+    errorCode: string;
+    errorMessage: string;
+    attempt: number;
+    maxAttempts: number;
+}
+export interface FunctionStarted extends BaseEvent {
+    eventType: 'function.started';
+    inputData: any;
+    attempt: number;
+}
+export interface FunctionCompleted extends BaseEvent {
+    eventType: 'function.completed';
+    outputData: any;
+    durationMs: number;
+}
+export interface FunctionFailed extends BaseEvent {
+    eventType: 'function.failed';
+    errorCode: string;
+    errorMessage: string;
+    durationMs: number;
+}
+export interface WorkflowStarted extends BaseEvent {
+    eventType: 'workflow.started';
+    inputData: any;
+    attempt: number;
+}
+export interface WorkflowCompleted extends BaseEvent {
+    eventType: 'workflow.completed';
+    outputData: any;
+    durationMs: number;
+}
+export interface WorkflowFailed extends BaseEvent {
+    eventType: 'workflow.failed';
+    errorCode: string;
+    errorMessage: string;
+    durationMs: number;
+}
+export interface WorkflowPaused extends BaseEvent {
+    eventType: 'workflow.paused';
+    reason: string;
+    pauseData: Record<string, any>;
+}
+export interface ToolStarted extends BaseEvent {
+    eventType: 'tool.started';
+    inputData: any;
+    attempt: number;
+}
+export interface ToolCompleted extends BaseEvent {
+    eventType: 'tool.completed';
+    outputData: any;
+    durationMs: number;
+}
+export interface ToolFailed extends BaseEvent {
+    eventType: 'tool.failed';
+    errorCode: string;
+    errorMessage: string;
+    durationMs: number;
+}
+export interface OutputStart extends BaseEvent {
+    eventType: 'output.start';
+}
+export interface OutputDelta extends BaseEvent {
+    eventType: 'output.delta';
+    content: string;
+    contentIndex: number;
+}
+export interface OutputStop extends BaseEvent {
+    eventType: 'output.stop';
+}
+export type LifecycleEvent = RunStarted | RunCompleted | RunFailed | FunctionStarted | FunctionCompleted | FunctionFailed | WorkflowStarted | WorkflowCompleted | WorkflowFailed | WorkflowPaused | ToolStarted | ToolCompleted | ToolFailed | OutputStart | OutputDelta | OutputStop;
+export type PlatformEvent = AgentEvent | LifecycleEvent;
+export declare function generateCid(): string;
+export declare function runStarted(correlationId: string, parentCorrelationId: string | null, opts: {
+    inputData: any;
+    attempt: number;
+}): RunStarted;
+export declare function runCompleted(correlationId: string, parentCorrelationId: string | null, opts: {
+    outputData: any;
+}): RunCompleted;
+export declare function runFailed(correlationId: string, parentCorrelationId: string | null, opts: {
+    errorCode: string;
+    errorMessage: string;
+    attempt: number;
+    maxAttempts: number;
+}): RunFailed;
+export declare function functionStarted(correlationId: string, parentCorrelationId: string, opts: {
+    inputData: any;
+    attempt: number;
+}): FunctionStarted;
+export declare function functionCompleted(correlationId: string, parentCorrelationId: string, opts: {
+    outputData: any;
+    durationMs: number;
+}): FunctionCompleted;
+export declare function functionFailed(correlationId: string, parentCorrelationId: string, opts: {
+    errorCode: string;
+    errorMessage: string;
+    durationMs: number;
+}): FunctionFailed;
+export declare function workflowStarted(correlationId: string, parentCorrelationId: string, opts: {
+    inputData: any;
+    attempt: number;
+}): WorkflowStarted;
+export declare function workflowCompleted(correlationId: string, parentCorrelationId: string, opts: {
+    outputData: any;
+    durationMs: number;
+}): WorkflowCompleted;
+export declare function workflowFailed(correlationId: string, parentCorrelationId: string, opts: {
+    errorCode: string;
+    errorMessage: string;
+    durationMs: number;
+}): WorkflowFailed;
+/**
+ * Workflow paused event — emitted when a workflow pauses for user input.
+ *
+ * The runtime projection treats `workflow.paused` as a terminal event for
+ * the gateway's `/v1/workflows/:name/run` endpoint (see
+ * runtime/crates/gateway/src/handlers/component.rs:160) and transitions the
+ * run's status to `paused` (see
+ * runtime/crates/processor/src/projections/runs.rs:130 apply_paused).
+ *
+ * Metadata carries fields the UI / resume endpoint need (question, options,
+ * pause_index, step_name, etc.) mirroring sdk-python's wait_for_input.
+ */
+export declare function workflowPaused(correlationId: string, parentCorrelationId: string, opts: {
+    reason: string;
+    pauseData: Record<string, any>;
+    metadata?: Record<string, string>;
+}): WorkflowPaused;
+export declare function toolStarted(correlationId: string, parentCorrelationId: string, opts: {
+    inputData: any;
+    attempt: number;
+}): ToolStarted;
+export declare function toolCompleted(correlationId: string, parentCorrelationId: string, opts: {
+    outputData: any;
+    durationMs: number;
+}): ToolCompleted;
+export declare function toolFailed(correlationId: string, parentCorrelationId: string, opts: {
+    errorCode: string;
+    errorMessage: string;
+    durationMs: number;
+}): ToolFailed;
+/**
+ * Convert a BaseEvent to a plain data payload for emission.
+ * Strips internal fields (correlationId, parentCorrelationId, eventId, etc.)
+ * and returns just the domain-specific data fields.
+ */
+export declare function toEventPayload(event: BaseEvent): Record<string, any>;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,256 @@
+/**
+ * Event types for platform lifecycle tracking and streaming.
+ *
+ * Event hierarchy via correlation IDs:
+ *   RunStarted
+ *     → FunctionStarted / WorkflowStarted / AgentStarted / ToolStarted
+ *       → (component-specific events)
+ *     → FunctionCompleted / WorkflowCompleted / AgentCompleted / ToolCompleted
+ *   RunCompleted | RunFailed
+ *
+ * Two routing paths (matching Rust core's JournalEventMessage classification):
+ *   - Checkpoint events (lifecycle): persisted via WriteCheckpoint gRPC
+ *   - SSE-only events (streaming): queued → flush task → EventStream
+ */
+import { randomUUID } from 'crypto';
+// ─── Factory helpers ─────────────────────────────────────────────────
+function baseFields(name, correlationId, parentCorrelationId, metadata = {}) {
+    return {
+        name,
+        correlationId,
+        parentCorrelationId,
+        eventId: randomUUID(),
+        timestampNs: BigInt(Date.now()) * 1000000n,
+        metadata,
+    };
+}
+export function agentStarted(agentName, correlationId, opts) {
+    return {
+        ...baseFields(`${agentName}.started`, correlationId, null),
+        eventType: 'agent.started',
+        agentName,
+        agentModel: opts.agentModel,
+        toolNames: opts.toolNames,
+        maxIterations: opts.maxIterations,
+    };
+}
+export function agentCompleted(agentName, correlationId, opts) {
+    return {
+        ...baseFields(`${agentName}.completed`, correlationId, null),
+        eventType: 'agent.completed',
+        agentName,
+        iterations: opts.iterations,
+        toolCallsCount: opts.toolCallsCount,
+        handoffTo: opts.handoffTo,
+        outputLength: opts.outputLength,
+    };
+}
+export function agentFailed(agentName, correlationId, opts) {
+    return {
+        ...baseFields(`${agentName}.failed`, correlationId, null),
+        eventType: 'agent.failed',
+        agentName,
+        iterations: opts.iterations,
+        error: opts.error,
+    };
+}
+export function iterationStarted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('iteration.started', correlationId, parentCorrelationId),
+        eventType: 'agent.iteration.started',
+        iteration: opts.iteration,
+        maxIterations: opts.maxIterations,
+    };
+}
+export function iterationCompleted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('iteration.completed', correlationId, parentCorrelationId),
+        eventType: 'agent.iteration.completed',
+        iteration: opts.iteration,
+        hasToolCalls: opts.hasToolCalls,
+        toolCallsCount: opts.toolCallsCount,
+    };
+}
+export function toolCallStarted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields(`tool.${opts.toolName}.started`, correlationId, parentCorrelationId),
+        eventType: 'tool_call.started',
+        toolName: opts.toolName,
+        toolCallId: opts.toolCallId,
+    };
+}
+export function toolCallCompleted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields(`tool.${opts.toolName}.completed`, correlationId, parentCorrelationId),
+        eventType: 'tool_call.completed',
+        toolName: opts.toolName,
+        toolCallId: opts.toolCallId,
+    };
+}
+export function toolCallFailed(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields(`tool.${opts.toolName}.failed`, correlationId, parentCorrelationId),
+        eventType: 'tool_call.failed',
+        toolName: opts.toolName,
+        toolCallId: opts.toolCallId,
+        error: opts.error,
+    };
+}
+// ─── Event classification (mirrors Rust JournalEventMessage) ────────
+/**
+ * SSE-only events are ephemeral streaming/observability events.
+ * They are NOT persisted and flow through the journal queue flush task.
+ */
+export function isSseOnlyEvent(eventType) {
+    return (eventType.startsWith('output.') ||
+        eventType.startsWith('lm.stream.') ||
+        eventType.startsWith('lm.message.') ||
+        eventType.startsWith('lm.thinking.') ||
+        eventType.startsWith('lm.tool_call.') ||
+        eventType.startsWith('progress.') ||
+        eventType.startsWith('log'));
+}
+/**
+ * Checkpoint events are persisted lifecycle events that require sync acknowledgement.
+ * They flow through the WriteCheckpoint gRPC RPC.
+ */
+export function isCheckpointEvent(eventType) {
+    return !isSseOnlyEvent(eventType);
+}
+// ─── Lifecycle factory helpers ──────────────────────────────────────
+export function generateCid() {
+    return randomUUID().slice(0, 8);
+}
+export function runStarted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('run.started', correlationId, parentCorrelationId),
+        eventType: 'run.started',
+        inputData: opts.inputData,
+        attempt: opts.attempt,
+    };
+}
+export function runCompleted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('run.completed', correlationId, parentCorrelationId),
+        eventType: 'run.completed',
+        outputData: opts.outputData,
+    };
+}
+export function runFailed(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('run.failed', correlationId, parentCorrelationId, {
+            attempt: String(opts.attempt),
+            max_attempts: String(opts.maxAttempts),
+        }),
+        eventType: 'run.failed',
+        errorCode: opts.errorCode,
+        errorMessage: opts.errorMessage,
+        attempt: opts.attempt,
+        maxAttempts: opts.maxAttempts,
+    };
+}
+export function functionStarted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('function.started', correlationId, parentCorrelationId),
+        eventType: 'function.started',
+        inputData: opts.inputData,
+        attempt: opts.attempt,
+    };
+}
+export function functionCompleted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('function.completed', correlationId, parentCorrelationId),
+        eventType: 'function.completed',
+        outputData: opts.outputData,
+        durationMs: opts.durationMs,
+    };
+}
+export function functionFailed(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('function.failed', correlationId, parentCorrelationId),
+        eventType: 'function.failed',
+        errorCode: opts.errorCode,
+        errorMessage: opts.errorMessage,
+        durationMs: opts.durationMs,
+    };
+}
+export function workflowStarted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('workflow.started', correlationId, parentCorrelationId),
+        eventType: 'workflow.started',
+        inputData: opts.inputData,
+        attempt: opts.attempt,
+    };
+}
+export function workflowCompleted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('workflow.completed', correlationId, parentCorrelationId),
+        eventType: 'workflow.completed',
+        outputData: opts.outputData,
+        durationMs: opts.durationMs,
+    };
+}
+export function workflowFailed(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('workflow.failed', correlationId, parentCorrelationId),
+        eventType: 'workflow.failed',
+        errorCode: opts.errorCode,
+        errorMessage: opts.errorMessage,
+        durationMs: opts.durationMs,
+    };
+}
+/**
+ * Workflow paused event — emitted when a workflow pauses for user input.
+ *
+ * The runtime projection treats `workflow.paused` as a terminal event for
+ * the gateway's `/v1/workflows/:name/run` endpoint (see
+ * runtime/crates/gateway/src/handlers/component.rs:160) and transitions the
+ * run's status to `paused` (see
+ * runtime/crates/processor/src/projections/runs.rs:130 apply_paused).
+ *
+ * Metadata carries fields the UI / resume endpoint need (question, options,
+ * pause_index, step_name, etc.) mirroring sdk-python's wait_for_input.
+ */
+export function workflowPaused(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('workflow.paused', correlationId, parentCorrelationId, opts.metadata || {}),
+        eventType: 'workflow.paused',
+        reason: opts.reason,
+        pauseData: opts.pauseData,
+    };
+}
+export function toolStarted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('tool.started', correlationId, parentCorrelationId),
+        eventType: 'tool.started',
+        inputData: opts.inputData,
+        attempt: opts.attempt,
+    };
+}
+export function toolCompleted(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('tool.completed', correlationId, parentCorrelationId),
+        eventType: 'tool.completed',
+        outputData: opts.outputData,
+        durationMs: opts.durationMs,
+    };
+}
+export function toolFailed(correlationId, parentCorrelationId, opts) {
+    return {
+        ...baseFields('tool.failed', correlationId, parentCorrelationId),
+        eventType: 'tool.failed',
+        errorCode: opts.errorCode,
+        errorMessage: opts.errorMessage,
+        durationMs: opts.durationMs,
+    };
+}
+/**
+ * Convert a BaseEvent to a plain data payload for emission.
+ * Strips internal fields (correlationId, parentCorrelationId, eventId, etc.)
+ * and returns just the domain-specific data fields.
+ */
+export function toEventPayload(event) {
+    const { name, correlationId, parentCorrelationId, eventId, timestampNs, eventType, metadata, ...data } = event;
+    return data;
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AA+FpC,wEAAwE;AAExE,SAAS,UAAU,CACjB,IAAY,EACZ,aAAqB,EACrB,mBAAkC,EAClC,WAAgC,EAAE;IAElC,OAAO;QACL,IAAI;QACJ,aAAa;QACb,mBAAmB;QACnB,OAAO,EAAE,UAAU,EAAE;QACrB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,QAAU;QAC5C,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,aAAqB,EACrB,IAAwE;IAExE,OAAO;QACL,GAAG,UAAU,CAAC,GAAG,SAAS,UAAU,EAAE,aAAa,EAAE,IAAI,CAAC;QAC1D,SAAS,EAAE,eAAe;QAC1B,SAAS;QACT,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,aAAqB,EACrB,IAAoG;IAEpG,OAAO;QACL,GAAG,UAAU,CAAC,GAAG,SAAS,YAAY,EAAE,aAAa,EAAE,IAAI,CAAC;QAC5D,SAAS,EAAE,iBAAiB;QAC5B,SAAS;QACT,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,SAAiB,EACjB,aAAqB,EACrB,IAA2C;IAE3C,OAAO;QACL,GAAG,UAAU,CAAC,GAAG,SAAS,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC;QACzD,SAAS,EAAE,cAAc;QACzB,SAAS;QACT,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,aAAqB,EACrB,mBAA2B,EAC3B,IAAkD;IAElD,OAAO;QACL,GAAG,UAAU,CAAC,mBAAmB,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACtE,SAAS,EAAE,yBAAyB;QACpC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,aAAqB,EACrB,mBAA2B,EAC3B,IAA0E;IAE1E,OAAO;QACL,GAAG,UAAU,CAAC,qBAAqB,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACxE,SAAS,EAAE,2BAA2B;QACtC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,aAAqB,EACrB,mBAA2B,EAC3B,IAA8C;IAE9C,OAAO;QACL,GAAG,UAAU,CAAC,QAAQ,IAAI,CAAC,QAAQ,UAAU,EAAE,aAAa,EAAE,mBAAmB,CAAC;QAClF,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,aAAqB,EACrB,mBAA2B,EAC3B,IAA8C;IAE9C,OAAO;QACL,GAAG,UAAU,CAAC,QAAQ,IAAI,CAAC,QAAQ,YAAY,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACpF,SAAS,EAAE,qBAAqB;QAChC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,aAAqB,EACrB,mBAA2B,EAC3B,IAA6D;IAE7D,OAAO;QACL,GAAG,UAAU,CAAC,QAAQ,IAAI,CAAC,QAAQ,SAAS,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACjF,SAAS,EAAE,kBAAkB;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;AACJ,CAAC;AAED,uEAAuE;AAEvE;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,CACL,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC;QAC/B,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC;QAClC,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC;QACnC,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC;QACpC,SAAS,CAAC,UAAU,CAAC,eAAe,CAAC;QACrC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC;QACjC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAC5B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAuHD,uEAAuE;AAEvE,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,aAAqB,EACrB,mBAAkC,EAClC,IAAyC;IAEzC,OAAO;QACL,GAAG,UAAU,CAAC,aAAa,EAAE,aAAa,EAAE,mBAAmB,CAAC;QAChE,SAAS,EAAE,aAAa;QACxB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,aAAqB,EACrB,mBAAkC,EAClC,IAAyB;IAEzB,OAAO;QACL,GAAG,UAAU,CAAC,eAAe,EAAE,aAAa,EAAE,mBAAmB,CAAC;QAClE,SAAS,EAAE,eAAe;QAC1B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,aAAqB,EACrB,mBAAkC,EAClC,IAAuF;IAEvF,OAAO;QACL,GAAG,UAAU,CAAC,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE;YAC9D,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YAC7B,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;SACvC,CAAC;QACF,SAAS,EAAE,YAAY;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,aAAqB,EACrB,mBAA2B,EAC3B,IAAyC;IAEzC,OAAO;QACL,GAAG,UAAU,CAAC,kBAAkB,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACrE,SAAS,EAAE,kBAAkB;QAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,aAAqB,EACrB,mBAA2B,EAC3B,IAA6C;IAE7C,OAAO;QACL,GAAG,UAAU,CAAC,oBAAoB,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACvE,SAAS,EAAE,oBAAoB;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,aAAqB,EACrB,mBAA2B,EAC3B,IAAqE;IAErE,OAAO;QACL,GAAG,UAAU,CAAC,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACpE,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,aAAqB,EACrB,mBAA2B,EAC3B,IAAyC;IAEzC,OAAO;QACL,GAAG,UAAU,CAAC,kBAAkB,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACrE,SAAS,EAAE,kBAAkB;QAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,aAAqB,EACrB,mBAA2B,EAC3B,IAA6C;IAE7C,OAAO;QACL,GAAG,UAAU,CAAC,oBAAoB,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACvE,SAAS,EAAE,oBAAoB;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,aAAqB,EACrB,mBAA2B,EAC3B,IAAqE;IAErE,OAAO;QACL,GAAG,UAAU,CAAC,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACpE,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,aAAqB,EACrB,mBAA2B,EAC3B,IAIC;IAED,OAAO;QACL,GAAG,UAAU,CAAC,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACzF,SAAS,EAAE,iBAAiB;QAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,aAAqB,EACrB,mBAA2B,EAC3B,IAAyC;IAEzC,OAAO;QACL,GAAG,UAAU,CAAC,cAAc,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACjE,SAAS,EAAE,cAAc;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,aAAqB,EACrB,mBAA2B,EAC3B,IAA6C;IAE7C,OAAO;QACL,GAAG,UAAU,CAAC,gBAAgB,EAAE,aAAa,EAAE,mBAAmB,CAAC;QACnE,SAAS,EAAE,gBAAgB;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,aAAqB,EACrB,mBAA2B,EAC3B,IAAqE;IAErE,OAAO;QACL,GAAG,UAAU,CAAC,aAAa,EAAE,aAAa,EAAE,mBAAmB,CAAC;QAChE,SAAS,EAAE,aAAa;QACxB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgB;IAC7C,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,mBAAmB,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAC/G,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/function.d.ts

@@ -0,0 +1,61 @@
+import type { FunctionHandler, FunctionOptions, RetryPolicy, BackoffPolicy } from './types';
+/**
+ * Function builder for creating durable functions
+ * @template TInput - Input parameter types
+ * @template TOutput - Return type
+ */
+export declare class FunctionBuilder<TInput = any, TOutput = any> {
+    private name;
+    private config;
+    constructor(name: string);
+    /**
+     * Configure retry policy
+     */
+    retry(policy: RetryPolicy): this;
+    /**
+     * Configure backoff strategy
+     */
+    backoff(policy: BackoffPolicy): this;
+    /**
+     * Configure timeout in milliseconds
+     */
+    timeout(ms: number): this;
+    /**
+     * Define the function handler
+     */
+    run(handler: FunctionHandler<TInput, TOutput>): FunctionHandler<TInput, TOutput>;
+}
+/**
+ * Create a new function builder
+ * @param name - Unique function name
+ * @returns Function builder instance
+ *
+ * @example
+ * ```typescript
+ * const greet = fn('greet').run(async (ctx, name: string) => {
+ *   return `Hello, ${name}!`;
+ * });
+ * ```
+ */
+export declare function fn<TInput = any, TOutput = any>(name: string): FunctionBuilder<TInput, TOutput>;
+/**
+ * Internal function registry
+ */
+declare class FunctionRegistry {
+    private static functions;
+    static register(name: string, config: {
+        handler: FunctionHandler;
+        options: FunctionOptions;
+    }): void;
+    static get(name: string): {
+        handler: FunctionHandler;
+        options: FunctionOptions;
+    } | undefined;
+    static getAll(): [string, {
+        handler: FunctionHandler;
+        options: FunctionOptions;
+    }][];
+    static clear(): void;
+}
+export { FunctionRegistry };
+//# sourceMappingURL=function.d.ts.map

package/dist/function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../src/function.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,WAAW,EACX,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,qBAAa,eAAe,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IAG1C,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,MAAM,CAAuB;gBAEjB,IAAI,EAAE,MAAM;IAEhC;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKhC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAKpC;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC;CASjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAC5C,IAAI,EAAE,MAAM,GACX,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAElC;AAED;;GAEG;AACH,cAAM,gBAAgB;IACpB,OAAO,CAAC,MAAM,CAAC,SAAS,CAGpB;IAEJ,MAAM,CAAC,QAAQ,CACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;QAAE,OAAO,EAAE,eAAe,CAAC;QAAC,OAAO,EAAE,eAAe,CAAA;KAAE;IAKhE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM;iBAVV,eAAe;iBAAW,eAAe;;IActD,MAAM,CAAC,MAAM;iBAdA,eAAe;iBAAW,eAAe;;IAkBtD,MAAM,CAAC,KAAK;CAGb;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}