@contractspec/lib.contracts 1.56.1 → 1.57.0

package/dist/docs/queries/docsIndex.query.d.ts

@@ -1,68 +1,68 @@
 import { OperationSpec } from "../../operations/operation.js";
 import "../../index.js";
-import * as _contractspec_lib_schema270 from "@contractspec/lib.schema";
+import * as _contractspec_lib_schema0 from "@contractspec/lib.schema";
 import { SchemaModel } from "@contractspec/lib.schema";
 
 //#region src/docs/queries/docsIndex.query.d.ts
 declare const DocSummaryModel: SchemaModel<{
   id: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   title: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   summary: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   route: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   visibility: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   kind: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   version: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   tags: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
     isArray: true;
   };
 }>;
 declare const DocsIndexInput: SchemaModel<{
   query: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   tag: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
     isArray: true;
   };
   visibility: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   kind: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   limit: {
-    type: _contractspec_lib_schema270.FieldType<number, number>;
+    type: _contractspec_lib_schema0.FieldType<number, number>;
     isOptional: true;
   };
   offset: {
-    type: _contractspec_lib_schema270.FieldType<number, number>;
+    type: _contractspec_lib_schema0.FieldType<number, number>;
     isOptional: true;
   };
 }>;
@@ -70,35 +70,35 @@ declare const DocsIndexOutput: SchemaModel<{
   items: {
     type: SchemaModel<{
       id: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       title: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       summary: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       route: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       visibility: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       kind: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       version: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       tags: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
         isArray: true;
       };
@@ -109,35 +109,35 @@ declare const DocsIndexOutput: SchemaModel<{
   docs: {
     type: SchemaModel<{
       id: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       title: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       summary: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       route: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       visibility: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       kind: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       version: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       tags: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
         isArray: true;
       };
@@ -146,73 +146,73 @@ declare const DocsIndexOutput: SchemaModel<{
     isArray: true;
   };
   total: {
-    type: _contractspec_lib_schema270.FieldType<number, number>;
+    type: _contractspec_lib_schema0.FieldType<number, number>;
     isOptional: true;
   };
   nextOffset: {
-    type: _contractspec_lib_schema270.FieldType<number, number>;
+    type: _contractspec_lib_schema0.FieldType<number, number>;
     isOptional: true;
   };
 }>;
 declare const DocsIndexQuery: OperationSpec<SchemaModel<{
   query: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   tag: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
     isArray: true;
   };
   visibility: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   kind: {
-    type: _contractspec_lib_schema270.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   limit: {
-    type: _contractspec_lib_schema270.FieldType<number, number>;
+    type: _contractspec_lib_schema0.FieldType<number, number>;
     isOptional: true;
   };
   offset: {
-    type: _contractspec_lib_schema270.FieldType<number, number>;
+    type: _contractspec_lib_schema0.FieldType<number, number>;
     isOptional: true;
   };
 }>, SchemaModel<{
   items: {
     type: SchemaModel<{
       id: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       title: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       summary: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       route: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       visibility: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       kind: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       version: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       tags: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
         isArray: true;
       };
@@ -223,35 +223,35 @@ declare const DocsIndexQuery: OperationSpec<SchemaModel<{
   docs: {
     type: SchemaModel<{
       id: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       title: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       summary: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       route: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       visibility: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       kind: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       version: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       tags: {
-        type: _contractspec_lib_schema270.FieldType<string, string>;
+        type: _contractspec_lib_schema0.FieldType<string, string>;
         isOptional: true;
         isArray: true;
       };
@@ -260,11 +260,11 @@ declare const DocsIndexQuery: OperationSpec<SchemaModel<{
     isArray: true;
   };
   total: {
-    type: _contractspec_lib_schema270.FieldType<number, number>;
+    type: _contractspec_lib_schema0.FieldType<number, number>;
     isOptional: true;
   };
   nextOffset: {
-    type: _contractspec_lib_schema270.FieldType<number, number>;
+    type: _contractspec_lib_schema0.FieldType<number, number>;
     isOptional: true;
   };
 }>, undefined>;

package/dist/docs/tech/llm/llm-integration.docblock.d.ts

@@ -1,7 +1,6 @@
 import { DocBlock } from "@contractspec/lib.contracts/docs";
 
 //#region src/docs/tech/llm/llm-integration.docblock.d.ts
-
 declare const tech_llm_integration_DocBlocks: DocBlock[];
 //#endregion
 export { tech_llm_integration_DocBlocks };

package/dist/docs/tech/mcp-endpoints.docblock.js

@@ -30,6 +30,11 @@ Three dedicated MCP servers keep AI agents efficient and scoped:
   - \`examples://example/<id>\`
 - Prompts mirror each surface (navigator, usage, bootstrap) for quick agent onboarding.
 - GraphQL remains at \`/graphql\`; health at \`/health\`.
+
+### Alpic hosting
+- Alpic exposes MCP at \`/\` (SSE + Streamable HTTP) and \`/mcp\` (Streamable HTTP).
+- Static UI assets are served at \`/assets\` from repo \`/assets\` or build output \`dist/assets\`.
+- Use the \`ALPIC_HOST\` environment variable to build absolute asset URLs.
 `
 }];
 registerDocBlocks(tech_mcp_endpoints_DocBlocks);

package/dist/events.d.ts

@@ -5,7 +5,6 @@ import { OwnerShipMeta } from "./ownership.js";
 import { AnySchemaModel } from "@contractspec/lib.schema";
 
 //#region src/events.d.ts
-
 /**
  * Metadata for an event specification.
  * Extends OwnerShipMeta with event-specific documentation.

package/dist/examples/index.d.ts

@@ -4,7 +4,6 @@ import { ExampleRegistry } from "./registry.js";
 import { CrossValidationContext, ExampleValidationError, ExampleValidationWarning, ValidateExampleResult, ValidateExamplesResult, validateExample, validateExampleReferences, validateExamples } from "./validation.js";
 
 //#region src/examples/index.d.ts
-
 /**
  * Helper to define an Example.
  */

package/dist/examples/registry.d.ts

@@ -2,7 +2,6 @@ import { SpecContractRegistry } from "../registry.js";
 import { ExampleKind, ExampleSpec, ExampleVisibility } from "./types.js";
 
 //#region src/examples/registry.d.ts
-
 /**
  * In-memory registry for ExampleSpec.
  *

package/dist/examples/schema.d.ts

@@ -3,34 +3,34 @@ import { z as z$1 } from "zod";
 
 //#region src/examples/schema.d.ts
 declare const ExampleKindSchema: z$1.ZodEnum<{
+  ui: "ui";
   template: "template";
   workflow: "workflow";
   integration: "integration";
   knowledge: "knowledge";
   blueprint: "blueprint";
-  ui: "ui";
   script: "script";
   library: "library";
 }>;
 declare const ExampleVisibilitySchema: z$1.ZodEnum<{
+  experimental: "experimental";
   public: "public";
   internal: "internal";
-  experimental: "experimental";
 }>;
 declare const ExampleSandboxModeSchema: z$1.ZodEnum<{
+  markdown: "markdown";
   playground: "playground";
   specs: "specs";
   builder: "builder";
-  markdown: "markdown";
   evolution: "evolution";
 }>;
 declare const StabilitySchema: z$1.ZodEnum<{
   experimental: "experimental";
-  deprecated: "deprecated";
   idea: "idea";
   in_creation: "in_creation";
   beta: "beta";
   stable: "stable";
+  deprecated: "deprecated";
 }>;
 declare const ExampleDocumentationSchema: z$1.ZodObject<{
   rootDocId: z$1.ZodOptional<z$1.ZodString>;
@@ -42,10 +42,10 @@ declare const ExampleDocumentationSchema: z$1.ZodObject<{
 declare const ExampleSandboxSupportSchema: z$1.ZodObject<{
   enabled: z$1.ZodBoolean;
   modes: z$1.ZodArray<z$1.ZodEnum<{
+    markdown: "markdown";
     playground: "playground";
     specs: "specs";
     builder: "builder";
-    markdown: "markdown";
     evolution: "evolution";
   }>>;
 }, z$1.core.$strip>;
@@ -61,10 +61,10 @@ declare const ExampleSurfacesSchema: z$1.ZodObject<{
   sandbox: z$1.ZodObject<{
     enabled: z$1.ZodBoolean;
     modes: z$1.ZodArray<z$1.ZodEnum<{
+      markdown: "markdown";
       playground: "playground";
       specs: "specs";
       builder: "builder";
-      markdown: "markdown";
       evolution: "evolution";
     }>>;
   }, z$1.core.$strip>;
@@ -94,29 +94,29 @@ declare const ExampleMetaSchema: z$1.ZodObject<{
   domain: z$1.ZodOptional<z$1.ZodString>;
   stability: z$1.ZodEnum<{
     experimental: "experimental";
-    deprecated: "deprecated";
     idea: "idea";
     in_creation: "in_creation";
     beta: "beta";
     stable: "stable";
+    deprecated: "deprecated";
   }>;
   owners: z$1.ZodArray<z$1.ZodString>;
   tags: z$1.ZodArray<z$1.ZodString>;
   docId: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
   kind: z$1.ZodEnum<{
+    ui: "ui";
     template: "template";
     workflow: "workflow";
     integration: "integration";
     knowledge: "knowledge";
     blueprint: "blueprint";
-    ui: "ui";
     script: "script";
     library: "library";
   }>;
   visibility: z$1.ZodEnum<{
+    experimental: "experimental";
     public: "public";
     internal: "internal";
-    experimental: "experimental";
   }>;
   summary: z$1.ZodOptional<z$1.ZodString>;
 }, z$1.core.$strip>;
@@ -142,29 +142,29 @@ declare const ExampleSpecSchema: z$1.ZodObject<{
     domain: z$1.ZodOptional<z$1.ZodString>;
     stability: z$1.ZodEnum<{
       experimental: "experimental";
-      deprecated: "deprecated";
       idea: "idea";
       in_creation: "in_creation";
       beta: "beta";
       stable: "stable";
+      deprecated: "deprecated";
     }>;
     owners: z$1.ZodArray<z$1.ZodString>;
     tags: z$1.ZodArray<z$1.ZodString>;
     docId: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
     kind: z$1.ZodEnum<{
+      ui: "ui";
       template: "template";
       workflow: "workflow";
       integration: "integration";
       knowledge: "knowledge";
       blueprint: "blueprint";
-      ui: "ui";
       script: "script";
       library: "library";
     }>;
     visibility: z$1.ZodEnum<{
+      experimental: "experimental";
       public: "public";
       internal: "internal";
-      experimental: "experimental";
     }>;
     summary: z$1.ZodOptional<z$1.ZodString>;
   }, z$1.core.$strip>;
@@ -180,10 +180,10 @@ declare const ExampleSpecSchema: z$1.ZodObject<{
     sandbox: z$1.ZodObject<{
       enabled: z$1.ZodBoolean;
       modes: z$1.ZodArray<z$1.ZodEnum<{
+        markdown: "markdown";
         playground: "playground";
         specs: "specs";
         builder: "builder";
-        markdown: "markdown";
         evolution: "evolution";
       }>>;
     }, z$1.core.$strip>;
@@ -221,11 +221,11 @@ declare function safeParseExampleSpec(data: unknown): z$1.ZodSafeParseResult<{
     version: string;
     key: string;
     description: string;
-    stability: "experimental" | "deprecated" | "idea" | "in_creation" | "beta" | "stable";
+    stability: "experimental" | "idea" | "in_creation" | "beta" | "stable" | "deprecated";
     owners: string[];
     tags: string[];
-    kind: "template" | "workflow" | "integration" | "knowledge" | "blueprint" | "ui" | "script" | "library";
-    visibility: "public" | "internal" | "experimental";
+    kind: "ui" | "template" | "workflow" | "integration" | "knowledge" | "blueprint" | "script" | "library";
+    visibility: "experimental" | "public" | "internal";
     title?: string | undefined;
     domain?: string | undefined;
     docId?: string[] | undefined;
@@ -235,7 +235,7 @@ declare function safeParseExampleSpec(data: unknown): z$1.ZodSafeParseResult<{
     templates: boolean;
     sandbox: {
       enabled: boolean;
-      modes: ("playground" | "specs" | "builder" | "markdown" | "evolution")[];
+      modes: ("markdown" | "playground" | "specs" | "builder" | "evolution")[];
     };
     studio: {
       enabled: boolean;

package/dist/experiments/spec.d.ts

@@ -43,12 +43,10 @@ interface TargetingRule {
   expression?: string;
 }
 type AllocationStrategy = {
-  type: 'random';
-  /** Optional salt for deterministic hashing. */
+  type: 'random'; /** Optional salt for deterministic hashing. */
   salt?: string;
 } | {
-  type: 'sticky';
-  /** Which attribute to hash for sticky assignment. */
+  type: 'sticky'; /** Which attribute to hash for sticky assignment. */
   attribute: 'userId' | 'organizationId' | 'sessionId';
   salt?: string;
 } | {

package/dist/features/index.d.ts

@@ -4,7 +4,6 @@ import { InstallFeatureDeps, installFeature } from "./install.js";
 import { validateFeatureTargetsV2 } from "./validation.js";
 
 //#region src/features/index.d.ts
-
 /**
  * Helper to define a Feature.
  */

package/dist/features/types.d.ts

@@ -58,11 +58,8 @@ interface FeatureModuleSpec {
   }[];
   /** Optional: declare per-presentation target requirements (V2 descriptors) */
   presentationsTargets?: {
-    /** Presentation key. */
-    key: string;
-    /** Presentation version. */
-    version: string;
-    /** Required targets that must be supported by the descriptor. */
+    /** Presentation key. */key: string; /** Presentation version. */
+    version: string; /** Required targets that must be supported by the descriptor. */
     targets: PresentationTarget[];
   }[];
   /**

package/dist/forms/forms.d.ts

@@ -27,8 +27,7 @@ type OptionsSource = {
   options: readonly FormOption[];
 } | {
   kind: 'resolver';
-  resolverKey: string;
-  /** Dot paths in form values to watch */
+  resolverKey: string; /** Dot paths in form values to watch */
   deps: string[];
   args?: Record<string, unknown>;
 };

package/dist/forms/forms.js

@@ -1,4 +1,4 @@
-import { __toCommonJS } from "../_virtual/rolldown_runtime.js";
+import { __toCommonJS } from "../_virtual/_rolldown/runtime.js";
 import { init_registry_utils, registry_utils_exports } from "../registry-utils.js";
 import { compareVersions } from "compare-versions";
 
@@ -83,7 +83,6 @@ function evalPredicate(values, pred) {
 			case "lengthGte": return (Array.isArray(v) || typeof v === "string") && v.length >= Number(value ?? 0);
 			case "lengthLt": return (Array.isArray(v) || typeof v === "string") && v.length < Number(value ?? 0);
 			case "lengthLte": return (Array.isArray(v) || typeof v === "string") && v.length <= Number(value ?? 0);
-			case "truthy":
 			default: return Boolean(v);
 		}
 	}