@tagma/sdk 0.7.35 → 0.7.37

package/README.md

@@ -339,6 +339,8 @@ Tasks can declare named, typed `inputs` / `outputs`. Inputs flow in from upstrea
 
 ### Built-in Triggers
 
+File and directory trigger watch paths may be relative to `workDir`, absolute, or external. This exception is only for trigger watch paths; other path fields remain workspace-bound.
+
 #### `manual` — Human approval gate
 
 | Field      | Type       | Required | Default                                                | Description                                       |
@@ -356,6 +358,14 @@ Tasks can declare named, typed `inputs` / `outputs`. Inputs flow in from upstrea
 | `path`    | `string` | Yes      | —       | File path to watch (relative to workDir)       |
 | `timeout` | `string` | No       | —       | How long to wait for the file to appear/change |
 
+#### `directory` - Directory watcher gate
+
+| Field     | Type          | Required | Default | Description                                      |
+| --------- | ------------- | -------- | ------- | ------------------------------------------------ |
+| `type`    | `"directory"` | Yes      | —       | Trigger type                                     |
+| `path`    | `string`      | Yes      | —       | Directory path to watch (relative to workDir)    |
+| `timeout` | `string`      | No       | —       | How long to wait for the directory to be created |
+
 ---
 
 ### Built-in Completions
@@ -401,6 +411,10 @@ Tasks can declare named, typed `inputs` / `outputs`. Inputs flow in from upstrea
 ### Root: `@tagma/sdk`
 
 - `createTagma(options?)`
+- `createTagma().run(config, options)` for either a single `PipelineConfig` or a `PipelineGraphConfig`
+- `createTagma().runYaml(content, options)` for either `pipeline:` or `workflow:` YAML documents
+- `detectTagmaYamlKind(content)`
+- `loadTagmaYaml(content, workDir)`
 - `bunRuntime()`
 - `definePipeline(pipeline)`
 - `PluginRegistry`
@@ -416,6 +430,10 @@ Tasks can declare named, typed `inputs` / `outputs`. Inputs flow in from upstrea
 - `deresolvePipeline(config, workDir)`
 - `validateConfig(config)`
 - `compileYamlContent(content, options?)`
+- `loadWorkflow(yaml, workDir)`
+- `parseWorkflowYaml(content)`
+- `serializeWorkflow(config)`
+- `validateRawWorkflow(config)`
 
 ### Plugins: `@tagma/sdk/plugins`
 
@@ -464,7 +482,7 @@ These ship in `@tagma/runtime-bun`, not `@tagma/sdk` — when you `bun add @tagm
 
 ### `bootstrapBuiltins(registry)`
 
-Registers all built-in plugins (opencode driver, file/manual triggers, completion checks, static-context middleware).
+Registers all built-in plugins (opencode driver, file/directory/manual triggers, completion checks, static-context middleware).
 
 ### `loadPipeline(yaml: string, workDir: string): Promise<PipelineConfig>`
 
@@ -479,11 +497,11 @@ Options:
 - `registry` -- use an existing `PluginRegistry` instance
 - `builtins` -- register built-in plugins into the instance registry; defaults to `true`
 - `plugins` -- register package-level `TagmaPlugin` capability objects into the instance registry
-- `runtime` -- override process execution, file watching, file existence checks, log storage, time, and sleep; defaults to `bunRuntime()`
+- `runtime` -- override process execution, file/directory watching, file/directory existence checks, log storage, time, and sleep; defaults to `bunRuntime()`
 
 ### `createTagma().run(config, options): Promise<EngineResult>`
 
-Executes the pipeline. Returns `{ success, runId, logPath, summary, states }`.
+Executes a single pipeline. Returns `{ success, runId, logPath, summary, states }`.
 
 Options:
 
@@ -506,6 +524,31 @@ Options:
 
 > **stdout / stderr persistence.** With the default Bun runtime, the engine streams every task's stdout and stderr to disk under `<workDir>/.tagma/logs/<runId>/<taskId>.stdout` and `.stderr`. Custom runtimes can relocate those artifacts by implementing `runtime.logStore.taskOutputPath()`. The `TaskResult.stdout` / `stderr` strings are bounded tails (8 MB / 4 MB by default) — long outputs are truncated from the head with a marker, and consumers that need the full bytes should read `TaskResult.stdoutPath` / `stderrPath`. Use `TaskResult.stdoutBytes` / `stderrBytes` to display "32 MB (truncated)" without re-stat'ing the file.
 
+### Workflow graph YAML
+
+Workflow graph YAML wraps multiple pipeline YAML files and lets the SDK execute them with graph-level dependencies and pipeline lifecycle controls.
+
+```yaml
+workflow:
+  kind: graph
+  name: release-flow
+  max_concurrency: 2
+  failure_policy: stop_all
+  pipelines:
+    - id: build
+      path: .tagma/build/build.yaml
+      lifecycle:
+        max_runs: 3
+        stop_when: success
+    - id: deploy
+      path: .tagma/deploy/deploy.yaml
+      depends_on: [build]
+```
+
+Per-pipeline `lifecycle.max_runs` defaults to `1`. `lifecycle.stop_when` defaults to `success`; supported values are `success` (retry until the first successful run or the max is reached), `failure` (run until the first failed run or the max is reached), and `always` (run exactly `max_runs` attempts unless aborted). Graph results include `runCount`, `maxRuns`, and per-attempt state on each pipeline node.
+
+`createTagma().run(graphConfig, options)` runs a programmatic `PipelineGraphConfig`. `createTagma().runYaml(content, options)` detects either top-level `pipeline:` or `workflow:` YAML and returns `{ kind: 'pipeline' | 'workflow', result }`, so CLI hosts can route one file path through one SDK call.
+
 ### `PipelineRunner`
 
 Higher-level wrapper for managing multiple concurrent pipeline runs — designed for sidecar / Tauri IPC scenarios where the frontend controls pipeline lifecycle by ID.
@@ -546,7 +589,7 @@ Properties:
 
 Typed error classes for trigger plugin error classification. The engine uses `instanceof` checks on these to set the correct task status (`blocked` or `timeout`) instead of matching on error message substrings.
 
-Built-in triggers (`manual`, `file`) throw these automatically. Trigger plugins should throw `TriggerBlockedError` for user/policy rejections and `TriggerTimeoutError` for genuine wait timeouts.
+Built-in triggers (`manual`, `file`, `directory`) throw these automatically. Trigger plugins should throw `TriggerBlockedError` for user/policy rejections and `TriggerTimeoutError` for genuine wait timeouts.
 
 ```ts
 import { TriggerBlockedError, TriggerTimeoutError } from '@tagma/sdk';

package/dist/bootstrap.d.ts

@@ -1,18 +1,66 @@
 import type { PluginRegistry } from '@tagma/core';
-export declare const BuiltinTagmaPlugin: {
+/**
+ * Safe-mode built-ins: plugins that do not execute arbitrary code or shell
+ * commands. These are registered with `{ safeMode: true }` and are available
+ * under `mode: 'safe'` pipelines without explicit allowlist entries.
+ */
+export declare const SafeBuiltinTagmaPlugin: {
     name: string;
     capabilities: {
         drivers: {
             opencode: import("@tagma/types").DriverPlugin;
         };
         triggers: {
+            directory: import("@tagma/types").TriggerPlugin;
             file: import("@tagma/types").TriggerPlugin;
             manual: import("@tagma/types").TriggerPlugin;
         };
         completions: {
             exit_code: import("@tagma/types").CompletionPlugin;
             file_exists: import("@tagma/types").CompletionPlugin;
+        };
+        middlewares: {
+            static_context: import("@tagma/types").MiddlewarePlugin;
+        };
+    };
+};
+/**
+ * Unsafe built-ins: plugins that execute arbitrary shell commands and must
+ * NOT be in the safe-mode allowlist. These require explicit caller opt-in
+ * via `safeModeAllowlist` or `mode: 'trusted'`.
+ *
+ * `output_check` pipes task output into a user-specified shell command,
+ * which is a direct command-execution vector. Including it in safe mode
+ * would bypass the safe-mode intent that blocks command execution.
+ */
+export declare const UnsafeBuiltinTagmaPlugin: {
+    name: string;
+    capabilities: {
+        completions: {
+            output_check: import("@tagma/types").CompletionPlugin;
+        };
+    };
+};
+/**
+ * Combined built-in plugin bundle for backward compatibility. Includes both
+ * safe and unsafe plugins. Use `bootstrapBuiltins()` to register with
+ * proper safe-mode scoping.
+ */
+export declare const BuiltinTagmaPlugin: {
+    name: string;
+    capabilities: {
+        drivers: {
+            opencode: import("@tagma/types").DriverPlugin;
+        };
+        triggers: {
+            directory: import("@tagma/types").TriggerPlugin;
+            file: import("@tagma/types").TriggerPlugin;
+            manual: import("@tagma/types").TriggerPlugin;
+        };
+        completions: {
             output_check: import("@tagma/types").CompletionPlugin;
+            exit_code: import("@tagma/types").CompletionPlugin;
+            file_exists: import("@tagma/types").CompletionPlugin;
         };
         middlewares: {
             static_context: import("@tagma/types").MiddlewarePlugin;
@@ -27,6 +75,14 @@ export declare const BuiltinTagmaPlugin: {
  *
  * Built-in handlers are stateless module singletons — registering the same
  * handler object into N registries is cheap and safe; no cloning is needed.
+ *
+ * Safe built-ins register with `{ safeMode: true }` so they are automatically
+ * available under `mode: 'safe'` pipelines without explicit allowlist entries.
+ * Unsafe built-ins (output_check, which executes arbitrary shell commands)
+ * register WITHOUT safeMode, requiring explicit caller opt-in.
+ *
+ * The registry's `getSafeModeDefaults()` surfaces these to the engine's 3-way
+ * safe-mode merge (hardcoded defaults ∪ registry-declared ∪ caller-supplied).
  */
 export declare function bootstrapBuiltins(target: PluginRegistry): void;
 //# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAsBlD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;CAmBR,CAAC;AAExB;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE9D"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAuBlD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;CAmBZ,CAAC;AAExB;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB;;;;;;;CAOd,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;CAWR,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAG9D"}

package/dist/bootstrap.js

@@ -7,32 +7,72 @@ import { OpenCodeDriver } from './drivers/opencode';
 // Built-in Triggers
 import { FileTrigger } from './triggers/file';
 import { ManualTrigger } from './triggers/manual';
+import { DirectoryTrigger } from './triggers/directory';
 // Built-in Completions
 import { ExitCodeCompletion } from './completions/exit-code';
 import { FileExistsCompletion } from './completions/file-exists';
 import { OutputCheckCompletion } from './completions/output-check';
 // Built-in Middleware
 import { StaticContextMiddleware } from './middlewares/static-context';
-export const BuiltinTagmaPlugin = {
-    name: '@tagma/sdk/builtins',
+/**
+ * Safe-mode built-ins: plugins that do not execute arbitrary code or shell
+ * commands. These are registered with `{ safeMode: true }` and are available
+ * under `mode: 'safe'` pipelines without explicit allowlist entries.
+ */
+export const SafeBuiltinTagmaPlugin = {
+    name: '@tagma/sdk/builtins-safe',
     capabilities: {
         drivers: {
             opencode: OpenCodeDriver,
         },
         triggers: {
+            directory: DirectoryTrigger,
             file: FileTrigger,
             manual: ManualTrigger,
         },
         completions: {
             exit_code: ExitCodeCompletion,
             file_exists: FileExistsCompletion,
-            output_check: OutputCheckCompletion,
         },
         middlewares: {
             static_context: StaticContextMiddleware,
         },
     },
 };
+/**
+ * Unsafe built-ins: plugins that execute arbitrary shell commands and must
+ * NOT be in the safe-mode allowlist. These require explicit caller opt-in
+ * via `safeModeAllowlist` or `mode: 'trusted'`.
+ *
+ * `output_check` pipes task output into a user-specified shell command,
+ * which is a direct command-execution vector. Including it in safe mode
+ * would bypass the safe-mode intent that blocks command execution.
+ */
+export const UnsafeBuiltinTagmaPlugin = {
+    name: '@tagma/sdk/builtins-unsafe',
+    capabilities: {
+        completions: {
+            output_check: OutputCheckCompletion,
+        },
+    },
+};
+/**
+ * Combined built-in plugin bundle for backward compatibility. Includes both
+ * safe and unsafe plugins. Use `bootstrapBuiltins()` to register with
+ * proper safe-mode scoping.
+ */
+export const BuiltinTagmaPlugin = {
+    name: '@tagma/sdk/builtins',
+    capabilities: {
+        drivers: SafeBuiltinTagmaPlugin.capabilities.drivers,
+        triggers: SafeBuiltinTagmaPlugin.capabilities.triggers,
+        completions: {
+            ...SafeBuiltinTagmaPlugin.capabilities.completions,
+            ...UnsafeBuiltinTagmaPlugin.capabilities.completions,
+        },
+        middlewares: SafeBuiltinTagmaPlugin.capabilities.middlewares,
+    },
+};
 /**
  * Register every built-in plugin into `target`. Hosts instantiate one
  * PluginRegistry per workspace or SDK instance and call this once per
@@ -41,8 +81,17 @@ export const BuiltinTagmaPlugin = {
  *
  * Built-in handlers are stateless module singletons — registering the same
  * handler object into N registries is cheap and safe; no cloning is needed.
+ *
+ * Safe built-ins register with `{ safeMode: true }` so they are automatically
+ * available under `mode: 'safe'` pipelines without explicit allowlist entries.
+ * Unsafe built-ins (output_check, which executes arbitrary shell commands)
+ * register WITHOUT safeMode, requiring explicit caller opt-in.
+ *
+ * The registry's `getSafeModeDefaults()` surfaces these to the engine's 3-way
+ * safe-mode merge (hardcoded defaults ∪ registry-declared ∪ caller-supplied).
  */
 export function bootstrapBuiltins(target) {
-    target.registerTagmaPlugin(BuiltinTagmaPlugin);
+    target.registerTagmaPlugin(SafeBuiltinTagmaPlugin, { safeMode: true });
+    target.registerTagmaPlugin(UnsafeBuiltinTagmaPlugin, { safeMode: false });
 }
 //# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAGA,mBAAmB;AACnB,wEAAwE;AACxE,0EAA0E;AAC1E,iCAAiC;AACjC,kEAAkE;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,sBAAsB;AACtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,qBAAqB;IAC3B,YAAY,EAAE;QACZ,OAAO,EAAE;YACP,QAAQ,EAAE,cAAc;SACzB;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,aAAa;SACtB;QACD,WAAW,EAAE;YACX,SAAS,EAAE,kBAAkB;YAC7B,WAAW,EAAE,oBAAoB;YACjC,YAAY,EAAE,qBAAqB;SACpC;QACD,WAAW,EAAE;YACX,cAAc,EAAE,uBAAuB;SACxC;KACF;CACoB,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,MAAM,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAGA,mBAAmB;AACnB,wEAAwE;AACxE,0EAA0E;AAC1E,iCAAiC;AACjC,kEAAkE;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,sBAAsB;AACtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,0BAA0B;IAChC,YAAY,EAAE;QACZ,OAAO,EAAE;YACP,QAAQ,EAAE,cAAc;SACzB;QACD,QAAQ,EAAE;YACR,SAAS,EAAE,gBAAgB;YAC3B,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,aAAa;SACtB;QACD,WAAW,EAAE;YACX,SAAS,EAAE,kBAAkB;YAC7B,WAAW,EAAE,oBAAoB;SAClC;QACD,WAAW,EAAE;YACX,cAAc,EAAE,uBAAuB;SACxC;KACF;CACoB,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,4BAA4B;IAClC,YAAY,EAAE;QACZ,WAAW,EAAE;YACX,YAAY,EAAE,qBAAqB;SACpC;KACF;CACoB,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,qBAAqB;IAC3B,YAAY,EAAE;QACZ,OAAO,EAAE,sBAAsB,CAAC,YAAY,CAAC,OAAO;QACpD,QAAQ,EAAE,sBAAsB,CAAC,YAAY,CAAC,QAAQ;QACtD,WAAW,EAAE;YACX,GAAG,sBAAsB,CAAC,YAAY,CAAC,WAAW;YAClD,GAAG,wBAAwB,CAAC,YAAY,CAAC,WAAW;SACrD;QACD,WAAW,EAAE,sBAAsB,CAAC,YAAY,CAAC,WAAW;KAC7D;CACoB,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,MAAM,CAAC,mBAAmB,CAAC,wBAAwB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-export { createTagma } from './tagma';
-export type { CreateTagmaOptions, Tagma, TagmaRunOptions } from './tagma';
+export { createTagma, detectTagmaYamlKind, loadTagmaYaml } from './tagma';
+export type { CreateTagmaOptions, Tagma, TagmaGraphRunOptions, TagmaRunOptions, TagmaRunnableConfig, TagmaYamlDocument, TagmaYamlRunResult, } from './tagma';
 export { bunRuntime } from '@tagma/runtime-bun';
 export type { EnvPolicy, TagmaRuntime, RunOptions as RuntimeRunOptions } from '@tagma/core';
-export { definePipeline, PluginRegistry, TriggerBlockedError, TriggerTimeoutError, } from '@tagma/core';
+export { definePipeline, PluginRegistry, TriggerBlockedError, TriggerTimeoutError, DEFAULT_TASK_TIMEOUT_MS, } from '@tagma/core';
 export type { EngineResult, RegisterPluginOptions, RunEventPayload } from '@tagma/core';
 export { RUN_PROTOCOL_VERSION, TASK_LOG_CAP, TASK_LIVE_OUTPUT_CAP, appendLiveOutput, } from '@tagma/types';
 export { PipelineGroup, PipelineGraphRunner, WorkflowValidationError, createPipelineGroup, loadWorkflow, parseWorkflowYaml, runPipelineGraph, serializeWorkflow, validateRawWorkflow, } from './workflow';
 export type { CreatePipelineGroupOptions, PipelineGraphPipelineResult, PipelineGraphResult, PipelineGraphRunnerOptions, PipelineGroupAddOptions, } from './workflow';
-export type { PipelineConfig, PipelineExecutionMode, PipelineGraphAbortReason, PipelineGraphConfig, PipelineGraphEventPayload, PipelineGraphNodeState, PipelineGraphNodeStatus, PipelineGraphPipelineConfig, RawPipelineConfig, RawWorkflowConfig, RawWorkflowPipelineConfig, RawTrackConfig, RawTaskConfig, TrackConfig, TaskConfig, WorkflowConfig, WorkflowFailurePolicy, WorkflowPipelineConfig, RunSnapshotPayload, WireRunEvent, RunTaskState, TaskLogLine, SecretResolver, SecretResolverContext, ApprovalRequestInfo, ApprovalRequestHandle, TaskStatus, ApprovalRequest, ApprovalGateway, PluginCategory, PluginCapabilities, TagmaPlugin, DriverPlugin, TriggerPlugin, TriggerWatchHandle, CompletionPlugin, MiddlewarePlugin, RunEventPayload as PipelineRunEventPayload, } from '@tagma/types';
+export type { PipelineConfig, PipelineExecutionMode, PipelineGraphAbortReason, PipelineGraphConfig, PipelineGraphEventPayload, PipelineGraphNodeState, PipelineGraphNodeStatus, PipelineGraphPipelineAttemptState, PipelineGraphPipelineConfig, PipelineGraphPipelineLifecycle, PipelineGraphStopWhen, RawPipelineConfig, RawWorkflowConfig, RawWorkflowPipelineConfig, RawTrackConfig, RawTaskConfig, TrackConfig, TaskConfig, WorkflowConfig, WorkflowDocumentKind, WorkflowFailurePolicy, WorkflowPipelineConfig, RunSnapshotPayload, WireRunEvent, RunTaskState, TaskLogLine, SecretResolver, SecretResolverContext, ApprovalRequestInfo, ApprovalRequestHandle, TaskStatus, ApprovalRequest, ApprovalGateway, PluginCategory, PluginCapabilities, TagmaPlugin, DriverPlugin, TriggerPlugin, TriggerWatchHandle, CompletionPlugin, MiddlewarePlugin, RunEventPayload as PipelineRunEventPayload, } from '@tagma/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,YAAY,EAAE,kBAAkB,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,EAC3B,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAMhB,eAAe,IAAI,uBAAuB,GAC3C,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1E,YAAY,EACV,kBAAkB,EAClB,KAAK,EACL,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,iCAAiC,EACjC,2BAA2B,EAC3B,8BAA8B,EAC9B,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,EACV,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,UAAU,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAMhB,eAAe,IAAI,uBAAuB,GAC3C,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
-export { createTagma } from './tagma';
+export { createTagma, detectTagmaYamlKind, loadTagmaYaml } from './tagma';
 export { bunRuntime } from '@tagma/runtime-bun';
-export { definePipeline, PluginRegistry, TriggerBlockedError, TriggerTimeoutError, } from '@tagma/core';
+export { definePipeline, PluginRegistry, TriggerBlockedError, TriggerTimeoutError, DEFAULT_TASK_TIMEOUT_MS, } from '@tagma/core';
 export { RUN_PROTOCOL_VERSION, TASK_LOG_CAP, TASK_LIVE_OUTPUT_CAP, appendLiveOutput, } from '@tagma/types';
 export { PipelineGroup, PipelineGraphRunner, WorkflowValidationError, createPipelineGroup, loadWorkflow, parseWorkflowYaml, runPipelineGraph, serializeWorkflow, validateRawWorkflow, } from './workflow';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAU1E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/tagma.d.ts

@@ -1,6 +1,7 @@
 import { PluginRegistry, type EngineResult, type RunPipelineOptions } from '@tagma/core';
 import type { TagmaRuntime } from '@tagma/core';
-import type { PipelineConfig, TagmaPlugin } from '@tagma/types';
+import type { PipelineConfig, PipelineGraphConfig, TagmaPlugin, WorkflowConfig } from '@tagma/types';
+import { type PipelineGraphResult, type PipelineGraphRunnerOptions } from './workflow';
 export interface CreateTagmaOptions {
     /**
      * Registry used by this SDK instance. Omit to create an isolated registry.
@@ -24,10 +25,33 @@ export interface CreateTagmaOptions {
 export interface TagmaRunOptions extends Omit<RunPipelineOptions, 'registry' | 'runtime'> {
     readonly cwd: string;
 }
+export interface TagmaGraphRunOptions extends Omit<PipelineGraphRunnerOptions, 'registry' | 'runtime'> {
+    readonly cwd: string;
+}
+export type TagmaRunnableConfig = PipelineConfig | PipelineGraphConfig;
+export type TagmaYamlDocument = {
+    readonly kind: 'pipeline';
+    readonly config: PipelineConfig;
+} | {
+    readonly kind: 'workflow';
+    readonly config: WorkflowConfig;
+};
+export type TagmaYamlRunResult = {
+    readonly kind: 'pipeline';
+    readonly result: EngineResult;
+} | {
+    readonly kind: 'workflow';
+    readonly result: PipelineGraphResult;
+};
 export interface Tagma {
     readonly registry: PluginRegistry;
     run(config: PipelineConfig, options: TagmaRunOptions): Promise<EngineResult>;
+    run(config: PipelineGraphConfig, options: TagmaGraphRunOptions): Promise<PipelineGraphResult>;
+    run(config: TagmaRunnableConfig, options: TagmaRunOptions | TagmaGraphRunOptions): Promise<EngineResult | PipelineGraphResult>;
+    runYaml(content: string, options: TagmaRunOptions | TagmaGraphRunOptions): Promise<TagmaYamlRunResult>;
     validate(config: PipelineConfig): readonly string[];
 }
+export declare function detectTagmaYamlKind(content: string): TagmaYamlDocument['kind'];
+export declare function loadTagmaYaml(content: string, workDir: string): Promise<TagmaYamlDocument>;
 export declare function createTagma(options?: CreateTagmaOptions): Tagma;
 //# sourceMappingURL=tagma.d.ts.map

package/dist/tagma.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tagma.d.ts","sourceRoot":"","sources":["../src/tagma.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACjC;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,SAAS,CAAC;IACvF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7E,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,MAAM,EAAE,CAAC;CACrD;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,KAAK,CA2BnE"}
+{"version":3,"file":"tagma.d.ts","sourceRoot":"","sources":["../src/tagma.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAUrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrG,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAChC,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACjC;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,SAAS,CAAC;IACvF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBACf,SAAQ,IAAI,CAAC,0BAA0B,EAAE,UAAU,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,mBAAmB,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAExE,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7E,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9F,GAAG,CACD,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,eAAe,GAAG,oBAAoB,GAC9C,OAAO,CAAC,YAAY,GAAG,mBAAmB,CAAC,CAAC;IAC/C,OAAO,CACL,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,GAAG,oBAAoB,GAC9C,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,MAAM,EAAE,CAAC;CACrD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAY9E;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAIhG;AAMD,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,KAAK,CAsDnE"}

package/dist/tagma.js

@@ -1,7 +1,33 @@
 import { PluginRegistry, runPipeline, } from '@tagma/core';
+import yaml from 'js-yaml';
 import { bootstrapBuiltins } from './bootstrap';
-import { PipelineValidationError, validateConfig, validateConfigDiagnostics } from './schema';
+import { PipelineValidationError, loadPipeline, validateConfig, validateConfigDiagnostics, } from './schema';
 import { bunRuntime } from '@tagma/runtime-bun';
+import { loadWorkflow, runPipelineGraph, } from './workflow';
+export function detectTagmaYamlKind(content) {
+    const doc = yaml.load(content);
+    if (doc && typeof doc === 'object' && !Array.isArray(doc)) {
+        const hasPipeline = Object.prototype.hasOwnProperty.call(doc, 'pipeline');
+        const hasWorkflow = Object.prototype.hasOwnProperty.call(doc, 'workflow');
+        if (hasPipeline && hasWorkflow) {
+            throw new Error('YAML must not contain both top-level "pipeline" and "workflow" keys');
+        }
+        if (hasPipeline)
+            return 'pipeline';
+        if (hasWorkflow)
+            return 'workflow';
+    }
+    throw new Error('YAML must contain a top-level "pipeline" or "workflow" key');
+}
+export async function loadTagmaYaml(content, workDir) {
+    const kind = detectTagmaYamlKind(content);
+    if (kind === 'pipeline')
+        return { kind, config: await loadPipeline(content, workDir) };
+    return { kind, config: await loadWorkflow(content, workDir) };
+}
+function isPipelineGraphConfig(config) {
+    return Array.isArray(config.pipelines);
+}
 export function createTagma(options = {}) {
     const registry = options.registry ?? new PluginRegistry();
     const runtime = options.runtime ?? bunRuntime();
@@ -11,18 +37,36 @@ export function createTagma(options = {}) {
     for (const plugin of options.plugins ?? []) {
         registry.registerTagmaPlugin(plugin);
     }
-    return {
-        registry,
-        async run(config, { cwd, ...runOptions }) {
-            const diagnostics = validateConfigDiagnostics(config, cwd);
-            if (diagnostics.length > 0) {
-                throw new PipelineValidationError(diagnostics);
-            }
-            return await runPipeline(config, cwd, {
+    async function run(config, { cwd, ...runOptions }) {
+        if (isPipelineGraphConfig(config)) {
+            return await runPipelineGraph(config, cwd, {
                 ...runOptions,
                 registry,
                 runtime,
             });
+        }
+        const diagnostics = validateConfigDiagnostics(config, cwd);
+        if (diagnostics.length > 0) {
+            throw new PipelineValidationError(diagnostics);
+        }
+        return await runPipeline(config, cwd, {
+            ...runOptions,
+            registry,
+            runtime,
+        });
+    }
+    return {
+        registry,
+        run,
+        async runYaml(content, options) {
+            const document = await loadTagmaYaml(content, options.cwd);
+            if (document.kind === 'pipeline') {
+                return { kind: 'pipeline', result: await run(document.config, options) };
+            }
+            return {
+                kind: 'workflow',
+                result: await run(document.config, options),
+            };
         },
         validate(config) {
             return validateConfig(config);

package/dist/tagma.js.map

@@ -1 +1 @@
-{"version":3,"file":"tagma.js","sourceRoot":"","sources":["../src/tagma.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,WAAW,GAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAmChD,MAAM,UAAU,WAAW,CAAC,UAA8B,EAAE;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,cAAc,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC;IAChD,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC/B,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC3C,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,OAAO;QACL,QAAQ;QACR,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,UAAU,EAAE;YACtC,MAAM,WAAW,GAAG,yBAAyB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC3D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,uBAAuB,CAAC,WAAW,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,MAAM,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE;gBACpC,GAAG,UAAU;gBACb,QAAQ;gBACR,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,CAAC,MAAM;YACb,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"tagma.js","sourceRoot":"","sources":["../src/tagma.ts"],"names":[],"mappings":"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"}

package/dist/triggers/directory.d.ts

@@ -0,0 +1,3 @@
+import { type TriggerPlugin } from '@tagma/types';
+export declare const DirectoryTrigger: TriggerPlugin;
+//# sourceMappingURL=directory.d.ts.map

package/dist/triggers/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/triggers/directory.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,aAAa,EAGnB,MAAM,cAAc,CAAC;AActB,eAAO,MAAM,gBAAgB,EAAE,aA2C9B,CAAC"}

package/dist/triggers/directory.js

@@ -0,0 +1,140 @@
+import { resolve, dirname, isAbsolute, relative } from 'path';
+import { TriggerTimeoutError, linkAbort, } from '@tagma/types';
+import { parseOptionalPluginTimeout } from '../duration';
+const IS_WINDOWS = process.platform === 'win32';
+function pathsEqual(a, b) {
+    return IS_WINDOWS ? a.toLowerCase() === b.toLowerCase() : a === b;
+}
+function isInsideOrEqual(parent, child) {
+    const rel = relative(resolve(parent), resolve(child));
+    return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));
+}
+export const DirectoryTrigger = {
+    name: 'directory',
+    schema: {
+        description: 'Wait for a directory to appear before the task runs.',
+        fields: {
+            path: {
+                type: 'path',
+                required: true,
+                description: 'Path to the directory to watch for (relative to workDir or absolute).',
+                placeholder: 'e.g. inbox/ready',
+            },
+            timeout: {
+                type: 'duration',
+                description: 'Maximum wait time (e.g. 30s, 5m). Omit or 0 to wait indefinitely.',
+                placeholder: '30s',
+            },
+        },
+    },
+    watch(config, ctx) {
+        const dirPath = config.path;
+        if (!dirPath)
+            throw new Error(`directory trigger: "path" is required`);
+        const safePath = resolve(ctx.workDir, dirPath);
+        const parentDir = dirname(safePath);
+        const timeoutMs = parseOptionalPluginTimeout(config.timeout, 0);
+        const disposeController = new AbortController();
+        return {
+            fired: waitForDirectory({
+                dirPath,
+                parentDir,
+                safePath,
+                timeoutMs,
+                timeoutLabel: config.timeout,
+                ctx,
+                disposeSignal: disposeController.signal,
+            }),
+            dispose(reason = 'directory trigger disposed') {
+                disposeController.abort(reason);
+            },
+        };
+    },
+};
+async function waitForDirectory(options) {
+    const { dirPath, parentDir, safePath, timeoutMs, timeoutLabel, ctx, disposeSignal } = options;
+    if (ctx.signal.aborted)
+        throw new Error('Pipeline aborted');
+    if (disposeSignal.aborted)
+        throw new Error('Trigger disposed');
+    if (isInsideOrEqual(ctx.workDir, parentDir)) {
+        await ctx.runtime.ensureDir(parentDir).catch(() => {
+            /* best effort; runtime watch will surface real failures */
+        });
+    }
+    if (ctx.signal.aborted)
+        throw new Error('Pipeline aborted');
+    if (disposeSignal.aborted)
+        throw new Error('Trigger disposed');
+    const watchController = new AbortController();
+    let removeAbortListener = () => {
+        /* no-op until the abort listener is installed */
+    };
+    const abortPromise = new Promise((_, reject) => {
+        const fire = (message) => {
+            watchController.abort();
+            reject(new Error(message));
+        };
+        const removePipeline = linkAbort(ctx.signal, () => fire('Pipeline aborted'));
+        const removeDispose = linkAbort(disposeSignal, () => fire('Trigger disposed'));
+        removeAbortListener = () => {
+            removePipeline();
+            removeDispose();
+        };
+    });
+    let timer = null;
+    const timeoutPromise = timeoutMs > 0
+        ? new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                watchController.abort();
+                reject(new TriggerTimeoutError(`directory trigger timeout: ${dirPath} did not appear within ${timeoutLabel}`));
+            }, timeoutMs);
+        })
+        : new Promise(() => {
+            /* no timeout */
+        });
+    async function watchLoop() {
+        // Use ignoreInitial:false so an already-created target directory still
+        // satisfies the gate during the initial scan. Runtimes that expose a
+        // precise directoryExists probe get a second ready-time check below.
+        for await (const event of ctx.runtime.watch(parentDir, {
+            ignoreInitial: false,
+            depth: 0,
+            cwd: parentDir,
+            awaitWriteFinishMs: 100,
+            signal: watchController.signal,
+        })) {
+            if (event.type === 'ready') {
+                if (ctx.runtime.directoryExists) {
+                    let exists = false;
+                    try {
+                        exists = await ctx.runtime.directoryExists(safePath);
+                    }
+                    catch (err) {
+                        throw new Error(`directory trigger existence check failed: ${err instanceof Error ? err.message : String(err)}`);
+                    }
+                    if (exists)
+                        return { path: safePath };
+                }
+                continue;
+            }
+            if (event.type === 'addDir' &&
+                pathsEqual(resolve(parentDir, event.path), safePath)) {
+                return { path: safePath };
+            }
+        }
+        if (ctx.signal.aborted)
+            throw new Error('Pipeline aborted');
+        throw new Error(`directory trigger watch ended before ${dirPath} appeared`);
+    }
+    try {
+        return await Promise.race([watchLoop(), timeoutPromise, abortPromise]);
+    }
+    finally {
+        if (timer !== null)
+            clearTimeout(timer);
+        removeAbortListener();
+        watchController.abort();
+    }
+}
+//# sourceMappingURL=directory.js.map