@treeseed/sdk 0.13.0-rc.64 → 0.13.0-rc.66

package/dist/capacity-provider/capability-ontology.d.ts

@@ -637,14 +637,14 @@ export declare const capabilityDemandSchema: z.ZodObject<{
             requirement: "required" | "preferred";
             value?: unknown;
         }>;
-        capabilityId: string;
         requirement: "required" | "preferred";
+        capabilityId: string;
         versionRange: string;
         alternativeGroup: string | null;
         requiredFeatures: string[];
     }, {
-        capabilityId: string;
         requirement: "required" | "preferred";
+        capabilityId: string;
         versionRange: string;
         configuration?: Record<string, {
             requirement: "required" | "preferred";
@@ -711,8 +711,8 @@ export declare const capabilityDemandSchema: z.ZodObject<{
             requirement: "required" | "preferred";
             value?: unknown;
         }>;
-        capabilityId: string;
         requirement: "required" | "preferred";
+        capabilityId: string;
         versionRange: string;
         alternativeGroup: string | null;
         requiredFeatures: string[];
@@ -741,8 +741,8 @@ export declare const capabilityDemandSchema: z.ZodObject<{
     contextModes: string[];
     ontologyGeneration: number;
     requirements: {
-        capabilityId: string;
         requirement: "required" | "preferred";
+        capabilityId: string;
         versionRange: string;
         configuration?: Record<string, {
             requirement: "required" | "preferred";
@@ -859,8 +859,130 @@ export declare const capabilityConformanceSchema: z.ZodObject<{
     tier: "signed-attestation" | "automated-suite" | "reviewed-certification";
     evidenceDigest: string;
 }>;
+export declare const providerContextCapacitySchema: z.ZodEffects<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+    mode: z.ZodLiteral<"bounded">;
+    measurement: z.ZodEnum<["tokens", "bytes", "items"]>;
+    defaultInitial: z.ZodNumber;
+    maximum: z.ZodNumber;
+    reservedOutput: z.ZodDefault<z.ZodNumber>;
+    transportPayloadBytes: z.ZodNumber;
+    measurementProvenance: z.ZodObject<{
+        provider: z.ZodString;
+        implementation: z.ZodString;
+        version: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    }, {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    maximum: number;
+    mode: "bounded";
+    measurement: "items" | "tokens" | "bytes";
+    defaultInitial: number;
+    reservedOutput: number;
+    transportPayloadBytes: number;
+    measurementProvenance: {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    };
+}, {
+    maximum: number;
+    mode: "bounded";
+    measurement: "items" | "tokens" | "bytes";
+    defaultInitial: number;
+    transportPayloadBytes: number;
+    measurementProvenance: {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    };
+    reservedOutput?: number | undefined;
+}>, z.ZodObject<{
+    mode: z.ZodLiteral<"unbounded">;
+    measurement: z.ZodDefault<z.ZodNullable<z.ZodEnum<["tokens", "bytes", "items"]>>>;
+    transportPayloadBytes: z.ZodNumber;
+    measurementProvenance: z.ZodObject<{
+        provider: z.ZodString;
+        implementation: z.ZodString;
+        version: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    }, {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    mode: "unbounded";
+    measurement: "items" | "tokens" | "bytes" | null;
+    transportPayloadBytes: number;
+    measurementProvenance: {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    };
+}, {
+    mode: "unbounded";
+    transportPayloadBytes: number;
+    measurementProvenance: {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    };
+    measurement?: "items" | "tokens" | "bytes" | null | undefined;
+}>]>, {
+    maximum: number;
+    mode: "bounded";
+    measurement: "items" | "tokens" | "bytes";
+    defaultInitial: number;
+    reservedOutput: number;
+    transportPayloadBytes: number;
+    measurementProvenance: {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    };
+} | {
+    mode: "unbounded";
+    measurement: "items" | "tokens" | "bytes" | null;
+    transportPayloadBytes: number;
+    measurementProvenance: {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    };
+}, {
+    maximum: number;
+    mode: "bounded";
+    measurement: "items" | "tokens" | "bytes";
+    defaultInitial: number;
+    transportPayloadBytes: number;
+    measurementProvenance: {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    };
+    reservedOutput?: number | undefined;
+} | {
+    mode: "unbounded";
+    transportPayloadBytes: number;
+    measurementProvenance: {
+        version: string | null;
+        provider: string;
+        implementation: string;
+    };
+    measurement?: "items" | "tokens" | "bytes" | null | undefined;
+}>;
 export declare const capabilityOfferSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<"treeseed.capability-offer/v1">;
+    schemaVersion: z.ZodLiteral<"treeseed.capability-offer/v2">;
     offerId: z.ZodString;
     capabilities: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -1010,6 +1132,128 @@ export declare const capabilityOfferSchema: z.ZodObject<{
         tier: "signed-attestation" | "automated-suite" | "reviewed-certification";
         evidenceDigest: string;
     }>, "many">;
+    contextCapacity: z.ZodEffects<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"bounded">;
+        measurement: z.ZodEnum<["tokens", "bytes", "items"]>;
+        defaultInitial: z.ZodNumber;
+        maximum: z.ZodNumber;
+        reservedOutput: z.ZodDefault<z.ZodNumber>;
+        transportPayloadBytes: z.ZodNumber;
+        measurementProvenance: z.ZodObject<{
+            provider: z.ZodString;
+            implementation: z.ZodString;
+            version: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        }, {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        maximum: number;
+        mode: "bounded";
+        measurement: "items" | "tokens" | "bytes";
+        defaultInitial: number;
+        reservedOutput: number;
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+    }, {
+        maximum: number;
+        mode: "bounded";
+        measurement: "items" | "tokens" | "bytes";
+        defaultInitial: number;
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+        reservedOutput?: number | undefined;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"unbounded">;
+        measurement: z.ZodDefault<z.ZodNullable<z.ZodEnum<["tokens", "bytes", "items"]>>>;
+        transportPayloadBytes: z.ZodNumber;
+        measurementProvenance: z.ZodObject<{
+            provider: z.ZodString;
+            implementation: z.ZodString;
+            version: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        }, {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        mode: "unbounded";
+        measurement: "items" | "tokens" | "bytes" | null;
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+    }, {
+        mode: "unbounded";
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+        measurement?: "items" | "tokens" | "bytes" | null | undefined;
+    }>]>, {
+        maximum: number;
+        mode: "bounded";
+        measurement: "items" | "tokens" | "bytes";
+        defaultInitial: number;
+        reservedOutput: number;
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+    } | {
+        mode: "unbounded";
+        measurement: "items" | "tokens" | "bytes" | null;
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+    }, {
+        maximum: number;
+        mode: "bounded";
+        measurement: "items" | "tokens" | "bytes";
+        defaultInitial: number;
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+        reservedOutput?: number | undefined;
+    } | {
+        mode: "unbounded";
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+        measurement?: "items" | "tokens" | "bytes" | null | undefined;
+    }>;
     limits: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     commercial: z.ZodObject<{
         currency: z.ZodNullable<z.ZodString>;
@@ -1025,7 +1269,7 @@ export declare const capabilityOfferSchema: z.ZodObject<{
     trust: z.ZodArray<z.ZodString, "many">;
     offerDigest: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    schemaVersion: "treeseed.capability-offer/v1";
+    schemaVersion: "treeseed.capability-offer/v2";
     capabilities: {
         id: string;
         version: string;
@@ -1076,6 +1320,28 @@ export declare const capabilityOfferSchema: z.ZodObject<{
         tier: "signed-attestation" | "automated-suite" | "reviewed-certification";
         evidenceDigest: string;
     }[];
+    contextCapacity: {
+        maximum: number;
+        mode: "bounded";
+        measurement: "items" | "tokens" | "bytes";
+        defaultInitial: number;
+        reservedOutput: number;
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+    } | {
+        mode: "unbounded";
+        measurement: "items" | "tokens" | "bytes" | null;
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+    };
     limits: Record<string, unknown>;
     commercial: {
         currency: string | null;
@@ -1084,7 +1350,7 @@ export declare const capabilityOfferSchema: z.ZodObject<{
     region: string | null;
     offerDigest: string;
 }, {
-    schemaVersion: "treeseed.capability-offer/v1";
+    schemaVersion: "treeseed.capability-offer/v2";
     capabilities: {
         id: string;
         version: string;
@@ -1135,6 +1401,28 @@ export declare const capabilityOfferSchema: z.ZodObject<{
         tier: "signed-attestation" | "automated-suite" | "reviewed-certification";
         evidenceDigest: string;
     }[];
+    contextCapacity: {
+        maximum: number;
+        mode: "bounded";
+        measurement: "items" | "tokens" | "bytes";
+        defaultInitial: number;
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+        reservedOutput?: number | undefined;
+    } | {
+        mode: "unbounded";
+        transportPayloadBytes: number;
+        measurementProvenance: {
+            version: string | null;
+            provider: string;
+            implementation: string;
+        };
+        measurement?: "items" | "tokens" | "bytes" | null | undefined;
+    };
     limits: Record<string, unknown>;
     commercial: {
         currency: string | null;
@@ -1203,4 +1491,5 @@ export type CapabilityOntology = z.infer<typeof capabilityOntologySchema>;
 export type CapabilityDemand = z.infer<typeof capabilityDemandSchema>;
 export type CapabilityOffer = z.infer<typeof capabilityOfferSchema>;
 export type CapabilityConformance = z.infer<typeof capabilityConformanceSchema>;
+export type ProviderContextCapacity = z.infer<typeof providerContextCapacitySchema>;
 export type CapabilityNegotiationReceipt = z.infer<typeof capabilityNegotiationReceiptSchema>;

package/dist/capacity-provider/capability-ontology.js

@@ -77,8 +77,28 @@ const capabilityConformanceSchema = z.object({
   expiresAt: z.string().datetime().nullable(),
   signature: z.object({ keyId: identifier, algorithm: z.literal("Ed25519"), value: z.string().min(1) }).strict()
 }).strict();
+const providerContextCapacitySchema = z.discriminatedUnion("mode", [
+  z.object({
+    mode: z.literal("bounded"),
+    measurement: z.enum(["tokens", "bytes", "items"]),
+    defaultInitial: z.number().int().positive(),
+    maximum: z.number().int().positive(),
+    reservedOutput: z.number().int().nonnegative().default(0),
+    transportPayloadBytes: z.number().int().positive(),
+    measurementProvenance: z.object({ provider: identifier, implementation: z.string().min(1), version: z.string().min(1).nullable() }).strict()
+  }).strict(),
+  z.object({
+    mode: z.literal("unbounded"),
+    measurement: z.enum(["tokens", "bytes", "items"]).nullable().default(null),
+    transportPayloadBytes: z.number().int().positive(),
+    measurementProvenance: z.object({ provider: identifier, implementation: z.string().min(1), version: z.string().min(1).nullable() }).strict()
+  }).strict()
+]).superRefine((value, context) => {
+  if (value.mode === "bounded" && value.defaultInitial > value.maximum) context.addIssue({ code: z.ZodIssueCode.custom, path: ["defaultInitial"], message: "Default initial context cannot exceed the maximum." });
+  if (value.mode === "bounded" && value.measurement === "tokens" && value.reservedOutput >= value.maximum) context.addIssue({ code: z.ZodIssueCode.custom, path: ["reservedOutput"], message: "Reserved output must leave room for input context." });
+});
 const capabilityOfferSchema = z.object({
-  schemaVersion: z.literal("treeseed.capability-offer/v1"),
+  schemaVersion: z.literal("treeseed.capability-offer/v2"),
   offerId: identifier,
   capabilities: z.array(capabilityReferenceSchema).min(1),
   features: z.array(identifier),
@@ -89,6 +109,7 @@ const capabilityOfferSchema = z.object({
   outputContracts: z.array(artifactContractSchema),
   interactionModes: z.array(identifier),
   conformance: z.array(capabilityConformanceSchema).min(1),
+  contextCapacity: providerContextCapacitySchema,
   limits: z.record(z.unknown()),
   commercial: z.object({ currency: z.string().min(3).max(3).nullable(), estimatedCost: z.number().nonnegative().nullable() }).strict(),
   region: z.string().min(1).nullable(),
@@ -195,5 +216,6 @@ export {
   capabilityOntologySchema,
   capabilityReferenceSchema,
   negotiateCapabilityOffer,
+  providerContextCapacitySchema,
   semverSatisfies
 };