@vibesdotdev/infra-core 0.0.2 → 1.0.0-rc.11

package/dist/kinds/artifact.kind.d.ts

@@ -14,6 +14,7 @@
  * 4. Implementation returns artifact content (format determined by impl)
  */
 import * as z from 'zod/v4';
+import { type RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
 /**
  * Minimal base schema for artifact descriptors.
  *
@@ -28,10 +29,43 @@ declare const ArtifactBaseSchema: z.ZodObject<{
     hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
     priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
     requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
     optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
     kind: z.ZodLiteral<"infra/artifact">;
+    format: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** What a generator is handed: where outputs go, the resources it may read, and its own descriptor. */
+export interface ArtifactGenerationContext {
+    /** Output directory for generated artifacts. */
+    outputDir: string;
+    /** Resource descriptors the generator may read. */
+    resources: RuntimeDescriptor[];
+    /** The generator's own descriptor. */
+    descriptor: RuntimeDescriptor;
+}
+/** Facts a generator reports about one output: JSON values only. */
+export declare const ArtifactMetadataSchema: z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+export type ArtifactMetadata = z.infer<typeof ArtifactMetadataSchema>;
+/** One generated output as the generate surface reads it: text or bytes, a name and a path. */
+export declare const ArtifactOutputSchema: z.ZodObject<{
+    content: z.ZodUnion<readonly [z.ZodString, z.ZodInstanceOf<Uint8Array<ArrayBuffer>>]>;
+    filename: z.ZodString;
+    path: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
 }, z.core.$strip>;
 /**
  * Generic artifact generator interface.
@@ -42,10 +76,10 @@ export interface ArtifactGenerator {
     /**
      * Generate artifact content.
      *
-     * @param options - Implementation-specific options (descriptor, context, etc.)
+     * @param context - Where outputs go, the readable resources and the generator's descriptor.
      * @returns Generated artifact (content + metadata)
      */
-    generate(options?: unknown): Promise<ArtifactOutput>;
+    generate(context?: ArtifactGenerationContext): Promise<ArtifactOutput>;
 }
 /**
  * Generated artifact output (generic shape).
@@ -53,14 +87,14 @@ export interface ArtifactGenerator {
  * Implementations may return more specific types.
  */
 export interface ArtifactOutput {
-    /** Generated content (string for text formats, Buffer for binary) */
-    content: string | Buffer;
+    /** Generated content (string for text formats, bytes for binary) */
+    content: string | Uint8Array;
     /** Recommended filename (including extension) */
     filename: string;
     /** Full output path */
     path: string;
     /** Optional metadata */
-    metadata?: Record<string, unknown>;
+    metadata?: ArtifactMetadata;
 }
 /**
  * Artifact descriptor type (base shape, implementations extend)
@@ -77,10 +111,24 @@ export declare const ArtifactDescriptorSchema: z.ZodObject<{
     hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
     priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
     requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
     optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
     kind: z.ZodLiteral<"infra/artifact">;
+    format: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * Artifact kind descriptor for runtime registration.
@@ -89,8 +137,8 @@ export declare const ArtifactDescriptorSchema: z.ZodObject<{
  * their own implementations via runtime plugins.
  */
 declare class NoOpArtifactImplementation implements ArtifactGenerator {
-    generate(options?: unknown): Promise<ArtifactOutput>;
+    generate(): Promise<ArtifactOutput>;
 }
-export declare const artifactKind: import("@vibesdotdev/runtime/schemas/kind").RuntimeKindDescriptorRecord<NoOpArtifactImplementation>;
-export { INFRA_DISCOVERY_PATTERN, extractStem } from './discovery.ts';
+export declare const artifactKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<NoOpArtifactImplementation>;
+export { INFRA_DISCOVERY_PATTERNS } from './discovery.ts';
 //# sourceMappingURL=artifact.kind.d.ts.map

package/dist/kinds/artifact.kind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifact.kind.d.ts","sourceRoot":"","sources":["../../src/kinds/artifact.kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAM5B;;;;;GAKG;AACH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;iBAEtB,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACrD;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,qEAAqE;IACrE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;iBAAqB,CAAC;AAE3D;;;;;GAKG;AACH,cAAM,0BAA2B,YAAW,iBAAiB;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;CAK1D;AAED,eAAO,MAAM,YAAY,qGAMvB,CAAC;AAGH,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"artifact.kind.d.ts","sourceRoot":"","sources":["../../src/kinds/artifact.kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAGzG;;;;;GAKG;AACH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMtB,CAAC;AAEH,uGAAuG;AACvG,MAAM,WAAW,yBAAyB;IACzC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,sCAAsC;IACtC,UAAU,EAAE,iBAAiB,CAAC;CAC9B;AAED,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,2QAAwC,CAAC;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACvE;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,oEAAoE;IACpE,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAqB,CAAC;AAE3D;;;;;GAKG;AACH,cAAM,0BAA2B,YAAW,iBAAiB;IACtD,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;CAMzC;AAED,eAAO,MAAM,YAAY,uFAKvB,CAAC;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/kinds/artifact.kind.js

@@ -14,9 +14,11 @@
  * 4. Implementation returns artifact content (format determined by impl)
  */
 import * as z from 'zod/v4';
-import { createRuntimeKind } from '@vibesdotdev/runtime/factory/kind';
-import { RuntimeDescriptorSchema } from '@vibesdotdev/runtime/schemas/descriptor';
-import { INFRA_DISCOVERY_PATTERN, extractStem } from "./discovery.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { createRuntimeKind } from '@vibesdotdev/kernel/factory/kind';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+import { INFRA_DISCOVERY_PATTERNS } from "./discovery.js";
 /**
  * Minimal base schema for artifact descriptors.
  *
@@ -24,7 +26,20 @@ import { INFRA_DISCOVERY_PATTERN, extractStem } from "./discovery.js";
  * output format, generation options, etc.).
  */
 const ArtifactBaseSchema = RuntimeDescriptorSchema.extend({
-    kind: z.literal('infra/artifact')
+    kind: z.literal('infra/artifact'),
+    /** The output format the generator produces (e.g. `yaml`, `jsonc`); `vibes infra generate --format` filters on it. */
+    format: z.string().min(1).optional(),
+    /** The resource kind the generator reads (e.g. `infra/worker`). */
+    source: z.object({ kind: z.string().min(1) }).optional()
+});
+/** Facts a generator reports about one output: JSON values only. */
+export const ArtifactMetadataSchema = z.record(z.string(), JsonValueSchema);
+/** One generated output as the generate surface reads it: text or bytes, a name and a path. */
+export const ArtifactOutputSchema = z.object({
+    content: z.union([z.string(), z.instanceof(Uint8Array)]),
+    filename: z.string().min(1),
+    path: z.string().min(1),
+    metadata: ArtifactMetadataSchema.optional()
 });
 /**
  * Artifact descriptor schema
@@ -37,17 +52,19 @@ export const ArtifactDescriptorSchema = ArtifactBaseSchema;
  * their own implementations via runtime plugins.
  */
 class NoOpArtifactImplementation {
-    async generate(options) {
-        throw new Error('No artifact generator registered. Adapter plugins (infra-kubernetes, infra-helm, etc.) must register implementations.');
+    async generate() {
+        throw new CapabilityError('No artifact generator is registered for this descriptor.', 'UNAVAILABLE', {
+            reason: 'artifact-generator-unregistered',
+            recoveryHint: 'Adapter plugins (infra-kubernetes, infra-helm, etc.) must register implementations.'
+        });
     }
 }
 export const artifactKind = createRuntimeKind({
     id: 'infra/artifact',
     descriptorSchema: ArtifactDescriptorSchema,
     defaultImplementation: NoOpArtifactImplementation,
-    discoveryPattern: INFRA_DISCOVERY_PATTERN,
-    extractStem
+    discoveryPatterns: INFRA_DISCOVERY_PATTERNS
 });
 // Re-export discovery helpers
-export { INFRA_DISCOVERY_PATTERN, extractStem } from "./discovery.js";
+export { INFRA_DISCOVERY_PATTERNS } from "./discovery.js";
 //# sourceMappingURL=artifact.kind.js.map

package/dist/kinds/artifact.kind.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifact.kind.js","sourceRoot":"","sources":["../../src/kinds/artifact.kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAElF,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACzD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;CACjC,CAAC,CAAC;AAsCH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,0BAA0B;IAC/B,KAAK,CAAC,QAAQ,CAAC,OAAiB;QAC/B,MAAM,IAAI,KAAK,CACd,uHAAuH,CACvH,CAAC;IACH,CAAC;CACD;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,iBAAiB,CAAiD;IAC7F,EAAE,EAAE,gBAAgB;IACpB,gBAAgB,EAAE,wBAAwB;IAC1C,qBAAqB,EAAE,0BAA0B;IACjD,gBAAgB,EAAE,uBAAuB;IACzC,WAAW;CACX,CAAC,CAAC;AAEH,8BAA8B;AAC9B,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"artifact.kind.js","sourceRoot":"","sources":["../../src/kinds/artifact.kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAA0B,MAAM,wCAAwC,CAAC;AACzG,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACzD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,sHAAsH;IACtH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpC,mEAAmE;IACnE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAC;AAYH,oEAAoE;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;AAG5E,+FAA+F;AAC/F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IACxD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAsCH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,0BAA0B;IAC/B,KAAK,CAAC,QAAQ;QACb,MAAM,IAAI,eAAe,CAAC,0DAA0D,EAAE,aAAa,EAAE;YACpG,MAAM,EAAE,iCAAiC;YACzC,YAAY,EAAE,qFAAqF;SACnG,CAAC,CAAC;IACJ,CAAC;CACD;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,iBAAiB,CAAiD;IAC7F,EAAE,EAAE,gBAAgB;IACpB,gBAAgB,EAAE,wBAAwB;IAC1C,qBAAqB,EAAE,0BAA0B;IACjD,iBAAiB,EAAE,wBAAwB;CAC3C,CAAC,CAAC;AAEH,8BAA8B;AAC9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/kinds/billing.kind.d.ts

@@ -0,0 +1,88 @@
+/** Provider-neutral read-only account economics. */
+import * as z from 'zod/v4';
+import type { RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+export declare const BillingMoneySchema: z.ZodObject<{
+    currency: z.ZodString;
+    amount: z.ZodString;
+}, z.core.$strip>;
+export declare const BillingSummarySchema: z.ZodObject<{
+    provider: z.ZodString;
+    collectedAt: z.ZodISODateTime;
+    accountBalance: z.ZodOptional<z.ZodObject<{
+        currency: z.ZodString;
+        amount: z.ZodString;
+    }, z.core.$strip>>;
+    monthToDateUsage: z.ZodOptional<z.ZodObject<{
+        currency: z.ZodString;
+        amount: z.ZodString;
+    }, z.core.$strip>>;
+    monthToDateBalance: z.ZodOptional<z.ZodObject<{
+        currency: z.ZodString;
+        amount: z.ZodString;
+    }, z.core.$strip>>;
+    grossProductCharges: z.ZodOptional<z.ZodObject<{
+        currency: z.ZodString;
+        amount: z.ZodString;
+    }, z.core.$strip>>;
+    invoiceCreditsAndAdjustments: z.ZodOptional<z.ZodObject<{
+        currency: z.ZodString;
+        amount: z.ZodString;
+    }, z.core.$strip>>;
+    sponsorshipCredits: z.ZodObject<{
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            available: "available";
+            unsupported: "unsupported";
+        }>;
+        remaining: z.ZodOptional<z.ZodObject<{
+            currency: z.ZodString;
+            amount: z.ZodString;
+        }, z.core.$strip>>;
+        expiresAt: z.ZodOptional<z.ZodISODateTime>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    errors: z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BillingSummary = z.infer<typeof BillingSummarySchema>;
+export declare const BillingDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"infra/billing">;
+    provider: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BillingDescriptor = z.infer<typeof BillingDescriptorSchema>;
+export interface BillingImplementation {
+    summary(): Promise<BillingSummary>;
+}
+declare class DefaultBillingImplementation {
+    readonly descriptor: RuntimeDescriptor;
+    readonly context: KindContext;
+    /** The descriptor as this kind's schema reads it. */
+    readonly config: BillingDescriptor;
+    constructor(descriptor: RuntimeDescriptor, context: KindContext);
+}
+export declare const billingKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<DefaultBillingImplementation>;
+export {};
+//# sourceMappingURL=billing.kind.d.ts.map

package/dist/kinds/billing.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.kind.d.ts","sourceRoot":"","sources":["../../src/kinds/billing.kind.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAGpE,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;iBAGlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,WAAW,qBAAqB;IACrC,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CACnC;AACD,cAAM,4BAA4B;aAIhB,UAAU,EAAE,iBAAiB;aAC7B,OAAO,EAAE,WAAW;IAJrC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;gBAElB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,WAAW;CAIrC;AACD,eAAO,MAAM,WAAW,yFAKtB,CAAC"}

package/dist/kinds/billing.kind.js

@@ -0,0 +1,48 @@
+/** Provider-neutral read-only account economics. */
+import * as z from 'zod/v4';
+import { createRuntimeKind } from '@vibesdotdev/kernel/factory/kind';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+import { readKindDescriptor } from "./read-descriptor.js";
+import { INFRA_DISCOVERY_PATTERNS } from "./discovery.js";
+export const BillingMoneySchema = z.object({
+    currency: z.string().regex(/^[A-Z]{3}$/, 'currency must be an ISO 4217-style code'),
+    amount: z.string().regex(/^-?\d+(?:\.\d+)?$/, 'amount must be a decimal string')
+});
+export const BillingSummarySchema = z.object({
+    provider: z.string().min(1),
+    collectedAt: z.iso.datetime({ offset: true }),
+    accountBalance: BillingMoneySchema.optional(),
+    monthToDateUsage: BillingMoneySchema.optional(),
+    monthToDateBalance: BillingMoneySchema.optional(),
+    grossProductCharges: BillingMoneySchema.optional(),
+    invoiceCreditsAndAdjustments: BillingMoneySchema.optional(),
+    sponsorshipCredits: z.object({
+        status: z.enum(['available', 'unknown', 'unsupported']),
+        remaining: BillingMoneySchema.optional(),
+        expiresAt: z.iso.datetime({ offset: true }).optional(),
+        reason: z.string().optional()
+    }),
+    errors: z.array(z.object({ source: z.string(), message: z.string() }))
+});
+export const BillingDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('infra/billing'),
+    provider: z.string().min(1).optional()
+});
+class DefaultBillingImplementation {
+    descriptor;
+    context;
+    /** The descriptor as this kind's schema reads it. */
+    config;
+    constructor(descriptor, context) {
+        this.descriptor = descriptor;
+        this.context = context;
+        this.config = readKindDescriptor(BillingDescriptorSchema, descriptor);
+    }
+}
+export const billingKind = createRuntimeKind({
+    id: 'infra/billing',
+    descriptorSchema: BillingDescriptorSchema,
+    defaultImplementation: DefaultBillingImplementation,
+    discoveryPatterns: INFRA_DISCOVERY_PATTERNS
+});
+//# sourceMappingURL=billing.kind.js.map

package/dist/kinds/billing.kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.kind.js","sourceRoot":"","sources":["../../src/kinds/billing.kind.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAGjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,yCAAyC,CAAC;IACnF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,iCAAiC,CAAC;CAChF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC7C,cAAc,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAC7C,gBAAgB,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAC/C,kBAAkB,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACjD,mBAAmB,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAClD,4BAA4B,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAC3D,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC;QAC5B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QACvD,SAAS,EAAE,kBAAkB,CAAC,QAAQ,EAAE;QACxC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;QACtD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC7B,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACrE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAKH,MAAM,4BAA4B;IAIhB;IACA;IAJjB,qDAAqD;IAC5C,MAAM,CAAoB;IACnC,YACiB,UAA6B,EAC7B,OAAoB;QADpB,eAAU,GAAV,UAAU,CAAmB;QAC7B,YAAO,GAAP,OAAO,CAAa;QAEpC,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;CACD;AACD,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAkD;IAC7F,EAAE,EAAE,eAAe;IACnB,gBAAgB,EAAE,uBAAuB;IACzC,qBAAqB,EAAE,4BAA4B;IACnD,iBAAiB,EAAE,wBAAwB;CAC3C,CAAC,CAAC"}