@tailor-platform/sdk 2.0.0-next.2 → 2.0.0-next.3

package/docs/services/workflow.md

@@ -207,23 +207,23 @@ Wait points allow a workflow job to suspend execution and wait for an external s
 
 ### Defining Wait Points
 
-Use `defineWaitPoint` to declare a single typed wait point:
+Use `createWaitPoint` to create a single typed wait point:
 
 ```typescript
-import { defineWaitPoint } from "@tailor-platform/sdk";
+import { createWaitPoint } from "@tailor-platform/sdk";
 
-export const approval = defineWaitPoint<
+export const approval = createWaitPoint<
   { message: string; requestId: string },
   { approved: boolean }
 >("approval");
 ```
 
-For multiple wait points, use `defineWaitPoints` with a builder callback. Property names become wait point keys, and JSDoc on each property is preserved in IDE autocompletion:
+For multiple wait points, use `createWaitPoints` with a builder callback. Property names become wait point keys, and JSDoc on each property is preserved in IDE autocompletion:
 
 ```typescript
-import { defineWaitPoints } from "@tailor-platform/sdk";
+import { createWaitPoints } from "@tailor-platform/sdk";
 
-export const waitPoints = defineWaitPoints((define) => ({
+export const waitPoints = createWaitPoints((define) => ({
   /** Manager approval step */
   managerApproval: define<{ amount: number }, { approved: boolean }>(),
   /** Finance review step */
@@ -245,9 +245,9 @@ Both must be JsonValue-compatible (plain objects/arrays; no class instances or f
 Call `.wait()` inside a workflow job body to suspend execution:
 
 ```typescript
-import { createWorkflow, createWorkflowJob, defineWaitPoint } from "@tailor-platform/sdk";
+import { createWaitPoint, createWorkflow, createWorkflowJob } from "@tailor-platform/sdk";
 
-export const approval = defineWaitPoint<
+export const approval = createWaitPoint<
   { message: string; requestId: string },
   { approved: boolean }
 >("approval");
@@ -406,22 +406,22 @@ Manage workflows using the CLI:
 
 ```bash
 # List workflows
-tailor-sdk workflow list
+tailor workflow list
 
 # Get workflow details
-tailor-sdk workflow get <name>
+tailor workflow get <name>
 
 # Start a workflow
-tailor-sdk workflow start <name> -m <machine-user> -a '{"key": "value"}'
+tailor workflow start <name> -m <machine-user> -a '{"key": "value"}'
 
 # List executions
-tailor-sdk workflow executions
+tailor workflow executions
 
 # Get execution details with logs
-tailor-sdk workflow executions <execution-id> --logs
+tailor workflow executions <execution-id> --logs
 
 # Resume a failed execution
-tailor-sdk workflow resume <execution-id>
+tailor workflow resume <execution-id>
 ```
 
 See [Workflow CLI Commands](../cli/workflow.md) for full documentation.

package/docs/testing.md

@@ -26,7 +26,7 @@ Platform API mocks under `@tailor-platform/sdk/vitest` (for use with the [`tailo
 - `mockTailordb` — TailorDB query stubs and call recording
 - `mockWorkflow` — `tailor.workflow` job / wait / resolve mocks
 - `runWorkflowLocally` — local full-chain workflow runner
-- `mockSecretmanager`, `mockAuthconnection`, `mockIdp`, `mockFile`, `mockIconv` — corresponding platform API mocks
+- `mockSecretmanager`, `mockAuthconnection`, `mockIdp`, `mockFile`, `mockIconv`, `mockAigateway` — corresponding platform API mocks
 
 For tighter alignment with the production runtime — Node.js module blocking, Web-only globals, and platform API mocks — pair the resolver helpers with the [`tailor-runtime` Vitest environment](#runtime-environment-emulation-beta) below.
 
@@ -63,7 +63,7 @@ export default defineConfig({
 
 ### Acquiring mocks with `using`
 
-Each mock controller (`mockTailordb`, `mockWorkflow`, `mockSecretmanager`, `mockAuthconnection`, `mockIdp`, `mockFile`, `mockIconv`) is a **factory function**. Acquire it inside a test with a [`using` declaration](https://github.com/tc39/proposal-explicit-resource-management) — its state is reset automatically when the test scope exits, so you no longer need `beforeEach(() => mock.reset())`:
+Each mock controller (`mockTailordb`, `mockWorkflow`, `mockSecretmanager`, `mockAuthconnection`, `mockIdp`, `mockFile`, `mockIconv`, `mockAigateway`) is a **factory function**. Acquire it inside a test with a [`using` declaration](https://github.com/tc39/proposal-explicit-resource-management) — its state is reset automatically when the test scope exits, so you no longer need `beforeEach(() => mock.reset())`:
 
 ```typescript
 import { mockTailordb } from "@tailor-platform/sdk/vitest";
@@ -200,7 +200,7 @@ import { mockAuthconnection } from "@tailor-platform/sdk/vitest";
 test("returns configured token", async () => {
   using ac = mockAuthconnection();
   ac.setTokens({
-    google: { access_token: "ya29.xxx", expires_in: 3600 },
+    google: { access_token: "ya29.xxx" },
   });
 
   const token = await tailor.authconnection.getConnectionToken("google");
@@ -295,6 +295,23 @@ test("mock encoding conversion", () => {
 });
 ```
 
+### AI Gateway Mock
+
+```typescript
+import { mockAigateway } from "@tailor-platform/sdk/vitest";
+
+test("resolves an AI Gateway URL", async () => {
+  using aigateway = mockAigateway();
+  aigateway.setUrls({ "my-aigateway": "https://my-aigateway.example.com" });
+
+  const { url } = await tailor.aigateway.get("my-aigateway");
+  expect(url).toBe("https://my-aigateway.example.com");
+  expect(aigateway.calls).toEqual([{ name: "my-aigateway" }]);
+});
+```
+
+Calling `get` for a name that hasn't been registered via `setUrls` throws.
+
 ### Loading Secrets from Config
 
 Pass a config path to load `defineSecretManager()` values into the mock:
@@ -561,6 +578,35 @@ describe("resolveApproval resolver", () => {
 
 `setResolveHandler` receives `(executionId, key, callback)` and decides whether to invoke the callback — that's how you assert the value returned to the suspended job.
 
+#### Resolvers that resume failed workflows
+
+Resolvers or executors that call `workflow.resumeWorkflow(executionId)` delegate to `tailor.workflow.resumeWorkflow` at runtime. With the `tailor-runtime` environment active, use `mockWorkflow().setResumeHandler` to control the returned execution ID and inspect `resumeWorkflow.mock.calls`:
+
+```typescript
+import { unauthenticatedTailorUser } from "@tailor-platform/sdk/test";
+import { mockWorkflow } from "@tailor-platform/sdk/vitest";
+import { describe, expect, test } from "vitest";
+import resolver from "./retryFailedWorkflow";
+
+describe("retryFailedWorkflow resolver", () => {
+  test("resumes a failed workflow execution", async () => {
+    using wf = mockWorkflow();
+    wf.setResumeHandler("exec-resumed-123");
+
+    const result = await resolver.body({
+      input: { executionId: "exec-failed-456" },
+      user: unauthenticatedTailorUser,
+      env: {},
+    });
+
+    expect(result).toEqual({ resumedExecutionId: "exec-resumed-123" });
+    expect(wf.resumeWorkflow.mock.calls).toEqual([["exec-failed-456"]]);
+  });
+});
+```
+
+`setResumeHandler` accepts a static string (same execution ID for every call) or a function `(executionId) => string` that computes one per call. By default the mock echoes the input `executionId`.
+
 ### Testing Executors
 
 Function-kind executors expose their handler as `executor.operation.body(args)`. The shape of `args` is determined by the trigger — for example, `recordCreatedTrigger({ type: user })` produces `{ newRecord }` typed against the type's output, plus runtime fields such as `env`, `actor`, and `invoker`. GraphQL, webhook, and workflow operation kinds are declarative and don't expose a user-authored body to test.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/sdk",
-  "version": "2.0.0-next.2",
+  "version": "2.0.0-next.3",
   "description": "Tailor Platform SDK - The SDK to work with Tailor Platform",
   "license": "MIT",
   "repository": {
@@ -9,12 +9,13 @@
     "directory": "packages/sdk"
   },
   "bin": {
-    "tailor-sdk": "./dist/cli/index.mjs"
+    "tailor": "./dist/cli/index.mjs"
   },
   "files": [
     "CHANGELOG.md",
     "dist",
     "docs",
+    "!docs/**/*.*.md",
     "postinstall.mjs",
     "README.md",
     "agent-skills"
@@ -26,6 +27,9 @@
   ],
   "main": "./dist/configure/index.mjs",
   "types": "./dist/configure/index.d.mts",
+  "imports": {
+    "#/*": "./src/*.ts"
+  },
   "exports": {
     ".": {
       "types": "./dist/configure/index.d.mts",
@@ -131,12 +135,17 @@
       "types": "./dist/runtime/file.d.mts",
       "import": "./dist/runtime/file.mjs",
       "default": "./dist/runtime/file.mjs"
+    },
+    "./runtime/aigateway": {
+      "types": "./dist/runtime/aigateway.d.mts",
+      "import": "./dist/runtime/aigateway.mjs",
+      "default": "./dist/runtime/aigateway.mjs"
     }
   },
   "dependencies": {
     "@0no-co/graphql.web": "1.3.2",
     "@badgateway/oauth2-client": "3.3.1",
-    "@bufbuild/protobuf": "2.12.0",
+    "@bufbuild/protobuf": "2.12.1",
     "@bufbuild/protovalidate": "1.2.0",
     "@connectrpc/connect": "2.1.2",
     "@connectrpc/connect-node": "2.1.2",
@@ -145,63 +154,65 @@
     "@jridgewell/trace-mapping": "0.3.31",
     "@napi-rs/keyring": "1.3.0",
     "@opentelemetry/api": "1.9.1",
-    "@opentelemetry/exporter-trace-otlp-proto": "0.219.0",
-    "@opentelemetry/resources": "2.8.0",
-    "@opentelemetry/sdk-trace-node": "2.8.0",
+    "@opentelemetry/exporter-trace-otlp-proto": "0.220.0",
+    "@opentelemetry/resources": "2.9.0",
+    "@opentelemetry/sdk-trace-node": "2.9.0",
     "@opentelemetry/semantic-conventions": "1.41.1",
-    "@oxc-project/types": "0.135.0",
+    "@oxc-project/types": "0.138.0",
     "@standard-schema/spec": "1.1.0",
     "@tailor-platform/function-kysely-tailordb": "0.1.3",
-    "@toiroakr/lines-db": "0.9.2",
+    "@toiroakr/lines-db": "0.10.0",
     "@toiroakr/read-multiline": "0.4.1",
-    "@urql/core": "6.0.1",
+    "@urql/core": "6.0.3",
+    "amaro": "1.1.10",
     "chalk": "5.6.2",
     "chokidar": "5.0.0",
     "confbox": "0.2.4",
     "date-fns": "4.4.0",
-    "es-toolkit": "1.47.1",
+    "es-toolkit": "1.49.0",
     "find-up-simple": "1.0.1",
-    "globals": "17.6.0",
-    "graphql": "16.14.2",
+    "globals": "17.7.0",
+    "graphql": "17.0.1",
     "inflection": "3.0.2",
     "kysely": "0.29.2",
     "madge": "8.0.0",
     "mime-types": "3.0.2",
     "open": "11.0.0",
-    "oxc-parser": "0.135.0",
+    "oxc-parser": "0.138.0",
     "p-limit": "7.3.0",
     "pathe": "2.0.3",
     "pgsql-ast-parser": "12.0.2",
     "pkg-types": "2.3.1",
-    "politty": "0.6.0",
-    "rolldown": "1.1.1",
+    "politty": "0.11.0",
+    "rolldown": "1.1.4",
     "semver": "7.8.5",
     "sql-highlight": "6.1.0",
     "std-env": "4.1.0",
     "table": "6.9.0",
     "ts-cron-validator": "1.1.5",
-    "tsx": "4.22.4",
     "type-fest": "5.7.0",
-    "undici": "8.5.0",
+    "undici": "8.6.0",
     "xdg-basedir": "5.1.0",
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@opentelemetry/sdk-trace-base": "2.8.0",
+    "@opentelemetry/sdk-trace-base": "2.9.0",
     "@types/madge": "5.0.3",
     "@types/mime-types": "3.0.1",
     "@types/node": "24.13.2",
     "@types/semver": "7.7.1",
-    "@typescript/native-preview": "7.0.0-dev.20260614.1",
-    "@vitest/coverage-v8": "4.1.8",
-    "oxfmt": "0.54.0",
-    "oxlint": "1.69.0",
-    "oxlint-tsgolint": "0.23.0",
+    "@typescript/native-preview": "7.0.0-dev.20260703.1",
+    "@vitest/coverage-v8": "4.1.9",
+    "eslint-plugin-zod": "4.7.0",
+    "oxfmt": "0.57.0",
+    "oxlint": "1.72.0",
+    "oxlint-tsgolint": "0.24.0",
     "sonda": "0.13.1",
-    "tsdown": "0.22.2",
+    "tsdown": "0.22.3",
     "typescript": "6.0.3",
-    "vitest": "4.1.8",
-    "zinfer": "0.1.8"
+    "vitest": "4.1.9",
+    "zinfer": "0.2.3",
+    "@tailor-platform/tailor-proto": "^0.0.0"
   },
   "peerDependencies": {
     "vite": "^6.0.0 || ^7.0.0 || ^8.0.0",
@@ -217,7 +228,7 @@
   },
   "engines": {
     "bun": ">=1.2.0",
-    "node": ">=22"
+    "node": ">=22.15.0"
   },
   "scripts": {
     "test": "vitest",
@@ -226,11 +237,11 @@
     "test:coverage": "vitest --coverage",
     "docs:check": "vitest run --project=unit* src/cli/docs.test.ts",
     "docs:update": "POLITTY_DOCS_UPDATE=true vitest run --project=unit* src/cli/docs.test.ts",
-    "build": "tsdown && politty generate-worker --bin dist/cli/index.mjs --program tailor-sdk --shell zsh --verify",
+    "build": "tsdown && politty generate-worker --bin dist/cli/index.mjs --program tailor --shell zsh --verify",
     "lint": "oxlint --type-aware .",
-    "check:public-api-jsdoc": "tsx scripts/check-public-api-jsdoc.ts",
-    "check:zod-isolation": "tsx scripts/check-zod-isolation.ts",
-    "check:import-cycles": "tsx scripts/check-import-cycles.ts",
+    "check:public-api-jsdoc": "node --experimental-strip-types scripts/check-public-api-jsdoc.ts",
+    "check:zod-isolation": "node --experimental-strip-types scripts/check-zod-isolation.ts",
+    "check:import-cycles": "node --experimental-strip-types scripts/check-import-cycles.ts",
     "lint:fix": "oxlint --type-aware . --fix",
     "typecheck": "tsc --noEmit",
     "typecheck:go": "tsgo",

package/postinstall.mjs

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
 
 import { existsSync } from "node:fs";
-import { register } from "node:module";
 import { dirname, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { findUpSync } from "find-up-simple";
@@ -12,9 +11,9 @@ const DEFAULT_CONFIG_FILENAME = "tailor.config.ts";
 async function install() {
   const cwd = process.env.INIT_CWD || process.cwd();
 
-  // Skip if running in the tailor-sdk package itself
+  // Skip if running in the @tailor-platform/sdk package itself
   if (cwd === __dirname || cwd === resolve(__dirname, "..", "..")) {
-    console.log("⚠️  Skipping postinstall in tailor-sdk package itself");
+    console.log("⚠️  Skipping postinstall in @tailor-platform/sdk package itself");
     return;
   }
 
@@ -22,8 +21,8 @@ async function install() {
 
   // Try to find and load the user's tailor.config.ts
   // Priority: env/config > search parent directories
-  const configPath = process.env.TAILOR_PLATFORM_SDK_CONFIG_PATH
-    ? resolve(cwd, process.env.TAILOR_PLATFORM_SDK_CONFIG_PATH)
+  const configPath = process.env.TAILOR_CONFIG_PATH
+    ? resolve(cwd, process.env.TAILOR_CONFIG_PATH)
     : findUpSync(DEFAULT_CONFIG_FILENAME, { cwd });
 
   if (!configPath || !existsSync(configPath)) {
@@ -34,7 +33,6 @@ async function install() {
   try {
     const configDir = dirname(configPath);
     process.chdir(configDir);
-    register("tsx", import.meta.url, { data: {} });
 
     const { generateUserTypes, loadConfig } = await import(
       pathToFileURL(resolve(__dirname, "dist", "cli", "lib.mjs")).href

package/dist/application-Dtqap5jM.mjs

@@ -1,3 +0,0 @@
-import { n as generatePluginFilesIfNeeded, r as loadApplication, t as defineApplication } from "./application-XuMWK4eq.mjs";
-
-export { defineApplication, generatePluginFilesIfNeeded };