@codemation/core 0.0.19 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @codemation/core
 
+## 0.2.1
+
+### Patch Changes
+
+- [#44](https://github.com/MadeRelevant/codemation/pull/44) [`4989e9c`](https://github.com/MadeRelevant/codemation/commit/4989e9c7d97513c05904d47d2f85794ba716a4d3) Thanks [@cblokland90](https://github.com/cblokland90)! - Add optional `icon` to `defineNode(...)` so plugin nodes can set `NodeConfigBase.icon` for the workflow canvas (Lucide, `builtin:`, `si:`, or image URLs).
+
+## 0.2.0
+
+### Minor Changes
+
+- [#41](https://github.com/MadeRelevant/codemation/pull/41) [`a72444e`](https://github.com/MadeRelevant/codemation/commit/a72444e25c4e744a9a90e231a59c93f8d90346e5) Thanks [@cblokland90](https://github.com/cblokland90)! - Add `WorkflowTestKit` and related engine test harness exports on `@codemation/core/testing`, with create-codemation templates and agent skills updated to document plugin unit tests.
+
+### Patch Changes
+
+- [#41](https://github.com/MadeRelevant/codemation/pull/41) [`a72444e`](https://github.com/MadeRelevant/codemation/commit/a72444e25c4e744a9a90e231a59c93f8d90346e5) Thanks [@cblokland90](https://github.com/cblokland90)! - Normalize run persistence around work items, execution instances, and run slot projections, while aligning the HTTP/UI run detail flow to run-centric naming. This also fixes AI agent tool schema serialization, nested tool item propagation, and execution inspector/canvas status handling for inline scheduler workflows.
+
+## 0.1.0
+
+### Minor Changes
+
+- [#39](https://github.com/MadeRelevant/codemation/pull/39) [`cbfe843`](https://github.com/MadeRelevant/codemation/commit/cbfe843ef2363e400a219f4d0bcd05b091ab83b4) Thanks [@cblokland90](https://github.com/cblokland90)! - Add `WorkflowTestKit` and related engine test harness exports on `@codemation/core/testing`, with create-codemation templates and agent skills updated to document plugin unit tests.
+
 ## 0.0.19
 
 ### Patch Changes

package/dist/EngineRuntimeRegistration.types-0sgV2XL2.d.ts

@@ -0,0 +1,42 @@
+import { Ti as EngineExecutionLimitsPolicyConfig, ir as TriggerRuntimeDiagnostics, oi as DependencyContainer, xr as WebhookTriggerRoutingDiagnostics, yr as WebhookTriggerMatcher } from "./RunIntentService-BCvGdOSY.js";
+
+//#region src/bootstrap/runtime/EngineRuntimeRegistration.types.d.ts
+
+/**
+ * Creates the webhook route matcher used by {@link import("../api/Engine").Engine}.
+ * Hosts may supply logging/diagnostics; tests often use the default factory without diagnostics.
+ */
+interface WebhookTriggerMatcherProvider {
+  createMatcher(container: DependencyContainer): WebhookTriggerMatcher;
+}
+/**
+ * Supplies optional trigger-runtime logging (inactive workflow skips, activation sync).
+ */
+interface TriggerRuntimeDiagnosticsProvider {
+  create(container: DependencyContainer): TriggerRuntimeDiagnostics | undefined;
+}
+interface EngineRuntimeRegistrationOptions {
+  /**
+   * Static limits merged into the factory when the policy token is first resolved.
+   * Prefer {@link resolveEngineExecutionLimits} when limits can change after registration (e.g. host `useRuntimeConfig`).
+   */
+  engineExecutionLimits?: Partial<EngineExecutionLimitsPolicyConfig>;
+  /**
+   * Called when the limits policy is first resolved; overrides {@link engineExecutionLimits} when both are set.
+   * Use this for host wiring so `runtime.engineExecutionLimits` applied after `registerCoreInfrastructure` is honored.
+   */
+  resolveEngineExecutionLimits?: () => Partial<EngineExecutionLimitsPolicyConfig> | undefined;
+  /**
+   * When {@link webhookTriggerMatcherProvider} is omitted, the registrar builds
+   * {@link import("../../runtime/WorkflowRepositoryWebhookTriggerMatcher").WorkflowRepositoryWebhookTriggerMatcher}
+   * using this optional routing diagnostics surface.
+   */
+  webhookTriggerRoutingDiagnostics?: WebhookTriggerRoutingDiagnostics;
+  /** Overrides default webhook matcher construction (e.g. host-injected loggers). */
+  webhookTriggerMatcherProvider?: WebhookTriggerMatcherProvider;
+  /** Overrides default trigger diagnostics (undefined when omitted). */
+  triggerRuntimeDiagnosticsProvider?: TriggerRuntimeDiagnosticsProvider;
+}
+//#endregion
+export { TriggerRuntimeDiagnosticsProvider as n, WebhookTriggerMatcherProvider as r, EngineRuntimeRegistrationOptions as t };
+//# sourceMappingURL=EngineRuntimeRegistration.types-0sgV2XL2.d.ts.map

package/dist/EngineWorkflowRunnerService-Dx7bJsJR.d.cts

@@ -0,0 +1,73 @@
+import { $n as PersistedWorkflowSnapshotNode, Ct as WorkflowId, I as Items, Lr as EngineExecutionLimitsPolicyConfig, Nn as WebhookTriggerRoutingDiagnostics, Qn as PersistedWorkflowSnapshot, Sn as WorkflowRepository, U as NodeConfigBase, Y as NodeId, _t as WorkflowDefinition, cr as RunResult, er as PersistedWorkflowTokenRegistryLike, gn as TriggerRuntimeDiagnostics, jn as WebhookTriggerMatcher, r as Engine, rt as ParentExecutionRef, vr as DependencyContainer } from "./RunIntentService-CV8izV8t.cjs";
+
+//#region src/workflowSnapshots/WorkflowSnapshotCodec.d.ts
+declare class WorkflowSnapshotCodec {
+  private readonly tokenRegistry;
+  constructor(tokenRegistry: PersistedWorkflowTokenRegistryLike);
+  create(workflow: WorkflowDefinition): PersistedWorkflowSnapshot;
+  hydrate(snapshotNode: PersistedWorkflowSnapshotNode, liveConfig: NodeConfigBase): NodeConfigBase;
+  private serializeConfig;
+  private injectTokenIds;
+  private mergeValue;
+  private mergeNestedValue;
+  private restoreNonSerializableProperties;
+  private restoreTypeProperty;
+  private resolveTokenId;
+  private resolveTokenName;
+  private asTypeToken;
+  private asRecord;
+}
+//#endregion
+//#region src/bootstrap/runtime/EngineRuntimeRegistration.types.d.ts
+/**
+ * Creates the webhook route matcher used by {@link import("../api/Engine").Engine}.
+ * Hosts may supply logging/diagnostics; tests often use the default factory without diagnostics.
+ */
+interface WebhookTriggerMatcherProvider {
+  createMatcher(container: DependencyContainer): WebhookTriggerMatcher;
+}
+/**
+ * Supplies optional trigger-runtime logging (inactive workflow skips, activation sync).
+ */
+interface TriggerRuntimeDiagnosticsProvider {
+  create(container: DependencyContainer): TriggerRuntimeDiagnostics | undefined;
+}
+interface EngineRuntimeRegistrationOptions {
+  /**
+   * Static limits merged into the factory when the policy token is first resolved.
+   * Prefer {@link resolveEngineExecutionLimits} when limits can change after registration (e.g. host `useRuntimeConfig`).
+   */
+  engineExecutionLimits?: Partial<EngineExecutionLimitsPolicyConfig>;
+  /**
+   * Called when the limits policy is first resolved; overrides {@link engineExecutionLimits} when both are set.
+   * Use this for host wiring so `runtime.engineExecutionLimits` applied after `registerCoreInfrastructure` is honored.
+   */
+  resolveEngineExecutionLimits?: () => Partial<EngineExecutionLimitsPolicyConfig> | undefined;
+  /**
+   * When {@link webhookTriggerMatcherProvider} is omitted, the registrar builds
+   * {@link import("../../runtime/WorkflowRepositoryWebhookTriggerMatcher").WorkflowRepositoryWebhookTriggerMatcher}
+   * using this optional routing diagnostics surface.
+   */
+  webhookTriggerRoutingDiagnostics?: WebhookTriggerRoutingDiagnostics;
+  /** Overrides default webhook matcher construction (e.g. host-injected loggers). */
+  webhookTriggerMatcherProvider?: WebhookTriggerMatcherProvider;
+  /** Overrides default trigger diagnostics (undefined when omitted). */
+  triggerRuntimeDiagnosticsProvider?: TriggerRuntimeDiagnosticsProvider;
+}
+//#endregion
+//#region src/runtime/EngineWorkflowRunnerService.d.ts
+declare class EngineWorkflowRunnerService {
+  private readonly engine;
+  private readonly workflowRepository;
+  constructor(engine: Engine, workflowRepository: WorkflowRepository);
+  runById(args: {
+    workflowId: WorkflowId;
+    startAt?: NodeId;
+    items: Items;
+    parent?: ParentExecutionRef;
+  }): Promise<RunResult>;
+  private findDefaultStartNodeId;
+}
+//#endregion
+export { WorkflowSnapshotCodec as a, WebhookTriggerMatcherProvider as i, EngineRuntimeRegistrationOptions as n, TriggerRuntimeDiagnosticsProvider as r, EngineWorkflowRunnerService as t };
+//# sourceMappingURL=EngineWorkflowRunnerService-Dx7bJsJR.d.cts.map

package/dist/InMemoryRunDataFactory-qIYQEar7.d.cts

@@ -0,0 +1,94 @@
+import { Bt as BinaryStorageStatResult, Ct as WorkflowId, H as NodeActivationId, Ht as BinaryStorageWriteResult, Jt as ExecutionContextFactory, Kt as ExecutionBinaryService, Lt as BinaryBody, Q as NodeOutputs, Rt as BinaryStorage, V as MutableRunData, Wr as RetryPolicySpec, Y as NodeId, b as CredentialSessionService, cn as NodeExecutionStatePublisher, ct as RunId, in as NodeExecutionContext, k as BinaryAttachment, ot as RunDataFactory, qt as ExecutionContext, rn as NodeBinaryAttachmentService, rt as ParentExecutionRef, st as RunDataSnapshot, zt as BinaryStorageReadResult } from "./RunIntentService-CV8izV8t.cjs";
+
+//#region src/execution/CredentialResolverFactory.d.ts
+declare class CredentialResolverFactory {
+  private readonly credentialSessions;
+  constructor(credentialSessions: CredentialSessionService);
+  create(workflowId: WorkflowId, nodeId: NodeId, config?: NodeExecutionContext["config"]): NodeExecutionContext["getCredential"];
+}
+//#endregion
+//#region src/execution/asyncSleeper.types.d.ts
+interface AsyncSleeper {
+  sleep(ms: number): Promise<void>;
+}
+//#endregion
+//#region src/execution/DefaultAsyncSleeper.d.ts
+declare class DefaultAsyncSleeper implements AsyncSleeper {
+  sleep(ms: number): Promise<void>;
+}
+//#endregion
+//#region src/execution/DefaultExecutionContextFactory.d.ts
+declare class DefaultExecutionContextFactory implements ExecutionContextFactory {
+  private readonly binaryStorage;
+  private readonly currentDate;
+  constructor(binaryStorage?: BinaryStorage, currentDate?: () => Date);
+  create(args: {
+    runId: RunId;
+    workflowId: WorkflowId;
+    parent?: ParentExecutionRef;
+    subworkflowDepth: number;
+    engineMaxNodeActivations: number;
+    engineMaxSubworkflowDepth: number;
+    data: RunDataSnapshot;
+    nodeState?: NodeExecutionStatePublisher;
+    getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
+  }): ExecutionContext;
+}
+//#endregion
+//#region src/execution/InProcessRetryRunner.d.ts
+declare class InProcessRetryRunner {
+  private readonly sleeper;
+  constructor(sleeper: AsyncSleeper);
+  run<T>(policy: RetryPolicySpec | undefined, work: () => Promise<T>): Promise<T>;
+  private static delayAfterFailureMs;
+  private static normalizePolicy;
+  private static assertPositiveInt;
+  private static assertNonNegativeFinite;
+  private static assertMultiplier;
+}
+//#endregion
+//#region src/binaries/UnavailableBinaryStorage.d.ts
+declare class UnavailableBinaryStorage implements BinaryStorage {
+  readonly driverName = "unavailable";
+  write(): Promise<never>;
+  openReadStream(): Promise<undefined>;
+  stat(): Promise<{
+    exists: false;
+  }>;
+  delete(): Promise<void>;
+}
+//#endregion
+//#region src/binaries/DefaultExecutionBinaryServiceFactory.d.ts
+declare class DefaultExecutionBinaryService implements ExecutionBinaryService {
+  private readonly storage;
+  private readonly workflowId;
+  private readonly runId;
+  private readonly now;
+  constructor(storage: BinaryStorage, workflowId: WorkflowId, runId: RunId, now: () => Date);
+  forNode(args: {
+    nodeId: NodeId;
+    activationId: NodeActivationId;
+  }): NodeBinaryAttachmentService;
+  openReadStream(attachment: BinaryAttachment): Promise<BinaryStorageReadResult | undefined>;
+}
+//#endregion
+//#region src/runStorage/InMemoryBinaryStorageRegistry.d.ts
+declare class InMemoryBinaryStorage implements BinaryStorage {
+  readonly driverName = "memory";
+  private readonly values;
+  write(args: {
+    storageKey: string;
+    body: BinaryBody;
+  }): Promise<BinaryStorageWriteResult>;
+  openReadStream(storageKey: string): Promise<BinaryStorageReadResult | undefined>;
+  stat(storageKey: string): Promise<BinaryStorageStatResult>;
+  delete(storageKey: string): Promise<void>;
+}
+//#endregion
+//#region src/runStorage/InMemoryRunDataFactory.d.ts
+declare class InMemoryRunDataFactory implements RunDataFactory {
+  create(initial?: Record<NodeId, NodeOutputs>): MutableRunData;
+}
+//#endregion
+export { InProcessRetryRunner as a, AsyncSleeper as c, UnavailableBinaryStorage as i, CredentialResolverFactory as l, InMemoryBinaryStorage as n, DefaultExecutionContextFactory as o, DefaultExecutionBinaryService as r, DefaultAsyncSleeper as s, InMemoryRunDataFactory as t };
+//# sourceMappingURL=InMemoryRunDataFactory-qIYQEar7.d.cts.map