@latchway/langchain 0.0.0-bootstrap.0 → 1.0.0

package/NOTICE

@@ -0,0 +1,7 @@
+Latchway JavaScript SDK
+Copyright 2026 Latchway contributors
+
+This product includes software developed by Latchway contributors.
+
+The Code of Conduct is adapted from Contributor Covenant version 2.1,
+licensed under the Creative Commons Attribution 4.0 International License.

package/README.md

@@ -1,5 +1,23 @@
-# @latchway/langchain
+# `@latchway/langchain`
 
-This is an inert, one-time namespace bootstrap package. It contains no runtime implementation and must not be used as an SDK dependency.
+The LangChain.js adapter configures `ChatOpenAI` and `OpenAIEmbeddings` through
+their underlying OpenAI client options. It does not introduce chains, agents,
+graphs, memory, retrieval, or tool execution.
 
-The maintained source repository is https://github.com/Latchway/latchway-js.git.
+```ts
+import { createLatchwayChatOpenAI } from "@latchway/langchain";
+
+const model = createLatchwayChatOpenAI({
+  latchway,
+  feature: "habit-assistant",
+});
+
+const message = await model.invoke("Summarize today");
+```
+
+The generated OpenAI-compatible model value is `latchway`; it is not a
+physical model selection. Streaming, batching, tools, structured output,
+cancellation, callbacks, and framework retries remain LangChain behavior over
+the authenticated transport. Latchway correlation IDs are mirrored to the
+underlying OpenAI client's conventional request-ID header without buffering
+the response.

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { ChatOpenAI, type ChatOpenAIFields, OpenAIEmbeddings, type OpenAIEmbeddingsParams } from "@langchain/openai";
+export interface AuthenticatedTransport {
+    readonly gatewayURL: string;
+    fetchFor(feature: string, framework: Readonly<{
+        id: "langchain-js";
+        version: string;
+    }>): (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+}
+export type LatchwayChatOpenAIOptions = Omit<ChatOpenAIFields, "apiKey" | "configuration" | "model" | "modelName" | "openAIApiKey">;
+export interface CreateLatchwayChatOpenAIOptions {
+    latchway: AuthenticatedTransport;
+    feature: string;
+    chatOptions?: LatchwayChatOpenAIOptions;
+}
+export type LatchwayEmbeddingsOptions = Omit<Partial<OpenAIEmbeddingsParams>, "model" | "modelName">;
+export interface CreateLatchwayEmbeddingsOptions {
+    latchway: AuthenticatedTransport;
+    feature: string;
+    embeddingsOptions?: LatchwayEmbeddingsOptions;
+}
+export declare function createLatchwayChatOpenAI(options: CreateLatchwayChatOpenAIOptions): ChatOpenAI;
+export declare function createLatchwayEmbeddings(options: CreateLatchwayEmbeddingsOptions): OpenAIEmbeddings;
+export declare const LANGCHAIN_OPENAI_VERSION: string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,QAAQ,CAAC;QAAE,EAAE,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAC3D,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxE;AAED,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,gBAAgB,EAChB,QAAQ,GAAG,eAAe,GAAG,OAAO,GAAG,WAAW,GAAG,cAAc,CACpE,CAAC;AAEF,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,yBAAyB,CAAC;CACzC;AAED,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,OAAO,CAAC,sBAAsB,CAAC,EAC/B,OAAO,GAAG,WAAW,CACtB,CAAC;AAEF,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,yBAAyB,CAAC;CAC/C;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,+BAA+B,GAAG,UAAU,CAc7F;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,+BAA+B,GAAG,gBAAgB,CAenG;AAED,eAAO,MAAM,wBAAwB,QAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,61 @@
+import { ChatOpenAI, OpenAIEmbeddings, } from "@langchain/openai";
+import langchainOpenAIPackage from "@langchain/openai/package.json" with { type: "json" };
+const frameworkVersion = langchainOpenAIPackage.version;
+const placeholder = "latchway-managed-not-a-provider-secret";
+export function createLatchwayChatOpenAI(options) {
+    const authenticatedFetch = options.latchway.fetchFor(options.feature, {
+        id: "langchain-js",
+        version: frameworkVersion,
+    });
+    return new ChatOpenAI({
+        ...options.chatOptions,
+        apiKey: placeholder,
+        model: "latchway",
+        configuration: {
+            baseURL: `${options.latchway.gatewayURL}/v1`,
+            fetch: withProviderRequestID(authenticatedFetch),
+        },
+    });
+}
+export function createLatchwayEmbeddings(options) {
+    const authenticatedFetch = options.latchway.fetchFor(options.feature, {
+        id: "langchain-js",
+        version: frameworkVersion,
+    });
+    return new OpenAIEmbeddings({
+        ...options.embeddingsOptions,
+        apiKey: placeholder,
+        encodingFormat: "float",
+        model: "latchway",
+        configuration: {
+            baseURL: `${options.latchway.gatewayURL}/v1`,
+            fetch: withProviderRequestID(authenticatedFetch),
+        },
+    });
+}
+export const LANGCHAIN_OPENAI_VERSION = frameworkVersion;
+function withProviderRequestID(fetch) {
+    return async (input, init) => aliasRequestID(await fetch(input, init));
+}
+function aliasRequestID(response) {
+    const requestID = response.headers.get("X-Latchway-Request-ID");
+    if (requestID === null || response.headers.has("X-Request-ID"))
+        return response;
+    const headers = new Headers(response.headers);
+    headers.set("X-Request-ID", requestID);
+    const aliased = new Response(response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+    preserveResponseLocation(aliased, response);
+    return aliased;
+}
+function preserveResponseLocation(target, source) {
+    Object.defineProperties(target, {
+        redirected: { value: source.redirected },
+        type: { value: source.type },
+        url: { value: source.url },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,gBAAgB,GAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,sBAAsB,MAAM,gCAAgC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE1F,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,OAAO,CAAC;AACxD,MAAM,WAAW,GAAG,wCAAwC,CAAC;AAgC7D,MAAM,UAAU,wBAAwB,CAAC,OAAwC;IAC/E,MAAM,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE;QACpE,EAAE,EAAE,cAAc;QAClB,OAAO,EAAE,gBAAgB;KAC1B,CAAC,CAAC;IACH,OAAO,IAAI,UAAU,CAAC;QACpB,GAAG,OAAO,CAAC,WAAW;QACtB,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,UAAU;QACjB,aAAa,EAAE;YACb,OAAO,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,KAAK;YAC5C,KAAK,EAAE,qBAAqB,CAAC,kBAAkB,CAAC;SACjD;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAwC;IAC/E,MAAM,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE;QACpE,EAAE,EAAE,cAAc;QAClB,OAAO,EAAE,gBAAgB;KAC1B,CAAC,CAAC;IACH,OAAO,IAAI,gBAAgB,CAAC;QAC1B,GAAG,OAAO,CAAC,iBAAiB;QAC5B,MAAM,EAAE,WAAW;QACnB,cAAc,EAAE,OAAO;QACvB,KAAK,EAAE,UAAU;QACjB,aAAa,EAAE;YACb,OAAO,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,KAAK;YAC5C,KAAK,EAAE,qBAAqB,CAAC,kBAAkB,CAAC;SACjD;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAEzD,SAAS,qBAAqB,CAC5B,KAA0E;IAE1E,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,cAAc,CAAC,QAAkB;IACxC,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAChE,IAAI,SAAS,KAAK,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC1C,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,OAAO;KACR,CAAC,CAAC;IACH,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAgB,EAAE,MAAgB;IAClE,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE;QAC9B,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE;QACxC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE;QAC5B,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE;KAC3B,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,10 +1,19 @@
 {
   "name": "@latchway/langchain",
-  "version": "0.0.0-bootstrap.0",
-  "description": "Reserved namespace bootstrap for the Latchway LangChain adapter.",
+  "version": "1.0.0",
+  "description": "Feature-bound Latchway transport adapter for LangChain.js OpenAI integrations",
   "license": "Apache-2.0",
+  "engines": {
+    "node": ">=24.19.0"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "files": [
+    "dist",
     "LICENSE",
+    "NOTICE",
     "README.md"
   ],
   "repository": {
@@ -13,8 +22,20 @@
     "directory": "packages/langchain"
   },
   "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/",
-    "tag": "bootstrap"
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@langchain/openai": "1.5.10",
+    "@latchway/client": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
   }
-}
+}