@method-ai-hq/sdk 0.0.0-stage → 0.14.2

package/dist/packages/workflow-language/src/validate.js

@@ -0,0 +1,77 @@
+import { stringify } from "yaml";
+import { validateMethod } from '@withmethod/runtime/document.js';
+export { parseDocumentValue, shapeErrors, MethodValidationError } from '@withmethod/runtime/document.js';
+export { outputSchema } from '@withmethod/runtime/semantics.js';
+import { effectiveOutputs } from "./schema.js";
+export function serializeWorkflow(value) { return stringify(value, { lineWidth: 0 }); }
+export function shapeObject(shape) { return typeof shape === "string" ? { type: shape } : shape; }
+export function validateShape(shape, label) {
+    const s = shapeObject(shape);
+    if (s.type === "record" && !s.fields)
+        throw Error(`${label}: record needs fields.`);
+    if (s.type === "list" && (!!s.fields === !!s.items))
+        throw Error(`${label}: list needs either fields or items.`);
+    if (s.fields && !["record", "list"].includes(s.type))
+        throw Error(`${label}: fields require a record or list.`);
+    if (s.items && s.type !== "list")
+        throw Error(`${label}: items require a list.`);
+    if (s.format && s.type !== "file")
+        throw Error(`${label}: format describes a file.`);
+    Object.entries(s.fields ?? {}).forEach(([key, child]) => validateShape(child, `${label}.${key}`));
+    if (s.items)
+        validateShape(s.items, `${label}.items`);
+}
+export function references(step) { return [...Object.values(step.in ?? {}), ...Object.values(step.each ?? {}), ...(step.when ? [step.when] : []), ...Object.values(step.effects ?? {}).flatMap(effect => Object.values(effect.in ?? {}))]; }
+export function producers(workflow) {
+    const result = new Map();
+    for (const [id, step] of Object.entries(workflow.steps))
+        for (const name of Object.keys(effectiveOutputs(step))) {
+            if (["inputs", "state", "environment", "run"].includes(name) || result.has(name))
+                throw Error(`Output ${name} must have one unique name.`);
+            result.set(name, id);
+        }
+    return result;
+}
+export function referenceShape(workflow, reference) {
+    const parts = reference.split("."), root = parts.shift();
+    let shape;
+    if (root === "environment") {
+        if (parts.length !== 1 || !workflow.environment?.[parts[0]])
+            throw Error(`Unknown connection ${reference}.`);
+        return undefined;
+    }
+    if (root === "run") {
+        if (parts.join(".") !== "started_at")
+            throw Error(`Unknown run value ${reference}.`);
+        return "text";
+    }
+    if (root === "inputs" || root === "state")
+        shape = workflow[root]?.[parts.shift()];
+    else {
+        const producer = producers(workflow).get(root), step = producer ? workflow.steps[producer] : undefined;
+        shape = step ? effectiveOutputs(step)[root] : undefined;
+        if (shape && step?.each)
+            shape = { type: "list", items: shape };
+    }
+    if (!shape)
+        throw Error(`Unknown data ${reference}.`);
+    for (const part of parts) {
+        const s = shapeObject(shape);
+        if (s.type === "list" && /^(0|[1-9][0-9]*)$/.test(part))
+            shape = s.fields ? { type: "record", fields: s.fields } : s.items;
+        else if (s.type === "record")
+            shape = s.fields?.[part];
+        else
+            shape = undefined;
+        if (!shape)
+            throw Error(`Unknown field ${reference}.`);
+    }
+    return shape;
+}
+export function stepDependencies(workflow, id) {
+    const step = workflow.steps[id], outputProducers = producers(workflow);
+    return [...new Set([...(typeof step.after === "string" ? [step.after] : step.after ?? []), ...references(step).flatMap(ref => { const producer = outputProducers.get(ref.split(".")[0]); return producer ? [producer] : []; })])];
+}
+export function loadWorkflow(value) {
+    return validateMethod(value).method;
+}

package/package.json

@@ -1,6 +1,232 @@
 {
   "name": "@method-ai-hq/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.14.2",
+  "description": "Build and run reusable .method files with checked steps and saved results.",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/packages/sdk/src/index.js",
+  "types": "dist/packages/sdk/src/index.d.ts",
+  "bin": {
+    "method": "dist/packages/sdk/src/method.js",
+    "method-bridge": "dist/packages/sdk/src/bridge.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/method-ai-hq/method-sdk.git",
+    "directory": "packages/sdk"
+  },
+  "keywords": [
+    "workflow",
+    "agents",
+    "ai-agents",
+    "verification",
+    "mcp"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && chmod +x dist/packages/sdk/src/bridge.js dist/packages/sdk/src/method.js && node scripts/copy-examples.mjs",
+    "prepack": "npm --prefix ../.. run build"
+  },
+  "dependencies": {
+    "@withmethod/runtime": "https://codeload.github.com/method-ai-hq/method-spec/tar.gz/c45c5ba1a3432b8d4e90ff07a7457eef5ea0f371",
+    "fflate": "^0.8.3",
+    "yaml": "^2.9.0",
+    "zod": "^3.25.76"
+  },
+  "homepage": "https://docs.withmethod.ai/sdk/overview",
+  "exports": {
+    ".": {
+      "types": "./dist/packages/sdk/src/index.d.ts",
+      "import": "./dist/packages/sdk/src/index.js",
+      "default": "./dist/packages/sdk/src/index.js"
+    },
+    "./schema": {
+      "types": "./dist/packages/workflow-language/src/schema.d.ts",
+      "import": "./dist/packages/workflow-language/src/schema.js",
+      "default": "./dist/packages/workflow-language/src/schema.js"
+    },
+    "./validate": {
+      "types": "./dist/packages/workflow-language/src/validate.d.ts",
+      "import": "./dist/packages/workflow-language/src/validate.js",
+      "default": "./dist/packages/workflow-language/src/validate.js"
+    },
+    "./execution": {
+      "types": "./dist/packages/workflow-language/src/execution.d.ts",
+      "import": "./dist/packages/workflow-language/src/execution.js",
+      "default": "./dist/packages/workflow-language/src/execution.js"
+    },
+    "./inspection": {
+      "types": "./dist/packages/workflow-language/src/inspection.d.ts",
+      "import": "./dist/packages/workflow-language/src/inspection.js",
+      "default": "./dist/packages/workflow-language/src/inspection.js"
+    },
+    "./result-files": {
+      "types": "./dist/packages/workflow-language/src/result-files.d.ts",
+      "import": "./dist/packages/workflow-language/src/result-files.js",
+      "default": "./dist/packages/workflow-language/src/result-files.js"
+    },
+    "./identity": {
+      "types": "./dist/packages/contracts/src/identity.d.ts",
+      "import": "./dist/packages/contracts/src/identity.js",
+      "default": "./dist/packages/contracts/src/identity.js"
+    },
+    "./method-package": {
+      "types": "./dist/packages/contracts/src/method-package.d.ts",
+      "import": "./dist/packages/contracts/src/method-package.js",
+      "default": "./dist/packages/contracts/src/method-package.js"
+    },
+    "./conversion": {
+      "types": "./dist/packages/method-document/src/conversion-report.d.ts",
+      "import": "./dist/packages/method-document/src/conversion-report.js",
+      "default": "./dist/packages/method-document/src/conversion-report.js"
+    },
+    "./method-client": {
+      "types": "./dist/packages/sdk/src/method-client.d.ts",
+      "import": "./dist/packages/sdk/src/method-client.js",
+      "default": "./dist/packages/sdk/src/method-client.js"
+    },
+    "./method-sync": {
+      "types": "./dist/packages/sdk/src/method-sync.d.ts",
+      "import": "./dist/packages/sdk/src/method-sync.js",
+      "default": "./dist/packages/sdk/src/method-sync.js"
+    },
+    "./method": {
+      "types": "./dist/packages/sdk/src/method.d.ts",
+      "import": "./dist/packages/sdk/src/method.js",
+      "default": "./dist/packages/sdk/src/method.js"
+    },
+    "./files": {
+      "types": "./dist/packages/sdk/src/files.d.ts",
+      "import": "./dist/packages/sdk/src/files.js",
+      "default": "./dist/packages/sdk/src/files.js"
+    },
+    "./inspect": {
+      "types": "./dist/packages/sdk/src/inspect.d.ts",
+      "import": "./dist/packages/sdk/src/inspect.js",
+      "default": "./dist/packages/sdk/src/inspect.js"
+    },
+    "./process": {
+      "types": "./dist/packages/sdk/src/process.d.ts",
+      "import": "./dist/packages/sdk/src/process.js",
+      "default": "./dist/packages/sdk/src/process.js"
+    },
+    "./executable": {
+      "types": "./dist/packages/sdk/src/executable.d.ts",
+      "import": "./dist/packages/sdk/src/executable.js",
+      "default": "./dist/packages/sdk/src/executable.js"
+    },
+    "./authoring": {
+      "types": "./dist/packages/sdk/src/authoring.d.ts",
+      "import": "./dist/packages/sdk/src/authoring.js",
+      "default": "./dist/packages/sdk/src/authoring.js"
+    },
+    "./method-help": {
+      "types": "./dist/packages/sdk/src/method-help.d.ts",
+      "import": "./dist/packages/sdk/src/method-help.js",
+      "default": "./dist/packages/sdk/src/method-help.js"
+    },
+    "./current-runtime": {
+      "types": "./dist/packages/sdk/src/current-runtime.d.ts",
+      "import": "./dist/packages/sdk/src/current-runtime.js",
+      "default": "./dist/packages/sdk/src/current-runtime.js"
+    },
+    "./local-setup": {
+      "types": "./dist/packages/sdk/src/local-setup.d.ts",
+      "import": "./dist/packages/sdk/src/local-setup.js",
+      "default": "./dist/packages/sdk/src/local-setup.js"
+    },
+    "./current-inspection": {
+      "types": "./dist/packages/sdk/src/current-inspection.d.ts",
+      "import": "./dist/packages/sdk/src/current-inspection.js",
+      "default": "./dist/packages/sdk/src/current-inspection.js"
+    },
+    "./method-files": {
+      "types": "./dist/packages/sdk/src/method-files.d.ts",
+      "import": "./dist/packages/sdk/src/method-files.js",
+      "default": "./dist/packages/sdk/src/method-files.js"
+    },
+    "./versions": {
+      "types": "./dist/packages/sdk/src/versions.d.ts",
+      "import": "./dist/packages/sdk/src/versions.js",
+      "default": "./dist/packages/sdk/src/versions.js"
+    },
+    "./outbox": {
+      "types": "./dist/packages/sdk/src/outbox.d.ts",
+      "import": "./dist/packages/sdk/src/outbox.js",
+      "default": "./dist/packages/sdk/src/outbox.js"
+    },
+    "./computer-settings": {
+      "types": "./dist/packages/sdk/src/computer-settings.d.ts",
+      "import": "./dist/packages/sdk/src/computer-settings.js",
+      "default": "./dist/packages/sdk/src/computer-settings.js"
+    },
+    "./bindings": {
+      "types": "./dist/packages/sdk/src/bindings.d.ts",
+      "import": "./dist/packages/sdk/src/bindings.js",
+      "default": "./dist/packages/sdk/src/bindings.js"
+    },
+    "./capabilities": {
+      "types": "./dist/packages/sdk/src/capabilities.d.ts",
+      "import": "./dist/packages/sdk/src/capabilities.js",
+      "default": "./dist/packages/sdk/src/capabilities.js"
+    },
+    "./prepare": {
+      "types": "./dist/packages/sdk/src/prepare.d.ts",
+      "import": "./dist/packages/sdk/src/prepare.js",
+      "default": "./dist/packages/sdk/src/prepare.js"
+    },
+    "./run-worker": {
+      "types": "./dist/packages/sdk/src/run-worker.d.ts",
+      "import": "./dist/packages/sdk/src/run-worker.js",
+      "default": "./dist/packages/sdk/src/run-worker.js"
+    },
+    "./local-cli": {
+      "types": "./dist/packages/sdk/src/local-cli.d.ts",
+      "import": "./dist/packages/sdk/src/local-cli.js",
+      "default": "./dist/packages/sdk/src/local-cli.js"
+    },
+    "./doctor": {
+      "types": "./dist/packages/sdk/src/doctor.d.ts",
+      "import": "./dist/packages/sdk/src/doctor.js",
+      "default": "./dist/packages/sdk/src/doctor.js"
+    },
+    "./run-saved": {
+      "types": "./dist/packages/sdk/src/run-saved.d.ts",
+      "import": "./dist/packages/sdk/src/run-saved.js",
+      "default": "./dist/packages/sdk/src/run-saved.js"
+    },
+    "./sdk-result-files": {
+      "types": "./dist/packages/sdk/src/result-files.d.ts",
+      "import": "./dist/packages/sdk/src/result-files.js",
+      "default": "./dist/packages/sdk/src/result-files.js"
+    },
+    "./package.json": "./package.json",
+    "./authoring-prompt": {
+      "types": "./dist/packages/sdk/src/authoring-prompt.d.ts",
+      "import": "./dist/packages/sdk/src/authoring-prompt.js",
+      "default": "./dist/packages/sdk/src/authoring-prompt.js"
+    },
+    "./progress": {
+      "types": "./dist/packages/sdk/src/progress.d.ts",
+      "import": "./dist/packages/sdk/src/progress.js",
+      "default": "./dist/packages/sdk/src/progress.js"
+    },
+    "./run-method": {
+      "types": "./dist/packages/sdk/src/run-method.d.ts",
+      "import": "./dist/packages/sdk/src/run-method.js",
+      "default": "./dist/packages/sdk/src/run-method.js"
+    },
+    "./authoring-example": {
+      "types": "./dist/packages/sdk/src/authoring-example.d.ts",
+      "import": "./dist/packages/sdk/src/authoring-example.js",
+      "default": "./dist/packages/sdk/src/authoring-example.js"
+    }
+  }
+}