@ap3x/ai 0.1.0

package/dist/utils/node-http-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-http-proxy.d.ts","sourceRoot":"","sources":["../../src/utils/node-http-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,oFAAoF;AACpF,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAY1D,yEAAyE;AACzE,eAAO,MAAM,kCAAkC,gHACgE,CAAC;AA8DhH;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,GAAG,GAAG,EACvB,GAAG,GAAE,QAAsB,GAC1B,GAAG,GAAG,SAAS,CAiBjB"}

package/dist/utils/overflow.d.ts

@@ -0,0 +1,25 @@
+import type { AssistantMessage } from "../types";
+/**
+ * Decide whether an assistant message represents a context-window overflow.
+ *
+ * Three signals are considered:
+ *
+ * 1. Error text: an `error` message whose `errorMessage` matches a known
+ *    overflow signature (and is not excluded as a throttling/rate-limit error).
+ * 2. Silent overflow: a successful `stop` message whose reported input tokens
+ *    exceed the supplied context window (e.g. z.ai accepts the request anyway).
+ * 3. Length-stop overflow: a `length` stop with zero output where the input
+ *    nearly fills the context window, i.e. the server truncated an oversized
+ *    prompt leaving no room to generate (e.g. Xiaomi MiMo).
+ *
+ * Cases 2 and 3 require the optional `contextWindow` argument. The function is
+ * total: it never throws for any message shape.
+ *
+ * @param message - The assistant message to classify.
+ * @param contextWindow - Optional context-window size enabling silent-overflow
+ *   and length-stop detection.
+ */
+export declare function isContextOverflow(message: AssistantMessage, contextWindow?: number): boolean;
+/** Return a copy of the overflow error signatures (primarily for tests). */
+export declare function getOverflowPatterns(): RegExp[];
+//# sourceMappingURL=overflow.d.ts.map

package/dist/utils/overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow.d.ts","sourceRoot":"","sources":["../../src/utils/overflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAuEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAuB5F;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}

package/dist/utils/sanitize-unicode.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Strip unpaired UTF-16 surrogate code units from a string. Unpaired
+ * surrogates break JSON serialization at many providers; correctly paired
+ * surrogates (valid emoji and other astral-plane characters) are preserved.
+ *
+ * @example sanitizeSurrogates("Hello \u{1F648} World") // => "Hello \u{1F648} World"
+ */
+export declare function sanitizeSurrogates(text: string): string;
+//# sourceMappingURL=sanitize-unicode.d.ts.map

package/dist/utils/sanitize-unicode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-unicode.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize-unicode.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/utils/sse.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A decoded Server-Sent Event: the `event:` type (or null), the joined `data:`
+ * payload, and the raw source lines (for diagnostics on a parse failure).
+ */
+export interface ServerSentEvent {
+    event: string | null;
+    data: string;
+    raw: string[];
+}
+/**
+ * Parse a `ReadableStream` of bytes into Server-Sent Events. Handles `\n`,
+ * `\r`, and `\r\n` line breaks and flushes a trailing event at end-of-stream.
+ * Throws `Request was aborted` if `signal` aborts mid-read.
+ */
+export declare function iterateServerSentEvents(body: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<ServerSentEvent>;
+/**
+ * Parse SSE events from an in-memory string. Convenience wrapper used by tests
+ * to feed canned SSE through the same decoder the network path uses.
+ */
+export declare function parseServerSentEventsFromString(text: string): Generator<ServerSentEvent>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/utils/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/utils/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAmED;;;;GAIG;AACH,wBAAuB,uBAAuB,CAC5C,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,eAAe,CAAC,CAyCjC;AAED;;;GAGG;AACH,wBAAiB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,eAAe,CAAC,CAgBzF"}

package/dist/validation.d.ts

@@ -0,0 +1,31 @@
+import { type TUnsafe } from "@sinclair/typebox";
+import type { Tool, ToolCall } from "./types";
+export type { Static, TSchema } from "@sinclair/typebox";
+export { Type } from "@sinclair/typebox";
+/**
+ * Build a JSON-Schema string-enum (`{ type: "string", enum: [...] }`). This is
+ * compatible with providers (e.g. Google) that reject `anyOf`/`const` unions.
+ *
+ * @example const Op = StringEnum(["add", "sub"], { description: "operation" });
+ */
+export declare function StringEnum<T extends readonly string[]>(values: T, options?: {
+    description?: string;
+    default?: T[number];
+}): TUnsafe<T[number]>;
+/**
+ * Find a tool by name and validate the call's arguments against its schema.
+ * @throws if the tool is missing or validation fails.
+ */
+export declare function validateToolCall(tools: Tool[], toolCall: ToolCall): Record<string, any>;
+/**
+ * Validate (and coerce) a tool call's arguments against the tool schema.
+ *
+ * The args are cloned, then validated by the appropriate engine: TypeBox
+ * schemas (carrying the `Kind` metadata symbol) go through `Value.Convert` +
+ * a compiled `TypeCheck`; plain JSON schemas go through AJV (which compiles to
+ * a guard and performs permissive in-place type coercion). On failure a
+ * multi-line error listing each failing path plus the received arguments is
+ * thrown.
+ */
+export declare function validateToolArguments(tool: Tool, toolCall: ToolCall): Record<string, any>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,OAAO,EAAQ,MAAM,mBAAmB,CAAC;AAIxF,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE9C,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EACpD,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;CAAE,GACtD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAOpB;AAqHD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAMvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CASzF"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@ap3x/ai",
+  "version": "0.1.0",
+  "description": "Unified multi-provider LLM API (OpenAI, Anthropic, Google, Bedrock, Mistral, …)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AP3X-Dev/AP3X.git",
+    "directory": "packages/ai"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean --tsconfig tsconfig.build.json && tsc -p tsconfig.build.json",
+    "prepublishOnly": "node ../../scripts/publish-gate.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.49",
+    "ajv": "^8.20.0",
+    "partial-json": "^0.1.7",
+    "undici": "^6.21.3"
+  }
+}