stitchkit 0.68.2 → 0.68.4

package/dist/{index-3vq6we8m.js → index-6tqys26z.js}

@@ -7,7 +7,7 @@ import {
   defaultSignalSource,
   guardSignalCallback,
   reportSignalError
-} from "./index-pr0qsmjy.js";
+} from "./index-z575awm9.js";
 import {
   extractIp,
   getClientInfo,
@@ -18,7 +18,7 @@ import {
   runWithRequestContext,
   setRequestEndpoint,
   setRequestError
-} from "./index-69m2278y.js";
+} from "./index-51a19y3v.js";
 import {
   ShutdownOptionsSchema
 } from "./index-dk6e56g0.js";
@@ -34,7 +34,7 @@ import {
   safeJsonParse,
   validateDeclaredOutput,
   zodIssues
-} from "./index-9ky9hhg3.js";
+} from "./index-bmmtz6r9.js";
 import {
   isRecord,
   transportResult
@@ -850,29 +850,39 @@ function contractStreamResponse(request, context, source, descriptor, operationA
           throw new AppError("STREAM_ITEM_INVALID", "Stream item did not match its contract", 500);
         }
         const item = parsed.data;
-        if (descriptor.terminal?.safeParse(item).success)
+        const terminal = descriptor.terminal?.safeParse(item).success ?? false;
+        if (terminal)
           terminalSeen = true;
-        const frame = { type: "data", data: item };
+        const frame = descriptor.framing === "item" ? item : { type: "data", data: item };
         if (encodedBytes(frame, format) > maxFrameBytes) {
           console.error(`[stitchkit] contract stream frame exceeded its ${maxFrameBytes} byte limit`);
           throw new AppError("STREAM_FRAME_TOO_LARGE", "Stream item exceeded its declared frame limit", 500);
         }
         yield frame;
+        if (terminal && descriptor.completion === "terminal")
+          return;
       }
       if (!terminalSeen) {
         throw new AppError("STREAM_TERMINAL_MISSING", "Stream completed before its declared terminal item", 500);
       }
-      yield { type: "end" };
+      if (descriptor.framing !== "item")
+        yield { type: "end" };
     } catch (error) {
       if (operationAbort.signal.aborted && !lifetimeExpired)
         return;
       if (lifetimeExpired) {
+        if (descriptor.framing === "item")
+          return;
         yield {
           type: "error",
           error: new AppError("STREAM_LIFETIME_EXCEEDED", "Stream exceeded its declared lifetime", 408).toJSON().error
         };
         return;
       }
+      if (descriptor.framing === "item") {
+        console.error("[stitchkit] item-framed contract stream failed:", normalizeError(error));
+        return;
+      }
       yield { type: "error", error: normalizeError(error).toJSON().error };
     } finally {
       if (lifetime !== undefined)

package/dist/{index-7etq650s.js → index-88yyydag.js}

@@ -1,6 +1,6 @@
 import {
   executeToolMethod
-} from "./index-cz32amcb.js";
+} from "./index-04agqrs8.js";
 import {
   assertToolExtensionCompatible,
   projectToolSurface

package/dist/{index-g2j2m6vv.js → index-9t2tdk1x.js}

@@ -1,10 +1,10 @@
 import {
   collectTools,
   createToolRunner
-} from "./index-7etq650s.js";
+} from "./index-88yyydag.js";
 import {
   toolErrorFromResult
-} from "./index-cz32amcb.js";
+} from "./index-04agqrs8.js";
 import {
   assertUniqueToolName
 } from "./index-vkk06pv1.js";

package/dist/{index-9ky9hhg3.js → index-bmmtz6r9.js}

@@ -177,6 +177,20 @@ function assertStreamingResponseEndpoint(prefix, key, ep) {
   if (!ep.stream.item || typeof ep.stream.item.parse !== "function") {
     throw new Error(`${where} must declare an item schema`);
   }
+  const runtimeFormat = Reflect.get(ep.stream, "format");
+  const runtimeFinalLine = Reflect.get(ep.stream, "finalLine");
+  if (ep.stream.framing === "item" && runtimeFormat === "sse") {
+    throw new Error(`${where} item framing is supported only for ndjson`);
+  }
+  if (ep.stream.framing === "item" && ep.stream.completion !== "terminal") {
+    throw new Error(`${where} item framing requires terminal completion`);
+  }
+  if (ep.stream.completion === "terminal" && !ep.stream.terminal) {
+    throw new Error(`${where} terminal completion requires a terminal schema`);
+  }
+  if (runtimeFinalLine === "require-newline" && runtimeFormat === "sse") {
+    throw new Error(`${where} finalLine applies only to ndjson`);
+  }
   assertPositiveLimit(where, "maxFrameBytes", ep.stream.maxFrameBytes);
   assertPositiveLimit(where, "lifetimeMs", ep.stream.lifetimeMs);
   assertPositiveLimit(where, "heartbeatMs", ep.stream.heartbeatMs);

package/dist/{index-dafax5md.js → index-hmfpjnh7.js}

@@ -1,6 +1,6 @@
 import {
   isUnsafeKey
-} from "./index-9ky9hhg3.js";
+} from "./index-bmmtz6r9.js";
 import {
   isRecord
 } from "./index-smpbdg6k.js";

package/dist/{index-cq9q73nf.js → index-j2nq04z6.js}

@@ -168,6 +168,20 @@ function assertStreamingResponseEndpoint(prefix, key, ep) {
   if (!ep.stream.item || typeof ep.stream.item.parse !== "function") {
     throw new Error(`${where} must declare an item schema`);
   }
+  const runtimeFormat = Reflect.get(ep.stream, "format");
+  const runtimeFinalLine = Reflect.get(ep.stream, "finalLine");
+  if (ep.stream.framing === "item" && runtimeFormat === "sse") {
+    throw new Error(`${where} item framing is supported only for ndjson`);
+  }
+  if (ep.stream.framing === "item" && ep.stream.completion !== "terminal") {
+    throw new Error(`${where} item framing requires terminal completion`);
+  }
+  if (ep.stream.completion === "terminal" && !ep.stream.terminal) {
+    throw new Error(`${where} terminal completion requires a terminal schema`);
+  }
+  if (runtimeFinalLine === "require-newline" && runtimeFormat === "sse") {
+    throw new Error(`${where} finalLine applies only to ndjson`);
+  }
   assertPositiveLimit(where, "maxFrameBytes", ep.stream.maxFrameBytes);
   assertPositiveLimit(where, "lifetimeMs", ep.stream.lifetimeMs);
   assertPositiveLimit(where, "heartbeatMs", ep.stream.heartbeatMs);

package/dist/{index-v5bayx1z.js → index-r5s4wqb5.js}

@@ -1,6 +1,6 @@
 import {
   normalizeError
-} from "./index-9ky9hhg3.js";
+} from "./index-bmmtz6r9.js";
 
 // src/internal/bounded-lines.ts
 var DEFAULT_STREAM_LINE_BYTES = 1024 * 1024;
@@ -19,7 +19,7 @@ function joinBytes(left, right) {
   result.set(right, left.byteLength);
   return result;
 }
-async function* readBoundedUtf8Lines(response, maxLineBytes) {
+async function* readBoundedUtf8Lines(response, maxLineBytes, requireFinalNewline = false) {
   const reader = response.body?.getReader();
   if (!reader)
     return;
@@ -48,8 +48,12 @@ async function* readBoundedUtf8Lines(response, maxLineBytes) {
         throw new RangeError(`Stream line exceeds the ${limit} byte limit`);
       }
     }
-    if (pending.byteLength > 0)
+    if (pending.byteLength > 0) {
+      if (requireFinalNewline) {
+        throw new SyntaxError("Stream ended with an unterminated final line");
+      }
       yield decoder.decode(pending);
+    }
   } finally {
     await reader.cancel().catch(() => {
       return;

package/dist/{index-2ve29dzn.js → index-thcy3w8c.js}

@@ -3,12 +3,12 @@ import {
   inputIsQuery,
   parseSSE,
   readBoundedUtf8Lines
-} from "./index-v5bayx1z.js";
+} from "./index-r5s4wqb5.js";
 import {
   ContractStreamFrameSchema,
   DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
   parseTrailingWildcard
-} from "./index-9ky9hhg3.js";
+} from "./index-bmmtz6r9.js";
 import {
   isRecord,
   mapObject,
@@ -291,7 +291,7 @@ function parseFailure(raw, error, onParseError) {
 }
 async function* parseNDJSON(response, options) {
   try {
-    for await (const rawLine of readBoundedUtf8Lines(response, options?.maxLineBytes ?? DEFAULT_STREAM_LINE_BYTES)) {
+    for await (const rawLine of readBoundedUtf8Lines(response, options?.maxLineBytes ?? DEFAULT_STREAM_LINE_BYTES, options?.finalLine === "require-newline")) {
       const line = (rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine).trim();
       if (line === "")
         continue;
@@ -309,44 +309,67 @@ async function* parseNDJSON(response, options) {
 // src/browser/contract-stream.ts
 function sourceFor(response, descriptor) {
   const options = {
-    maxLineBytes: descriptor.maxFrameBytes ?? DEFAULT_CONTRACT_STREAM_FRAME_BYTES
+    maxLineBytes: descriptor.maxFrameBytes ?? DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
+    finalLine: descriptor.finalLine
   };
   return descriptor.format === "sse" ? parseSSE(response, options) : parseNDJSON(response, options);
 }
 async function* readContractStream(response, descriptor, abort) {
   let ended = false;
   let terminalSeen = descriptor.terminal === undefined;
+  const source = sourceFor(response, descriptor);
   try {
-    for await (const raw of sourceFor(response, descriptor)) {
-      const parsedFrame = ContractStreamFrameSchema.safeParse(raw);
-      if (!parsedFrame.success) {
-        throw new ApiError("STREAM_PROTOCOL_ERROR", 0, undefined, "Stream frame did not match the protocol envelope");
-      }
-      const frame = parsedFrame.data;
-      if (frame.type === "error") {
-        throw new ApiError(frame.error.code, 0, frame.error.details, frame.error.message, frame.error.hint);
-      }
-      if (frame.type === "end") {
-        if (!terminalSeen) {
-          throw new ApiError("STREAM_TERMINAL_MISSING", 0, undefined, "Stream completed before its declared terminal item");
+    for (;; ) {
+      const next = await source.next();
+      if (next.done)
+        break;
+      let candidate = next.value;
+      if (descriptor.framing !== "item") {
+        const parsedFrame = ContractStreamFrameSchema.safeParse(candidate);
+        if (!parsedFrame.success) {
+          throw new ApiError("STREAM_PROTOCOL_ERROR", 0, undefined, "Stream frame did not match the protocol envelope");
         }
-        ended = true;
-        return;
+        const frame = parsedFrame.data;
+        if (frame.type === "error") {
+          throw new ApiError(frame.error.code, 0, frame.error.details, frame.error.message, frame.error.hint);
+        }
+        if (frame.type === "end") {
+          if (!terminalSeen) {
+            throw new ApiError("STREAM_TERMINAL_MISSING", 0, undefined, "Stream completed before its declared terminal item");
+          }
+          ended = true;
+          return;
+        }
+        candidate = frame.data;
       }
-      const parsedItem = descriptor.item.safeParse(frame.data);
+      const parsedItem = descriptor.item.safeParse(candidate);
       if (!parsedItem.success) {
         throw new ApiError("STREAM_ITEM_INVALID", 0, undefined, "Stream item did not match its contract");
       }
       const item = parsedItem.data;
-      if (descriptor.terminal?.safeParse(item).success)
+      const terminal = descriptor.terminal?.safeParse(item).success ?? false;
+      if (terminal)
         terminalSeen = true;
+      if (terminal && descriptor.completion === "terminal") {
+        abort();
+        await source.return(undefined);
+        ended = true;
+      }
       yield item;
+      if (ended)
+        return;
+    }
+    if (descriptor.framing === "item") {
+      if (terminalSeen)
+        return;
+      throw new ApiError("STREAM_TERMINAL_MISSING", 0, undefined, "Stream completed before its declared terminal item");
     }
     if (!ended) {
       throw new ApiError("STREAM_TRUNCATED", 0, undefined, "Stream ended without its protocol terminal frame");
     }
   } finally {
     abort();
+    await source.return(undefined);
   }
 }
 

package/dist/{index-pr0qsmjy.js → index-z575awm9.js}

@@ -1,7 +1,7 @@
 import {
   isUnsafeKey,
   mergeMeta
-} from "./index-9ky9hhg3.js";
+} from "./index-bmmtz6r9.js";
 import {
   callRuntimeHandler,
   isRecord,

package/dist/index.js

@@ -21,7 +21,7 @@ import {
   parseTrailingWildcard,
   rateLimited,
   unauthorized
-} from "./index-cq9q73nf.js";
+} from "./index-j2nq04z6.js";
 import {
   isRecord,
   mapObject,
@@ -315,7 +315,7 @@ function joinBytes(left, right) {
   result.set(right, left.byteLength);
   return result;
 }
-async function* readBoundedUtf8Lines(response, maxLineBytes) {
+async function* readBoundedUtf8Lines(response, maxLineBytes, requireFinalNewline = false) {
   const reader = response.body?.getReader();
   if (!reader)
     return;
@@ -344,8 +344,12 @@ async function* readBoundedUtf8Lines(response, maxLineBytes) {
         throw new RangeError(`Stream line exceeds the ${limit} byte limit`);
       }
     }
-    if (pending.byteLength > 0)
+    if (pending.byteLength > 0) {
+      if (requireFinalNewline) {
+        throw new SyntaxError("Stream ended with an unterminated final line");
+      }
       yield decoder.decode(pending);
+    }
   } finally {
     await reader.cancel().catch(() => {
       return;
@@ -701,7 +705,7 @@ function parseFailure(raw, error, onParseError) {
 }
 async function* parseNDJSON(response, options) {
   try {
-    for await (const rawLine of readBoundedUtf8Lines(response, options?.maxLineBytes ?? DEFAULT_STREAM_LINE_BYTES)) {
+    for await (const rawLine of readBoundedUtf8Lines(response, options?.maxLineBytes ?? DEFAULT_STREAM_LINE_BYTES, options?.finalLine === "require-newline")) {
       const line = (rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine).trim();
       if (line === "")
         continue;
@@ -719,44 +723,67 @@ async function* parseNDJSON(response, options) {
 // src/browser/contract-stream.ts
 function sourceFor(response, descriptor) {
   const options = {
-    maxLineBytes: descriptor.maxFrameBytes ?? DEFAULT_CONTRACT_STREAM_FRAME_BYTES
+    maxLineBytes: descriptor.maxFrameBytes ?? DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
+    finalLine: descriptor.finalLine
   };
   return descriptor.format === "sse" ? parseSSE(response, options) : parseNDJSON(response, options);
 }
 async function* readContractStream(response, descriptor, abort) {
   let ended = false;
   let terminalSeen = descriptor.terminal === undefined;
+  const source = sourceFor(response, descriptor);
   try {
-    for await (const raw of sourceFor(response, descriptor)) {
-      const parsedFrame = ContractStreamFrameSchema.safeParse(raw);
-      if (!parsedFrame.success) {
-        throw new ApiError("STREAM_PROTOCOL_ERROR", 0, undefined, "Stream frame did not match the protocol envelope");
-      }
-      const frame = parsedFrame.data;
-      if (frame.type === "error") {
-        throw new ApiError(frame.error.code, 0, frame.error.details, frame.error.message, frame.error.hint);
-      }
-      if (frame.type === "end") {
-        if (!terminalSeen) {
-          throw new ApiError("STREAM_TERMINAL_MISSING", 0, undefined, "Stream completed before its declared terminal item");
+    for (;; ) {
+      const next = await source.next();
+      if (next.done)
+        break;
+      let candidate = next.value;
+      if (descriptor.framing !== "item") {
+        const parsedFrame = ContractStreamFrameSchema.safeParse(candidate);
+        if (!parsedFrame.success) {
+          throw new ApiError("STREAM_PROTOCOL_ERROR", 0, undefined, "Stream frame did not match the protocol envelope");
         }
-        ended = true;
-        return;
+        const frame = parsedFrame.data;
+        if (frame.type === "error") {
+          throw new ApiError(frame.error.code, 0, frame.error.details, frame.error.message, frame.error.hint);
+        }
+        if (frame.type === "end") {
+          if (!terminalSeen) {
+            throw new ApiError("STREAM_TERMINAL_MISSING", 0, undefined, "Stream completed before its declared terminal item");
+          }
+          ended = true;
+          return;
+        }
+        candidate = frame.data;
       }
-      const parsedItem = descriptor.item.safeParse(frame.data);
+      const parsedItem = descriptor.item.safeParse(candidate);
       if (!parsedItem.success) {
         throw new ApiError("STREAM_ITEM_INVALID", 0, undefined, "Stream item did not match its contract");
       }
       const item = parsedItem.data;
-      if (descriptor.terminal?.safeParse(item).success)
+      const terminal = descriptor.terminal?.safeParse(item).success ?? false;
+      if (terminal)
         terminalSeen = true;
+      if (terminal && descriptor.completion === "terminal") {
+        abort();
+        await source.return(undefined);
+        ended = true;
+      }
       yield item;
+      if (ended)
+        return;
+    }
+    if (descriptor.framing === "item") {
+      if (terminalSeen)
+        return;
+      throw new ApiError("STREAM_TERMINAL_MISSING", 0, undefined, "Stream completed before its declared terminal item");
     }
     if (!ended) {
       throw new ApiError("STREAM_TRUNCATED", 0, undefined, "Stream ended without its protocol terminal frame");
     }
   } finally {
     abort();
+    await source.return(undefined);
   }
 }
 

package/dist/internal/bounded-lines.d.ts

@@ -1,4 +1,4 @@
 export declare const DEFAULT_STREAM_LINE_BYTES: number;
 /** Bounded, fatal-UTF-8 line reader shared by NDJSON and SSE parsers. */
-export declare function readBoundedUtf8Lines(response: Response, maxLineBytes?: number): AsyncGenerator<string>;
+export declare function readBoundedUtf8Lines(response: Response, maxLineBytes?: number, requireFinalNewline?: boolean): AsyncGenerator<string>;
 //# sourceMappingURL=bounded-lines.d.ts.map

package/dist/internal/bounded-lines.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bounded-lines.d.ts","sourceRoot":"","sources":["../../src/internal/bounded-lines.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,QAAc,CAAC;AAkBrD,yEAAyE;AACzE,wBAAuB,oBAAoB,CACzC,QAAQ,EAAE,QAAQ,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,cAAc,CAAC,MAAM,CAAC,CAgCxB"}
+{"version":3,"file":"bounded-lines.d.ts","sourceRoot":"","sources":["../../src/internal/bounded-lines.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,QAAc,CAAC;AAkBrD,yEAAyE;AACzE,wBAAuB,oBAAoB,CACzC,QAAQ,EAAE,QAAQ,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,mBAAmB,UAAQ,GAC1B,cAAc,CAAC,MAAM,CAAC,CAqCxB"}

package/dist/node.js

@@ -5,7 +5,7 @@ import {
   createHandler,
   createSocketIOServer,
   createUnixClientTransport
-} from "./index-3vq6we8m.js";
+} from "./index-6tqys26z.js";
 import {
   createImplement,
   createImplementRegistry,
@@ -14,8 +14,8 @@ import {
   createScopedImplementRegistry,
   implement,
   implementRegistry
-} from "./index-pr0qsmjy.js";
-import"./index-69m2278y.js";
+} from "./index-z575awm9.js";
+import"./index-51a19y3v.js";
 import"./index-557by2db.js";
 import {
   ShutdownOptionsSchema,
@@ -24,7 +24,7 @@ import {
   ShutdownStatusSchema,
   createServerLifecycle
 } from "./index-dk6e56g0.js";
-import"./index-9ky9hhg3.js";
+import"./index-bmmtz6r9.js";
 import"./index-smpbdg6k.js";
 import {
   AppError,

package/dist/observability/index.js

@@ -10,7 +10,7 @@ import {
   redact,
   sanitizePayload,
   truncatePreview
-} from "../index-dafax5md.js";
+} from "../index-hmfpjnh7.js";
 import {
   getRequestContext,
   getTraceId,
@@ -21,7 +21,7 @@ import {
   setRequestError,
   setRequestUser,
   wrapInRequestContext
-} from "../index-69m2278y.js";
+} from "../index-51a19y3v.js";
 import {
   childSpan,
   createTraceContext,
@@ -30,7 +30,7 @@ import {
   recordedErrorMessage,
   resolvePropagationContext,
   resolveTraceContext
-} from "../index-9ky9hhg3.js";
+} from "../index-bmmtz6r9.js";
 import {
   isRecord
 } from "../index-smpbdg6k.js";

package/dist/remote.js

@@ -1,11 +1,11 @@
 import {
   ApiError,
   createClient
-} from "./index-2ve29dzn.js";
-import"./index-v5bayx1z.js";
+} from "./index-thcy3w8c.js";
+import"./index-r5s4wqb5.js";
 import {
   mergeMeta
-} from "./index-9ky9hhg3.js";
+} from "./index-bmmtz6r9.js";
 import {
   isRecord
 } from "./index-smpbdg6k.js";

package/dist/server/contract-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract-stream.d.ts","sourceRoot":"","sources":["../../src/server/contract-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAiB/C,gEAAgE;AAChE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,UAAU,EAAE,wBAAwB,EACpC,cAAc,EAAE,eAAe,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAmFnB"}
+{"version":3,"file":"contract-stream.d.ts","sourceRoot":"","sources":["../../src/server/contract-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAiB/C,gEAAgE;AAChE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,UAAU,EAAE,wBAAwB,EACpC,cAAc,EAAE,eAAe,GAC9B,OAAO,CAAC,QAAQ,CAAC,CA6FnB"}

package/dist/server/index.js

@@ -13,7 +13,7 @@ import {
   sseRoute,
   streamingRoute,
   webSocketLane
-} from "../index-3vq6we8m.js";
+} from "../index-6tqys26z.js";
 import {
   composeAuthHooks,
   createAuthHook,
@@ -26,7 +26,7 @@ import {
   signJwt,
   verifyJwt,
   verifyPkce
-} from "../index-wqyrvhzz.js";
+} from "../index-3ydx9j01.js";
 import {
   DEFAULT_CORS_ALLOW_HEADERS,
   DEFAULT_CORS_EXPOSE_HEADERS,
@@ -40,7 +40,7 @@ import {
   defineMultipartStream,
   implement,
   implementRegistry
-} from "../index-pr0qsmjy.js";
+} from "../index-z575awm9.js";
 import {
   extractIp,
   generateTraceId,
@@ -48,7 +48,7 @@ import {
   getTraceId,
   resolveSocketIp,
   resolveTraceId
-} from "../index-69m2278y.js";
+} from "../index-51a19y3v.js";
 import {
   isWithinDir,
   realPathWithinDir
@@ -69,7 +69,7 @@ import {
   inputIsQuery,
   parseSSE,
   streamSSE
-} from "../index-v5bayx1z.js";
+} from "../index-r5s4wqb5.js";
 import {
   DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
   errorCode,
@@ -78,7 +78,7 @@ import {
   normalizeError,
   parseTrailingWildcard,
   zodIssues
-} from "../index-9ky9hhg3.js";
+} from "../index-bmmtz6r9.js";
 import {
   isRecord
 } from "../index-smpbdg6k.js";
@@ -799,7 +799,10 @@ function generateOpenApiDocument(config) {
               schema: { type: "string" },
               "x-stitchkit-item-schema": safeJson(method.stream.item, "output"),
               "x-stitchkit-max-frame-bytes": method.stream.maxFrameBytes ?? DEFAULT_CONTRACT_STREAM_FRAME_BYTES,
-              "x-stitchkit-terminal-required": Boolean(method.stream.terminal)
+              "x-stitchkit-terminal-required": Boolean(method.stream.terminal),
+              "x-stitchkit-stream-framing": method.stream.framing ?? "envelope",
+              "x-stitchkit-stream-completion": method.stream.completion ?? "stream-end",
+              "x-stitchkit-final-line": method.stream.finalLine ?? "allow"
             }
           }
         };

package/dist/server/openapi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/server/openapi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,iFAAiF;IACjF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAC;IAChE,oCAAoC;IACpC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAChD;AA6DD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CA8L9E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,QAAQ,CAM9E"}
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/server/openapi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,iFAAiF;IACjF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAC;IAChE,oCAAoC;IACpC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAChD;AA6DD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAiM9E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,QAAQ,CAM9E"}