@intelligo-dev/chat 1.0.0-beta.13

package/dist/generation.js

@@ -0,0 +1,85 @@
+/**
+ * The `streamText` options a product may set per turn: how the model
+ * samples (temperature, a token ceiling, a tool choice, a seed), none of
+ * which changes what settlement reads back. Written out as an allowlist
+ * rather than an `Omit<>` over the SDK's type, so an option a later SDK adds
+ * is not admitted silently.
+ *
+ * What the transport keeps, and why each one is not negotiable:
+ *
+ *   `abortSignal`   without `request.signal` an abandoned run bills in
+ *                   full and `onAbort` never fires.
+ *   `timeout`       a timeout lands on the error path, which releases
+ *                   the hold without charging tokens the provider has
+ *                   already produced. The route's deadline is
+ *                   `maxDuration`.
+ *   `onFinish`,     the transport captures `totalUsage` there; replacing
+ *   `onEnd`         it means every turn ends "stream ended without
+ *                   usage".
+ *   `onAbort`       settles from `sumStepUsage(steps)`.
+ *   `onError`       the failure path is `run.fail()` plus localised copy.
+ *   `model`         admission already priced the resolved `modelId`;
+ *                   another model bills one admission never saw.
+ *   `system`,       `prepareMessages` owns what the model is shown.
+ *   `messages`,
+ *   `prompt`,
+ *   `instructions`
+ *   `tools`,        already seams on the agent, and the same object
+ *   `activeTools`   feeds `convertToModelMessages`; a second source
+ *                   desynchronises the two.
+ *   `stopWhen`      `stepCountIs(maxSteps)` must stay first and
+ *                   unremovable — an uncapped step count is an uncapped
+ *                   bill. `ResolvedAgent.stopWhen` appends to it.
+ *   `_internal`     the SDK's own test seam, not a product knob.
+ *
+ * Enforced three ways, because a cast defeats the type: the type itself,
+ * `pickGenerationOptions` copying only `GENERATION_KEYS` at runtime, and the
+ * handler spreading the result *first* so the transport's own keys win.
+ */
+/**
+ * Every key of `ChatGenerationOptions`, as values.
+ *
+ * `satisfies` proves the array holds only real keys; `Exhaustive` below
+ * proves it holds all of them, so a field added to the interface
+ * without a line here is a compile error rather than an option that
+ * silently never reaches the model.
+ */
+export const GENERATION_KEYS = [
+    "maxOutputTokens",
+    "temperature",
+    "topP",
+    "topK",
+    "presencePenalty",
+    "frequencyPenalty",
+    "stopSequences",
+    "seed",
+    "reasoning",
+    "maxRetries",
+    "headers",
+    "toolChoice",
+    "prepareStep",
+    "telemetry",
+    "experimental_transform",
+    "onStepEnd",
+];
+// Stryker disable next-line BooleanLiteral: equivalent — the assertion is the type annotation, which `tsc` checks and the test runner's transform strips; the value itself is never read, so `false` changes nothing a test could observe.
+const _exhaustive = true;
+void _exhaustive;
+/**
+ * The allowlisted options, copied by name.
+ *
+ * Absent keys produce no own property rather than an explicit
+ * `undefined`: the handler spreads the result into a call where a
+ * present-but-undefined key would override the SDK's own default.
+ */
+export function pickGenerationOptions(options) {
+    if (!options)
+        return {};
+    const picked = {};
+    for (const key of GENERATION_KEYS) {
+        if (options[key] !== undefined)
+            picked[key] = options[key];
+    }
+    return picked;
+}
+//# sourceMappingURL=generation.js.map

package/dist/generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.js","sourceRoot":"","sources":["../src/generation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AA4DH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,iBAAiB;IACjB,aAAa;IACb,MAAM;IACN,MAAM;IACN,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,MAAM;IACN,WAAW;IACX,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,aAAa;IACb,WAAW;IACX,wBAAwB;IACxB,WAAW;CACkD,CAAC;AAOhE,2OAA2O;AAC3O,MAAM,WAAW,GAAyC,IAAI,CAAC;AAC/D,KAAK,WAAW,CAAC;AAEjB;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAA0C;IAE1C,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAwC,CAAC;AAClD,CAAC"}

package/dist/handler.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The chat transport: one turn, from request to settled execution.
+ *
+ *   onRequest → parse → authenticate → rate limit → load the row →
+ *   resolveAgent → feature gate → model gate → create the row →
+ *   prepareMessages → executions.begin() → streamText | streamTurn →
+ *   settle → persist.
+ *
+ * Web `Request` in, `Response` out; request headers reach
+ * `requireWorkspace()` through `core/request-context`, never `next/*`.
+ *
+ * Entitlement is decided at `executions.begin()`, after the agent and
+ * model are resolved, so the hold matches what will actually run.
+ * Everything before it is cheaper and answers without opening an execution.
+ *
+ * Every terminal path settles exactly once: `complete()` is
+ * compare-and-swap in the boundary, so whichever of finish, abort or
+ * error gets there first wins and the others are no-ops.
+ */
+import type { ChatServerConfig } from "./config.js";
+export type ChatHandler = {
+    POST: (request: Request) => Promise<Response>;
+    DELETE: (request: Request) => Promise<Response>;
+    /** Stream resumption. Answers 204: no turn is resumable on this transport. */
+    GET: (request: Request) => Promise<Response>;
+    /** The CORS preflight, when `cors` is configured; 204 otherwise. */
+    OPTIONS: (request: Request) => Promise<Response>;
+};
+export declare function createChatHandler(config: ChatServerConfig): ChatHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAiDH,OAAO,KAAK,EAEV,gBAAgB,EAMjB,MAAM,UAAU,CAAC;AAgJlB,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,8EAA8E;IAC9E,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7C,oEAAoE;IACpE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAClD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAu6BvE"}