@inf-monkeys-tech/monkeys 1.0.0

package/README.md

@@ -0,0 +1,38 @@
+# Monkeys JS SDK
+
+`@inf-monkeys-tech/monkeys` 是 Monkeys 跨仓 TypeScript 合同、运行时 Schema 与 JSON Schema 的唯一发布源。所有消费者只使用一套 canonical 合同和稳定公开入口，禁止导入包内 `src/*`。
+
+## 安装
+
+```bash
+yarn add @inf-monkeys-tech/monkeys@1.0.0 --registry https://registry.npmjs.org
+```
+
+## 稳定入口
+
+```ts
+import type {
+  RequestScope,
+  WorkflowDefinition,
+} from '@inf-monkeys-tech/monkeys/contracts';
+import {
+  RequestScopeSchema,
+  WorkflowDefinitionSchema,
+} from '@inf-monkeys-tech/monkeys/schemas';
+```
+
+- `@inf-monkeys-tech/monkeys/contracts`：canonical TypeScript 合同。
+- `@inf-monkeys-tech/monkeys/schemas`：同一合同的 Zod 运行时 Schema 与 schema registry。
+- `@inf-monkeys-tech/monkeys/json-schema/*`：构建时生成的 JSON Schema 2020-12 文件。
+
+当前 canonical 合同覆盖 RequestScope、ExecutionLink、Completion、Artifact/Output、Workflow、Capability、Page/Runtime Descriptor、Tenant Config、Theme Tokens、Ontology、Projection、Lineage、Domain Event 与 Trend/Radar 数据对象。运行时 Schema 严格拒绝未声明字段、错误引用和不满足不变量的数据；SDK 不提供旧合同迁移器、兼容别名或并行版本入口。
+
+## 发布门禁
+
+```bash
+yarn typecheck
+yarn test
+yarn pack:check
+```
+
+`yarn test` 会重新构建包、生成全部 JSON Schema，并验证公开导出、所有 canonical 合同、严格字段边界和跨字段不变量。

package/lib/contracts/artifact.d.ts

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+export declare const StorageLocatorSchema: z.ZodObject<{
+    provider: z.ZodString;
+    bucket: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
+    region: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const ArtifactAccessSchema: z.ZodObject<{
+    tenantId: z.ZodOptional<z.ZodString>;
+    teamId: z.ZodOptional<z.ZodString>;
+    ownerRef: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        ownerRepo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    visibility: z.ZodEnum<{
+        private: "private";
+        team: "team";
+        tenant: "tenant";
+        public: "public";
+    }>;
+}, z.core.$strict>;
+export declare const ArtifactManifestSchema: z.ZodObject<{
+    contract: z.ZodLiteral<"ArtifactManifest">;
+    artifactId: z.ZodString;
+    kind: z.ZodString;
+    mimeType: z.ZodString;
+    byteSize: z.ZodOptional<z.ZodNumber>;
+    sha256: z.ZodString;
+    storage: z.ZodObject<{
+        provider: z.ZodString;
+        bucket: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        region: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    sourceRef: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        ownerRepo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    runRef: z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        ownerRepo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    outputRef: z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        ownerRepo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    producer: z.ZodObject<{
+        service: z.ZodString;
+        version: z.ZodString;
+        capabilityRef: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+            version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            ownerRepo: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    access: z.ZodObject<{
+        tenantId: z.ZodOptional<z.ZodString>;
+        teamId: z.ZodOptional<z.ZodString>;
+        ownerRef: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+            version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            ownerRepo: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        visibility: z.ZodEnum<{
+            private: "private";
+            team: "team";
+            tenant: "tenant";
+            public: "public";
+        }>;
+    }, z.core.$strict>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<import("./common").JsonValue, unknown, z.core.$ZodTypeInternals<import("./common").JsonValue, unknown>>>>;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export declare const OutputRecordSchema: z.ZodObject<{
+    contract: z.ZodLiteral<"OutputRecord">;
+    outputId: z.ZodString;
+    runRef: z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        ownerRepo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    outputPort: z.ZodString;
+    value: z.ZodOptional<z.ZodType<import("./common").JsonValue, unknown, z.core.$ZodTypeInternals<import("./common").JsonValue, unknown>>>;
+    artifactRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        ownerRepo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    schemaRef: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export type StorageLocator = z.infer<typeof StorageLocatorSchema>;
+export type ArtifactAccess = z.infer<typeof ArtifactAccessSchema>;
+export type ArtifactManifest = z.infer<typeof ArtifactManifestSchema>;
+export type OutputRecord = z.infer<typeof OutputRecordSchema>;
+//# sourceMappingURL=artifact.d.ts.map

package/lib/contracts/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../src/contracts/artifact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,oBAAoB;;;;;;;kBAStB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;kBAOtB,CAAC;AAEZ,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuBxB,CAAC;AAEZ,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;kBAWpB,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/lib/contracts/artifact.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputRecordSchema = exports.ArtifactManifestSchema = exports.ArtifactAccessSchema = exports.StorageLocatorSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("./common");
+exports.StorageLocatorSchema = zod_1.z
+    .object({
+    provider: common_1.ContractIdentifierSchema,
+    bucket: common_1.ContractIdentifierSchema.optional(),
+    key: common_1.ContractIdentifierSchema,
+    region: common_1.ContractIdentifierSchema.optional(),
+    url: zod_1.z.string().url().optional(),
+    expiresAt: common_1.IsoDateTimeSchema.optional(),
+})
+    .strict();
+exports.ArtifactAccessSchema = zod_1.z
+    .object({
+    tenantId: common_1.ContractIdentifierSchema.optional(),
+    teamId: common_1.ContractIdentifierSchema.optional(),
+    ownerRef: common_1.EntityRefSchema.optional(),
+    visibility: zod_1.z.enum(['private', 'team', 'tenant', 'public']),
+})
+    .strict();
+exports.ArtifactManifestSchema = zod_1.z
+    .object({
+    contract: zod_1.z.literal('ArtifactManifest'),
+    artifactId: common_1.ContractIdentifierSchema,
+    kind: common_1.ContractIdentifierSchema,
+    mimeType: zod_1.z.string().trim().min(1),
+    byteSize: zod_1.z.number().int().nonnegative().optional(),
+    sha256: common_1.Sha256Schema,
+    storage: exports.StorageLocatorSchema,
+    sourceRef: common_1.EntityRefSchema.optional(),
+    runRef: common_1.EntityRefSchema,
+    outputRef: common_1.EntityRefSchema,
+    producer: zod_1.z
+        .object({
+        service: common_1.ContractIdentifierSchema,
+        version: common_1.ContractIdentifierSchema,
+        capabilityRef: common_1.EntityRefSchema.optional(),
+    })
+        .strict(),
+    access: exports.ArtifactAccessSchema,
+    metadata: zod_1.z.record(zod_1.z.string(), common_1.JsonValueSchema).default({}),
+    createdAt: common_1.IsoDateTimeSchema,
+})
+    .strict();
+exports.OutputRecordSchema = zod_1.z
+    .object({
+    contract: zod_1.z.literal('OutputRecord'),
+    outputId: common_1.ContractIdentifierSchema,
+    runRef: common_1.EntityRefSchema,
+    outputPort: common_1.ContractIdentifierSchema,
+    value: common_1.JsonValueSchema.optional(),
+    artifactRefs: zod_1.z.array(common_1.EntityRefSchema).default([]),
+    schemaRef: common_1.ContractIdentifierSchema.optional(),
+    createdAt: common_1.IsoDateTimeSchema,
+})
+    .strict();
+//# sourceMappingURL=artifact.js.map

package/lib/contracts/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../src/contracts/artifact.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qCAMkB;AAEL,QAAA,oBAAoB,GAAG,OAAC;KAClC,MAAM,CAAC;IACN,QAAQ,EAAE,iCAAwB;IAClC,MAAM,EAAE,iCAAwB,CAAC,QAAQ,EAAE;IAC3C,GAAG,EAAE,iCAAwB;IAC7B,MAAM,EAAE,iCAAwB,CAAC,QAAQ,EAAE;IAC3C,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,0BAAiB,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,MAAM,EAAE,CAAC;AAEC,QAAA,oBAAoB,GAAG,OAAC;KAClC,MAAM,CAAC;IACN,QAAQ,EAAE,iCAAwB,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,iCAAwB,CAAC,QAAQ,EAAE;IAC3C,QAAQ,EAAE,wBAAe,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;CAC5D,CAAC;KACD,MAAM,EAAE,CAAC;AAEC,QAAA,sBAAsB,GAAG,OAAC;KACpC,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACvC,UAAU,EAAE,iCAAwB;IACpC,IAAI,EAAE,iCAAwB;IAC9B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACnD,MAAM,EAAE,qBAAY;IACpB,OAAO,EAAE,4BAAoB;IAC7B,SAAS,EAAE,wBAAe,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,wBAAe;IACvB,SAAS,EAAE,wBAAe;IAC1B,QAAQ,EAAE,OAAC;SACR,MAAM,CAAC;QACN,OAAO,EAAE,iCAAwB;QACjC,OAAO,EAAE,iCAAwB;QACjC,aAAa,EAAE,wBAAe,CAAC,QAAQ,EAAE;KAC1C,CAAC;SACD,MAAM,EAAE;IACX,MAAM,EAAE,4BAAoB;IAC5B,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,wBAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D,SAAS,EAAE,0BAAiB;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC;AAEC,QAAA,kBAAkB,GAAG,OAAC;KAChC,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IACnC,QAAQ,EAAE,iCAAwB;IAClC,MAAM,EAAE,wBAAe;IACvB,UAAU,EAAE,iCAAwB;IACpC,KAAK,EAAE,wBAAe,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,wBAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,SAAS,EAAE,iCAAwB,CAAC,QAAQ,EAAE;IAC9C,SAAS,EAAE,0BAAiB;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC"}

package/lib/contracts/capability.d.ts

@@ -0,0 +1,347 @@
+import { z } from 'zod';
+export declare const ContractPortSchema: z.ZodObject<{
+    name: z.ZodString;
+    schemaRef: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    multiple: z.ZodDefault<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const CapabilityProviderBindingSchema: z.ZodObject<{
+    providerRef: z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        ownerRepo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    productContexts: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        studio: "studio";
+        kernel: "kernel";
+        compute: "compute";
+    }>>>;
+    priority: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const CapabilityManifestSchema: z.ZodObject<{
+    contract: z.ZodLiteral<"CapabilityManifest">;
+    id: z.ZodString;
+    capabilityVersion: z.ZodString;
+    ownerRepo: z.ZodString;
+    kind: z.ZodEnum<{
+        workflow: "workflow";
+        view: "view";
+        "professional-provider": "professional-provider";
+        primitive: "primitive";
+        composite: "composite";
+        tool: "tool";
+    }>;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    ports: z.ZodObject<{
+        inputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            schemaRef: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            multiple: z.ZodDefault<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        outputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            schemaRef: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            multiple: z.ZodDefault<z.ZodBoolean>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    runtime: z.ZodObject<{
+        providerBindings: z.ZodArray<z.ZodObject<{
+            providerRef: z.ZodObject<{
+                kind: z.ZodString;
+                id: z.ZodString;
+                version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+                ownerRepo: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            productContexts: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                studio: "studio";
+                kernel: "kernel";
+                compute: "compute";
+            }>>>;
+            priority: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+        loading: z.ZodEnum<{
+            lazy: "lazy";
+            eager: "eager";
+            viewport: "viewport";
+            "on-activation": "on-activation";
+        }>;
+        fallbackCapabilityRef: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+            version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+            ownerRepo: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        stateOwner: z.ZodEnum<{
+            provider: "provider";
+            host: "host";
+            external: "external";
+        }>;
+        stateSchemaRef: z.ZodOptional<z.ZodString>;
+        sideEffects: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            storage: "storage";
+            navigation: "navigation";
+            network: "network";
+            worker: "worker";
+            websocket: "websocket";
+        }>>>;
+    }, z.core.$strict>;
+    placement: z.ZodObject<{
+        surfaces: z.ZodArray<z.ZodString>;
+        slots: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        variants: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        tokenRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    accessibility: z.ZodObject<{
+        keyboardModel: z.ZodString;
+        focusModel: z.ZodString;
+        labelContract: z.ZodString;
+    }, z.core.$strict>;
+    observability: z.ZodObject<{
+        eventNamespace: z.ZodString;
+        metrics: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        performanceBudgetMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const CapabilitySourceTypeSchema: z.ZodEnum<{
+    workflow: "workflow";
+    "tool-manifest": "tool-manifest";
+    "plugin-manifest": "plugin-manifest";
+    openapi: "openapi";
+    comfyui: "comfyui";
+}>;
+export declare const CapabilityRegistrySourceSchema: z.ZodObject<{
+    sourceType: z.ZodEnum<{
+        workflow: "workflow";
+        "tool-manifest": "tool-manifest";
+        "plugin-manifest": "plugin-manifest";
+        openapi: "openapi";
+        comfyui: "comfyui";
+    }>;
+    sourceId: z.ZodString;
+    ownerRepo: z.ZodString;
+}, z.core.$strict>;
+export declare const CapabilityRegistryEntrySchema: z.ZodObject<{
+    manifest: z.ZodObject<{
+        contract: z.ZodLiteral<"CapabilityManifest">;
+        id: z.ZodString;
+        capabilityVersion: z.ZodString;
+        ownerRepo: z.ZodString;
+        kind: z.ZodEnum<{
+            workflow: "workflow";
+            view: "view";
+            "professional-provider": "professional-provider";
+            primitive: "primitive";
+            composite: "composite";
+            tool: "tool";
+        }>;
+        displayName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        ports: z.ZodObject<{
+            inputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                schemaRef: z.ZodString;
+                required: z.ZodDefault<z.ZodBoolean>;
+                multiple: z.ZodDefault<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            outputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                schemaRef: z.ZodString;
+                required: z.ZodDefault<z.ZodBoolean>;
+                multiple: z.ZodDefault<z.ZodBoolean>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+        runtime: z.ZodObject<{
+            providerBindings: z.ZodArray<z.ZodObject<{
+                providerRef: z.ZodObject<{
+                    kind: z.ZodString;
+                    id: z.ZodString;
+                    version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+                    ownerRepo: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+                productContexts: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    studio: "studio";
+                    kernel: "kernel";
+                    compute: "compute";
+                }>>>;
+                priority: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>>;
+            loading: z.ZodEnum<{
+                lazy: "lazy";
+                eager: "eager";
+                viewport: "viewport";
+                "on-activation": "on-activation";
+            }>;
+            fallbackCapabilityRef: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodString;
+                id: z.ZodString;
+                version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+                ownerRepo: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            stateOwner: z.ZodEnum<{
+                provider: "provider";
+                host: "host";
+                external: "external";
+            }>;
+            stateSchemaRef: z.ZodOptional<z.ZodString>;
+            sideEffects: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                storage: "storage";
+                navigation: "navigation";
+                network: "network";
+                worker: "worker";
+                websocket: "websocket";
+            }>>>;
+        }, z.core.$strict>;
+        placement: z.ZodObject<{
+            surfaces: z.ZodArray<z.ZodString>;
+            slots: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            variants: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            tokenRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+        accessibility: z.ZodObject<{
+            keyboardModel: z.ZodString;
+            focusModel: z.ZodString;
+            labelContract: z.ZodString;
+        }, z.core.$strict>;
+        observability: z.ZodObject<{
+            eventNamespace: z.ZodString;
+            metrics: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            performanceBudgetMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    sources: z.ZodArray<z.ZodObject<{
+        sourceType: z.ZodEnum<{
+            workflow: "workflow";
+            "tool-manifest": "tool-manifest";
+            "plugin-manifest": "plugin-manifest";
+            openapi: "openapi";
+            comfyui: "comfyui";
+        }>;
+        sourceId: z.ZodString;
+        ownerRepo: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const CapabilityRegistryDocumentSchema: z.ZodObject<{
+    contract: z.ZodLiteral<"CapabilityRegistry">;
+    entries: z.ZodArray<z.ZodObject<{
+        manifest: z.ZodObject<{
+            contract: z.ZodLiteral<"CapabilityManifest">;
+            id: z.ZodString;
+            capabilityVersion: z.ZodString;
+            ownerRepo: z.ZodString;
+            kind: z.ZodEnum<{
+                workflow: "workflow";
+                view: "view";
+                "professional-provider": "professional-provider";
+                primitive: "primitive";
+                composite: "composite";
+                tool: "tool";
+            }>;
+            displayName: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            ports: z.ZodObject<{
+                inputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    schemaRef: z.ZodString;
+                    required: z.ZodDefault<z.ZodBoolean>;
+                    multiple: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+                outputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    schemaRef: z.ZodString;
+                    required: z.ZodDefault<z.ZodBoolean>;
+                    multiple: z.ZodDefault<z.ZodBoolean>;
+                    description: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>;
+            runtime: z.ZodObject<{
+                providerBindings: z.ZodArray<z.ZodObject<{
+                    providerRef: z.ZodObject<{
+                        kind: z.ZodString;
+                        id: z.ZodString;
+                        version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+                        ownerRepo: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>;
+                    productContexts: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                        studio: "studio";
+                        kernel: "kernel";
+                        compute: "compute";
+                    }>>>;
+                    priority: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strict>>;
+                loading: z.ZodEnum<{
+                    lazy: "lazy";
+                    eager: "eager";
+                    viewport: "viewport";
+                    "on-activation": "on-activation";
+                }>;
+                fallbackCapabilityRef: z.ZodOptional<z.ZodObject<{
+                    kind: z.ZodString;
+                    id: z.ZodString;
+                    version: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+                    ownerRepo: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                stateOwner: z.ZodEnum<{
+                    provider: "provider";
+                    host: "host";
+                    external: "external";
+                }>;
+                stateSchemaRef: z.ZodOptional<z.ZodString>;
+                sideEffects: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    storage: "storage";
+                    navigation: "navigation";
+                    network: "network";
+                    worker: "worker";
+                    websocket: "websocket";
+                }>>>;
+            }, z.core.$strict>;
+            placement: z.ZodObject<{
+                surfaces: z.ZodArray<z.ZodString>;
+                slots: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                variants: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                tokenRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>;
+            accessibility: z.ZodObject<{
+                keyboardModel: z.ZodString;
+                focusModel: z.ZodString;
+                labelContract: z.ZodString;
+            }, z.core.$strict>;
+            observability: z.ZodObject<{
+                eventNamespace: z.ZodString;
+                metrics: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                performanceBudgetMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        sources: z.ZodArray<z.ZodObject<{
+            sourceType: z.ZodEnum<{
+                workflow: "workflow";
+                "tool-manifest": "tool-manifest";
+                "plugin-manifest": "plugin-manifest";
+                openapi: "openapi";
+                comfyui: "comfyui";
+            }>;
+            sourceId: z.ZodString;
+            ownerRepo: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ContractPort = z.infer<typeof ContractPortSchema>;
+export type CapabilityProviderBinding = z.infer<typeof CapabilityProviderBindingSchema>;
+export type CapabilityManifest = z.infer<typeof CapabilityManifestSchema>;
+export type CapabilitySourceType = z.infer<typeof CapabilitySourceTypeSchema>;
+export type CapabilityRegistrySource = z.infer<typeof CapabilityRegistrySourceSchema>;
+export type CapabilityRegistryEntry = z.infer<typeof CapabilityRegistryEntrySchema>;
+export type CapabilityRegistryDocument = z.infer<typeof CapabilityRegistryDocumentSchema>;
+//# sourceMappingURL=capability.d.ts.map

package/lib/contracts/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/contracts/capability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,kBAAkB;;;;;;kBAQpB,CAAC;AAEZ,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;kBAMjC,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuEjC,CAAC;AAEL,eAAO,MAAM,0BAA0B;;;;;;EAMrC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;kBAMhC,CAAC;AAEZ,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK/B,CAAC;AAEZ,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkBzC,CAAC;AAEL,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}