@ggui-ai/protocol 0.2.0-alpha.4 → 0.3.0-rc.0

package/dist/schemas/data-contract.d.ts

@@ -45,7 +45,7 @@
  * deliberately do NOT enforce JSON Schema's full grammar at this
  * layer — that work belongs in
  * `@ggui-ai/protocol/validation/schema-subset` and runs at
- * push-time + blueprint-registration-time as the F4 schema
+ * render-time + blueprint-registration-time as the F4 schema
  * compatibility checker. Agents authoring malformed schemas surface
  * at that pass with a named violation reason; this layer's job is
  * just to accept the contract and pass it to the generator.
@@ -63,7 +63,7 @@ export declare const jsonValueSchema: z.ZodType<JsonValue>;
  * fields the TS interface enumerates. `additionalProperties` and
  * `items` are recursive — kept loose (`z.unknown()`) to avoid
  * deep `z.lazy` chains; the F4 schema-subset checker validates
- * full structural correctness at push time.
+ * full structural correctness at render time.
  */
 export declare const jsonSchemaSchema: z.ZodType<JsonSchema>;
 /**
@@ -72,7 +72,7 @@ export declare const jsonSchemaSchema: z.ZodType<JsonSchema>;
  * Shape: `{schema: {type:'string', ...}, required?, default?, ...}`.
  * The JSON Schema NEVER sits flat at the entry level — every entry's
  * schema lives in `.schema`. Authors writing `{type:'string'}` instead
- * of `{schema: {type:'string'}}` will hit a shape error at push time.
+ * of `{schema: {type:'string'}}` will hit a shape error at render time.
  */
 export declare const propEntrySchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
@@ -139,7 +139,6 @@ export declare const streamChannelEntrySchema: z.ZodObject<{
         none: "none";
     }>>;
     complete: z.ZodOptional<z.ZodBoolean>;
-    tool: z.ZodOptional<z.ZodString>;
     source: z.ZodOptional<z.ZodObject<{
         tool: z.ZodString;
         args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
@@ -160,7 +159,6 @@ export declare const streamSpecSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         none: "none";
     }>>;
     complete: z.ZodOptional<z.ZodBoolean>;
-    tool: z.ZodOptional<z.ZodString>;
     source: z.ZodOptional<z.ZodObject<{
         tool: z.ZodString;
         args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
@@ -184,11 +182,16 @@ export declare const contextSpecSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
 }, z.core.$strict>>;
 /** {@link AgentToolEntry} — per-tool metadata in an {@link AgentCapabilitiesSpec}. */
 export declare const agentToolEntrySchema: z.ZodObject<{
-    description: z.ZodOptional<z.ZodString>;
+    serverInfo: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    toolInfo: z.ZodObject<{
+        inputSchema: z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>;
+        description: z.ZodOptional<z.ZodString>;
+        outputSchema: z.ZodOptional<z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>>;
+    }, z.core.$strict>;
     usage: z.ZodOptional<z.ZodString>;
-    inputSchema: z.ZodOptional<z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>>;
-    outputSchema: z.ZodOptional<z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>>;
-    required: z.ZodOptional<z.ZodBoolean>;
     example: z.ZodOptional<z.ZodObject<{
         input: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
         output: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
@@ -197,11 +200,16 @@ export declare const agentToolEntrySchema: z.ZodObject<{
 /** {@link AgentCapabilitiesSpec} — wrapper over the per-tool map. */
 export declare const agentCapabilitiesSpecSchema: z.ZodObject<{
     tools: z.ZodRecord<z.ZodString, z.ZodObject<{
-        description: z.ZodOptional<z.ZodString>;
+        serverInfo: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        toolInfo: z.ZodObject<{
+            inputSchema: z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>;
+            description: z.ZodOptional<z.ZodString>;
+            outputSchema: z.ZodOptional<z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>>;
+        }, z.core.$strict>;
         usage: z.ZodOptional<z.ZodString>;
-        inputSchema: z.ZodOptional<z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>>;
-        outputSchema: z.ZodOptional<z.ZodType<JsonSchema, unknown, z.core.$ZodTypeInternals<JsonSchema, unknown>>>;
-        required: z.ZodOptional<z.ZodBoolean>;
         example: z.ZodOptional<z.ZodObject<{
             input: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
             output: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
@@ -214,7 +222,7 @@ export declare const agentCapabilitiesSpecSchema: z.ZodObject<{
  * Each key in `App.publicEnv` MUST match this pattern. The prefix is
  * the **security boundary** — operators can't accidentally stash
  * sensitive credentials under arbitrary names, and downstream consumers
- * (push gate, bootstrap projection, iframe shim) can rely on the
+ * (render gate, bootstrap projection, iframe shim) can rely on the
  * naming convention to mean "public-by-design".
  *
  * Rule: `GGUI_PUBLIC_APP_` prefix, then uppercase letters / digits /
@@ -239,7 +247,7 @@ export declare const PUBLIC_ENV_APP_KEY_RE: RegExp;
  *
  * Entries are App.publicEnv key names — `GGUI_PUBLIC_APP_*`. Wrappers
  * that declare a `requires` key must have a corresponding App-side
- * publicEnv value at push time (gate: `assertPublicEnvSatisfied`).
+ * publicEnv value at render time (gate: `assertPublicEnvSatisfied`).
  */
 export declare const gadgetRequiresSchema: z.ZodReadonly<z.ZodArray<z.ZodString>>;
 /**
@@ -302,7 +310,7 @@ export declare const SEMVER_PIN_RE: RegExp;
  * Hostname-only regex for `bundleHost` — the registry hostname (no
  * scheme, no path) that the server prepends `https://` to and
  * appends the canonical `/bundles/<scope>/<name>/<version>/{bundle.js,style.css}`
- * suffix to when resolving a gadget's URLs at push time.
+ * suffix to when resolving a gadget's URLs at render time.
  *
  * Examples that pass:
  *   - `registry.ggui.ai` (spec default)
@@ -335,7 +343,7 @@ export declare const DEFAULT_BUNDLE_HOST = "registry.ggui.ai";
  * Used symmetrically by:
  *   - `buildInstallCommand` (publish CLI) to emit `http://localhost:PORT`
  *     in the printed `ggui gadget install ...` line.
- *   - `resolveGadgetUrls` (push-time bootstrap derivation) to compute
+ *   - `resolveGadgetUrls` (render-time bootstrap derivation) to compute
  *     `http://localhost:PORT/bundles/...` so iframe fetches a reachable
  *     URL during local-dev / sandbox-registry workflows.
  *
@@ -378,7 +386,6 @@ export declare const gadgetExportSchema: z.ZodUnion<readonly [z.ZodObject<{
     example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
     permission: z.ZodOptional<z.ZodString>;
     gotchas: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
     hook: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
@@ -386,7 +393,6 @@ export declare const gadgetExportSchema: z.ZodUnion<readonly [z.ZodObject<{
     example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
     permission: z.ZodOptional<z.ZodString>;
     gotchas: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
     component: z.ZodString;
 }, z.core.$strict>]>;
 /**
@@ -417,7 +423,6 @@ export declare const strictGadgetExportSchema: z.ZodUnion<readonly [z.ZodObject<
         "screen-wake-lock": "screen-wake-lock";
     }>>;
     gotchas: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
     hook: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
     description: z.ZodString;
@@ -442,7 +447,6 @@ export declare const strictGadgetExportSchema: z.ZodUnion<readonly [z.ZodObject<
         "screen-wake-lock": "screen-wake-lock";
     }>>;
     gotchas: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
     component: z.ZodString;
 }, z.core.$strict>]>;
 /**
@@ -459,7 +463,6 @@ export declare const gadgetDescriptorSchema: z.ZodObject<{
         example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
         permission: z.ZodOptional<z.ZodString>;
         gotchas: z.ZodOptional<z.ZodString>;
-        required: z.ZodOptional<z.ZodBoolean>;
         hook: z.ZodString;
     }, z.core.$strict>, z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
@@ -467,7 +470,6 @@ export declare const gadgetDescriptorSchema: z.ZodObject<{
         example: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
         permission: z.ZodOptional<z.ZodString>;
         gotchas: z.ZodOptional<z.ZodString>;
-        required: z.ZodOptional<z.ZodBoolean>;
         component: z.ZodString;
     }, z.core.$strict>]>>;
     version: z.ZodString;
@@ -519,7 +521,6 @@ export declare const strictGadgetDescriptorSchema: z.ZodObject<{
             "screen-wake-lock": "screen-wake-lock";
         }>>;
         gotchas: z.ZodOptional<z.ZodString>;
-        required: z.ZodOptional<z.ZodBoolean>;
         hook: z.ZodString;
     }, z.core.$strict>, z.ZodObject<{
         description: z.ZodString;
@@ -544,7 +545,6 @@ export declare const strictGadgetDescriptorSchema: z.ZodObject<{
             "screen-wake-lock": "screen-wake-lock";
         }>>;
         gotchas: z.ZodOptional<z.ZodString>;
-        required: z.ZodOptional<z.ZodBoolean>;
         component: z.ZodString;
     }, z.core.$strict>]>>;
     version: z.ZodString;
@@ -605,7 +605,6 @@ export declare const registeredGadgetDescriptorSchema: z.ZodObject<{
             "screen-wake-lock": "screen-wake-lock";
         }>>;
         gotchas: z.ZodOptional<z.ZodString>;
-        required: z.ZodOptional<z.ZodBoolean>;
         hook: z.ZodString;
     }, z.core.$strict>, z.ZodObject<{
         description: z.ZodString;
@@ -630,7 +629,6 @@ export declare const registeredGadgetDescriptorSchema: z.ZodObject<{
             "screen-wake-lock": "screen-wake-lock";
         }>>;
         gotchas: z.ZodOptional<z.ZodString>;
-        required: z.ZodOptional<z.ZodBoolean>;
         component: z.ZodString;
     }, z.core.$strict>]>>;
     version: z.ZodString;
@@ -654,7 +652,7 @@ export declare const registeredGadgetDescriptorSchema: z.ZodObject<{
  * The only wire-authored payload is optional intent-specific prose:
  *
  *   - `description?` / `usage?` — when present the agent's prose wins
- *     over the registered export's text; when omitted, push-time
+ *     over the registered export's text; when omitted, render-time
  *     resolution inherits the registered text verbatim.
  *
  * Everything else — `version`, transport metadata, `permission`,
@@ -691,8 +689,8 @@ export declare const gadgetPackageUseSchema: z.ZodRecord<z.ZodString, z.ZodObjec
  * the UI uses. The wire carries identity only — `(package, export
  * name)` — never `version` or transport metadata: the ggui server
  * resolves the full {@link GadgetDescriptor} from the `App.gadgets`
- * catalog at push time onto the `SessionStackEntry.gadgetDescriptors`
- * sidecar.
+ * catalog at render time onto the `ComponentGguiSession.gadgetDescriptors`
+ * sidecar (the `gadgetDescriptors` field of the `GguiSession` union member).
  *
  * `.strict()` (not `.passthrough()`): the retired `libraries` field
  * (renamed to `gadgets`) and any other stale sibling field MUST fail

package/dist/schemas/data-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-contract.d.ts","sourceRoot":"","sources":["../../src/schemas/data-contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-contract.d.ts","sourceRoot":"","sources":["../../src/schemas/data-contract.ts"],"names":[],"mappings":"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"}

package/dist/schemas/data-contract.js

@@ -45,7 +45,7 @@
  * deliberately do NOT enforce JSON Schema's full grammar at this
  * layer — that work belongs in
  * `@ggui-ai/protocol/validation/schema-subset` and runs at
- * push-time + blueprint-registration-time as the F4 schema
+ * render-time + blueprint-registration-time as the F4 schema
  * compatibility checker. Agents authoring malformed schemas surface
  * at that pass with a named violation reason; this layer's job is
  * just to accept the contract and pass it to the generator.
@@ -75,7 +75,7 @@ export const jsonValueSchema = z.lazy(() => z.union([
  * fields the TS interface enumerates. `additionalProperties` and
  * `items` are recursive — kept loose (`z.unknown()`) to avoid
  * deep `z.lazy` chains; the F4 schema-subset checker validates
- * full structural correctness at push time.
+ * full structural correctness at render time.
  */
 export const jsonSchemaSchema = z.lazy(() => z
     .object({
@@ -109,7 +109,7 @@ export const jsonSchemaSchema = z.lazy(() => z
  * Shape: `{schema: {type:'string', ...}, required?, default?, ...}`.
  * The JSON Schema NEVER sits flat at the entry level — every entry's
  * schema lives in `.schema`. Authors writing `{type:'string'}` instead
- * of `{schema: {type:'string'}}` will hit a shape error at push time.
+ * of `{schema: {type:'string'}}` will hit a shape error at render time.
  */
 export const propEntrySchema = z
     .object({
@@ -161,7 +161,6 @@ export const streamChannelEntrySchema = z
     mode: z.enum(['append', 'replace']).optional(),
     replay: z.enum(['latest', 'all', 'none']).optional(),
     complete: z.boolean().optional(),
-    tool: z.string().optional(),
     source: z
         .object({
         tool: z.string(),
@@ -188,18 +187,20 @@ export const contextSpecSchema = z.record(z.string(), contextEntrySchema);
 /** {@link AgentToolEntry} — per-tool metadata in an {@link AgentCapabilitiesSpec}. */
 export const agentToolEntrySchema = z
     .object({
-    description: z.string().optional(),
-    usage: z.string().optional(),
-    inputSchema: jsonSchemaSchema.optional(),
-    outputSchema: jsonSchemaSchema.optional(),
-    required: z.boolean().optional(),
-    example: z
+    // version is OPTIONAL: a Tier-2 author derives serverInfo.name from the
+    // mcp__<server>__ prefix and has no version; the catalog (Tier-1) fills both
+    // from `initialize`. name stays required — serverInfo without a name carries
+    // no identity.
+    serverInfo: z.object({ name: z.string(), version: z.string().optional() }).strict().optional(),
+    toolInfo: z
         .object({
-        input: jsonValueSchema,
-        output: jsonValueSchema,
+        inputSchema: jsonSchemaSchema,
+        description: z.string().optional(),
+        outputSchema: jsonSchemaSchema.optional(),
     })
-        .strict()
-        .optional(),
+        .strict(),
+    usage: z.string().optional(),
+    example: z.object({ input: jsonValueSchema, output: jsonValueSchema }).strict().optional(),
 })
     .strict();
 /** {@link AgentCapabilitiesSpec} — wrapper over the per-tool map. */
@@ -214,7 +215,7 @@ export const agentCapabilitiesSpecSchema = z
  * Each key in `App.publicEnv` MUST match this pattern. The prefix is
  * the **security boundary** — operators can't accidentally stash
  * sensitive credentials under arbitrary names, and downstream consumers
- * (push gate, bootstrap projection, iframe shim) can rely on the
+ * (render gate, bootstrap projection, iframe shim) can rely on the
  * naming convention to mean "public-by-design".
  *
  * Rule: `GGUI_PUBLIC_APP_` prefix, then uppercase letters / digits /
@@ -239,7 +240,7 @@ export const PUBLIC_ENV_APP_KEY_RE = /^GGUI_PUBLIC_APP_[A-Z0-9_]+$/;
  *
  * Entries are App.publicEnv key names — `GGUI_PUBLIC_APP_*`. Wrappers
  * that declare a `requires` key must have a corresponding App-side
- * publicEnv value at push time (gate: `assertPublicEnvSatisfied`).
+ * publicEnv value at render time (gate: `assertPublicEnvSatisfied`).
  */
 export const gadgetRequiresSchema = z
     .array(z.string().regex(PUBLIC_ENV_APP_KEY_RE))
@@ -304,7 +305,7 @@ export const SEMVER_PIN_RE = /^\d+\.\d+\.\d+(-[\w.]+)?(\+[\w.]+)?$/;
  * Hostname-only regex for `bundleHost` — the registry hostname (no
  * scheme, no path) that the server prepends `https://` to and
  * appends the canonical `/bundles/<scope>/<name>/<version>/{bundle.js,style.css}`
- * suffix to when resolving a gadget's URLs at push time.
+ * suffix to when resolving a gadget's URLs at render time.
  *
  * Examples that pass:
  *   - `registry.ggui.ai` (spec default)
@@ -337,7 +338,7 @@ export const DEFAULT_BUNDLE_HOST = 'registry.ggui.ai';
  * Used symmetrically by:
  *   - `buildInstallCommand` (publish CLI) to emit `http://localhost:PORT`
  *     in the printed `ggui gadget install ...` line.
- *   - `resolveGadgetUrls` (push-time bootstrap derivation) to compute
+ *   - `resolveGadgetUrls` (render-time bootstrap derivation) to compute
  *     `http://localhost:PORT/bundles/...` so iframe fetches a reachable
  *     URL during local-dev / sandbox-registry workflows.
  *
@@ -369,13 +370,12 @@ export function bundleHostScheme(host) {
 export { HOOK_NAME_RE, COMPONENT_NAME_RE } from './gadget-name-grammar.js';
 /**
  * Per-export field shape shared by both export-schema postures —
- * `gotchas` + `required`. Teaching text (`description` / `usage` /
- * `example`) and `permission` differ between wire-permissive and
- * registry-strict, so they are spread per-posture below.
+ * `gotchas`. Teaching text (`description` / `usage` / `example`) and
+ * `permission` differ between wire-permissive and registry-strict, so
+ * they are spread per-posture below.
  */
 const baseExportFieldsShape = {
     gotchas: z.string().optional(),
-    required: z.boolean().optional(),
 };
 /**
  * Wire-permissive per-export metadata: teaching text optional,
@@ -425,7 +425,7 @@ const basePackageFieldsShape = {
     // Shared `gadgetRequiresSchema`.
     requires: gadgetRequiresSchema.optional(),
     // HTTPS URL of the package's `.d.ts`. The handler fetches it at
-    // push time, SRI-verifies against `typesSri`, and loads it into the
+    // render time, SRI-verifies against `typesSri`, and loads it into the
     // code-gen sandbox VFS. Optional at the base shape;
     // `registeredGadgetDescriptorSchema` refines it to REQUIRED for
     // non-stdlib packages.
@@ -551,7 +551,7 @@ export const registeredGadgetDescriptorSchema = strictGadgetDescriptorSchema.ref
  * The only wire-authored payload is optional intent-specific prose:
  *
  *   - `description?` / `usage?` — when present the agent's prose wins
- *     over the registered export's text; when omitted, push-time
+ *     over the registered export's text; when omitted, render-time
  *     resolution inherits the registered text verbatim.
  *
  * Everything else — `version`, transport metadata, `permission`,
@@ -595,8 +595,8 @@ export const gadgetPackageUseSchema = z
  * the UI uses. The wire carries identity only — `(package, export
  * name)` — never `version` or transport metadata: the ggui server
  * resolves the full {@link GadgetDescriptor} from the `App.gadgets`
- * catalog at push time onto the `SessionStackEntry.gadgetDescriptors`
- * sidecar.
+ * catalog at render time onto the `ComponentGguiSession.gadgetDescriptors`
+ * sidecar (the `gadgetDescriptors` field of the `GguiSession` union member).
  *
  * `.strict()` (not `.passthrough()`): the retired `libraries` field
  * (renamed to `gadgets`) and any other stale sibling field MUST fail

package/dist/schemas/handshake-suggestion.d.ts

@@ -8,7 +8,7 @@
  * `z.ZodType<T>` so any drift fails compile.
  */
 import { z } from 'zod';
-import type { BlueprintDraft, BlueprintMeta, HandshakeSuggestion, JsonPatch, JsonPatchOp, PushDecision, SuggestionAmendments, SuggestionFinding, SuggestionOrigin } from '../types/handshake-suggestion.js';
+import type { BlueprintDraft, BlueprintMeta, HandshakeSuggestion, JsonPatch, JsonPatchOp, SuggestionAmendments, SuggestionFinding, SuggestionOrigin } from '../types/handshake-suggestion.js';
 /** Three-mode routing enum on {@link HandshakeSuggestion.origin}. */
 export declare const suggestionOriginSchema: z.ZodType<SuggestionOrigin>;
 /** Single JSON-Patch op (RFC 6902 subset — add/remove/replace). */
@@ -31,7 +31,7 @@ export declare const blueprintDraftObjectSchema: z.ZodObject<{
     }, z.core.$strict>>;
     generator: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
-/** `BlueprintDraft` — input shape on handshake + override push. */
+/** `BlueprintDraft` — input shape on the handshake. */
 export declare const blueprintDraftSchema: z.ZodType<BlueprintDraft>;
 /** `BlueprintMeta` — projected onto the handshake response. */
 export declare const blueprintMetaSchema: z.ZodType<BlueprintMeta>;
@@ -41,6 +41,4 @@ export declare const suggestionFindingSchema: z.ZodType<SuggestionFinding>;
 export declare const suggestionAmendmentsSchema: z.ZodType<SuggestionAmendments>;
 /** The full handshake suggestion — produced in step-2 of the handshake. */
 export declare const handshakeSuggestionSchema: z.ZodType<HandshakeSuggestion>;
-/** Push decision discriminator — accept vs override. */
-export declare const pushDecisionSchema: z.ZodType<PushDecision>;
 //# sourceMappingURL=handshake-suggestion.d.ts.map

package/dist/schemas/handshake-suggestion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handshake-suggestion.d.ts","sourceRoot":"","sources":["../../src/schemas/handshake-suggestion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,kCAAkC,CAAC;AAI1C,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAI7D,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAezB,CAAC;AAE7B,8DAA8D;AAC9D,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAsD,CAAC;AAExG;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;kBAc5B,CAAC;AAEZ,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAA2D,CAAC;AAEvH,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CASlB,CAAC;AAExC,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAOtB,CAAC;AAE5C,qDAAqD;AACrD,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAKzB,CAAC;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAQxB,CAAC;AAE9C,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAQ1B,CAAC"}
+{"version":3,"file":"handshake-suggestion.d.ts","sourceRoot":"","sources":["../../src/schemas/handshake-suggestion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,kCAAkC,CAAC;AAI1C,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAI7D,CAAC;AAEH,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAezB,CAAC;AAE7B,8DAA8D;AAC9D,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAsD,CAAC;AAExG;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;kBAc5B,CAAC;AAEZ,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAA2D,CAAC;AAEvH,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CASlB,CAAC;AAExC,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAOtB,CAAC;AAE5C,qDAAqD;AACrD,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAKzB,CAAC;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CASxB,CAAC"}

package/dist/schemas/handshake-suggestion.js

@@ -9,7 +9,7 @@
  */
 import { z } from 'zod';
 import { dataContractSchema, jsonValueSchema } from './data-contract.js';
-import { blueprintVarianceSchema } from './blueprint.js';
+import { blueprintSourceSchema, blueprintVarianceSchema } from './blueprint.js';
 /** Three-mode routing enum on {@link HandshakeSuggestion.origin}. */
 export const suggestionOriginSchema = z.enum([
     'cache',
@@ -56,15 +56,15 @@ export const blueprintDraftObjectSchema = z
     generator: z.string().optional(),
 })
     .strict();
-/** `BlueprintDraft` — input shape on handshake + override push. */
+/** `BlueprintDraft` — input shape on the handshake. */
 export const blueprintDraftSchema = blueprintDraftObjectSchema;
 /** `BlueprintMeta` — projected onto the handshake response. */
 export const blueprintMetaSchema = z
     .object({
-    blueprintId: z.string().min(1),
+    blueprintId: z.string().min(1).optional(),
     contractHash: z.string().min(1),
     codeHash: z.string().optional(),
-    generator: z.string().min(1),
+    source: blueprintSourceSchema.optional(),
     variance: blueprintVarianceSchema,
     selectedReason: z.string().optional(),
 })
@@ -91,17 +91,8 @@ export const handshakeSuggestionSchema = z
     origin: suggestionOriginSchema,
     rationale: z.string(),
     blueprintMeta: blueprintMetaSchema,
+    proposedContractSummary: z.string().optional(),
     amendments: suggestionAmendmentsSchema.optional(),
     validationFindings: z.array(suggestionFindingSchema).optional(),
 })
     .strict();
-/** Push decision discriminator — accept vs override. */
-export const pushDecisionSchema = z.union([
-    z.object({ kind: z.literal('accept') }).strict(),
-    z
-        .object({
-        kind: z.literal('override'),
-        blueprintDraft: blueprintDraftSchema,
-    })
-        .strict(),
-]);