@qlever-llc/trellis 0.10.1 → 0.10.2

package/src/sdk/_generated/core/contract.ts

@@ -0,0 +1,67 @@
+// Generated from ./generated/contracts/manifests/trellis.core@v1.json
+import type { ContractDependencyUse, SdkContractModule, TrellisContractV1, UseSpec } from "@qlever-llc/trellis";
+import { API } from "./api.js";
+
+const CONTRACT_MODULE_METADATA = Symbol.for("@qlever-llc/trellis/contracts/contract-module");
+
+export const CONTRACT_ID = "trellis.core@v1" as const;
+export const CONTRACT_DIGEST = "L4HW6uUIxDhK1Kpa_PUxpumoMberMgiCgJTNN5Qvje0" as const;
+export const CONTRACT = {"capabilities":{"trellis.core::catalog.read":{"description":"List the installed Trellis contract catalog.","displayName":"Read contract catalog"},"trellis.core::contract.read":{"description":"Read installed contract manifests and metadata.","displayName":"Read installed contracts"}},"description":"Trellis runtime RPCs available to all connected participants.","displayName":"Trellis Core","docs":{"markdown":"Exposes the Trellis catalog, contract details, runtime bindings, and surface availability checks used by platform participants.","summary":"Runtime catalog and binding APIs."},"format":"trellis.contract.v1","id":"trellis.core@v1","kind":"service","rpc":{"Trellis.Bindings.Get":{"capabilities":{"call":["service"]},"docs":{"markdown":"Returns runtime resource bindings for the caller's active service contract.","summary":"Read service resource bindings."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"}],"input":{"schema":"TrellisBindingsGetRequest"},"internal":true,"output":{"schema":"TrellisBindingsGetResponse"},"subject":"rpc.v1.Trellis.Bindings.Get","version":"v1"},"Trellis.Catalog":{"capabilities":{"call":["trellis.core::catalog.read"]},"docs":{"markdown":"Returns the active contract catalog entries available in the deployment.","summary":"List visible contracts."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"}],"input":{"schema":"TrellisCatalogRequest"},"output":{"schema":"TrellisCatalogResponse"},"subject":"rpc.v1.Trellis.Catalog","version":"v1"},"Trellis.Contract.Get":{"capabilities":{"call":["trellis.core::contract.read"]},"docs":{"markdown":"Returns the normalized contract manifest for a known contract digest.","summary":"Read one contract manifest."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"}],"input":{"schema":"TrellisContractGetRequest"},"output":{"schema":"TrellisContractGetResponse"},"subject":"rpc.v1.Trellis.Contract.Get","version":"v1"},"Trellis.Surface.Status":{"capabilities":{"call":["trellis.core::catalog.read"]},"docs":{"markdown":"Reports capability and deployment authority status for a contract-owned surface.","summary":"Inspect surface availability."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"}],"input":{"schema":"TrellisSurfaceStatusRequest"},"output":{"schema":"TrellisSurfaceStatusResponse"},"subject":"rpc.v1.Trellis.Surface.Status","version":"v1"}},"schemas":{"TrellisBindingsGetRequest":{"properties":{"contractId":{"minLength":1,"type":"string"},"digest":{"pattern":"^[A-Za-z0-9_-]+$","type":"string"}},"type":"object"},"TrellisBindingsGetResponse":{"properties":{"binding":{"properties":{"contractId":{"minLength":1,"type":"string"},"digest":{"pattern":"^[A-Za-z0-9_-]+$","type":"string"},"resources":{"properties":{"eventConsumers":{"patternProperties":{"^.*$":{"properties":{"ackWaitMs":{"minimum":1,"type":"integer"},"backoffMs":{"items":{"minimum":0,"type":"integer"},"type":"array"},"concurrency":{"minimum":1,"type":"integer"},"consumerName":{"minLength":1,"type":"string"},"filterSubjects":{"items":{"minLength":1,"type":"string"},"type":"array"},"maxDeliver":{"minimum":1,"type":"integer"},"ordering":{"const":"strict","type":"string"},"replay":{"anyOf":[{"const":"new","type":"string"},{"const":"all","type":"string"}]},"stream":{"minLength":1,"type":"string"}},"required":["stream","consumerName","filterSubjects","replay","ordering","concurrency","ackWaitMs","maxDeliver","backoffMs"],"type":"object"}},"type":"object"},"jobs":{"properties":{"namespace":{"minLength":1,"type":"string"},"queues":{"patternProperties":{"^.*$":{"properties":{"ackWaitMs":{"minimum":1,"type":"integer"},"backoffMs":{"items":{"minimum":0,"type":"integer"},"type":"array"},"concurrency":{"minimum":1,"type":"integer"},"consumerName":{"minLength":1,"type":"string"},"defaultDeadlineMs":{"minimum":1,"type":"integer"},"dlq":{"type":"boolean"},"logs":{"type":"boolean"},"maxDeliver":{"minimum":1,"type":"integer"},"payload":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"},"progress":{"type":"boolean"},"publishPrefix":{"minLength":1,"type":"string"},"queueType":{"minLength":1,"type":"string"},"result":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"},"workSubject":{"minLength":1,"type":"string"}},"required":["queueType","publishPrefix","workSubject","consumerName","payload","maxDeliver","backoffMs","ackWaitMs","progress","logs","dlq","concurrency"],"type":"object"}},"type":"object"},"workStream":{"minLength":1,"type":"string"}},"required":["namespace","queues"],"type":"object"},"kv":{"patternProperties":{"^.*$":{"properties":{"bucket":{"minLength":1,"type":"string"},"history":{"minimum":1,"type":"integer"},"maxValueBytes":{"minimum":1,"type":"integer"},"ttlMs":{"minimum":0,"type":"integer"}},"required":["bucket","history","ttlMs"],"type":"object"}},"type":"object"},"store":{"patternProperties":{"^.*$":{"properties":{"maxObjectBytes":{"minimum":1,"type":"integer"},"maxTotalBytes":{"minimum":1,"type":"integer"},"name":{"minLength":1,"type":"string"},"ttlMs":{"minimum":0,"type":"integer"}},"required":["name","ttlMs"],"type":"object"}},"type":"object"}},"type":"object"}},"required":["contractId","digest","resources"],"type":"object"},"eventConsumers":{"patternProperties":{"^.*$":{"properties":{"ackWaitMs":{"minimum":1,"type":"integer"},"backoffMs":{"items":{"minimum":0,"type":"integer"},"type":"array"},"concurrency":{"minimum":1,"type":"integer"},"consumerName":{"minLength":1,"type":"string"},"filterSubjects":{"items":{"minLength":1,"type":"string"},"type":"array"},"maxDeliver":{"minimum":1,"type":"integer"},"ordering":{"const":"strict","type":"string"},"replay":{"anyOf":[{"const":"new","type":"string"},{"const":"all","type":"string"}]},"stream":{"minLength":1,"type":"string"}},"required":["stream","consumerName","filterSubjects","replay","ordering","concurrency","ackWaitMs","maxDeliver","backoffMs"],"type":"object"}},"type":"object"}},"type":"object"},"TrellisCatalogRequest":{"properties":{},"type":"object"},"TrellisCatalogResponse":{"properties":{"catalog":{"properties":{"contracts":{"items":{"properties":{"description":{"minLength":1,"type":"string"},"digest":{"type":"string"},"displayName":{"minLength":1,"type":"string"},"id":{"type":"string"}},"required":["id","digest","displayName","description"],"type":"object"},"type":"array"},"format":{"const":"trellis.catalog.v1","type":"string"},"issues":{"items":{"properties":{"actions":{"items":{"properties":{"action":{"anyOf":[{"const":"keep-current","type":"string"},{"const":"force-replace","type":"string"}]},"deploymentIds":{"items":{"type":"string"},"type":"array"},"description":{"minLength":1,"type":"string"},"digests":{"items":{"type":"string"},"type":"array"},"label":{"minLength":1,"type":"string"},"risk":{"anyOf":[{"const":"recommended","type":"string"},{"const":"dangerous","type":"string"}]}},"required":["action","label","description","risk","deploymentIds","digests"],"type":"object"},"type":"array"},"conflictingDeploymentIds":{"items":{"type":"string"},"type":"array"},"conflictingDigest":{"type":"string"},"conflictingDigests":{"items":{"type":"string"},"type":"array"},"contractId":{"type":"string"},"deploymentIds":{"items":{"type":"string"},"type":"array"},"digest":{"type":"string"},"effectiveDeploymentIds":{"items":{"type":"string"},"type":"array"},"effectiveDigests":{"items":{"type":"string"},"type":"array"},"issueId":{"minLength":1,"type":"string"},"kind":{"anyOf":[{"const":"missing-active-contract","type":"string"},{"const":"invalid-active-contract","type":"string"},{"const":"incompatible-active-contract","type":"string"},{"const":"invalid-active-contract-uses","type":"string"}]},"message":{"minLength":1,"type":"string"}},"required":["issueId","kind","message","deploymentIds","actions"],"type":"object"},"type":"array"}},"required":["format","contracts"],"type":"object"}},"required":["catalog"],"type":"object"},"TrellisContractGetRequest":{"properties":{"digest":{"pattern":"^[A-Za-z0-9_-]+$","type":"string"}},"required":["digest"],"type":"object"},"TrellisContractGetResponse":{"properties":{"contract":{"properties":{"description":{"minLength":1,"type":"string"},"displayName":{"minLength":1,"type":"string"},"docs":{"properties":{"markdown":{"type":"string"},"summary":{"type":"string"}},"required":["markdown"],"type":"object"},"errors":{"patternProperties":{"^.*$":{"type":"object"}},"type":"object"},"events":{"patternProperties":{"^.*$":{"type":"object"}},"type":"object"},"exports":{"properties":{"schemas":{"items":{"minLength":1,"type":"string"},"type":"array"}},"type":"object"},"format":{"const":"trellis.contract.v1","type":"string"},"id":{"minLength":1,"type":"string"},"jobs":{"patternProperties":{"^.*$":{"properties":{"ackWaitMs":{"minimum":1,"type":"integer"},"backoffMs":{"items":{"minimum":0,"type":"integer"},"type":"array"},"concurrency":{"minimum":1,"type":"integer"},"defaultDeadlineMs":{"minimum":1,"type":"integer"},"dlq":{"type":"boolean"},"docs":{"properties":{"markdown":{"type":"string"},"summary":{"type":"string"}},"required":["markdown"],"type":"object"},"logs":{"type":"boolean"},"maxDeliver":{"minimum":1,"type":"integer"},"payload":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"},"progress":{"type":"boolean"},"result":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"}},"required":["payload"],"type":"object"}},"type":"object"},"kind":{"anyOf":[{"const":"service","type":"string"},{"const":"app","type":"string"},{"const":"device","type":"string"},{"const":"agent","type":"string"}]},"operations":{"patternProperties":{"^.*$":{"type":"object"}},"type":"object"},"resources":{"additionalProperties":false,"properties":{"kv":{"patternProperties":{"^.*$":{"properties":{"docs":{"properties":{"markdown":{"type":"string"},"summary":{"type":"string"}},"required":["markdown"],"type":"object"},"history":{"default":1,"minimum":1,"type":"integer"},"maxValueBytes":{"minimum":1,"type":"integer"},"purpose":{"minLength":1,"type":"string"},"required":{"default":true,"type":"boolean"},"schema":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"},"ttlMs":{"default":0,"minimum":0,"type":"integer"}},"required":["purpose","schema"],"type":"object"}},"type":"object"},"store":{"patternProperties":{"^.*$":{"properties":{"docs":{"properties":{"markdown":{"type":"string"},"summary":{"type":"string"}},"required":["markdown"],"type":"object"},"maxObjectBytes":{"minimum":1,"type":"integer"},"maxTotalBytes":{"minimum":1,"type":"integer"},"purpose":{"minLength":1,"type":"string"},"required":{"default":true,"type":"boolean"},"ttlMs":{"default":0,"minimum":0,"type":"integer"}},"required":["purpose"],"type":"object"}},"type":"object"}},"type":"object"},"rpc":{"patternProperties":{"^.*$":{"type":"object"}},"type":"object"},"schemas":{"patternProperties":{"^.*$":{"anyOf":[{"type":"object"},{"type":"boolean"}]}},"type":"object"},"state":{"patternProperties":{"^.*$":{"properties":{"acceptedVersions":{"patternProperties":{"^.*$":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"}},"type":"object"},"docs":{"properties":{"markdown":{"type":"string"},"summary":{"type":"string"}},"required":["markdown"],"type":"object"},"kind":{"anyOf":[{"const":"value","type":"string"},{"const":"map","type":"string"}]},"schema":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"},"stateVersion":{"minLength":1,"type":"string"}},"required":["kind","schema"],"type":"object"}},"type":"object"},"uses":{"patternProperties":{"^.*$":{"type":"object"}},"type":"object"}},"required":["format","id","displayName","description","kind"],"type":"object"}},"required":["contract"],"type":"object"},"TrellisSurfaceStatusRequest":{"properties":{"action":{"anyOf":[{"const":"call","type":"string"},{"const":"publish","type":"string"},{"const":"subscribe","type":"string"},{"const":"observe","type":"string"}]},"contractId":{"minLength":1,"type":"string"},"kind":{"anyOf":[{"const":"rpc","type":"string"},{"const":"operation","type":"string"},{"const":"event","type":"string"},{"const":"feed","type":"string"}]},"surface":{"minLength":1,"type":"string"}},"required":["contractId","kind","surface"],"type":"object"},"TrellisSurfaceStatusResponse":{"properties":{"status":{"anyOf":[{"properties":{"liveImplementer":{"type":"boolean"},"runtime":{"anyOf":[{"const":"live","type":"string"},{"const":"no_live_implementer","type":"string"},{"const":"disabled","type":"string"}]},"state":{"const":"available","type":"string"}},"required":["state","liveImplementer","runtime"],"type":"object"},{"properties":{"reason":{"anyOf":[{"const":"authority_unavailable","type":"string"}]},"state":{"const":"unavailable","type":"string"}},"required":["state","reason"],"type":"object"},{"properties":{"missingCapabilities":{"items":{"type":"string"},"type":"array"},"state":{"const":"unauthorized","type":"string"}},"required":["state","missingCapabilities"],"type":"object"},{"properties":{"contractId":{"minLength":1,"type":"string"},"state":{"const":"unknown_contract","type":"string"}},"required":["state","contractId"],"type":"object"},{"properties":{"contractId":{"minLength":1,"type":"string"},"kind":{"minLength":1,"type":"string"},"state":{"const":"unknown_surface","type":"string"},"surface":{"minLength":1,"type":"string"}},"required":["state","contractId","kind","surface"],"type":"object"}]}},"required":["status"],"type":"object"}},"uses":{"required":{"health":{"contract":"trellis.health@v1","events":{"publish":["Health.Heartbeat"]}}}}} as TrellisContractV1;
+
+function assertSelectedKeysExist(
+  kind: "rpc" | "operations" | "events" | "feeds",
+  keys: readonly string[] | undefined,
+  api: Record<string, unknown>,
+) {
+  if (!keys) {
+    return;
+  }
+
+  for (const key of keys) {
+    if (!Object.hasOwn(api, key)) {
+      throw new Error(`Contract '${CONTRACT_ID}' does not expose ${kind} key '${key}'`);
+    }
+  }
+}
+
+function assertValidUseSpec(spec: UseSpec<typeof API.owned>) {
+  assertSelectedKeysExist("rpc", spec.rpc?.call, API.owned.rpc);
+  assertSelectedKeysExist("operations", spec.operations?.call, API.owned.operations);
+  assertSelectedKeysExist("events", spec.events?.publish, API.owned.events);
+  assertSelectedKeysExist("events", spec.events?.subscribe, API.owned.events);
+  assertSelectedKeysExist("feeds", spec.feeds?.subscribe, API.owned.feeds);
+}
+
+export const sdk: SdkContractModule<typeof CONTRACT_ID, typeof API.owned> = {
+  CONTRACT_ID,
+  CONTRACT_DIGEST,
+  CONTRACT,
+  API,
+  use: (<const TSpec extends UseSpec<typeof API.owned>>(spec: TSpec) => {
+    assertValidUseSpec(spec);
+
+    const dependencyUse = {
+      contract: CONTRACT_ID,
+      ...(spec.rpc?.call ? { rpc: { call: [...spec.rpc.call] } } : {}),
+      ...(spec.operations?.call ? { operations: { call: [...spec.operations.call] } } : {}),
+      ...((spec.events?.publish || spec.events?.subscribe)
+        ? {
+          events: {
+            ...(spec.events.publish ? { publish: [...spec.events.publish] } : {}),
+            ...(spec.events.subscribe ? { subscribe: [...spec.events.subscribe] } : {}),
+          },
+        }
+        : {}),
+      ...(spec.feeds?.subscribe ? { feeds: { subscribe: [...spec.feeds.subscribe] } } : {}),
+    };
+
+    Object.defineProperty(dependencyUse, CONTRACT_MODULE_METADATA, {
+      value: sdk,
+      enumerable: false,
+    });
+
+    return dependencyUse as ContractDependencyUse<typeof CONTRACT_ID, typeof API.owned, TSpec>;
+  }),
+};
+
+export const use = sdk.use;

package/src/sdk/_generated/core/mod.ts

@@ -0,0 +1,6 @@
+export { API, OWNED_API } from "./api.js";
+export type { Api, ApiViews, OwnedApi } from "./api.js";
+export * from "./types.js";
+export * from "./schemas.js";
+export type { Client, HandlerClient, TrellisCoreClient, TrellisCoreState } from "./client.js";
+export { CONTRACT, CONTRACT_DIGEST, CONTRACT_ID, use, sdk } from "./contract.js";

package/src/sdk/_generated/core/owned_api.ts

@@ -0,0 +1,51 @@
+// Generated from ./generated/contracts/manifests/trellis.core@v1.json
+import type { TrellisAPI } from "@qlever-llc/trellis/contracts";
+import { schema } from "@qlever-llc/trellis/contracts";
+import type * as Types from "./types.js";
+import { TrellisBindingsGetRequestSchema, TrellisBindingsGetResponseSchema, TrellisCatalogRequestSchema, TrellisCatalogResponseSchema, TrellisContractGetRequestSchema, TrellisContractGetResponseSchema, TrellisSurfaceStatusRequestSchema, TrellisSurfaceStatusResponseSchema } from "./schemas.js";
+
+export const OWNED_API = {
+  rpc: {
+    "Trellis.Bindings.Get": {
+      subject: "rpc.v1.Trellis.Bindings.Get",
+      input: schema<Types.TrellisBindingsGetInput>(TrellisBindingsGetRequestSchema),
+      output: schema<Types.TrellisBindingsGetOutput>(TrellisBindingsGetResponseSchema),
+      callerCapabilities: ["service"],
+      errors: ["UnexpectedError","ValidationError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError"] as const,
+    },
+    "Trellis.Catalog": {
+      subject: "rpc.v1.Trellis.Catalog",
+      input: schema<Types.TrellisCatalogInput>(TrellisCatalogRequestSchema),
+      output: schema<Types.TrellisCatalogOutput>(TrellisCatalogResponseSchema),
+      callerCapabilities: ["trellis.core::catalog.read"],
+      errors: ["UnexpectedError","ValidationError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError"] as const,
+    },
+    "Trellis.Contract.Get": {
+      subject: "rpc.v1.Trellis.Contract.Get",
+      input: schema<Types.TrellisContractGetInput>(TrellisContractGetRequestSchema),
+      output: schema<Types.TrellisContractGetOutput>(TrellisContractGetResponseSchema),
+      callerCapabilities: ["trellis.core::contract.read"],
+      errors: ["UnexpectedError","ValidationError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError"] as const,
+    },
+    "Trellis.Surface.Status": {
+      subject: "rpc.v1.Trellis.Surface.Status",
+      input: schema<Types.TrellisSurfaceStatusInput>(TrellisSurfaceStatusRequestSchema),
+      output: schema<Types.TrellisSurfaceStatusOutput>(TrellisSurfaceStatusResponseSchema),
+      callerCapabilities: ["trellis.core::catalog.read"],
+      errors: ["UnexpectedError","ValidationError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError"] as const,
+    },
+  },
+  operations: {
+  },
+  events: {
+  },
+  feeds: {
+  },
+  subjects: {
+  },
+} satisfies TrellisAPI;
+

package/src/sdk/_generated/core/schemas.ts

@@ -0,0 +1,17 @@
+// Generated from ./generated/contracts/manifests/trellis.core@v1.json
+export const TrellisBindingsGetRequestSchema = {"properties":{"contractId":{"minLength":1,"type":"string"},"digest":{"pattern":"^[A-Za-z0-9_-]+$","type":"string"}},"type":"object"} as const;
+
+export const TrellisBindingsGetResponseSchema = {"properties":{"binding":{"properties":{"contractId":{"minLength":1,"type":"string"},"digest":{"pattern":"^[A-Za-z0-9_-]+$","type":"string"},"resources":{"properties":{"eventConsumers":{"patternProperties":{"^.*$":{"properties":{"ackWaitMs":{"minimum":1,"type":"integer"},"backoffMs":{"items":{"minimum":0,"type":"integer"},"type":"array"},"concurrency":{"minimum":1,"type":"integer"},"consumerName":{"minLength":1,"type":"string"},"filterSubjects":{"items":{"minLength":1,"type":"string"},"type":"array"},"maxDeliver":{"minimum":1,"type":"integer"},"ordering":{"const":"strict","type":"string"},"replay":{"anyOf":[{"const":"new","type":"string"},{"const":"all","type":"string"}]},"stream":{"minLength":1,"type":"string"}},"required":["stream","consumerName","filterSubjects","replay","ordering","concurrency","ackWaitMs","maxDeliver","backoffMs"],"type":"object"}},"type":"object"},"jobs":{"properties":{"namespace":{"minLength":1,"type":"string"},"queues":{"patternProperties":{"^.*$":{"properties":{"ackWaitMs":{"minimum":1,"type":"integer"},"backoffMs":{"items":{"minimum":0,"type":"integer"},"type":"array"},"concurrency":{"minimum":1,"type":"integer"},"consumerName":{"minLength":1,"type":"string"},"defaultDeadlineMs":{"minimum":1,"type":"integer"},"dlq":{"type":"boolean"},"logs":{"type":"boolean"},"maxDeliver":{"minimum":1,"type":"integer"},"payload":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"},"progress":{"type":"boolean"},"publishPrefix":{"minLength":1,"type":"string"},"queueType":{"minLength":1,"type":"string"},"result":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"},"workSubject":{"minLength":1,"type":"string"}},"required":["queueType","publishPrefix","workSubject","consumerName","payload","maxDeliver","backoffMs","ackWaitMs","progress","logs","dlq","concurrency"],"type":"object"}},"type":"object"},"workStream":{"minLength":1,"type":"string"}},"required":["namespace","queues"],"type":"object"},"kv":{"patternProperties":{"^.*$":{"properties":{"bucket":{"minLength":1,"type":"string"},"history":{"minimum":1,"type":"integer"},"maxValueBytes":{"minimum":1,"type":"integer"},"ttlMs":{"minimum":0,"type":"integer"}},"required":["bucket","history","ttlMs"],"type":"object"}},"type":"object"},"store":{"patternProperties":{"^.*$":{"properties":{"maxObjectBytes":{"minimum":1,"type":"integer"},"maxTotalBytes":{"minimum":1,"type":"integer"},"name":{"minLength":1,"type":"string"},"ttlMs":{"minimum":0,"type":"integer"}},"required":["name","ttlMs"],"type":"object"}},"type":"object"}},"type":"object"}},"required":["contractId","digest","resources"],"type":"object"},"eventConsumers":{"patternProperties":{"^.*$":{"properties":{"ackWaitMs":{"minimum":1,"type":"integer"},"backoffMs":{"items":{"minimum":0,"type":"integer"},"type":"array"},"concurrency":{"minimum":1,"type":"integer"},"consumerName":{"minLength":1,"type":"string"},"filterSubjects":{"items":{"minLength":1,"type":"string"},"type":"array"},"maxDeliver":{"minimum":1,"type":"integer"},"ordering":{"const":"strict","type":"string"},"replay":{"anyOf":[{"const":"new","type":"string"},{"const":"all","type":"string"}]},"stream":{"minLength":1,"type":"string"}},"required":["stream","consumerName","filterSubjects","replay","ordering","concurrency","ackWaitMs","maxDeliver","backoffMs"],"type":"object"}},"type":"object"}},"type":"object"} as const;
+
+export const TrellisCatalogRequestSchema = {"properties":{},"type":"object"} as const;
+
+export const TrellisCatalogResponseSchema = {"properties":{"catalog":{"properties":{"contracts":{"items":{"properties":{"description":{"minLength":1,"type":"string"},"digest":{"type":"string"},"displayName":{"minLength":1,"type":"string"},"id":{"type":"string"}},"required":["id","digest","displayName","description"],"type":"object"},"type":"array"},"format":{"const":"trellis.catalog.v1","type":"string"},"issues":{"items":{"properties":{"actions":{"items":{"properties":{"action":{"anyOf":[{"const":"keep-current","type":"string"},{"const":"force-replace","type":"string"}]},"deploymentIds":{"items":{"type":"string"},"type":"array"},"description":{"minLength":1,"type":"string"},"digests":{"items":{"type":"string"},"type":"array"},"label":{"minLength":1,"type":"string"},"risk":{"anyOf":[{"const":"recommended","type":"string"},{"const":"dangerous","type":"string"}]}},"required":["action","label","description","risk","deploymentIds","digests"],"type":"object"},"type":"array"},"conflictingDeploymentIds":{"items":{"type":"string"},"type":"array"},"conflictingDigest":{"type":"string"},"conflictingDigests":{"items":{"type":"string"},"type":"array"},"contractId":{"type":"string"},"deploymentIds":{"items":{"type":"string"},"type":"array"},"digest":{"type":"string"},"effectiveDeploymentIds":{"items":{"type":"string"},"type":"array"},"effectiveDigests":{"items":{"type":"string"},"type":"array"},"issueId":{"minLength":1,"type":"string"},"kind":{"anyOf":[{"const":"missing-active-contract","type":"string"},{"const":"invalid-active-contract","type":"string"},{"const":"incompatible-active-contract","type":"string"},{"const":"invalid-active-contract-uses","type":"string"}]},"message":{"minLength":1,"type":"string"}},"required":["issueId","kind","message","deploymentIds","actions"],"type":"object"},"type":"array"}},"required":["format","contracts"],"type":"object"}},"required":["catalog"],"type":"object"} as const;
+
+export const TrellisContractGetRequestSchema = {"properties":{"digest":{"pattern":"^[A-Za-z0-9_-]+$","type":"string"}},"required":["digest"],"type":"object"} as const;
+
+export const TrellisContractGetResponseSchema = {"properties":{"contract":{"properties":{"description":{"minLength":1,"type":"string"},"displayName":{"minLength":1,"type":"string"},"docs":{"properties":{"markdown":{"type":"string"},"summary":{"type":"string"}},"required":["markdown"],"type":"object"},"errors":{"patternProperties":{"^.*$":{"type":"object"}},"type":"object"},"events":{"patternProperties":{"^.*$":{"type":"object"}},"type":"object"},"exports":{"properties":{"schemas":{"items":{"minLength":1,"type":"string"},"type":"array"}},"type":"object"},"format":{"const":"trellis.contract.v1","type":"string"},"id":{"minLength":1,"type":"string"},"jobs":{"patternProperties":{"^.*$":{"properties":{"ackWaitMs":{"minimum":1,"type":"integer"},"backoffMs":{"items":{"minimum":0,"type":"integer"},"type":"array"},"concurrency":{"minimum":1,"type":"integer"},"defaultDeadlineMs":{"minimum":1,"type":"integer"},"dlq":{"type":"boolean"},"docs":{"properties":{"markdown":{"type":"string"},"summary":{"type":"string"}},"required":["markdown"],"type":"object"},"logs":{"type":"boolean"},"maxDeliver":{"minimum":1,"type":"integer"},"payload":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"},"progress":{"type":"boolean"},"result":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"}},"required":["payload"],"type":"object"}},"type":"object"},"kind":{"anyOf":[{"const":"service","type":"string"},{"const":"app","type":"string"},{"const":"device","type":"string"},{"const":"agent","type":"string"}]},"operations":{"patternProperties":{"^.*$":{"type":"object"}},"type":"object"},"resources":{"additionalProperties":false,"properties":{"kv":{"patternProperties":{"^.*$":{"properties":{"docs":{"properties":{"markdown":{"type":"string"},"summary":{"type":"string"}},"required":["markdown"],"type":"object"},"history":{"default":1,"minimum":1,"type":"integer"},"maxValueBytes":{"minimum":1,"type":"integer"},"purpose":{"minLength":1,"type":"string"},"required":{"default":true,"type":"boolean"},"schema":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"},"ttlMs":{"default":0,"minimum":0,"type":"integer"}},"required":["purpose","schema"],"type":"object"}},"type":"object"},"store":{"patternProperties":{"^.*$":{"properties":{"docs":{"properties":{"markdown":{"type":"string"},"summary":{"type":"string"}},"required":["markdown"],"type":"object"},"maxObjectBytes":{"minimum":1,"type":"integer"},"maxTotalBytes":{"minimum":1,"type":"integer"},"purpose":{"minLength":1,"type":"string"},"required":{"default":true,"type":"boolean"},"ttlMs":{"default":0,"minimum":0,"type":"integer"}},"required":["purpose"],"type":"object"}},"type":"object"}},"type":"object"},"rpc":{"patternProperties":{"^.*$":{"type":"object"}},"type":"object"},"schemas":{"patternProperties":{"^.*$":{"anyOf":[{"type":"object"},{"type":"boolean"}]}},"type":"object"},"state":{"patternProperties":{"^.*$":{"properties":{"acceptedVersions":{"patternProperties":{"^.*$":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"}},"type":"object"},"docs":{"properties":{"markdown":{"type":"string"},"summary":{"type":"string"}},"required":["markdown"],"type":"object"},"kind":{"anyOf":[{"const":"value","type":"string"},{"const":"map","type":"string"}]},"schema":{"properties":{"schema":{"minLength":1,"type":"string"}},"required":["schema"],"type":"object"},"stateVersion":{"minLength":1,"type":"string"}},"required":["kind","schema"],"type":"object"}},"type":"object"},"uses":{"patternProperties":{"^.*$":{"type":"object"}},"type":"object"}},"required":["format","id","displayName","description","kind"],"type":"object"}},"required":["contract"],"type":"object"} as const;
+
+export const TrellisSurfaceStatusRequestSchema = {"properties":{"action":{"anyOf":[{"const":"call","type":"string"},{"const":"publish","type":"string"},{"const":"subscribe","type":"string"},{"const":"observe","type":"string"}]},"contractId":{"minLength":1,"type":"string"},"kind":{"anyOf":[{"const":"rpc","type":"string"},{"const":"operation","type":"string"},{"const":"event","type":"string"},{"const":"feed","type":"string"}]},"surface":{"minLength":1,"type":"string"}},"required":["contractId","kind","surface"],"type":"object"} as const;
+
+export const TrellisSurfaceStatusResponseSchema = {"properties":{"status":{"anyOf":[{"properties":{"liveImplementer":{"type":"boolean"},"runtime":{"anyOf":[{"const":"live","type":"string"},{"const":"no_live_implementer","type":"string"},{"const":"disabled","type":"string"}]},"state":{"const":"available","type":"string"}},"required":["state","liveImplementer","runtime"],"type":"object"},{"properties":{"reason":{"anyOf":[{"const":"authority_unavailable","type":"string"}]},"state":{"const":"unavailable","type":"string"}},"required":["state","reason"],"type":"object"},{"properties":{"missingCapabilities":{"items":{"type":"string"},"type":"array"},"state":{"const":"unauthorized","type":"string"}},"required":["state","missingCapabilities"],"type":"object"},{"properties":{"contractId":{"minLength":1,"type":"string"},"state":{"const":"unknown_contract","type":"string"}},"required":["state","contractId"],"type":"object"},{"properties":{"contractId":{"minLength":1,"type":"string"},"kind":{"minLength":1,"type":"string"},"state":{"const":"unknown_surface","type":"string"},"surface":{"minLength":1,"type":"string"}},"required":["state","contractId","kind","surface"],"type":"object"}]}},"required":["status"],"type":"object"} as const;
+

package/src/sdk/_generated/core/types.ts

@@ -0,0 +1,40 @@
+// Generated from ./generated/contracts/manifests/trellis.core@v1.json
+import type { RpcHandlerFn } from "@qlever-llc/trellis";
+import type { API } from "./api.js";
+
+export const CONTRACT_ID = "trellis.core@v1" as const;
+export const CONTRACT_DIGEST = "L4HW6uUIxDhK1Kpa_PUxpumoMberMgiCgJTNN5Qvje0" as const;
+
+export type TrellisBindingsGetInput = { contractId?: string; digest?: string; };
+export type TrellisBindingsGetOutput = { binding?: { contractId: string; digest: string; resources: { eventConsumers?: { [k: string]: { ackWaitMs: number; backoffMs: Array<number>; concurrency: number; consumerName: string; filterSubjects: Array<string>; maxDeliver: number; ordering: "strict"; replay: ("new" | "all"); stream: string; }; }; jobs?: { namespace: string; queues: { [k: string]: { ackWaitMs: number; backoffMs: Array<number>; concurrency: number; consumerName: string; defaultDeadlineMs?: number; dlq: boolean; logs: boolean; maxDeliver: number; payload: { schema: string; }; progress: boolean; publishPrefix: string; queueType: string; result?: { schema: string; }; workSubject: string; }; }; workStream?: string; }; kv?: { [k: string]: { bucket: string; history: number; maxValueBytes?: number; ttlMs: number; }; }; store?: { [k: string]: { maxObjectBytes?: number; maxTotalBytes?: number; name: string; ttlMs: number; }; }; }; }; eventConsumers?: { [k: string]: { ackWaitMs: number; backoffMs: Array<number>; concurrency: number; consumerName: string; filterSubjects: Array<string>; maxDeliver: number; ordering: "strict"; replay: ("new" | "all"); stream: string; }; }; };
+
+export type TrellisCatalogInput = {  };
+export type TrellisCatalogOutput = { catalog: { contracts: Array<{ description: string; digest: string; displayName: string; id: string; }>; format: "trellis.catalog.v1"; issues?: Array<{ actions: Array<{ action: ("keep-current" | "force-replace"); deploymentIds: Array<string>; description: string; digests: Array<string>; label: string; risk: ("recommended" | "dangerous"); }>; conflictingDeploymentIds?: Array<string>; conflictingDigest?: string; conflictingDigests?: Array<string>; contractId?: string; deploymentIds: Array<string>; digest?: string; effectiveDeploymentIds?: Array<string>; effectiveDigests?: Array<string>; issueId: string; kind: ("missing-active-contract" | "invalid-active-contract" | "incompatible-active-contract" | "invalid-active-contract-uses"); message: string; }>; }; };
+
+export type TrellisContractGetInput = { digest: string; };
+export type TrellisContractGetOutput = { contract: { description: string; displayName: string; docs?: { markdown: string; summary?: string; }; errors?: { [k: string]: {  }; }; events?: { [k: string]: {  }; }; exports?: { schemas?: Array<string>; }; format: "trellis.contract.v1"; id: string; jobs?: { [k: string]: { ackWaitMs?: number; backoffMs?: Array<number>; concurrency?: number; defaultDeadlineMs?: number; dlq?: boolean; docs?: { markdown: string; summary?: string; }; logs?: boolean; maxDeliver?: number; payload: { schema: string; }; progress?: boolean; result?: { schema: string; }; }; }; kind: ("service" | "app" | "device" | "agent"); operations?: { [k: string]: {  }; }; resources?: { kv?: { [k: string]: { docs?: { markdown: string; summary?: string; }; history?: number; maxValueBytes?: number; purpose: string; required?: boolean; schema: { schema: string; }; ttlMs?: number; }; }; store?: { [k: string]: { docs?: { markdown: string; summary?: string; }; maxObjectBytes?: number; maxTotalBytes?: number; purpose: string; required?: boolean; ttlMs?: number; }; }; }; rpc?: { [k: string]: {  }; }; schemas?: { [k: string]: ({  } | boolean); }; state?: { [k: string]: { acceptedVersions?: { [k: string]: { schema: string; }; }; docs?: { markdown: string; summary?: string; }; kind: ("value" | "map"); schema: { schema: string; }; stateVersion?: string; }; }; uses?: { [k: string]: {  }; }; }; };
+
+export type TrellisSurfaceStatusInput = { action?: ("call" | "publish" | "subscribe" | "observe"); contractId: string; kind: ("rpc" | "operation" | "event" | "feed"); surface: string; };
+export type TrellisSurfaceStatusOutput = { status: ({ liveImplementer: boolean; runtime: ("live" | "no_live_implementer" | "disabled"); state: "available"; } | { reason: ("authority_unavailable"); state: "unavailable"; } | { missingCapabilities: Array<string>; state: "unauthorized"; } | { contractId: string; state: "unknown_contract"; } | { contractId: string; kind: string; state: "unknown_surface"; surface: string; }); };
+
+export interface RpcMap {
+  "Trellis.Bindings.Get": { input: TrellisBindingsGetInput; output: TrellisBindingsGetOutput; };
+  "Trellis.Catalog": { input: TrellisCatalogInput; output: TrellisCatalogOutput; };
+  "Trellis.Contract.Get": { input: TrellisContractGetInput; output: TrellisContractGetOutput; };
+  "Trellis.Surface.Status": { input: TrellisSurfaceStatusInput; output: TrellisSurfaceStatusOutput; };
+}
+
+export type TrellisBindingsGetHandler = RpcHandlerFn<typeof API.owned, "Trellis.Bindings.Get">;
+export type TrellisCatalogHandler = RpcHandlerFn<typeof API.owned, "Trellis.Catalog">;
+export type TrellisContractGetHandler = RpcHandlerFn<typeof API.owned, "Trellis.Contract.Get">;
+export type TrellisSurfaceStatusHandler = RpcHandlerFn<typeof API.owned, "Trellis.Surface.Status">;
+
+export interface EventMap {
+}
+
+export interface FeedMap {
+}
+
+export interface SubjectMap {
+}
+

package/src/sdk/_generated/health/api.ts

@@ -0,0 +1,47 @@
+// Generated from ./generated/contracts/manifests/trellis.health@v1.json
+import { OWNED_API } from "./owned_api.js";
+
+export { OWNED_API };
+
+export type UsedApi = {
+  rpc: {
+  };
+  operations: {
+  };
+  events: {
+  };
+  feeds: {
+  };
+  subjects: {
+  };
+};
+
+export const USED_API: UsedApi = {
+  rpc: {
+  },
+  operations: {
+  },
+  events: {
+  },
+  feeds: {
+  },
+  subjects: {
+  },
+};
+
+export type OwnedApi = typeof OWNED_API;
+export type Api = {
+  rpc: OwnedApi["rpc"] & UsedApi["rpc"];
+  operations: OwnedApi["operations"] & UsedApi["operations"];
+  events: OwnedApi["events"] & UsedApi["events"];
+  feeds: OwnedApi["feeds"] & UsedApi["feeds"];
+  subjects: OwnedApi["subjects"] & UsedApi["subjects"];
+};
+
+export const API = {
+  owned: OWNED_API,
+  used: USED_API,
+} as const;
+
+export type ApiViews = typeof API;
+

package/src/sdk/_generated/health/client.ts

@@ -0,0 +1,45 @@
+// Generated from ./generated/contracts/manifests/trellis.health@v1.json
+import type { AcceptedOperation, AsyncResult, BaseError, EventOpts, FeedSubscribeOpts, FeedSubscription, HandlerTrellis, MapStateStoreClient, MaybeAsync, OperationInputBuilder, OperationObserverCallbacks, OperationRef, OperationRefData, OperationRuntimeHandle, PreparedTrellisEvent, ReceiveTransferGrant, ReceiveTransferHandle, RequestOpts, Result, RpcHandlerContext, SendTransferGrant, SendTransferHandle, TerminalOperation, TransferCapableOperationInputBuilder, TrellisConnection, UnexpectedError, ValidationError, ValueStateStoreClient } from "@qlever-llc/trellis";
+import type { API, Api } from "./api.js";
+import type * as Types from "./types.js";
+
+type EventCallback<TMessage> = {
+  bivarianceHack(message: TMessage): MaybeAsync<void, BaseError>;
+}["bivarianceHack"];
+
+type RpcHandler<TInput, TOutput> = (args: { input: TInput; context: RpcHandlerContext; client: HandlerClient }) => MaybeAsync<TOutput, BaseError>;
+
+export type TrellisHealthState = {};
+
+export interface TrellisHealthClient {
+  readonly name: string;
+  readonly timeout: number;
+  readonly stream: string;
+  readonly api: Api;
+  readonly state: TrellisHealthState;
+  readonly connection: TrellisConnection;
+  transfer(grant: SendTransferGrant): SendTransferHandle;
+  transfer(grant: ReceiveTransferGrant): ReceiveTransferHandle;
+  readonly rpc: {};
+  readonly event: {
+    readonly health: {
+      heartbeat: { publish(event: Omit<Types.HealthHeartbeatEvent, "header">): AsyncResult<void, ValidationError | UnexpectedError>; prepare(event: Omit<Types.HealthHeartbeatEvent, "header">): Result<PreparedTrellisEvent<Omit<Types.HealthHeartbeatEvent, "header">>, ValidationError | UnexpectedError>; listen(handler: EventCallback<Types.HealthHeartbeatEvent>, subjectData?: Record<string, unknown>, opts?: EventOpts): AsyncResult<void, ValidationError | UnexpectedError>; };
+    };
+  };
+  readonly feed: {};
+  readonly operation: {};
+  wait(): AsyncResult<void, BaseError>;
+}
+
+export interface Service extends Client {
+  readonly handle: ServiceHandle;
+}
+
+export interface ServiceHandle {
+  readonly rpc: {};
+  readonly feed: {};
+  readonly operation: {};
+}
+
+export type HandlerClient = HandlerTrellis<Api>;
+export type Client = TrellisHealthClient;

package/src/sdk/_generated/health/contract.ts

@@ -0,0 +1,67 @@
+// Generated from ./generated/contracts/manifests/trellis.health@v1.json
+import type { ContractDependencyUse, SdkContractModule, TrellisContractV1, UseSpec } from "@qlever-llc/trellis";
+import { API } from "./api.js";
+
+const CONTRACT_MODULE_METADATA = Symbol.for("@qlever-llc/trellis/contracts/contract-module");
+
+export const CONTRACT_ID = "trellis.health@v1" as const;
+export const CONTRACT_DIGEST = "RHDzeH2V6Nltzk6WklCLbTIK48hF0hNuO9Qk6-BosT4" as const;
+export const CONTRACT = {"description":"Expose shared Trellis heartbeat events for service observability.","displayName":"Trellis Health","docs":{"markdown":"Defines the heartbeat event services publish so operators can observe service liveness.","summary":"Service heartbeat events."},"events":{"Health.Heartbeat":{"docs":{"markdown":"Emitted by services to report runtime identity, uptime, and health metadata.","summary":"Publish service liveness."},"event":{"schema":"HealthHeartbeat"},"subject":"events.v1.Health.Heartbeat","version":"v1"}},"format":"trellis.contract.v1","id":"trellis.health@v1","kind":"service","schemas":{"HealthHeartbeat":{"properties":{"checks":{"items":{"properties":{"error":{"type":"string"},"info":{"patternProperties":{"^.*$":{}},"type":"object"},"latencyMs":{"type":"number"},"name":{"type":"string"},"status":{"anyOf":[{"const":"ok","type":"string"},{"const":"failed","type":"string"}]},"summary":{"type":"string"}},"required":["name","status","latencyMs"],"type":"object"},"type":"array"},"header":{"properties":{"id":{"type":"string"},"time":{"format":"date-time","type":"string"}},"required":["id","time"],"type":"object"},"service":{"properties":{"contractDigest":{"type":"string"},"contractId":{"type":"string"},"info":{"patternProperties":{"^.*$":{}},"type":"object"},"instanceId":{"type":"string"},"kind":{"anyOf":[{"const":"service","type":"string"},{"const":"device","type":"string"}]},"name":{"type":"string"},"publishIntervalMs":{"minimum":1,"type":"integer"},"runtime":{"anyOf":[{"const":"deno","type":"string"},{"const":"node","type":"string"},{"const":"rust","type":"string"},{"const":"unknown","type":"string"}]},"runtimeVersion":{"type":"string"},"startedAt":{"format":"date-time","type":"string"},"version":{"type":"string"}},"required":["name","kind","instanceId","contractId","contractDigest","startedAt","publishIntervalMs","runtime"],"type":"object"},"status":{"anyOf":[{"const":"healthy","type":"string"},{"const":"unhealthy","type":"string"},{"const":"degraded","type":"string"}]},"summary":{"type":"string"}},"required":["header","service","status","checks"],"type":"object"}}} as TrellisContractV1;
+
+function assertSelectedKeysExist(
+  kind: "rpc" | "operations" | "events" | "feeds",
+  keys: readonly string[] | undefined,
+  api: Record<string, unknown>,
+) {
+  if (!keys) {
+    return;
+  }
+
+  for (const key of keys) {
+    if (!Object.hasOwn(api, key)) {
+      throw new Error(`Contract '${CONTRACT_ID}' does not expose ${kind} key '${key}'`);
+    }
+  }
+}
+
+function assertValidUseSpec(spec: UseSpec<typeof API.owned>) {
+  assertSelectedKeysExist("rpc", spec.rpc?.call, API.owned.rpc);
+  assertSelectedKeysExist("operations", spec.operations?.call, API.owned.operations);
+  assertSelectedKeysExist("events", spec.events?.publish, API.owned.events);
+  assertSelectedKeysExist("events", spec.events?.subscribe, API.owned.events);
+  assertSelectedKeysExist("feeds", spec.feeds?.subscribe, API.owned.feeds);
+}
+
+export const sdk: SdkContractModule<typeof CONTRACT_ID, typeof API.owned> = {
+  CONTRACT_ID,
+  CONTRACT_DIGEST,
+  CONTRACT,
+  API,
+  use: (<const TSpec extends UseSpec<typeof API.owned>>(spec: TSpec) => {
+    assertValidUseSpec(spec);
+
+    const dependencyUse = {
+      contract: CONTRACT_ID,
+      ...(spec.rpc?.call ? { rpc: { call: [...spec.rpc.call] } } : {}),
+      ...(spec.operations?.call ? { operations: { call: [...spec.operations.call] } } : {}),
+      ...((spec.events?.publish || spec.events?.subscribe)
+        ? {
+          events: {
+            ...(spec.events.publish ? { publish: [...spec.events.publish] } : {}),
+            ...(spec.events.subscribe ? { subscribe: [...spec.events.subscribe] } : {}),
+          },
+        }
+        : {}),
+      ...(spec.feeds?.subscribe ? { feeds: { subscribe: [...spec.feeds.subscribe] } } : {}),
+    };
+
+    Object.defineProperty(dependencyUse, CONTRACT_MODULE_METADATA, {
+      value: sdk,
+      enumerable: false,
+    });
+
+    return dependencyUse as ContractDependencyUse<typeof CONTRACT_ID, typeof API.owned, TSpec>;
+  }),
+};
+
+export const use = sdk.use;

package/src/sdk/_generated/health/mod.ts

@@ -0,0 +1,6 @@
+export { API, OWNED_API } from "./api.js";
+export type { Api, ApiViews, OwnedApi } from "./api.js";
+export * from "./types.js";
+export * from "./schemas.js";
+export type { Client, HandlerClient, TrellisHealthClient, TrellisHealthState } from "./client.js";
+export { CONTRACT, CONTRACT_DIGEST, CONTRACT_ID, use, sdk } from "./contract.js";

package/src/sdk/_generated/health/owned_api.ts

@@ -0,0 +1,25 @@
+// Generated from ./generated/contracts/manifests/trellis.health@v1.json
+import type { TrellisAPI } from "@qlever-llc/trellis/contracts";
+import { schema } from "@qlever-llc/trellis/contracts";
+import type * as Types from "./types.js";
+import { HealthHeartbeatSchema } from "./schemas.js";
+
+export const OWNED_API = {
+  rpc: {
+  },
+  operations: {
+  },
+  events: {
+    "Health.Heartbeat": {
+      subject: "events.v1.Health.Heartbeat",
+      event: schema<Types.HealthHeartbeatEvent>(HealthHeartbeatSchema),
+      publishCapabilities: [],
+      subscribeCapabilities: [],
+    },
+  },
+  feeds: {
+  },
+  subjects: {
+  },
+} satisfies TrellisAPI;
+

package/src/sdk/_generated/health/schemas.ts

@@ -0,0 +1,3 @@
+// Generated from ./generated/contracts/manifests/trellis.health@v1.json
+export const HealthHeartbeatSchema = {"properties":{"checks":{"items":{"properties":{"error":{"type":"string"},"info":{"patternProperties":{"^.*$":{}},"type":"object"},"latencyMs":{"type":"number"},"name":{"type":"string"},"status":{"anyOf":[{"const":"ok","type":"string"},{"const":"failed","type":"string"}]},"summary":{"type":"string"}},"required":["name","status","latencyMs"],"type":"object"},"type":"array"},"header":{"properties":{"id":{"type":"string"},"time":{"format":"date-time","type":"string"}},"required":["id","time"],"type":"object"},"service":{"properties":{"contractDigest":{"type":"string"},"contractId":{"type":"string"},"info":{"patternProperties":{"^.*$":{}},"type":"object"},"instanceId":{"type":"string"},"kind":{"anyOf":[{"const":"service","type":"string"},{"const":"device","type":"string"}]},"name":{"type":"string"},"publishIntervalMs":{"minimum":1,"type":"integer"},"runtime":{"anyOf":[{"const":"deno","type":"string"},{"const":"node","type":"string"},{"const":"rust","type":"string"},{"const":"unknown","type":"string"}]},"runtimeVersion":{"type":"string"},"startedAt":{"format":"date-time","type":"string"},"version":{"type":"string"}},"required":["name","kind","instanceId","contractId","contractDigest","startedAt","publishIntervalMs","runtime"],"type":"object"},"status":{"anyOf":[{"const":"healthy","type":"string"},{"const":"unhealthy","type":"string"},{"const":"degraded","type":"string"}]},"summary":{"type":"string"}},"required":["header","service","status","checks"],"type":"object"} as const;
+

package/src/sdk/_generated/health/types.ts

@@ -0,0 +1,19 @@
+// Generated from ./generated/contracts/manifests/trellis.health@v1.json
+export const CONTRACT_ID = "trellis.health@v1" as const;
+export const CONTRACT_DIGEST = "RHDzeH2V6Nltzk6WklCLbTIK48hF0hNuO9Qk6-BosT4" as const;
+
+export type HealthHeartbeatEvent = { checks: Array<{ error?: string; info?: { [k: string]: unknown; }; latencyMs: number; name: string; status: ("ok" | "failed"); summary?: string; }>; header: { id: string; time: string; }; service: { contractDigest: string; contractId: string; info?: { [k: string]: unknown; }; instanceId: string; kind: ("service" | "device"); name: string; publishIntervalMs: number; runtime: ("deno" | "node" | "rust" | "unknown"); runtimeVersion?: string; startedAt: string; version?: string; }; status: ("healthy" | "unhealthy" | "degraded"); summary?: string; };
+
+export interface RpcMap {
+}
+
+export interface EventMap {
+  "Health.Heartbeat": { event: HealthHeartbeatEvent; };
+}
+
+export interface FeedMap {
+}
+
+export interface SubjectMap {
+}
+

package/src/sdk/_generated/jobs/api.ts

@@ -0,0 +1,58 @@
+// Generated from ./generated/contracts/manifests/trellis.jobs@v1.json
+import { OWNED_API } from "./owned_api.js";
+import { OWNED_API as AuthApi } from "../../auth.js";
+import { OWNED_API as CoreApi } from "../../core.js";
+import { OWNED_API as HealthApi } from "../../health.js";
+
+export { OWNED_API };
+
+export type UsedApi = {
+  rpc: {
+    readonly "Auth.Requests.Validate": typeof AuthApi.rpc["Auth.Requests.Validate"];
+    readonly "Trellis.Bindings.Get": typeof CoreApi.rpc["Trellis.Bindings.Get"];
+    readonly "Trellis.Catalog": typeof CoreApi.rpc["Trellis.Catalog"];
+  };
+  operations: {
+  };
+  events: {
+    readonly "Health.Heartbeat": typeof HealthApi.events["Health.Heartbeat"];
+  };
+  feeds: {
+  };
+  subjects: {
+  };
+};
+
+export const USED_API: UsedApi = {
+  rpc: {
+    get "Auth.Requests.Validate"() { return AuthApi.rpc["Auth.Requests.Validate"]; },
+    get "Trellis.Bindings.Get"() { return CoreApi.rpc["Trellis.Bindings.Get"]; },
+    get "Trellis.Catalog"() { return CoreApi.rpc["Trellis.Catalog"]; },
+  },
+  operations: {
+  },
+  events: {
+    get "Health.Heartbeat"() { return HealthApi.events["Health.Heartbeat"]; },
+  },
+  feeds: {
+  },
+  subjects: {
+  },
+};
+
+export type OwnedApi = typeof OWNED_API;
+export type Api = {
+  rpc: OwnedApi["rpc"] & UsedApi["rpc"];
+  operations: OwnedApi["operations"] & UsedApi["operations"];
+  events: OwnedApi["events"] & UsedApi["events"];
+  feeds: OwnedApi["feeds"] & UsedApi["feeds"];
+  subjects: OwnedApi["subjects"] & UsedApi["subjects"];
+};
+
+export const API = {
+  owned: OWNED_API,
+  used: USED_API,
+} as const;
+
+export type ApiViews = typeof API;
+