@loopstack/contracts 0.14.1 → 0.16.0

package/.github/workflows/publish-npm.yml

@@ -0,0 +1,83 @@
+name: 'Publish to NPM Workflow'
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  publish:
+    name: 'Build & Publish to NPM'
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Check if tag is on main branch
+        run: |
+          git fetch origin main
+          if ! git branch -r --contains ${{ github.ref }} | grep -q 'origin/main'; then
+            echo "❌ Tag is not on main branch"
+            exit 1
+          fi
+          echo "✅ Tag is on main branch"
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Extract Package Version
+        id: package
+        run: |
+          echo "name=$(node -p "require('./package.json').name")" >> $GITHUB_OUTPUT
+          echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
+
+      - name: Validate Version Matches Tag
+        run: |
+          TAG_VERSION=${GITHUB_REF#refs/tags/v}
+          PKG_VERSION=${{ steps.package.outputs.version }}
+          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
+            echo "❌ Tag version ($TAG_VERSION) does not match package.json version ($PKG_VERSION)"
+            exit 1
+          fi
+          echo "✅ Versions match"
+
+      - name: Install Dependencies
+        run: npm ci
+        
+      - name: Build Package
+        run: npm run build --if-present
+
+      - name: Publish to NPM
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        if: success()
+        with:
+          tag_name: ${{ github.ref_name }}
+          body: |
+            ## 📦 NPM Package
+
+            **Package:** [${{ steps.package.outputs.name }}](https://www.npmjs.com/package/${{ steps.package.outputs.name }}/v/${{ steps.package.outputs.version }})
+            **Version:** ${{ steps.package.outputs.version }}
+
+            Install with:
+            ```bash
+            npm install ${{ steps.package.outputs.name }}@${{ steps.package.outputs.version }}
+            ```
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/dist/schemas/main.schema.d.ts

@@ -585,9 +585,10 @@ export declare const BlockConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
     type: z.ZodDefault<z.ZodLiteral<"workflow">>;
     transitions: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        from: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
-        to: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
-        when: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["manual", "onEntry"]>, z.ZodString]>>;
+        from: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+        to: z.ZodString;
+        if: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString, z.ZodLiteral<"true">, z.ZodLiteral<"false">]>>;
+        trigger: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["manual", "onEntry"]>, z.ZodString]>>;
         call: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             tool: z.ZodString;
@@ -605,11 +606,12 @@ export declare const BlockConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
             assign?: Record<string, string | number | boolean | Record<string, any> | null> | undefined;
         }>, "many">>;
         onError: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
+    }, "strict", z.ZodTypeAny, {
         id: string;
-        from?: string | string[] | undefined;
-        to?: string | string[] | undefined;
-        when?: string | undefined;
+        from: string | string[];
+        to: string;
+        if?: string | undefined;
+        trigger?: string | undefined;
         call?: {
             tool: string;
             id?: string | undefined;
@@ -619,9 +621,10 @@ export declare const BlockConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
         onError?: string | undefined;
     }, {
         id: string;
-        from?: string | string[] | undefined;
-        to?: string | string[] | undefined;
-        when?: string | undefined;
+        from: string | string[];
+        to: string;
+        if?: string | undefined;
+        trigger?: string | undefined;
         call?: {
             tool: string;
             id?: string | undefined;
@@ -659,9 +662,10 @@ export declare const BlockConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
     } | undefined;
     transitions?: {
         id: string;
-        from?: string | string[] | undefined;
-        to?: string | string[] | undefined;
-        when?: string | undefined;
+        from: string | string[];
+        to: string;
+        if?: string | undefined;
+        trigger?: string | undefined;
         call?: {
             tool: string;
             id?: string | undefined;
@@ -699,9 +703,10 @@ export declare const BlockConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodOb
     } | undefined;
     transitions?: {
         id: string;
-        from?: string | string[] | undefined;
-        to?: string | string[] | undefined;
-        when?: string | undefined;
+        from: string | string[];
+        to: string;
+        if?: string | undefined;
+        trigger?: string | undefined;
         call?: {
             tool: string;
             id?: string | undefined;

package/dist/schemas/tool-call.schema.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export declare const ToolCallSchema: z.ZodObject<{
+export declare const ToolCallConfigSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     tool: z.ZodString;
     args: z.ZodOptional<z.ZodAny>;
@@ -15,3 +15,19 @@ export declare const ToolCallSchema: z.ZodObject<{
     args?: any;
     assign?: Record<string, string | number | boolean | Record<string, any> | null> | undefined;
 }>;
+export declare const ToolCallSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    tool: z.ZodString;
+    args: z.ZodOptional<z.ZodAny>;
+    assign: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodNull, z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodRecord<z.ZodString, z.ZodAny>]>>>;
+}, "strip", z.ZodTypeAny, {
+    tool: string;
+    id?: string | undefined;
+    args?: any;
+    assign?: Record<string, string | number | boolean | Record<string, any> | null> | undefined;
+}, {
+    tool: string;
+    id?: string | undefined;
+    args?: any;
+    assign?: Record<string, string | number | boolean | Record<string, any> | null> | undefined;
+}>;

package/dist/schemas/tool-call.schema.js

@@ -1,11 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolCallSchema = void 0;
+exports.ToolCallSchema = exports.ToolCallConfigSchema = void 0;
 const zod_1 = require("zod");
 const assignment_schema_1 = require("./assignment.schema");
-exports.ToolCallSchema = zod_1.z.object({
+exports.ToolCallConfigSchema = zod_1.z.object({
     id: zod_1.z.string().optional(),
     tool: zod_1.z.string(),
     args: zod_1.z.any().optional(),
     assign: assignment_schema_1.AssignmentConfigSchema.optional(),
 });
+exports.ToolCallSchema = zod_1.z.object({
+    id: zod_1.z.string().optional(),
+    tool: zod_1.z.string(),
+    args: zod_1.z.any().optional(),
+    assign: assignment_schema_1.AssignmentSchema.optional(),
+});

package/dist/schemas/workflow-transition.schema.d.ts

@@ -1,9 +1,10 @@
 import { z } from 'zod';
-export declare const WorkflowTransitionSchema: z.ZodObject<{
+export declare const WorkflowTransitionConfigSchema: z.ZodObject<{
     id: z.ZodString;
-    from: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
-    to: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
-    when: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["manual", "onEntry"]>, z.ZodString]>>;
+    from: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    to: z.ZodString;
+    if: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString, z.ZodLiteral<"true">, z.ZodLiteral<"false">]>>;
+    trigger: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["manual", "onEntry"]>, z.ZodString]>>;
     call: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         tool: z.ZodString;
@@ -21,11 +22,62 @@ export declare const WorkflowTransitionSchema: z.ZodObject<{
         assign?: Record<string, string | number | boolean | Record<string, any> | null> | undefined;
     }>, "many">>;
     onError: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    from: string | string[];
+    to: string;
+    if?: string | undefined;
+    trigger?: string | undefined;
+    call?: {
+        tool: string;
+        id?: string | undefined;
+        args?: any;
+        assign?: Record<string, string | number | boolean | Record<string, any> | null> | undefined;
+    }[] | undefined;
+    onError?: string | undefined;
+}, {
+    id: string;
+    from: string | string[];
+    to: string;
+    if?: string | undefined;
+    trigger?: string | undefined;
+    call?: {
+        tool: string;
+        id?: string | undefined;
+        args?: any;
+        assign?: Record<string, string | number | boolean | Record<string, any> | null> | undefined;
+    }[] | undefined;
+    onError?: string | undefined;
+}>;
+export declare const WorkflowTransitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    from: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+    to: z.ZodString;
+    if: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"true">, z.ZodLiteral<"false">]>>;
+    trigger: z.ZodOptional<z.ZodEnum<["manual", "onEntry"]>>;
+    call: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        tool: z.ZodString;
+        args: z.ZodOptional<z.ZodAny>;
+        assign: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodNull, z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodRecord<z.ZodString, z.ZodAny>]>>>;
+    }, "strip", z.ZodTypeAny, {
+        tool: string;
+        id?: string | undefined;
+        args?: any;
+        assign?: Record<string, string | number | boolean | Record<string, any> | null> | undefined;
+    }, {
+        tool: string;
+        id?: string | undefined;
+        args?: any;
+        assign?: Record<string, string | number | boolean | Record<string, any> | null> | undefined;
+    }>, "many">>;
+    onError: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
     id: string;
-    from?: string | string[] | undefined;
-    to?: string | string[] | undefined;
-    when?: string | undefined;
+    from: string | string[];
+    to: string;
+    if?: string | undefined;
+    trigger?: "manual" | "onEntry" | undefined;
     call?: {
         tool: string;
         id?: string | undefined;
@@ -35,9 +87,10 @@ export declare const WorkflowTransitionSchema: z.ZodObject<{
     onError?: string | undefined;
 }, {
     id: string;
-    from?: string | string[] | undefined;
-    to?: string | string[] | undefined;
-    when?: string | undefined;
+    from: string | string[];
+    to: string;
+    if?: string | undefined;
+    trigger?: "manual" | "onEntry" | undefined;
     call?: {
         tool: string;
         id?: string | undefined;

package/dist/schemas/workflow-transition.schema.js

@@ -1,17 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkflowTransitionSchema = void 0;
+exports.WorkflowTransitionSchema = exports.WorkflowTransitionConfigSchema = void 0;
 const zod_1 = require("zod");
 const tool_call_schema_1 = require("./tool-call.schema");
 const template_expression_schema_1 = require("./template-expression.schema");
-exports.WorkflowTransitionSchema = zod_1.z.object({
+exports.WorkflowTransitionConfigSchema = zod_1.z.object({
     id: zod_1.z.string(),
-    from: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional(),
-    to: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional(),
-    when: zod_1.z.union([
+    from: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]),
+    to: zod_1.z.string(),
+    if: zod_1.z.union([template_expression_schema_1.TemplateExpression, zod_1.z.string(), zod_1.z.literal('true'), zod_1.z.literal('false')]).optional(),
+    trigger: zod_1.z.union([
         zod_1.z.enum(["manual", "onEntry"]),
         template_expression_schema_1.TemplateExpression,
     ]).optional(),
+    call: zod_1.z.array(tool_call_schema_1.ToolCallConfigSchema).optional(),
+    onError: zod_1.z.string().optional(),
+}).strict();
+exports.WorkflowTransitionSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    from: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]),
+    to: zod_1.z.string(),
+    if: zod_1.z.union([zod_1.z.string(), zod_1.z.literal('true'), zod_1.z.literal('false')]).optional(),
+    trigger: zod_1.z.enum(["manual", "onEntry"]).optional(),
     call: zod_1.z.array(tool_call_schema_1.ToolCallSchema).optional(),
     onError: zod_1.z.string().optional(),
-});
+}).strict();

package/dist/schemas/workflow.schema.d.ts

@@ -311,9 +311,10 @@ export declare const WorkflowSchema: z.ZodObject<{
     type: z.ZodDefault<z.ZodLiteral<"workflow">>;
     transitions: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        from: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
-        to: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
-        when: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["manual", "onEntry"]>, z.ZodString]>>;
+        from: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+        to: z.ZodString;
+        if: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString, z.ZodLiteral<"true">, z.ZodLiteral<"false">]>>;
+        trigger: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["manual", "onEntry"]>, z.ZodString]>>;
         call: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             tool: z.ZodString;
@@ -331,11 +332,12 @@ export declare const WorkflowSchema: z.ZodObject<{
             assign?: Record<string, string | number | boolean | Record<string, any> | null> | undefined;
         }>, "many">>;
         onError: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
+    }, "strict", z.ZodTypeAny, {
         id: string;
-        from?: string | string[] | undefined;
-        to?: string | string[] | undefined;
-        when?: string | undefined;
+        from: string | string[];
+        to: string;
+        if?: string | undefined;
+        trigger?: string | undefined;
         call?: {
             tool: string;
             id?: string | undefined;
@@ -345,9 +347,10 @@ export declare const WorkflowSchema: z.ZodObject<{
         onError?: string | undefined;
     }, {
         id: string;
-        from?: string | string[] | undefined;
-        to?: string | string[] | undefined;
-        when?: string | undefined;
+        from: string | string[];
+        to: string;
+        if?: string | undefined;
+        trigger?: string | undefined;
         call?: {
             tool: string;
             id?: string | undefined;
@@ -385,9 +388,10 @@ export declare const WorkflowSchema: z.ZodObject<{
     } | undefined;
     transitions?: {
         id: string;
-        from?: string | string[] | undefined;
-        to?: string | string[] | undefined;
-        when?: string | undefined;
+        from: string | string[];
+        to: string;
+        if?: string | undefined;
+        trigger?: string | undefined;
         call?: {
             tool: string;
             id?: string | undefined;
@@ -425,9 +429,10 @@ export declare const WorkflowSchema: z.ZodObject<{
     } | undefined;
     transitions?: {
         id: string;
-        from?: string | string[] | undefined;
-        to?: string | string[] | undefined;
-        when?: string | undefined;
+        from: string | string[];
+        to: string;
+        if?: string | undefined;
+        trigger?: string | undefined;
         call?: {
             tool: string;
             id?: string | undefined;

package/dist/schemas/workflow.schema.js

@@ -15,5 +15,5 @@ exports.WorkflowBaseSchema = block_schema_1.BlockSchema.extend({
 });
 exports.WorkflowSchema = exports.WorkflowBaseSchema.extend({
     type: zod_1.z.literal('workflow').default('workflow'),
-    transitions: zod_1.z.array(workflow_transition_schema_1.WorkflowTransitionSchema).optional(),
+    transitions: zod_1.z.array(workflow_transition_schema_1.WorkflowTransitionConfigSchema).optional(),
 });

package/dist/types/interfaces/document-item.interface.d.ts

@@ -3,7 +3,7 @@ import { UiFormType } from '../types/ui-form.type';
 export interface DocumentItemInterface {
     id: string;
     name: string;
-    configKey: string;
+    blockName: string;
     content: any;
     schema: JSONSchemaConfigType;
     validationError: any;

package/dist/types/interfaces/pipeline-config.interface.d.ts

@@ -1,6 +1,6 @@
 import { JSONSchemaConfigType, UiFormType } from '../types';
 export interface PipelineConfigInterface {
-    configKey: string;
+    blockName: string;
     title?: string;
     description?: string;
     schema?: JSONSchemaConfigType;

package/dist/types/interfaces/transition-info.interface.d.ts

@@ -1,6 +1,6 @@
 export interface TransitionInfoInterface {
     id: string;
     from: string;
-    to: string | string[];
+    to: string;
     onError?: string;
 }

package/dist/types/interfaces/workflow.interface.d.ts

@@ -5,7 +5,7 @@ import { UiFormType } from '../types/ui-form.type';
 import { WorkflowTransitionType } from '../types/workflow-transition.type';
 export interface WorkflowInterface {
     id: string;
-    configKey: string;
+    blockName: string;
     title: string;
     index: number;
     labels: string[];

package/dist/types/types/tool-call.type.d.ts

@@ -1,3 +1,3 @@
 import { z } from 'zod';
-import { ToolCallSchema } from '../../schemas';
-export type ToolCallType = z.infer<typeof ToolCallSchema>;
+import { ToolCallConfigSchema } from '../../schemas';
+export type ToolCallType = z.infer<typeof ToolCallConfigSchema>;

package/dist/types/types/workflow-transition.type.d.ts

@@ -1,3 +1,3 @@
 import { z } from 'zod';
-import { WorkflowTransitionSchema } from '../../schemas';
-export type WorkflowTransitionType = z.infer<typeof WorkflowTransitionSchema>;
+import { WorkflowTransitionConfigSchema } from '../../schemas';
+export type WorkflowTransitionType = z.infer<typeof WorkflowTransitionConfigSchema>;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@loopstack/contracts",
   "displayName": "Loopstack Contracts",
   "description": "A collection of types and schemas shared between projects",
-  "version": "0.14.1",
+  "version": "0.16.0",
   "license": "BSL",
   "author": {
     "name": "Jakob Klippel",
@@ -26,15 +26,20 @@
   },
   "typesVersions": {
     "*": {
-      "types": ["./dist/types/index.d.ts"],
-      "enums": ["./dist/enums/index.d.ts"],
-      "schemas": ["./dist/schemas/index.d.ts"]
+      "types": [
+        "./dist/types/index.d.ts"
+      ],
+      "enums": [
+        "./dist/enums/index.d.ts"
+      ],
+      "schemas": [
+        "./dist/schemas/index.d.ts"
+      ]
     }
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "watch": "tsc --watch",
-    "prepare": "npm run build",
     "compile": "tsc --noEmit"
   },
   "peerDependencies": {