@trifoli/cli 0.1.0

package/LICENSE

@@ -0,0 +1,185 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+Copyright 2025 CleverCube AI (https://github.com/CleverCubeAi)
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship made available under
+   the License, as indicated by a copyright notice that is included in
+   or attached to the work (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean, as submitted to the Licensor for inclusion
+   in the Work by the copyright owner or by an individual or Legal Entity
+   authorized to submit on behalf of the copyright owner. For the purposes
+   of this definition, "submitted" means any form of electronic, verbal,
+   or written communication sent to the Licensor or its representatives,
+   including but not limited to communication on electronic mailing lists,
+   source code control systems, and issue tracking systems that are managed
+   by, or on behalf of, the Licensor for the purpose of discussing and
+   improving the Work, but excluding communication that is conspicuously
+   marked or otherwise designated in writing by the copyright owner as
+   "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any Legal Entity on behalf of
+   whom a Contribution has been received by the Licensor and subsequently
+   incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a cross-claim
+   or counterclaim in a lawsuit) alleging that the Work or a Contribution
+   incorporated within the Work constitutes patent or contributory patent
+   infringement, then any patent licenses granted to You under this License
+   for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work
+   or Derivative Works thereof in any medium, with or without modifications,
+   and in Source or Object form, provided that You meet the following
+   conditions:
+
+   (a) You must give any other recipients of the Work or Derivative Works
+       a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices stating
+       that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works that
+       You distribute, all copyright, patent, trademark, and attribution
+       notices from the Source form of the Work, excluding those notices
+       that do not pertain to any part of the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, You must include a readable copy of the attribution
+       notices contained within such NOTICE file, in at least one of the
+       following places: within a NOTICE text provided as part of the
+       Derivative Works; within the Source form or documentation, if
+       provided along with the Derivative Works; or, within a display
+       generated by the Derivative Works, if and wherever such third-party
+       notices normally appear. The contents of the NOTICE file are for
+       informational purposes only and do not modify the License. You may
+       add Your own attribution notices within Derivative Works that You
+       distribute, alongside or as an addendum to the NOTICE text from
+       the Work, provided that such additional attribution notices cannot
+       be construed as modifying the License.
+
+   You may add Your own license statement for Your modifications and may
+   provide additional grant of rights to use, copy, modify, merge,
+   publish, distribute, sublicense, and/or sell copies of Your
+   modifications, or for such combined works, as a whole, under terms
+   of Your choice, if You accept that You have not modified the Work's
+   legal terms and conditions for reproduction, distribution, and
+   modification of the Work.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed
+   to in writing, Licensor provides the Work (and each Contributor
+   provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES
+   OR CONDITIONS OF ANY KIND, either express or implied, including,
+   without limitation, any warranties or conditions of TITLE,
+   NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+   PURPOSE. You are solely responsible for determining the
+   appropriateness of using or reproducing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or exemplary damages of any character arising as a result
+   of this License or out of the use or inability to use the Work
+   (including but not limited to damages for loss of goodwill, work
+   stoppage, computer failure or malfunction, or all other commercial
+   damages or losses), even if such Contributor has been advised of the
+   possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the
+   Work or Derivative Works thereof, You may choose to offer, and charge
+   a fee for, acceptance of support, warranty, indemnity, or other
+   liability obligations and/or rights consistent with this License.
+   However, in accepting such obligations, You may act only on Your own
+   behalf and on Your sole responsibility, not on behalf of any other
+   Contributor, and only if You agree to indemnify, defend, and hold each
+   Contributor harmless for any liability incurred by, or claims asserted
+   against, such Contributor by reason of your accepting any such
+   warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+---
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,38 @@
+# @trifoli/cli
+
+Command-line tools for the [Trifoli Protocol](https://github.com/CleverCubeAi/trifoli-protocol).
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `trifoli validate <file>` | Validate a Trifoli document against the JSON Schema. |
+| `trifoli run <file>` | Run a workflow; pass inputs with `--input <json>` or `--input-file <path>`. Use `--workflow <id>` when the file contains multiple workflows. |
+| `trifoli list <dir>` | List workflow IDs discovered under a directory. |
+| `trifoli mcp <dir>` | Serve all workflows in a directory over MCP (stdio transport). |
+
+Run `trifoli --help` for common flags (`--schema`, `--credentials-env`, etc.).
+
+## Build and run (monorepo)
+
+From `trifoli-engine/` after `pnpm install` and `pnpm build`:
+
+```bash
+node packages/cli/dist/index.js validate ../examples/01-weather/get-city-weather.trifoli.json
+node packages/cli/dist/index.js run ../examples/01-weather/get-city-weather.trifoli.json --input '{"city":"Casablanca"}'
+```
+
+When the package is published or linked, the same entrypoint is available as the `trifoli` binary (see `package.json` `"bin"`).
+
+## Not implemented
+
+The following ideas may land in later releases; they are **not** in this package today:
+
+- `trifoli serve` — HTTP server for workflows
+- `trifoli inspect` — DAG visualization
+
+For programmatic execution and custom hosting, use **`@trifoli/engine`** (see [`../engine/README.md`](../engine/README.md)).
+
+## License
+
+Apache 2.0.

package/dist/argv.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Minimal argv parser. Splits an array of arguments into positional values
+ * and flags. Supports `--flag value` (string) and `--flag` (boolean).
+ *
+ * Not a full POSIX parser; we accept what `trifoli` actually needs.
+ */
+export interface ParsedArgs {
+    positional: string[];
+    flags: Record<string, string | boolean>;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function flagString(flags: Record<string, string | boolean>, key: string): string | undefined;
+export declare function flagBoolean(flags: Record<string, string | boolean>, key: string): boolean;
+//# sourceMappingURL=argv.d.ts.map

package/dist/argv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argv.d.ts","sourceRoot":"","sources":["../src/argv.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;CACzC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAqBpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGnG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAEzF"}

package/dist/argv.js

@@ -0,0 +1,35 @@
+/**
+ * Minimal argv parser. Splits an array of arguments into positional values
+ * and flags. Supports `--flag value` (string) and `--flag` (boolean).
+ *
+ * Not a full POSIX parser; we accept what `trifoli` actually needs.
+ */
+export function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const tok = argv[i];
+        if (!tok.startsWith("--")) {
+            positional.push(tok);
+            continue;
+        }
+        const name = tok.slice(2);
+        const next = argv[i + 1];
+        if (next === undefined || next.startsWith("--")) {
+            flags[name] = true;
+        }
+        else {
+            flags[name] = next;
+            i++;
+        }
+    }
+    return { positional, flags };
+}
+export function flagString(flags, key) {
+    const v = flags[key];
+    return typeof v === "string" ? v : undefined;
+}
+export function flagBoolean(flags, key) {
+    return flags[key] === true || flags[key] === "true";
+}
+//# sourceMappingURL=argv.js.map

package/dist/argv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argv.js","sourceRoot":"","sources":["../src/argv.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAqC,EAAE,CAAC;IAEnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACnB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAuC,EAAE,GAAW;IAC7E,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAuC,EAAE,GAAW;IAC9E,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC;AACtD,CAAC"}

package/dist/commands/list.d.ts

@@ -0,0 +1,15 @@
+import { type ParsedArgs } from "../argv.js";
+import { type CliIo } from "../io.js";
+export interface ListOptions {
+    io?: CliIo;
+}
+/**
+ * `trifoli list <dir>` — load all `.trifoli.json` files in a directory and
+ * print one row per workflow: `<id>\t<title>`.
+ *
+ * Exit codes:
+ *   0 — listing succeeded (may be empty)
+ *   1 — runtime error (dir not found, schema missing, document invalid)
+ */
+export declare function listCommand(args: ParsedArgs, opts?: ListOptions): Promise<number>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAa,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAGjD,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,KAAK,CAAC;CACZ;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8C3F"}

package/dist/commands/list.js

@@ -0,0 +1,60 @@
+import { stat } from "node:fs/promises";
+import { TrifoliEngine, TrifoliEngineError, loadSchemaFromFile } from "@trifoli/engine";
+import { flagString } from "../argv.js";
+import { consoleIo } from "../io.js";
+import { resolveSchemaPath } from "../schema-resolver.js";
+/**
+ * `trifoli list <dir>` — load all `.trifoli.json` files in a directory and
+ * print one row per workflow: `<id>\t<title>`.
+ *
+ * Exit codes:
+ *   0 — listing succeeded (may be empty)
+ *   1 — runtime error (dir not found, schema missing, document invalid)
+ */
+export async function listCommand(args, opts = {}) {
+    const io = opts.io ?? consoleIo;
+    const dir = args.positional[0];
+    if (!dir) {
+        io.stderr("Usage: trifoli list <dir> [--schema <path>]");
+        return 1;
+    }
+    try {
+        const s = await stat(dir);
+        if (!s.isDirectory()) {
+            io.stderr(`Not a directory: ${dir}`);
+            return 1;
+        }
+    }
+    catch (e) {
+        io.stderr(`Cannot read ${dir}: ${e.message}`);
+        return 1;
+    }
+    let schema;
+    try {
+        const schemaPath = await resolveSchemaPath({ explicit: flagString(args.flags, "schema") });
+        schema = await loadSchemaFromFile(schemaPath);
+    }
+    catch (e) {
+        io.stderr(e.message);
+        return 1;
+    }
+    const engine = new TrifoliEngine({ schema });
+    try {
+        await engine.loadFromDirectory(dir);
+    }
+    catch (e) {
+        if (e instanceof TrifoliEngineError) {
+            io.stderr(`${e.errorCode}: ${e.message}`);
+            return 1;
+        }
+        io.stderr(e.message);
+        return 1;
+    }
+    for (const id of engine.list()) {
+        const doc = engine.getWorkflow(id);
+        const title = doc?.info.title ?? "";
+        io.stdout(`${id}\t${title}`);
+    }
+    return 0;
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAExF,OAAO,EAAE,UAAU,EAAmB,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,SAAS,EAAc,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM1D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAgB,EAAE,OAAoB,EAAE;IACxE,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,SAAS,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,EAAE,CAAC,MAAM,CAAC,6CAA6C,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACrB,EAAE,CAAC,MAAM,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;YACrC,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,EAAE,CAAC,MAAM,CAAC,eAAe,GAAG,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC3F,MAAM,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,EAAE,CAAC,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,kBAAkB,EAAE,CAAC;YACpC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,EAAE,CAAC,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,GAAG,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACpC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,19 @@
+import { type ParsedArgs } from "../argv.js";
+import { type CliIo } from "../io.js";
+export interface McpOptions {
+    io?: CliIo;
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * `trifoli mcp <dir> [--schema <path>] [--credentials-env]`
+ *
+ * Loads every workflow in `<dir>` and starts an MCP server (stdio transport).
+ * Each workflow is exposed as one MCP tool. The process stays alive until
+ * the parent (e.g., Claude Desktop) closes the pipe.
+ *
+ * Exit codes:
+ *   0 — server started and exited cleanly
+ *   1 — runtime error (dir/schema missing, document invalid)
+ */
+export declare function mcpCommand(args: ParsedArgs, opts?: McpOptions): Promise<number>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAqC,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAGzE,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAoEzF"}

package/dist/commands/mcp.js

@@ -0,0 +1,82 @@
+import { stat } from "node:fs/promises";
+import { TrifoliEngine, TrifoliEngineError, loadSchemaFromFile } from "@trifoli/engine";
+import { createMcpServer } from "@trifoli/mcp-adapter";
+import { flagString } from "../argv.js";
+import { consoleIo, readCredentialsFromEnv } from "../io.js";
+import { resolveSchemaPath } from "../schema-resolver.js";
+/**
+ * `trifoli mcp <dir> [--schema <path>] [--credentials-env]`
+ *
+ * Loads every workflow in `<dir>` and starts an MCP server (stdio transport).
+ * Each workflow is exposed as one MCP tool. The process stays alive until
+ * the parent (e.g., Claude Desktop) closes the pipe.
+ *
+ * Exit codes:
+ *   0 — server started and exited cleanly
+ *   1 — runtime error (dir/schema missing, document invalid)
+ */
+export async function mcpCommand(args, opts = {}) {
+    const io = opts.io ?? consoleIo;
+    const env = opts.env ?? process.env;
+    const dir = args.positional[0];
+    if (!dir) {
+        io.stderr("Usage: trifoli mcp <dir> [--schema <path>] [--credentials-env]");
+        return 1;
+    }
+    try {
+        const s = await stat(dir);
+        if (!s.isDirectory()) {
+            io.stderr(`Not a directory: ${dir}`);
+            return 1;
+        }
+    }
+    catch (e) {
+        io.stderr(`Cannot read ${dir}: ${e.message}`);
+        return 1;
+    }
+    let schema;
+    try {
+        const schemaPath = await resolveSchemaPath({ explicit: flagString(args.flags, "schema") });
+        schema = await loadSchemaFromFile(schemaPath);
+    }
+    catch (e) {
+        io.stderr(e.message);
+        return 1;
+    }
+    const credentials = args.flags["credentials-env"] ? readCredentialsFromEnv(env) : undefined;
+    const engine = new TrifoliEngine({ schema, credentials });
+    try {
+        await engine.loadFromDirectory(dir);
+    }
+    catch (e) {
+        if (e instanceof TrifoliEngineError) {
+            io.stderr(`${e.errorCode}: ${e.message}`);
+            return 1;
+        }
+        io.stderr(e.message);
+        return 1;
+    }
+    const ids = engine.list();
+    if (ids.length === 0) {
+        io.stderr(`No workflows found in ${dir}`);
+        return 1;
+    }
+    io.stderr(`Trifoli MCP — exposing ${ids.length} workflow(s): ${ids.join(", ")}`);
+    const server = createMcpServer({ engine });
+    await server.start();
+    await new Promise((resolve) => {
+        const shutdown = async () => {
+            try {
+                await server.stop();
+            }
+            finally {
+                resolve();
+            }
+        };
+        process.once("SIGINT", shutdown);
+        process.once("SIGTERM", shutdown);
+        process.stdin.once("close", shutdown);
+    });
+    return 0;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"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"}

package/dist/commands/run.d.ts

@@ -0,0 +1,17 @@
+import { type ParsedArgs } from "../argv.js";
+import { type CliIo } from "../io.js";
+export interface RunOptions {
+    io?: CliIo;
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * `trifoli run <file> [--input <json>] [--input-file <path>] [--workflow <id>] [--credentials-env]`
+ *
+ * Exit codes:
+ *   0 — workflow ran and status is "succeeded"
+ *   1 — runtime error (file/schema/inputs invalid)
+ *   2 — document failed schema validation
+ *   3 — workflow ran but status is "failed"
+ */
+export declare function runCommand(args: ParsedArgs, opts?: RunOptions): Promise<number>;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAKL,KAAK,KAAK,EACX,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFzF"}

package/dist/commands/run.js

@@ -0,0 +1,92 @@
+import { TrifoliEngine, TrifoliEngineError, loadSchemaFromFile } from "@trifoli/engine";
+import { flagBoolean, flagString } from "../argv.js";
+import { consoleIo, formatResult, loadInputs, readCredentialsFromEnv, } from "../io.js";
+import { resolveSchemaPath } from "../schema-resolver.js";
+/**
+ * `trifoli run <file> [--input <json>] [--input-file <path>] [--workflow <id>] [--credentials-env]`
+ *
+ * Exit codes:
+ *   0 — workflow ran and status is "succeeded"
+ *   1 — runtime error (file/schema/inputs invalid)
+ *   2 — document failed schema validation
+ *   3 — workflow ran but status is "failed"
+ */
+export async function runCommand(args, opts = {}) {
+    const io = opts.io ?? consoleIo;
+    const env = opts.env ?? process.env;
+    const file = args.positional[0];
+    if (!file) {
+        io.stderr("Usage: trifoli run <file> [--input <json>] [--input-file <path>] [--workflow <id>] [--credentials-env]");
+        return 1;
+    }
+    let schema;
+    try {
+        const schemaPath = await resolveSchemaPath({ explicit: flagString(args.flags, "schema") });
+        schema = await loadSchemaFromFile(schemaPath);
+    }
+    catch (e) {
+        io.stderr(e.message);
+        return 1;
+    }
+    let inputs;
+    try {
+        inputs = await loadInputs({
+            input: flagString(args.flags, "input"),
+            inputFile: flagString(args.flags, "input-file"),
+        });
+    }
+    catch (e) {
+        io.stderr(e.message);
+        return 1;
+    }
+    const credentials = flagBoolean(args.flags, "credentials-env")
+        ? readCredentialsFromEnv(env)
+        : undefined;
+    const engine = new TrifoliEngine({ schema, credentials });
+    try {
+        await engine.load(file);
+    }
+    catch (e) {
+        if (e instanceof TrifoliEngineError && e.errorCode === "DOCUMENT_INVALID") {
+            io.stderr(`Invalid document: ${e.message}`);
+            if (e.detail)
+                io.stderr(JSON.stringify(e.detail, null, 2));
+            return 2;
+        }
+        io.stderr(e.message);
+        return 1;
+    }
+    const ids = engine.list();
+    if (ids.length === 0) {
+        io.stderr(`No workflows found in ${file}`);
+        return 1;
+    }
+    let workflowId = flagString(args.flags, "workflow");
+    if (!workflowId) {
+        if (ids.length > 1) {
+            io.stderr(`Multiple workflows in ${file} (${ids.join(", ")}). Use --workflow <id> to choose one.`);
+            return 1;
+        }
+        workflowId = ids[0];
+    }
+    else if (!ids.includes(workflowId)) {
+        io.stderr(`Workflow '${workflowId}' not found in ${file}. Available: ${ids.join(", ")}`);
+        return 1;
+    }
+    try {
+        const result = await engine.run(workflowId, inputs);
+        io.stdout(formatResult(result));
+        return result.status === "succeeded" ? 0 : 3;
+    }
+    catch (e) {
+        if (e instanceof TrifoliEngineError) {
+            io.stderr(`${e.errorCode}: ${e.message}`);
+            if (e.errorCode === "INPUT_INVALID")
+                return 1;
+            return 3;
+        }
+        io.stderr(e.message);
+        return 1;
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAExF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAmB,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,SAAS,EACT,YAAY,EACZ,UAAU,EACV,sBAAsB,GAEvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAO1D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAgB,EAAE,OAAmB,EAAE;IACtE,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,SAAS,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAEpC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,EAAE,CAAC,MAAM,CACP,wGAAwG,CACzG,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC3F,MAAM,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,EAAE,CAAC,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,UAAU,CAAC;YACxB,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;YACtC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC;SAChD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,EAAE,CAAC,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC;QAC5D,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC;QAC7B,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAE1D,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,kBAAkB,IAAI,CAAC,CAAC,SAAS,KAAK,kBAAkB,EAAE,CAAC;YAC1E,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5C,IAAI,CAAC,CAAC,MAAM;gBAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,EAAE,CAAC,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,EAAE,CAAC,MAAM,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,EAAE,CAAC,MAAM,CACP,yBAAyB,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,uCAAuC,CACxF,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,UAAU,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;IACvB,CAAC;SAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,EAAE,CAAC,MAAM,CAAC,aAAa,UAAU,kBAAkB,IAAI,gBAAgB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACpD,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,kBAAkB,EAAE,CAAC;YACpC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,CAAC,SAAS,KAAK,eAAe;gBAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,EAAE,CAAC,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,14 @@
+import { type ParsedArgs } from "../argv.js";
+import { type CliIo } from "../io.js";
+export interface ValidateOptions {
+    io?: CliIo;
+}
+/**
+ * `trifoli validate <file>` — load and validate one Trifoli document.
+ * Returns process exit code:
+ *   0 — document is valid
+ *   1 — runtime error (file not found, schema not found, etc.)
+ *   2 — document failed schema validation
+ */
+export declare function validateCommand(args: ParsedArgs, opts?: ValidateOptions): Promise<number>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAOA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAa,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAGjD,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,KAAK,CAAC;CACZ;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4CnG"}

package/dist/commands/validate.js

@@ -0,0 +1,58 @@
+import { DocumentValidationError, TrifoliEngine, TrifoliEngineError, loadSchemaFromFile, } from "@trifoli/engine";
+import { flagString } from "../argv.js";
+import { consoleIo } from "../io.js";
+import { resolveSchemaPath } from "../schema-resolver.js";
+/**
+ * `trifoli validate <file>` — load and validate one Trifoli document.
+ * Returns process exit code:
+ *   0 — document is valid
+ *   1 — runtime error (file not found, schema not found, etc.)
+ *   2 — document failed schema validation
+ */
+export async function validateCommand(args, opts = {}) {
+    const io = opts.io ?? consoleIo;
+    const file = args.positional[0];
+    if (!file) {
+        io.stderr("Usage: trifoli validate <file> [--schema <path>]");
+        return 1;
+    }
+    let schemaPath;
+    try {
+        schemaPath = await resolveSchemaPath({ explicit: flagString(args.flags, "schema") });
+    }
+    catch (e) {
+        io.stderr(e.message);
+        return 1;
+    }
+    let schema;
+    try {
+        schema = await loadSchemaFromFile(schemaPath);
+    }
+    catch (e) {
+        io.stderr(`Failed to load schema from ${schemaPath}: ${e.message}`);
+        return 1;
+    }
+    const engine = new TrifoliEngine({ schema });
+    try {
+        await engine.load(file);
+        const ids = engine.list();
+        for (const id of ids)
+            io.stdout(`OK ${id}`);
+        return 0;
+    }
+    catch (e) {
+        if (e instanceof DocumentValidationError) {
+            io.stderr(`Invalid document: ${e.message}`);
+            if (e.detail)
+                io.stderr(JSON.stringify(e.detail, null, 2));
+            return 2;
+        }
+        if (e instanceof TrifoliEngineError) {
+            io.stderr(`${e.errorCode}: ${e.message}`);
+            return 1;
+        }
+        io.stderr(e.message);
+        return 1;
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,UAAU,EAAmB,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,SAAS,EAAc,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM1D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAgB,EAAE,OAAwB,EAAE;IAChF,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,SAAS,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,EAAE,CAAC,MAAM,CAAC,kDAAkD,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,EAAE,CAAC,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,EAAE,CAAC,MAAM,CAAC,8BAA8B,UAAU,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,MAAM,EAAE,IAAI,GAAG;YAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,uBAAuB,EAAE,CAAC;YACzC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5C,IAAI,CAAC,CAAC,MAAM;gBAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,YAAY,kBAAkB,EAAE,CAAC;YACpC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,EAAE,CAAC,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Trifoli CLI — `trifoli` command.
+ *
+ * Subcommands:
+ *   trifoli validate <file>    Validate a Trifoli document against the schema.
+ *   trifoli run <file> [opts]  Execute a workflow.
+ *   trifoli list <dir>         List workflows in a directory.
+ *   trifoli mcp <dir>          Serve workflows over MCP (stdio).
+ */
+export declare function main(argv: string[]): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAiDH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAa1D"}

package/dist/index.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+/**
+ * Trifoli CLI — `trifoli` command.
+ *
+ * Subcommands:
+ *   trifoli validate <file>    Validate a Trifoli document against the schema.
+ *   trifoli run <file> [opts]  Execute a workflow.
+ *   trifoli list <dir>         List workflows in a directory.
+ *   trifoli mcp <dir>          Serve workflows over MCP (stdio).
+ */
+import { parseArgs } from "./argv.js";
+import { mcpCommand } from "./commands/mcp.js";
+import { listCommand } from "./commands/list.js";
+import { runCommand } from "./commands/run.js";
+import { validateCommand } from "./commands/validate.js";
+const HELP = `
+trifoli — command-line tools for the Trifoli Protocol
+
+Usage:
+  trifoli validate <file> [--schema <path>]
+      Validate a Trifoli document.
+
+  trifoli run <file> [--input <json>] [--input-file <path>]
+                     [--workflow <id>] [--credentials-env] [--schema <path>]
+      Execute a workflow. Prints the WorkflowRunResult as JSON.
+
+  trifoli list <dir> [--schema <path>]
+      List workflows in a directory.
+
+  trifoli mcp <dir> [--credentials-env] [--schema <path>]
+      Serve workflows over the Model Context Protocol (stdio transport).
+
+Common flags:
+  --schema <path>      Path to the Trifoli JSON Schema. Defaults to the
+                       schema/ folder walking up from cwd, then to the
+                       schema bundled inside @trifoli/engine.
+  --credentials-env    Read auth credentials from TRIFOLI_AUTH_* env vars.
+
+Exit codes:
+  0  success
+  1  runtime error (file/schema missing, bad inputs)
+  2  document failed schema validation
+  3  workflow ran but reported status=failed
+
+See: https://github.com/CleverCubeAi/trifoli-protocol
+`.trim();
+const handlers = {
+    validate: (a) => validateCommand(a),
+    run: (a) => runCommand(a),
+    list: (a) => listCommand(a),
+    mcp: (a) => mcpCommand(a),
+};
+export async function main(argv) {
+    const cmd = argv[0];
+    if (!cmd || cmd === "--help" || cmd === "-h" || cmd === "help") {
+        process.stdout.write(HELP + "\n");
+        return 0;
+    }
+    const handler = handlers[cmd];
+    if (!handler) {
+        process.stderr.write(`Unknown command '${cmd}'.\n${HELP}\n`);
+        return 1;
+    }
+    const parsed = parseArgs(argv.slice(1));
+    return handler(parsed);
+}
+const isMain = (() => {
+    try {
+        return import.meta.url === `file://${process.argv[1]}`;
+    }
+    catch {
+        return false;
+    }
+})();
+if (isMain) {
+    main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+        process.stderr.write(`Unhandled error: ${err.message ?? err}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAmB,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BZ,CAAC,IAAI,EAAE,CAAC;AAIT,MAAM,QAAQ,GAA4B;IACxC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;CAC1B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAClC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;IACnB,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAEL,IAAI,MAAM,EAAE,CAAC;IACX,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC,GAAG,EAAE,EAAE;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAqB,GAAa,CAAC,OAAO,IAAI,GAAG,IAAI,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,23 @@
+import type { WorkflowRunResult } from "@trifoli/engine";
+export interface CliIo {
+    stdout: (line: string) => void;
+    stderr: (line: string) => void;
+}
+export declare const consoleIo: CliIo;
+export declare function readJsonFile<T = unknown>(path: string): Promise<T>;
+/**
+ * Resolve workflow inputs from `--input <json>` or `--input-file <path>`.
+ * Returns `{}` if neither flag is set. Errors if both are set.
+ */
+export declare function loadInputs(opts: {
+    input?: string;
+    inputFile?: string;
+}): Promise<Record<string, unknown>>;
+/**
+ * Read auth credentials from environment variables prefixed `TRIFOLI_AUTH_`.
+ * `TRIFOLI_AUTH_FOO=bar` becomes `{ foo: "bar" }`.
+ */
+export declare function readCredentialsFromEnv(env?: NodeJS.ProcessEnv): Record<string, string>;
+/** Format a WorkflowRunResult as pretty JSON. */
+export declare function formatResult(result: WorkflowRunResult): string;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,eAAO,MAAM,SAAS,EAAE,KAGvB,CAAC;AAEF,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAOxE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAuBnC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQnG;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAE9D"}

package/dist/io.js

@@ -0,0 +1,62 @@
+import { readFile } from "node:fs/promises";
+export const consoleIo = {
+    stdout: (s) => process.stdout.write(s + "\n"),
+    stderr: (s) => process.stderr.write(s + "\n"),
+};
+export async function readJsonFile(path) {
+    const raw = await readFile(path, "utf-8");
+    try {
+        return JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`Failed to parse JSON from ${path}: ${e.message}`);
+    }
+}
+/**
+ * Resolve workflow inputs from `--input <json>` or `--input-file <path>`.
+ * Returns `{}` if neither flag is set. Errors if both are set.
+ */
+export async function loadInputs(opts) {
+    if (opts.input && opts.inputFile) {
+        throw new Error("Pass either --input or --input-file, not both.");
+    }
+    if (opts.input) {
+        try {
+            const parsed = JSON.parse(opts.input);
+            if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+                throw new Error("--input JSON must be an object");
+            }
+            return parsed;
+        }
+        catch (e) {
+            throw new Error(`Failed to parse --input JSON: ${e.message}`);
+        }
+    }
+    if (opts.inputFile) {
+        const obj = await readJsonFile(opts.inputFile);
+        if (obj === null || typeof obj !== "object" || Array.isArray(obj)) {
+            throw new Error(`--input-file must contain a JSON object: ${opts.inputFile}`);
+        }
+        return obj;
+    }
+    return {};
+}
+/**
+ * Read auth credentials from environment variables prefixed `TRIFOLI_AUTH_`.
+ * `TRIFOLI_AUTH_FOO=bar` becomes `{ foo: "bar" }`.
+ */
+export function readCredentialsFromEnv(env = process.env) {
+    const out = {};
+    for (const [k, v] of Object.entries(env)) {
+        if (!k.startsWith("TRIFOLI_AUTH_") || v === undefined)
+            continue;
+        const name = k.slice("TRIFOLI_AUTH_".length).toLowerCase();
+        out[name] = v;
+    }
+    return out;
+}
+/** Format a WorkflowRunResult as pretty JSON. */
+export function formatResult(result) {
+    return JSON.stringify(result, null, 2);
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAS5C,MAAM,CAAC,MAAM,SAAS,GAAU;IAC9B,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;CAC9C,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAc,IAAY;IAC1D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAGhC;IACC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3E,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,MAAiC,CAAC;QAC3C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,iCAAkC,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,MAAM,YAAY,CAAU,IAAI,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,GAA8B,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACzE,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,SAAS;YAAE,SAAS;QAChE,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3D,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,MAAyB;IACpD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/schema-resolver.d.ts

@@ -0,0 +1,23 @@
+export declare class SchemaNotFoundError extends Error {
+    constructor();
+}
+export interface ResolveSchemaOptions {
+    /** Explicit `--schema <path>` override. Takes precedence. */
+    explicit?: string;
+    /** Directory to start the upward walk from (defaults to process.cwd()). */
+    cwd?: string;
+    /** Schema version to look for (defaults to 0.1.0). */
+    version?: string;
+}
+/**
+ * Resolve the path to a Trifoli JSON Schema.
+ *
+ * Order of precedence:
+ *   1. `opts.explicit` (the `--schema` flag)
+ *   2. `schema/trifoli-<version>.json` walking up from `cwd`
+ *   3. The schema bundled inside `@trifoli/engine`
+ *
+ * Throws `SchemaNotFoundError` if none of these resolve.
+ */
+export declare function resolveSchemaPath(opts?: ResolveSchemaOptions): Promise<string>;
+//# sourceMappingURL=schema-resolver.d.ts.map

package/dist/schema-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-resolver.d.ts","sourceRoot":"","sources":["../src/schema-resolver.ts"],"names":[],"mappings":"AAKA,qBAAa,mBAAoB,SAAQ,KAAK;;CAO7C;AAuBD,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAexF"}

package/dist/schema-resolver.js

@@ -0,0 +1,57 @@
+import { access } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { getBundledSchemaPath } from "@trifoli/engine";
+export class SchemaNotFoundError extends Error {
+    constructor() {
+        super("Could not locate the Trifoli JSON Schema. Pass --schema <path>, run from a repo containing schema/trifoli-*.json, or build @trifoli/engine to populate the bundled copy.");
+        this.name = "SchemaNotFoundError";
+    }
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findUpwards(startDir, version) {
+    let dir = resolve(startDir);
+    for (let i = 0; i < 32; i++) {
+        const candidate = join(dir, "schema", `trifoli-${version}.json`);
+        if (await exists(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Resolve the path to a Trifoli JSON Schema.
+ *
+ * Order of precedence:
+ *   1. `opts.explicit` (the `--schema` flag)
+ *   2. `schema/trifoli-<version>.json` walking up from `cwd`
+ *   3. The schema bundled inside `@trifoli/engine`
+ *
+ * Throws `SchemaNotFoundError` if none of these resolve.
+ */
+export async function resolveSchemaPath(opts = {}) {
+    const version = opts.version ?? "0.1.0";
+    if (opts.explicit) {
+        if (await exists(opts.explicit))
+            return opts.explicit;
+        throw new Error(`Schema file not found: ${opts.explicit}`);
+    }
+    const walked = await findUpwards(opts.cwd ?? process.cwd(), version);
+    if (walked)
+        return walked;
+    const bundled = getBundledSchemaPath(version);
+    if (await exists(bundled))
+        return bundled;
+    throw new SchemaNotFoundError();
+}
+//# sourceMappingURL=schema-resolver.js.map

package/dist/schema-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-resolver.js","sourceRoot":"","sources":["../src/schema-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C;QACE,KAAK,CACH,0KAA0K,CAC3K,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAe;IAC1D,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,WAAW,OAAO,OAAO,CAAC,CAAC;QACjE,IAAI,MAAM,MAAM,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAChC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAWD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA6B,EAAE;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC;IAExC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,MAAM,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAE1C,MAAM,IAAI,mBAAmB,EAAE,CAAC;AAClC,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@trifoli/cli",
+  "version": "0.1.0",
+  "description": "Command-line tools for the Trifoli Protocol — validate, run, and serve workflows.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "trifoli": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@trifoli/engine": "0.1.0",
+    "@trifoli/mcp-adapter": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.4.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "pretest": "pnpm --filter @trifoli/engine --filter @trifoli/mcp-adapter run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo 'lint not configured yet'"
+  }
+}