@gobing-ai/ts-dual-workflow-engine 0.3.0 → 0.3.1

package/dist/host.d.ts

@@ -1,13 +1,26 @@
 import { type ProcessExecutor } from '@gobing-ai/ts-runtime';
+import { type CapabilityOrigin } from '@gobing-ai/ts-runtime/plugin';
 import type { ActionResult, ActionRunContext, ActionRunner, GuardContext, GuardRunner } from './types';
 /** Registry owner for workflow actions and guards. */
 export declare class WorkflowEngineHost {
     private readonly actions;
     private readonly guards;
     /** Register or replace an action runner. */
-    registerAction(action: ActionRunner): this;
+    registerAction(action: ActionRunner, origin?: CapabilityOrigin): this;
     /** Register or replace a guard runner. */
-    registerGuard(guard: GuardRunner): this;
+    registerGuard(guard: GuardRunner, origin?: CapabilityOrigin): this;
+    /** Return true when an action of `kind` is registered. */
+    hasAction(kind: string): boolean;
+    /** Return true when a guard of `kind` is registered. */
+    hasGuard(kind: string): boolean;
+    /** List registered action kinds in registration order. */
+    listActions(): string[];
+    /** List registered guard kinds in registration order. */
+    listGuards(): string[];
+    /** Origin of a registered action, or undefined if none. Lets 0010 distinguish builtin from extension overrides. */
+    actionOrigin(kind: string): CapabilityOrigin | undefined;
+    /** Origin of a registered guard, or undefined if none. */
+    guardOrigin(kind: string): CapabilityOrigin | undefined;
     /** Execute a registered action. */
     runAction(kind: string, options: Record<string, unknown>, context: ActionRunContext): Promise<ActionResult>;
     /** Evaluate a registered guard. */

package/dist/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEvG,sDAAsD;AACtD,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IAEzD,4CAA4C;IAC5C,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAK1C,0CAA0C;IAC1C,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAKvC,mCAAmC;IAC7B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAMjH,mCAAmC;IAC7B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CAK/G;AAED,4FAA4F;AAC5F,wBAAgB,+BAA+B,CAC3C,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,eAAe,CAAA;CAAO,GACpD,kBAAkB,CAWpB;AAED,0DAA0D;AAC1D,qBAAa,gBAAiB,YAAW,YAAY;IACjD,QAAQ,CAAC,IAAI,UAAU;IAEvB,mCAAmC;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;CAGzE;AAED,kEAAkE;AAClE,qBAAa,iBAAkB,YAAW,YAAY;IAGtC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAF5C,QAAQ,CAAC,IAAI,WAAW;gBAEK,eAAe,EAAE,eAAe;IAE7D,0DAA0D;IACpD,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;CAgBpG"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,KAAK,gBAAgB,EAAsB,MAAM,8BAA8B,CAAC;AAEzF,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEvG,sDAAsD;AACtD,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2D;IACnF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyD;IAEhF,4CAA4C;IAC5C,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,GAAE,gBAA8B,GAAG,IAAI;IAKlF,0CAA0C;IAC1C,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,GAAE,gBAA8B,GAAG,IAAI;IAK/E,0DAA0D;IAC1D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,0DAA0D;IAC1D,WAAW,IAAI,MAAM,EAAE;IAIvB,yDAAyD;IACzD,UAAU,IAAI,MAAM,EAAE;IAItB,mHAAmH;IACnH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIxD,0DAA0D;IAC1D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIvD,mCAAmC;IAC7B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAOjH,mCAAmC;IAC7B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CAI/G;AAED,4FAA4F;AAC5F,wBAAgB,+BAA+B,CAC3C,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,eAAe,CAAA;CAAO,GACpD,kBAAkB,CAcpB;AAED,0DAA0D;AAC1D,qBAAa,gBAAiB,YAAW,YAAY;IACjD,QAAQ,CAAC,IAAI,UAAU;IAEvB,mCAAmC;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;CAGzE;AAED,kEAAkE;AAClE,qBAAa,iBAAkB,YAAW,YAAY;IAGtC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAF5C,QAAQ,CAAC,IAAI,WAAW;gBAEK,eAAe,EAAE,eAAe;IAE7D,0DAA0D;IACpD,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;CAgBpG"}

package/dist/host.js

@@ -1,45 +1,70 @@
 import { NodeProcessExecutor } from '@gobing-ai/ts-runtime';
+import { CapabilityRegistry } from '@gobing-ai/ts-runtime/plugin';
 import { WorkflowValidationError } from './errors.js';
 /** Registry owner for workflow actions and guards. */
 export class WorkflowEngineHost {
-    actions = new Map();
-    guards = new Map();
+    actions = new CapabilityRegistry('workflow action');
+    guards = new CapabilityRegistry('workflow guard');
     /** Register or replace an action runner. */
-    registerAction(action) {
-        this.actions.set(action.kind, action);
+    registerAction(action, origin = 'extension') {
+        this.actions.register(action.kind, action, origin);
         return this;
     }
     /** Register or replace a guard runner. */
-    registerGuard(guard) {
-        this.guards.set(guard.kind, guard);
+    registerGuard(guard, origin = 'extension') {
+        this.guards.register(guard.kind, guard, origin);
         return this;
     }
+    /** Return true when an action of `kind` is registered. */
+    hasAction(kind) {
+        return this.actions.has(kind);
+    }
+    /** Return true when a guard of `kind` is registered. */
+    hasGuard(kind) {
+        return this.guards.has(kind);
+    }
+    /** List registered action kinds in registration order. */
+    listActions() {
+        return this.actions.list();
+    }
+    /** List registered guard kinds in registration order. */
+    listGuards() {
+        return this.guards.list();
+    }
+    /** Origin of a registered action, or undefined if none. Lets 0010 distinguish builtin from extension overrides. */
+    actionOrigin(kind) {
+        return this.actions.getEntry(kind)?.origin;
+    }
+    /** Origin of a registered guard, or undefined if none. */
+    guardOrigin(kind) {
+        return this.guards.getEntry(kind)?.origin;
+    }
     /** Execute a registered action. */
     async runAction(kind, options, context) {
-        const action = this.actions.get(kind);
-        if (action === undefined)
+        // Guard at the host boundary so unknown kinds surface as WorkflowValidationError,
+        // not the shared registry's generic Error (ADR-010 R13).
+        if (!this.actions.has(kind))
             throw new WorkflowValidationError(`Unknown workflow action "${kind}"`);
-        return await action.execute(options, context);
+        return await this.actions.get(kind).execute(options, context);
     }
     /** Evaluate a registered guard. */
     async evaluateGuard(kind, options, context) {
-        const guard = this.guards.get(kind);
-        if (guard === undefined)
+        if (!this.guards.has(kind))
             throw new WorkflowValidationError(`Unknown workflow guard "${kind}"`);
-        return await guard.evaluate(options, context);
+        return await this.guards.get(kind).evaluate(options, context);
     }
 }
 /** Create a workflow host with built-in note, shell, always, and action-ok capabilities. */
 export function createDefaultWorkflowEngineHost(options = {}) {
     const host = new WorkflowEngineHost();
-    host.registerAction(new NoteActionRunner());
-    host.registerAction(new ShellActionRunner(options.processExecutor ?? new NodeProcessExecutor()));
-    host.registerGuard({ kind: 'always', evaluate: async () => true });
-    host.registerGuard({ kind: 'never', evaluate: async () => false });
+    host.registerAction(new NoteActionRunner(), 'builtin');
+    host.registerAction(new ShellActionRunner(options.processExecutor ?? new NodeProcessExecutor()), 'builtin');
+    host.registerGuard({ kind: 'always', evaluate: async () => true }, 'builtin');
+    host.registerGuard({ kind: 'never', evaluate: async () => false }, 'builtin');
     host.registerGuard({
         kind: 'action-ok',
         evaluate: async (_options, context) => context.lastActionResult?.ok === true,
-    });
+    }, 'builtin');
     return host;
 }
 /** Built-in action that records a note in result data. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-dual-workflow-engine",
-    "version": "0.3.0",
+    "version": "0.3.1",
     "description": "@gobing-ai/ts-dual-workflow-engine — State-machine and transition-flow workflow runtime.",
     "keywords": [
         "typescript",
@@ -48,9 +48,9 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-dual-workflow-engine-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-db": "^0.3.0",
-        "@gobing-ai/ts-runtime": "^0.3.0",
-        "@gobing-ai/ts-utils": "^0.3.0",
+        "@gobing-ai/ts-db": "^0.3.1",
+        "@gobing-ai/ts-runtime": "^0.3.1",
+        "@gobing-ai/ts-utils": "^0.3.1",
         "zod": "^4.1.0"
     },
     "devDependencies": {

package/src/host.ts

@@ -1,36 +1,67 @@
 import { NodeProcessExecutor, type ProcessExecutor } from '@gobing-ai/ts-runtime';
+import { type CapabilityOrigin, CapabilityRegistry } from '@gobing-ai/ts-runtime/plugin';
 import { WorkflowValidationError } from './errors';
 import type { ActionResult, ActionRunContext, ActionRunner, GuardContext, GuardRunner } from './types';
 
 /** Registry owner for workflow actions and guards. */
 export class WorkflowEngineHost {
-    private readonly actions = new Map<string, ActionRunner>();
-    private readonly guards = new Map<string, GuardRunner>();
+    private readonly actions = new CapabilityRegistry<ActionRunner>('workflow action');
+    private readonly guards = new CapabilityRegistry<GuardRunner>('workflow guard');
 
     /** Register or replace an action runner. */
-    registerAction(action: ActionRunner): this {
-        this.actions.set(action.kind, action);
+    registerAction(action: ActionRunner, origin: CapabilityOrigin = 'extension'): this {
+        this.actions.register(action.kind, action, origin);
         return this;
     }
 
     /** Register or replace a guard runner. */
-    registerGuard(guard: GuardRunner): this {
-        this.guards.set(guard.kind, guard);
+    registerGuard(guard: GuardRunner, origin: CapabilityOrigin = 'extension'): this {
+        this.guards.register(guard.kind, guard, origin);
         return this;
     }
 
+    /** Return true when an action of `kind` is registered. */
+    hasAction(kind: string): boolean {
+        return this.actions.has(kind);
+    }
+
+    /** Return true when a guard of `kind` is registered. */
+    hasGuard(kind: string): boolean {
+        return this.guards.has(kind);
+    }
+
+    /** List registered action kinds in registration order. */
+    listActions(): string[] {
+        return this.actions.list();
+    }
+
+    /** List registered guard kinds in registration order. */
+    listGuards(): string[] {
+        return this.guards.list();
+    }
+
+    /** Origin of a registered action, or undefined if none. Lets 0010 distinguish builtin from extension overrides. */
+    actionOrigin(kind: string): CapabilityOrigin | undefined {
+        return this.actions.getEntry(kind)?.origin;
+    }
+
+    /** Origin of a registered guard, or undefined if none. */
+    guardOrigin(kind: string): CapabilityOrigin | undefined {
+        return this.guards.getEntry(kind)?.origin;
+    }
+
     /** Execute a registered action. */
     async runAction(kind: string, options: Record<string, unknown>, context: ActionRunContext): Promise<ActionResult> {
-        const action = this.actions.get(kind);
-        if (action === undefined) throw new WorkflowValidationError(`Unknown workflow action "${kind}"`);
-        return await action.execute(options, context);
+        // Guard at the host boundary so unknown kinds surface as WorkflowValidationError,
+        // not the shared registry's generic Error (ADR-010 R13).
+        if (!this.actions.has(kind)) throw new WorkflowValidationError(`Unknown workflow action "${kind}"`);
+        return await this.actions.get(kind).execute(options, context);
     }
 
     /** Evaluate a registered guard. */
     async evaluateGuard(kind: string, options: Record<string, unknown>, context: GuardContext): Promise<boolean> {
-        const guard = this.guards.get(kind);
-        if (guard === undefined) throw new WorkflowValidationError(`Unknown workflow guard "${kind}"`);
-        return await guard.evaluate(options, context);
+        if (!this.guards.has(kind)) throw new WorkflowValidationError(`Unknown workflow guard "${kind}"`);
+        return await this.guards.get(kind).evaluate(options, context);
     }
 }
 
@@ -39,14 +70,17 @@ export function createDefaultWorkflowEngineHost(
     options: { processExecutor?: ProcessExecutor } = {},
 ): WorkflowEngineHost {
     const host = new WorkflowEngineHost();
-    host.registerAction(new NoteActionRunner());
-    host.registerAction(new ShellActionRunner(options.processExecutor ?? new NodeProcessExecutor()));
-    host.registerGuard({ kind: 'always', evaluate: async () => true });
-    host.registerGuard({ kind: 'never', evaluate: async () => false });
-    host.registerGuard({
-        kind: 'action-ok',
-        evaluate: async (_options, context) => context.lastActionResult?.ok === true,
-    });
+    host.registerAction(new NoteActionRunner(), 'builtin');
+    host.registerAction(new ShellActionRunner(options.processExecutor ?? new NodeProcessExecutor()), 'builtin');
+    host.registerGuard({ kind: 'always', evaluate: async () => true }, 'builtin');
+    host.registerGuard({ kind: 'never', evaluate: async () => false }, 'builtin');
+    host.registerGuard(
+        {
+            kind: 'action-ok',
+            evaluate: async (_options, context) => context.lastActionResult?.ok === true,
+        },
+        'builtin',
+    );
     return host;
 }