@nodetool-ai/websocket 0.7.0-rc.22 → 0.8.1

package/dist/sdk/sdk-preflight-service.js

@@ -0,0 +1,104 @@
+import { runSdkV1Preflight } from "./sdk-preflight-orchestrator.js";
+import { createNodeToolSdkV1RequirementResolver } from "./sdk-preflight-requirement-resolver.js";
+import { createNodeToolSdkV1RuntimeProbe } from "./sdk-runtime-requirement-probe.js";
+import { createNodeToolSdkV1ModelProbe } from "./sdk-model-requirement-probe.js";
+import { createNodeToolSdkV1NodePackageProbe } from "./sdk-node-package-requirement-probe.js";
+import { createNodeToolSdkV1ExecutionReadinessProbe } from "./sdk-execution-readiness-probe.js";
+import { createNodeToolSdkV1WorkflowSource } from "./sdk-preflight-workflow-source.js";
+import { getExistingDownloadManager } from "@nodetool-ai/huggingface";
+import { createNodeToolSdkV1HuggingFaceDownloadStateReader } from "./sdk-huggingface-download-state.js";
+import { isFunctionValue } from "../lib/wire-values.js";
+/**
+ * Binds NodeTool's workflow authorization and requirement lookup to the same
+ * authenticated principal. This remains transport-independent and unrouted.
+ */
+export function createNodeToolSdkV1PreflightService(options) {
+    const listRegistryPackageIds = () => isFunctionValue(options.registry.listNodePackageIds)
+        ? options.registry.listNodePackageIds()
+        : [];
+    const resolveRegistryPackageId = (nodeType) => isFunctionValue(options.registry.getNodePackageId)
+        ? (options.registry.getNodePackageId(nodeType) ?? null)
+        : null;
+    const readHuggingFaceDownloadState = createNodeToolSdkV1HuggingFaceDownloadStateReader({
+        providerIds: ["huggingface"],
+        getDownloadManager: (userId) => getExistingDownloadManager(userId)
+    });
+    const workflowSource = options.workflowSource ??
+        createNodeToolSdkV1WorkflowSource({ registry: options.registry });
+    const createRequirementResolver = options.createRequirementResolver ??
+        ((principal) => {
+            const configuredProbes = options.requirementResolverOptions?.probes;
+            const modelProbe = configuredProbes?.model ??
+                createNodeToolSdkV1ModelProbe({
+                    userId: principal.userId,
+                    listProviderIds: options.requirementResolverOptions?.listProviderIds,
+                    isProviderReady: options.requirementResolverOptions?.isProviderReady,
+                    listModelIds: options.listCachedModelIds,
+                    getModelDownloadStatus: options.getModelDownloadStatus ?? readHuggingFaceDownloadState
+                });
+            const nodePackageProbe = configuredProbes?.node_pack ??
+                createNodeToolSdkV1NodePackageProbe({
+                    userId: principal.userId,
+                    listInstalledPackageIds: options.listInstalledNodePackageIds ?? listRegistryPackageIds
+                });
+            const probes = { ...configuredProbes };
+            if (modelProbe) {
+                probes.model = modelProbe;
+            }
+            if (nodePackageProbe) {
+                probes.node_pack = nodePackageProbe;
+            }
+            if (options.getPythonBridgeReady) {
+                probes.runtime =
+                    configuredProbes?.runtime ??
+                        createNodeToolSdkV1RuntimeProbe({
+                            getPythonBridgeReady: options.getPythonBridgeReady
+                        });
+            }
+            return createNodeToolSdkV1RequirementResolver({
+                ...options.requirementResolverOptions,
+                probes,
+                userId: principal.userId
+            });
+        });
+    return {
+        async preflight(input) {
+            const resolveRequirement = input.request.level === "static"
+                ? undefined
+                : createRequirementResolver(input.principal);
+            const executionContext = input.request.level === "execution"
+                ? {
+                    request: {
+                        ...input.request,
+                        level: "execution"
+                    },
+                    principal: input.principal
+                }
+                : null;
+            const probeExecutionReadiness = executionContext && options.probeExecutionReadiness
+                ? () => options.probeExecutionReadiness(executionContext)
+                : executionContext && options.getExecutionCapacitySnapshot
+                    ? createNodeToolSdkV1ExecutionReadinessProbe({
+                        getCapacitySnapshot: () => options.getExecutionCapacitySnapshot(executionContext),
+                        getTargetReadiness: options.getExecutionTargetReadiness
+                            ? () => options.getExecutionTargetReadiness(executionContext)
+                            : undefined
+                    })
+                    : undefined;
+            return runSdkV1Preflight({
+                request: input.request,
+                principal: input.principal,
+                workflowSource,
+                registry: options.registry,
+                resolveRequirement,
+                probeExecutionReadiness,
+                getModelPrice: options.getModelPrice,
+                quantities: options.quantities,
+                approvalThreshold: options.approvalThreshold,
+                resolveNodePackageId: options.resolveNodePackageId ??
+                    (({ nodeType }) => resolveRegistryPackageId(nodeType))
+            });
+        }
+    };
+}
+//# sourceMappingURL=sdk-preflight-service.js.map

package/dist/sdk/sdk-preflight-service.js.map

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

package/dist/sdk/sdk-preflight-workflow-source.d.ts

@@ -0,0 +1,18 @@
+import { Workflow } from "@nodetool-ai/models";
+import type { NodeRegistry } from "@nodetool-ai/node-sdk";
+import type { SdkV1AuthorizedWorkflowSource } from "./sdk-preflight-orchestrator.js";
+interface CreateNodeToolSdkV1WorkflowSourceOptions {
+    registry: NodeRegistry;
+    /**
+     * Injectable for focused tests. Production uses Workflow.find, which
+     * enforces owner/public/collaborator read access.
+     */
+    findAuthorizedWorkflow?: (userId: string, workflowId: string) => Promise<Workflow | null>;
+}
+/**
+ * Adapts NodeTool's existing authorized workflow read and graph-derived
+ * interface implementation to the transport-neutral preflight boundary.
+ */
+export declare function createNodeToolSdkV1WorkflowSource(options: CreateNodeToolSdkV1WorkflowSourceOptions): SdkV1AuthorizedWorkflowSource;
+export {};
+//# sourceMappingURL=sdk-preflight-workflow-source.d.ts.map

package/dist/sdk/sdk-preflight-workflow-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-preflight-workflow-source.d.ts","sourceRoot":"","sources":["../../src/sdk/sdk-preflight-workflow-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAOrF,UAAU,wCAAwC;IAChD,QAAQ,EAAE,YAAY,CAAC;IACvB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,CACvB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,wCAAwC,GAChD,6BAA6B,CAqC/B"}

package/dist/sdk/sdk-preflight-workflow-source.js

@@ -0,0 +1,42 @@
+import { Workflow } from "@nodetool-ai/models";
+import { deriveWorkflowInterfaceSourceV1 } from "../workflow-interface-service.js";
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/**
+ * Adapts NodeTool's existing authorized workflow read and graph-derived
+ * interface implementation to the transport-neutral preflight boundary.
+ */
+export function createNodeToolSdkV1WorkflowSource(options) {
+    const findAuthorizedWorkflow = options.findAuthorizedWorkflow ??
+        ((userId, workflowId) => Workflow.find(userId, workflowId));
+    return {
+        async loadAuthorizedWorkflow(input) {
+            const workflow = await findAuthorizedWorkflow(input.principal.userId, input.workflowId);
+            if (!workflow)
+                return null;
+            if (input.workspaceId !== null &&
+                workflow.workspace_id !== input.workspaceId) {
+                return null;
+            }
+            const source = deriveWorkflowInterfaceSourceV1({
+                workflow,
+                registry: options.registry
+            });
+            return {
+                workflowInterface: source.workflowInterface,
+                graph: {
+                    nodes: (source.graph.nodes ?? []).map((node) => ({
+                        id: node.id,
+                        type: node.type,
+                        properties: isRecord(node.properties) ? node.properties : undefined,
+                        data: isRecord(node.data) ? node.data : undefined,
+                        dynamic_outputs: node.dynamic_outputs
+                    })),
+                    edges: source.graph.edges ?? []
+                }
+            };
+        }
+    };
+}
+//# sourceMappingURL=sdk-preflight-workflow-source.js.map

package/dist/sdk/sdk-preflight-workflow-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-preflight-workflow-source.js","sourceRoot":"","sources":["../../src/sdk/sdk-preflight-workflow-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AAEnF,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAcD;;;GAGG;AACH,MAAM,UAAU,iCAAiC,CAC/C,OAAiD;IAEjD,MAAM,sBAAsB,GAC1B,OAAO,CAAC,sBAAsB;QAC9B,CAAC,CAAC,MAAc,EAAE,UAAkB,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAE9E,OAAO;QACL,KAAK,CAAC,sBAAsB,CAAC,KAAK;YAChC,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAC3C,KAAK,CAAC,SAAS,CAAC,MAAM,EACtB,KAAK,CAAC,UAAU,CACjB,CAAC;YACF,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAC3B,IACE,KAAK,CAAC,WAAW,KAAK,IAAI;gBAC1B,QAAQ,CAAC,YAAY,KAAK,KAAK,CAAC,WAAW,EAC3C,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,MAAM,GAAG,+BAA+B,CAAC;gBAC7C,QAAQ;gBACR,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC,CAAC;YACH,OAAO;gBACL,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;gBAC3C,KAAK,EAAE;oBACL,KAAK,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBAC/C,EAAE,EAAE,IAAI,CAAC,EAAE;wBACX,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;wBACnE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;wBACjD,eAAe,EAAE,IAAI,CAAC,eAAe;qBACtC,CAAC,CAAC;oBACH,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE;iBAChC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sdk/sdk-route-policy.d.ts

@@ -0,0 +1,3 @@
+export declare function isSdkV1DiscoveryRequest(pathname: string, method: string): boolean;
+export declare function isSdkV1AuthenticationRequired(environment?: NodeJS.ProcessEnv, serverAuthenticationRequired?: boolean): boolean;
+//# sourceMappingURL=sdk-route-policy.d.ts.map

package/dist/sdk/sdk-route-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-route-policy.d.ts","sourceRoot":"","sources":["../../src/sdk/sdk-route-policy.ts"],"names":[],"mappings":"AAEA,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAcT;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,GAAE,MAAM,CAAC,UAAwB,EAC5C,4BAA4B,UAAQ,GACnC,OAAO,CAIT"}

package/dist/sdk/sdk-route-policy.js

@@ -0,0 +1,18 @@
+import { isSdkV1AuthenticationEnabled } from "./sdk-feature-flags.js";
+export function isSdkV1DiscoveryRequest(pathname, method) {
+    if (method === "POST" && pathname === "/api/sdk/v1/workflow-interfaces") {
+        return true;
+    }
+    if (method !== "GET") {
+        return false;
+    }
+    return (pathname === "/api/sdk/v1/capabilities" ||
+        pathname === "/api/sdk/v1/models" ||
+        pathname === "/api/sdk/v1/node-types" ||
+        pathname === "/api/sdk/v1/workflows" ||
+        /^\/api\/workflows\/[^/]+\/interface$/.test(pathname));
+}
+export function isSdkV1AuthenticationRequired(environment = process.env, serverAuthenticationRequired = false) {
+    return (serverAuthenticationRequired || isSdkV1AuthenticationEnabled(environment));
+}
+//# sourceMappingURL=sdk-route-policy.js.map

package/dist/sdk/sdk-route-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-route-policy.js","sourceRoot":"","sources":["../../src/sdk/sdk-route-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAEtE,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,MAAc;IAEd,IAAI,MAAM,KAAK,MAAM,IAAI,QAAQ,KAAK,iCAAiC,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CACL,QAAQ,KAAK,0BAA0B;QACvC,QAAQ,KAAK,oBAAoB;QACjC,QAAQ,KAAK,wBAAwB;QACrC,QAAQ,KAAK,uBAAuB;QACpC,sCAAsC,CAAC,IAAI,CAAC,QAAQ,CAAC,CACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,WAAW,GAAsB,OAAO,CAAC,GAAG,EAC5C,4BAA4B,GAAG,KAAK;IAEpC,OAAO,CACL,4BAA4B,IAAI,4BAA4B,CAAC,WAAW,CAAC,CAC1E,CAAC;AACJ,CAAC"}

package/dist/sdk/sdk-runtime-capabilities-service.d.ts

@@ -0,0 +1,60 @@
+import type { NodeRegistry } from "@nodetool-ai/node-sdk";
+import { type SdkV1CapabilityLimits, type SdkV1ProfileStatus, type SdkV1PythonBridgeStatus } from "./sdk-capabilities-service.js";
+type Resolvable<T> = T | (() => T);
+interface CreateNodeToolSdkV1CapabilitiesProviderOptions {
+    nodetoolVersion: string;
+    registry: Pick<NodeRegistry, "revision">;
+    pythonBridge: Resolvable<SdkV1PythonBridgeStatus>;
+    profiles: Resolvable<Readonly<Record<string, SdkV1ProfileStatus>>>;
+    authModes: Resolvable<ReadonlyArray<"trusted_local" | "bearer">>;
+    assetUriSchemes: Resolvable<readonly string[]>;
+    /**
+     * Every advertised limit must already be enforced by the current transport
+     * or lifecycle service. The upload limit may be omitted because NodeTool's
+     * storage layer exposes its authoritative configured value.
+     */
+    limits: Omit<SdkV1CapabilityLimits, "maxUploadBytes"> & {
+        maxUploadBytes?: number;
+    };
+    now?: () => Date;
+    getConfiguredMaxUploadBytes?: () => number;
+}
+/**
+ * Composes the public capability document from live server state.
+ *
+ * The returned function reads dynamic values on every invocation, so registry
+ * reloads, Python bridge transitions, and profile changes do not leave clients
+ * with a snapshot captured at server startup. This remains transport-neutral.
+ */
+export declare function createNodeToolSdkV1CapabilitiesProvider(options: CreateNodeToolSdkV1CapabilitiesProviderOptions): () => {
+    protocol_version: "1";
+    nodetool_version: string;
+    server_time: string;
+    supported_encodings: ("json-text" | "messagepack")[];
+    default_encoding: "json-text" | "messagepack";
+    profiles: Record<string, "available" | "disabled" | "unavailable">;
+    registry_revision: number;
+    python_bridge: "disabled" | "ready" | "starting" | "unavailable";
+    auth_modes: ("bearer" | "trusted_local")[];
+    asset_uri_schemes: string[];
+    execution_options?: {
+        persistence: ("job" | "session")[];
+        event_detail: ("full" | "outputs" | "terminal")[];
+        asset_persistence: ("auto" | "temporary")[];
+        defaults: {
+            persistence: "job";
+            event_detail: "full";
+            asset_persistence: "temporary";
+        };
+    } | undefined;
+    limits: {
+        max_rpc_batch: number;
+        max_inline_bytes: number;
+        max_upload_bytes: number;
+        max_queued_jobs: number;
+        max_job_event_replay: number;
+        request_timeout_seconds: number;
+    };
+};
+export {};
+//# sourceMappingURL=sdk-runtime-capabilities-service.d.ts.map

package/dist/sdk/sdk-runtime-capabilities-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-runtime-capabilities-service.d.ts","sourceRoot":"","sources":["../../src/sdk/sdk-runtime-capabilities-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,+BAA+B,CAAC;AAGvC,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAEnC,UAAU,8CAA8C;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACzC,YAAY,EAAE,UAAU,CAAC,uBAAuB,CAAC,CAAC;IAClD,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACnE,SAAS,EAAE,UAAU,CAAC,aAAa,CAAC,eAAe,GAAG,QAAQ,CAAC,CAAC,CAAC;IACjE,eAAe,EAAE,UAAU,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC/C;;;;OAIG;IACH,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,GAAG;QACtD,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,2BAA2B,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5C;AAMD;;;;;;GAMG;AACH,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBxD"}

package/dist/sdk/sdk-runtime-capabilities-service.js

@@ -0,0 +1,30 @@
+import { getMaxUploadBytes } from "@nodetool-ai/storage";
+import { buildSdkV1Capabilities } from "./sdk-capabilities-service.js";
+import { isFunctionValue } from "../lib/wire-values.js";
+function resolve(value) {
+    return isFunctionValue(value) ? value() : value;
+}
+/**
+ * Composes the public capability document from live server state.
+ *
+ * The returned function reads dynamic values on every invocation, so registry
+ * reloads, Python bridge transitions, and profile changes do not leave clients
+ * with a snapshot captured at server startup. This remains transport-neutral.
+ */
+export function createNodeToolSdkV1CapabilitiesProvider(options) {
+    const getConfiguredMaxUploadBytes = options.getConfiguredMaxUploadBytes ?? getMaxUploadBytes;
+    return () => buildSdkV1Capabilities({
+        nodetoolVersion: options.nodetoolVersion,
+        registryRevision: options.registry.revision,
+        pythonBridge: resolve(options.pythonBridge),
+        profiles: resolve(options.profiles),
+        authModes: resolve(options.authModes),
+        assetUriSchemes: resolve(options.assetUriSchemes),
+        limits: {
+            ...options.limits,
+            maxUploadBytes: options.limits.maxUploadBytes ?? getConfiguredMaxUploadBytes()
+        },
+        now: options.now?.()
+    });
+}
+//# sourceMappingURL=sdk-runtime-capabilities-service.js.map

package/dist/sdk/sdk-runtime-capabilities-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-runtime-capabilities-service.js","sourceRoot":"","sources":["../../src/sdk/sdk-runtime-capabilities-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EACL,sBAAsB,EAIvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAuBxD,SAAS,OAAO,CAAI,KAAoB;IACtC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uCAAuC,CACrD,OAAuD;IAEvD,MAAM,2BAA2B,GAC/B,OAAO,CAAC,2BAA2B,IAAI,iBAAiB,CAAC;IAE3D,OAAO,GAAG,EAAE,CACV,sBAAsB,CAAC;QACrB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,gBAAgB,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ;QAC3C,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;QAC3C,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;QACnC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;QACrC,eAAe,EAAE,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC;QACjD,MAAM,EAAE;YACN,GAAG,OAAO,CAAC,MAAM;YACjB,cAAc,EACZ,OAAO,CAAC,MAAM,CAAC,cAAc,IAAI,2BAA2B,EAAE;SACjE;QACD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE;KACrB,CAAC,CAAC;AACP,CAAC"}

package/dist/sdk/sdk-runtime-requirement-probe.d.ts

@@ -0,0 +1,13 @@
+import type { SdkV1Requirement } from "@nodetool-ai/protocol/api-schemas/sdk-lifecycle-v1.js";
+import type { SdkV1RequirementAvailability } from "./sdk-static-preflight-service.js";
+interface CreateNodeToolSdkV1RuntimeProbeOptions {
+    getPythonBridgeReady: () => boolean;
+    hasExecutable?: (command: string) => Promise<boolean>;
+}
+/**
+ * Checks only locally authoritative runtime state. It never installs software,
+ * starts a model download, provisions a worker, or calls an inference API.
+ */
+export declare function createNodeToolSdkV1RuntimeProbe(options: CreateNodeToolSdkV1RuntimeProbeOptions): (requirement: Readonly<SdkV1Requirement>) => Promise<SdkV1RequirementAvailability>;
+export {};
+//# sourceMappingURL=sdk-runtime-requirement-probe.d.ts.map

package/dist/sdk/sdk-runtime-requirement-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-runtime-requirement-probe.d.ts","sourceRoot":"","sources":["../../src/sdk/sdk-runtime-requirement-probe.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uDAAuD,CAAC;AAC9F,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAStF,UAAU,sCAAsC;IAC9C,oBAAoB,EAAE,MAAM,OAAO,CAAC;IACpC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAcD;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,sCAAsC,GAC9C,CACD,WAAW,EAAE,QAAQ,CAAC,gBAAgB,CAAC,KACpC,OAAO,CAAC,4BAA4B,CAAC,CAgCzC"}

package/dist/sdk/sdk-runtime-requirement-probe.js

@@ -0,0 +1,55 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const NODE_RUNTIMES = new Set(["node", "nodejs", "javascript", "typescript"]);
+const EXECUTABLE_RUNTIMES = new Map([
+    ["ffmpeg", "ffmpeg"],
+    ["ffprobe", "ffprobe"]
+]);
+async function defaultHasExecutable(command) {
+    try {
+        await execFileAsync(command, ["-version"], {
+            timeout: 2_000,
+            windowsHide: true
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Checks only locally authoritative runtime state. It never installs software,
+ * starts a model download, provisions a worker, or calls an inference API.
+ */
+export function createNodeToolSdkV1RuntimeProbe(options) {
+    const hasExecutable = options.hasExecutable ?? defaultHasExecutable;
+    return async (requirement) => {
+        const runtime = requirement.id.trim().toLowerCase();
+        if (NODE_RUNTIMES.has(runtime)) {
+            return { status: "available", message: null };
+        }
+        if (runtime === "python") {
+            return options.getPythonBridgeReady()
+                ? { status: "available", message: null }
+                : {
+                    status: "unavailable",
+                    message: "The Python runtime is not ready."
+                };
+        }
+        const executable = EXECUTABLE_RUNTIMES.get(runtime);
+        if (executable) {
+            return (await hasExecutable(executable))
+                ? { status: "available", message: null }
+                : {
+                    status: "missing",
+                    message: `The ${runtime} runtime is not installed or not on PATH.`
+                };
+        }
+        return {
+            status: "unknown",
+            message: "Runtime availability has not been checked."
+        };
+    };
+}
+//# sourceMappingURL=sdk-runtime-requirement-probe.js.map

package/dist/sdk/sdk-runtime-requirement-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-runtime-requirement-probe.js","sourceRoot":"","sources":["../../src/sdk/sdk-runtime-requirement-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;AAC9E,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACpB,CAAC,SAAS,EAAE,SAAS,CAAC;CACvB,CAAC,CAAC;AAOH,KAAK,UAAU,oBAAoB,CAAC,OAAe;IACjD,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE;YACzC,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAA+C;IAI/C,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,oBAAoB,CAAC;IAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpD,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChD,CAAC;QACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC,oBAAoB,EAAE;gBACnC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;gBACxC,CAAC,CAAC;oBACE,MAAM,EAAE,aAAa;oBACrB,OAAO,EAAE,kCAAkC;iBAC5C,CAAC;QACR,CAAC;QAED,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;gBACtC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;gBACxC,CAAC,CAAC;oBACE,MAAM,EAAE,SAAS;oBACjB,OAAO,EAAE,OAAO,OAAO,2CAA2C;iBACnE,CAAC;QACR,CAAC;QAED,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,4CAA4C;SACtD,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/sdk/sdk-static-preflight-service.d.ts

@@ -0,0 +1,66 @@
+import { type CostEstimateInput, type GraphValidationInput, type GraphValidationRegistry } from "@nodetool-ai/node-sdk";
+import { type SdkV1PreflightRequest, type SdkV1PreflightSummary, type SdkV1Requirement, type SdkV1ValidationIssue } from "@nodetool-ai/protocol/api-schemas/sdk-lifecycle-v1.js";
+import { type WorkflowInterfaceV1Response } from "@nodetool-ai/protocol/api-schemas/workflows.js";
+type PreflightRegistry = GraphValidationRegistry & {
+    getMetadata: CostEstimateInput["getMetadata"];
+};
+export interface BuildSdkV1StaticPreflightOptions {
+    request: SdkV1PreflightRequest;
+    workflowInterface: WorkflowInterfaceV1Response;
+    graph: GraphValidationInput;
+    registry: PreflightRegistry;
+    getModelPrice?: CostEstimateInput["getModelPrice"];
+    quantities?: Readonly<Record<string, number>>;
+    approvalThreshold?: number | null;
+    /**
+     * Resolves an explicit installed-package identity for a node type.
+     * Returning null means the registry cannot authoritatively identify a
+     * package. Implementations must not infer package ids from namespaces.
+     */
+    resolveNodePackageId?: (input: {
+        nodeId: string;
+        nodeType: string;
+        metadata: ReturnType<PreflightRegistry["getMetadata"]>;
+    }) => string | null;
+}
+export interface SdkV1RequirementAvailability {
+    status: SdkV1Requirement["status"];
+    message?: string | null;
+    details?: SdkV1Requirement["details"];
+}
+interface BuildSdkV1AvailabilityPreflightOptions extends Omit<BuildSdkV1StaticPreflightOptions, "request"> {
+    request: SdkV1PreflightRequest & {
+        level: "availability";
+    };
+    resolveRequirement: (requirement: Readonly<SdkV1Requirement>) => Promise<SdkV1RequirementAvailability> | SdkV1RequirementAvailability;
+}
+export interface SdkV1ExecutionReadiness {
+    requirements: SdkV1Requirement[];
+    issues: SdkV1ValidationIssue[];
+}
+interface BuildSdkV1ExecutionPreflightOptions extends Omit<BuildSdkV1AvailabilityPreflightOptions, "request"> {
+    request: SdkV1PreflightRequest & {
+        level: "execution";
+    };
+    probeExecutionReadiness: () => Promise<SdkV1ExecutionReadiness> | SdkV1ExecutionReadiness;
+}
+/**
+ * Runs side-effect-free static preflight against caller-supplied workflow
+ * state. It performs no database, provider, worker, asset, or model-download
+ * operations and is intentionally not exposed as a route yet.
+ */
+export declare function buildSdkV1StaticPreflight(options: BuildSdkV1StaticPreflightOptions): SdkV1PreflightSummary;
+/**
+ * Resolves the requirements discovered by static preflight through
+ * caller-supplied, read-only probes. Probe failures are redacted and treated
+ * conservatively as unknown; no provider request, download, or job is started.
+ */
+export declare function buildSdkV1AvailabilityPreflight(options: BuildSdkV1AvailabilityPreflightOptions): Promise<SdkV1PreflightSummary>;
+/**
+ * Adds execution-target readiness to availability preflight. The injected
+ * probe may inspect worker/capacity state but must not enqueue jobs, start
+ * downloads, or contact paid providers.
+ */
+export declare function buildSdkV1ExecutionPreflight(options: BuildSdkV1ExecutionPreflightOptions): Promise<SdkV1PreflightSummary>;
+export {};
+//# sourceMappingURL=sdk-static-preflight-service.d.ts.map

package/dist/sdk/sdk-static-preflight-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-static-preflight-service.d.ts","sourceRoot":"","sources":["../../src/sdk/sdk-static-preflight-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,gDAAgD,CAAC;AASxD,KAAK,iBAAiB,GAAG,uBAAuB,GAAG;IACjD,WAAW,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;CAC/C,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,qBAAqB,CAAC;IAC/B,iBAAiB,EAAE,2BAA2B,CAAC;IAC/C,KAAK,EAAE,oBAAoB,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,aAAa,CAAC,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC7B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,UAAU,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC;KACxD,KAAK,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;CACvC;AAED,UAAU,sCAAuC,SAAQ,IAAI,CAC3D,gCAAgC,EAChC,SAAS,CACV;IACC,OAAO,EAAE,qBAAqB,GAAG;QAAE,KAAK,EAAE,cAAc,CAAA;KAAE,CAAC;IAC3D,kBAAkB,EAAE,CAClB,WAAW,EAAE,QAAQ,CAAC,gBAAgB,CAAC,KACpC,OAAO,CAAC,4BAA4B,CAAC,GAAG,4BAA4B,CAAC;CAC3E;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,UAAU,mCAAoC,SAAQ,IAAI,CACxD,sCAAsC,EACtC,SAAS,CACV;IACC,OAAO,EAAE,qBAAqB,GAAG;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC;IACxD,uBAAuB,EAAE,MACrB,OAAO,CAAC,uBAAuB,CAAC,GAChC,uBAAuB,CAAC;CAC7B;AAuXD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,qBAAqB,CAoEvB;AAED;;;;GAIG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,sCAAsC,GAC9C,OAAO,CAAC,qBAAqB,CAAC,CA+ChC;AAeD;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,qBAAqB,CAAC,CAmDhC"}