@kb-labs/infra-worker-contracts 0.5.0

package/LICENSE

@@ -0,0 +1,4 @@
+This project is licensed under the same terms as the KB Labs Plugin Template root project.
+
+See the root LICENSE file at the repository root for full details.
+

package/README.md

@@ -0,0 +1,11 @@
+# @kb-labs/infra-worker-contracts
+
+Shared types/contracts for infra worker plugin integration.
+
+Use this package when orchestrator and infra worker need a stable typed payload/result contract.
+
+## Build
+
+```bash
+pnpm --filter @kb-labs/infra-worker-contracts build
+```

package/dist/contract.d.ts

@@ -0,0 +1,84 @@
+declare const pluginContractsManifest: {
+    readonly schema: "kb.plugin.contracts/1";
+    readonly pluginId: "@kb-labs/infra-worker";
+    readonly contractsVersion: "1.0.0";
+    readonly artifacts: {
+        readonly 'infra.prepare.result': {
+            readonly id: "infra.prepare.result";
+            readonly kind: "json";
+            readonly description: "Result payload for infra preparation command.";
+            readonly pathPattern: "artifacts/infra/prepare/result.json";
+            readonly mediaType: "application/json";
+            readonly schemaRef: "@kb-labs/infra-worker-contracts/schema#PrepareInfraOutput";
+            readonly example: {
+                readonly summary: "Infra prepare output";
+                readonly payload: {
+                    readonly workspaceId: "ws_123";
+                    readonly environmentId: "env_456";
+                    readonly snapshotId: "snap_789";
+                };
+            };
+        };
+    };
+    readonly commands: {
+        readonly 'infra-worker:prepare': {
+            readonly id: "infra-worker:prepare";
+            readonly description: "Materialize workspace and optionally provision environment/snapshot.";
+            readonly input: {
+                readonly ref: "@kb-labs/infra-worker-contracts/schema#PrepareInfraInput";
+                readonly format: "zod";
+            };
+            readonly output: {
+                readonly ref: "@kb-labs/infra-worker-contracts/schema#PrepareInfraOutput";
+                readonly format: "zod";
+            };
+            readonly produces: ["infra.prepare.result"];
+            readonly examples: ["kb infra-worker prepare --sourceRef repo://main --basePath /workspace/main"];
+        };
+        readonly 'infra-worker:capture-snapshot': {
+            readonly id: "infra-worker:capture-snapshot";
+            readonly description: "Capture snapshot for workspace/environment.";
+            readonly input: {
+                readonly ref: "@kb-labs/infra-worker-contracts/schema#CaptureSnapshotInput";
+                readonly format: "zod";
+            };
+            readonly output: {
+                readonly ref: "@kb-labs/infra-worker-contracts/schema#CaptureSnapshotOutput";
+                readonly format: "zod";
+            };
+            readonly produces: [];
+            readonly examples: ["kb infra-worker capture-snapshot --workspaceId ws_123 --namespace runs/main"];
+        };
+        readonly 'infra-worker:restore-snapshot': {
+            readonly id: "infra-worker:restore-snapshot";
+            readonly description: "Restore snapshot to workspace/environment.";
+            readonly input: {
+                readonly ref: "@kb-labs/infra-worker-contracts/schema#RestoreSnapshotInput";
+                readonly format: "zod";
+            };
+            readonly output: {
+                readonly ref: "@kb-labs/infra-worker-contracts/schema#RestoreSnapshotOutput";
+                readonly format: "zod";
+            };
+            readonly produces: [];
+            readonly examples: ["kb infra-worker restore-snapshot --snapshotId snap_789 --workspaceId ws_123"];
+        };
+    };
+    readonly workflows: {};
+    readonly api: {
+        readonly rest: {
+            readonly basePath: "/v1/plugins/infra-worker";
+            readonly routes: {};
+        };
+    };
+};
+type PluginArtifactIds = keyof typeof pluginContractsManifest.artifacts;
+type PluginCommandIds = keyof typeof pluginContractsManifest.commands;
+type PluginWorkflowIds = keyof typeof pluginContractsManifest.workflows;
+type PluginRouteIds = typeof pluginContractsManifest.api extends {
+    rest: {
+        routes: infer R;
+    };
+} ? R extends Record<string, any> ? keyof R : never : never;
+
+export { type PluginArtifactIds, type PluginCommandIds, type PluginRouteIds, type PluginWorkflowIds, pluginContractsManifest };

package/dist/contract.js

@@ -0,0 +1,83 @@
+// src/version.ts
+var contractsSchemaId = "kb.plugin.contracts/1";
+var contractsVersion = "1.0.0";
+
+// src/contract.ts
+var pluginContractsManifest = {
+  schema: contractsSchemaId,
+  pluginId: "@kb-labs/infra-worker",
+  contractsVersion,
+  artifacts: {
+    "infra.prepare.result": {
+      id: "infra.prepare.result",
+      kind: "json",
+      description: "Result payload for infra preparation command.",
+      pathPattern: "artifacts/infra/prepare/result.json",
+      mediaType: "application/json",
+      schemaRef: "@kb-labs/infra-worker-contracts/schema#PrepareInfraOutput",
+      example: {
+        summary: "Infra prepare output",
+        payload: {
+          workspaceId: "ws_123",
+          environmentId: "env_456",
+          snapshotId: "snap_789"
+        }
+      }
+    }
+  },
+  commands: {
+    "infra-worker:prepare": {
+      id: "infra-worker:prepare",
+      description: "Materialize workspace and optionally provision environment/snapshot.",
+      input: {
+        ref: "@kb-labs/infra-worker-contracts/schema#PrepareInfraInput",
+        format: "zod"
+      },
+      output: {
+        ref: "@kb-labs/infra-worker-contracts/schema#PrepareInfraOutput",
+        format: "zod"
+      },
+      produces: ["infra.prepare.result"],
+      examples: ["kb infra-worker prepare --sourceRef repo://main --basePath /workspace/main"]
+    },
+    "infra-worker:capture-snapshot": {
+      id: "infra-worker:capture-snapshot",
+      description: "Capture snapshot for workspace/environment.",
+      input: {
+        ref: "@kb-labs/infra-worker-contracts/schema#CaptureSnapshotInput",
+        format: "zod"
+      },
+      output: {
+        ref: "@kb-labs/infra-worker-contracts/schema#CaptureSnapshotOutput",
+        format: "zod"
+      },
+      produces: [],
+      examples: ["kb infra-worker capture-snapshot --workspaceId ws_123 --namespace runs/main"]
+    },
+    "infra-worker:restore-snapshot": {
+      id: "infra-worker:restore-snapshot",
+      description: "Restore snapshot to workspace/environment.",
+      input: {
+        ref: "@kb-labs/infra-worker-contracts/schema#RestoreSnapshotInput",
+        format: "zod"
+      },
+      output: {
+        ref: "@kb-labs/infra-worker-contracts/schema#RestoreSnapshotOutput",
+        format: "zod"
+      },
+      produces: [],
+      examples: ["kb infra-worker restore-snapshot --snapshotId snap_789 --workspaceId ws_123"]
+    }
+  },
+  workflows: {},
+  api: {
+    rest: {
+      basePath: "/v1/plugins/infra-worker",
+      routes: {}
+    }
+  }
+};
+
+export { pluginContractsManifest };
+//# sourceMappingURL=contract.js.map
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts","../src/contract.ts"],"names":[],"mappings":";AAAO,IAAM,iBAAA,GAAoB,uBAAA;AAI1B,IAAM,gBAAA,GAAmB,OAAA;;;ACDzB,IAAM,uBAAA,GAA0B;AAAA,EACrC,MAAA,EAAQ,iBAAA;AAAA,EACR,QAAA,EAAU,uBAAA;AAAA,EACV,gBAAA;AAAA,EACA,SAAA,EAAW;AAAA,IACT,sBAAA,EAAwB;AAAA,MACtB,EAAA,EAAI,sBAAA;AAAA,MACJ,IAAA,EAAM,MAAA;AAAA,MACN,WAAA,EAAa,+CAAA;AAAA,MACb,WAAA,EAAa,qCAAA;AAAA,MACb,SAAA,EAAW,kBAAA;AAAA,MACX,SAAA,EAAW,2DAAA;AAAA,MACX,OAAA,EAAS;AAAA,QACP,OAAA,EAAS,sBAAA;AAAA,QACT,OAAA,EAAS;AAAA,UACP,WAAA,EAAa,QAAA;AAAA,UACb,aAAA,EAAe,SAAA;AAAA,UACf,UAAA,EAAY;AAAA;AACd;AACF;AACF,GACF;AAAA,EACA,QAAA,EAAU;AAAA,IACR,sBAAA,EAAwB;AAAA,MACtB,EAAA,EAAI,sBAAA;AAAA,MACJ,WAAA,EAAa,sEAAA;AAAA,MACb,KAAA,EAAO;AAAA,QACL,GAAA,EAAK,0DAAA;AAAA,QACL,MAAA,EAAQ;AAAA,OACV;AAAA,MACA,MAAA,EAAQ;AAAA,QACN,GAAA,EAAK,2DAAA;AAAA,QACL,MAAA,EAAQ;AAAA,OACV;AAAA,MACA,QAAA,EAAU,CAAC,sBAAsB,CAAA;AAAA,MACjC,QAAA,EAAU,CAAC,4EAA4E;AAAA,KACzF;AAAA,IACA,+BAAA,EAAiC;AAAA,MAC/B,EAAA,EAAI,+BAAA;AAAA,MACJ,WAAA,EAAa,6CAAA;AAAA,MACb,KAAA,EAAO;AAAA,QACL,GAAA,EAAK,6DAAA;AAAA,QACL,MAAA,EAAQ;AAAA,OACV;AAAA,MACA,MAAA,EAAQ;AAAA,QACN,GAAA,EAAK,8DAAA;AAAA,QACL,MAAA,EAAQ;AAAA,OACV;AAAA,MACA,UAAU,EAAC;AAAA,MACX,QAAA,EAAU,CAAC,6EAA6E;AAAA,KAC1F;AAAA,IACA,+BAAA,EAAiC;AAAA,MAC/B,EAAA,EAAI,+BAAA;AAAA,MACJ,WAAA,EAAa,4CAAA;AAAA,MACb,KAAA,EAAO;AAAA,QACL,GAAA,EAAK,6DAAA;AAAA,QACL,MAAA,EAAQ;AAAA,OACV;AAAA,MACA,MAAA,EAAQ;AAAA,QACN,GAAA,EAAK,8DAAA;AAAA,QACL,MAAA,EAAQ;AAAA,OACV;AAAA,MACA,UAAU,EAAC;AAAA,MACX,QAAA,EAAU,CAAC,6EAA6E;AAAA;AAC1F,GACF;AAAA,EACA,WAAW,EAAC;AAAA,EACZ,GAAA,EAAK;AAAA,IACH,IAAA,EAAM;AAAA,MACJ,QAAA,EAAU,0BAAA;AAAA,MACV,QAAQ;AAAC;AACX;AAEJ","file":"contract.js","sourcesContent":["export const contractsSchemaId = 'kb.plugin.contracts/1' as const;\n\nexport type ContractsSchemaId = typeof contractsSchemaId;\n\nexport const contractsVersion = '1.0.0' as const;\n\n","import type { PluginContracts } from './types';\nimport { contractsSchemaId, contractsVersion } from './version';\n\nexport const pluginContractsManifest = {\n  schema: contractsSchemaId,\n  pluginId: '@kb-labs/infra-worker',\n  contractsVersion,\n  artifacts: {\n    'infra.prepare.result': {\n      id: 'infra.prepare.result',\n      kind: 'json',\n      description: 'Result payload for infra preparation command.',\n      pathPattern: 'artifacts/infra/prepare/result.json',\n      mediaType: 'application/json',\n      schemaRef: '@kb-labs/infra-worker-contracts/schema#PrepareInfraOutput',\n      example: {\n        summary: 'Infra prepare output',\n        payload: {\n          workspaceId: 'ws_123',\n          environmentId: 'env_456',\n          snapshotId: 'snap_789',\n        },\n      },\n    }\n  },\n  commands: {\n    'infra-worker:prepare': {\n      id: 'infra-worker:prepare',\n      description: 'Materialize workspace and optionally provision environment/snapshot.',\n      input: {\n        ref: '@kb-labs/infra-worker-contracts/schema#PrepareInfraInput',\n        format: 'zod'\n      },\n      output: {\n        ref: '@kb-labs/infra-worker-contracts/schema#PrepareInfraOutput',\n        format: 'zod'\n      },\n      produces: ['infra.prepare.result'],\n      examples: ['kb infra-worker prepare --sourceRef repo://main --basePath /workspace/main']\n    },\n    'infra-worker:capture-snapshot': {\n      id: 'infra-worker:capture-snapshot',\n      description: 'Capture snapshot for workspace/environment.',\n      input: {\n        ref: '@kb-labs/infra-worker-contracts/schema#CaptureSnapshotInput',\n        format: 'zod'\n      },\n      output: {\n        ref: '@kb-labs/infra-worker-contracts/schema#CaptureSnapshotOutput',\n        format: 'zod'\n      },\n      produces: [],\n      examples: ['kb infra-worker capture-snapshot --workspaceId ws_123 --namespace runs/main']\n    },\n    'infra-worker:restore-snapshot': {\n      id: 'infra-worker:restore-snapshot',\n      description: 'Restore snapshot to workspace/environment.',\n      input: {\n        ref: '@kb-labs/infra-worker-contracts/schema#RestoreSnapshotInput',\n        format: 'zod'\n      },\n      output: {\n        ref: '@kb-labs/infra-worker-contracts/schema#RestoreSnapshotOutput',\n        format: 'zod'\n      },\n      produces: [],\n      examples: ['kb infra-worker restore-snapshot --snapshotId snap_789 --workspaceId ws_123']\n    }\n  },\n  workflows: {},\n  api: {\n    rest: {\n      basePath: '/v1/plugins/infra-worker',\n      routes: {},\n    },\n  },\n} as const satisfies PluginContracts;\n\nexport type PluginArtifactIds = keyof typeof pluginContractsManifest.artifacts;\nexport type PluginCommandIds = keyof typeof pluginContractsManifest.commands;\nexport type PluginWorkflowIds = keyof typeof pluginContractsManifest.workflows;\nexport type PluginRouteIds = typeof pluginContractsManifest.api extends { rest: { routes: infer R } }\n  ? R extends Record<string, any>\n    ? keyof R\n    : never\n  : never;\n"]}