@dbx-tools/shared-graphiti 0.9.43

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,64 @@
+# @dbx-tools/shared-graphiti
+
+Use the browser-safe Graphiti option contract from Node, AppKit, browser tools,
+or generated language bindings. This package owns defaults, validation,
+environment parsing, and model-gateway ownership rules so every runtime accepts
+the same configuration.
+
+## Resolve Runtime Options
+
+```ts
+import { resolveGraphitiOptions } from "@dbx-tools/shared-graphiti/options";
+
+const options = resolveGraphitiOptions({
+  profile: "MY-PROFILE",
+  model: "gpt 5",
+  embedderModel: "gte large",
+});
+```
+
+The result includes stable listener, model, embedding, gateway, and structured
+output defaults. Supplying `modelGatewayUrl` selects an existing gateway unless
+`manageModelGateway` explicitly opts back into local ownership.
+
+## Serialize A Child Runtime
+
+Use the shared serializer when a Node host starts the Python Graphiti runtime:
+
+```ts
+import {
+  GRAPHITI_OPTIONS_ENV,
+  serializeGraphitiOptions,
+} from "@dbx-tools/shared-graphiti/options";
+
+const environment = {
+  [GRAPHITI_OPTIONS_ENV]: serializeGraphitiOptions({
+    profile: "MY-PROFILE",
+    falkorDataDir: "/var/lib/agent-memory",
+  }),
+};
+```
+
+The Python binding consumes this exact validated record. Do not add parallel
+environment parsing or option types in a CLI, AppKit plugin, or language
+runtime.
+
+## Build Provider Environment
+
+Use `graphitiEnvironment` to derive the OpenAI-compatible variables expected by
+Graphiti without duplicating model, embedding, key, or structured-output
+mapping:
+
+```ts
+import { graphitiEnvironment } from "@dbx-tools/shared-graphiti/options";
+
+const environment = graphitiEnvironment({
+  modelGatewayUrl: "http://127.0.0.1:4000/v1",
+  manageModelGateway: false,
+  model: "databricks-gpt-5",
+});
+```
+
+Zod schemas own runtime validation and inferred input/output types. Process
+launching, Databricks authentication, model discovery, and service lifecycle
+remain with their Node and CLI owners.

package/exports.ts

@@ -0,0 +1,8 @@
+export {
+  graphitiEnvironment,
+  graphitiGatewayHealthUrl,
+  graphitiOptionOverrides,
+  graphitiOptionsFromEnvironment,
+  resolveGraphitiOptions,
+  serializeGraphitiOptions,
+} from "./src/options.ts";

package/index.ts

@@ -0,0 +1,10 @@
+// GENERATED by projen watch - DO NOT EDIT.
+// Regenerated from the exporting modules in ./src.
+// Hand edits are overwritten on the next watch; this file is read-only.
+
+export const PACKAGE_IDENTIFIER = "@dbx-tools/shared-graphiti";
+export const PACKAGE_VERSION = "0.9.43";
+export * as options from "./src/options.ts";
+export { GRAPHITI_OPTIONS_ENV, GraphitiOptionsSchema, GraphitiCliOptionsSchema, GRAPHITI_DEFAULTS, ResolvedGraphitiOptionsSchema } from "./src/options.ts";
+export type { GraphitiOptions, ResolvedGraphitiOptions } from "./src/options.ts";
+export * from "./exports.ts";

package/lib/exports.d.ts

@@ -0,0 +1 @@
+export { graphitiEnvironment, graphitiGatewayHealthUrl, graphitiOptionOverrides, graphitiOptionsFromEnvironment, resolveGraphitiOptions, serializeGraphitiOptions, } from "./src/options.ts";

package/lib/exports.js

@@ -0,0 +1,2 @@
+export { graphitiEnvironment, graphitiGatewayHealthUrl, graphitiOptionOverrides, graphitiOptionsFromEnvironment, resolveGraphitiOptions, serializeGraphitiOptions, } from "./src/options.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXhwb3J0cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL2V4cG9ydHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUNMLG1CQUFtQixFQUNuQix3QkFBd0IsRUFDeEIsdUJBQXVCLEVBQ3ZCLDhCQUE4QixFQUM5QixzQkFBc0IsRUFDdEIsd0JBQXdCLEdBQ3pCLE1BQU0sa0JBQWtCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQge1xuICBncmFwaGl0aUVudmlyb25tZW50LFxuICBncmFwaGl0aUdhdGV3YXlIZWFsdGhVcmwsXG4gIGdyYXBoaXRpT3B0aW9uT3ZlcnJpZGVzLFxuICBncmFwaGl0aU9wdGlvbnNGcm9tRW52aXJvbm1lbnQsXG4gIHJlc29sdmVHcmFwaGl0aU9wdGlvbnMsXG4gIHNlcmlhbGl6ZUdyYXBoaXRpT3B0aW9ucyxcbn0gZnJvbSBcIi4vc3JjL29wdGlvbnMudHNcIjtcbiJdfQ==

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+export declare const PACKAGE_IDENTIFIER = "@dbx-tools/shared-graphiti";
+export declare const PACKAGE_VERSION = "0.9.43";
+export * as options from "./src/options.ts";
+export { GRAPHITI_OPTIONS_ENV, GraphitiOptionsSchema, GraphitiCliOptionsSchema, GRAPHITI_DEFAULTS, ResolvedGraphitiOptionsSchema } from "./src/options.ts";
+export type { GraphitiOptions, ResolvedGraphitiOptions } from "./src/options.ts";
+export * from "./exports.ts";

package/lib/index.js

@@ -0,0 +1,9 @@
+// GENERATED by projen watch - DO NOT EDIT.
+// Regenerated from the exporting modules in ./src.
+// Hand edits are overwritten on the next watch; this file is read-only.
+export const PACKAGE_IDENTIFIER = "@dbx-tools/shared-graphiti";
+export const PACKAGE_VERSION = "0.9.43";
+export * as options from "./src/options.js";
+export { GRAPHITI_OPTIONS_ENV, GraphitiOptionsSchema, GraphitiCliOptionsSchema, GRAPHITI_DEFAULTS, ResolvedGraphitiOptionsSchema } from "./src/options.js";
+export * from "./exports.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyw0QkFBNEIsQ0FBQztBQUMvRCxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsUUFBUSxDQUFDO0FBQ3hDLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxFQUFFLG9CQUFvQixFQUFFLHFCQUFxQixFQUFFLHdCQUF3QixFQUFFLGlCQUFpQixFQUFFLDZCQUE2QixFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFFM0osY0FBYyxjQUFjLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBHRU5FUkFURUQgYnkgcHJvamVuIHdhdGNoIC0gRE8gTk9UIEVESVQuXG4vLyBSZWdlbmVyYXRlZCBmcm9tIHRoZSBleHBvcnRpbmcgbW9kdWxlcyBpbiAuL3NyYy5cbi8vIEhhbmQgZWRpdHMgYXJlIG92ZXJ3cml0dGVuIG9uIHRoZSBuZXh0IHdhdGNoOyB0aGlzIGZpbGUgaXMgcmVhZC1vbmx5LlxuXG5leHBvcnQgY29uc3QgUEFDS0FHRV9JREVOVElGSUVSID0gXCJAZGJ4LXRvb2xzL3NoYXJlZC1ncmFwaGl0aVwiO1xuZXhwb3J0IGNvbnN0IFBBQ0tBR0VfVkVSU0lPTiA9IFwiMC45LjQzXCI7XG5leHBvcnQgKiBhcyBvcHRpb25zIGZyb20gXCIuL3NyYy9vcHRpb25zLnRzXCI7XG5leHBvcnQgeyBHUkFQSElUSV9PUFRJT05TX0VOViwgR3JhcGhpdGlPcHRpb25zU2NoZW1hLCBHcmFwaGl0aUNsaU9wdGlvbnNTY2hlbWEsIEdSQVBISVRJX0RFRkFVTFRTLCBSZXNvbHZlZEdyYXBoaXRpT3B0aW9uc1NjaGVtYSB9IGZyb20gXCIuL3NyYy9vcHRpb25zLnRzXCI7XG5leHBvcnQgdHlwZSB7IEdyYXBoaXRpT3B0aW9ucywgUmVzb2x2ZWRHcmFwaGl0aU9wdGlvbnMgfSBmcm9tIFwiLi9zcmMvb3B0aW9ucy50c1wiO1xuZXhwb3J0ICogZnJvbSBcIi4vZXhwb3J0cy50c1wiO1xuIl19

package/lib/src/options.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Browser-safe Graphiti configuration shared by every runtime.
+ *
+ * This module owns the Graphiti option schema, defaults, environment mapping,
+ * and derived gateway settings. CLIs, AppKit integrations, and generated
+ * bindings should pass this configuration through rather than recreating it.
+ *
+ * @module
+ */
+import { z } from "zod";
+/** Environment variable carrying one serialized {@link GraphitiOptions} object. */
+export declare const GRAPHITI_OPTIONS_ENV = "DBX_GRAPHITI_OPTIONS";
+export declare const GraphitiOptionsSchema: z.ZodObject<{
+    python: z.ZodDefault<z.ZodString>;
+    profile: z.ZodOptional<z.ZodString>;
+    graphitiHome: z.ZodOptional<z.ZodString>;
+    model: z.ZodDefault<z.ZodString>;
+    embedderModel: z.ZodDefault<z.ZodString>;
+    embedderDimensions: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    modelGatewayUrl: z.ZodOptional<z.ZodString>;
+    modelGatewayHost: z.ZodDefault<z.ZodString>;
+    modelGatewayPort: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    modelGatewayCommand: z.ZodOptional<z.ZodString>;
+    manageModelGateway: z.ZodOptional<z.ZodBoolean>;
+    openAiApiKey: z.ZodOptional<z.ZodString>;
+    structuredOutputMode: z.ZodDefault<z.ZodString>;
+    graphitiHost: z.ZodDefault<z.ZodString>;
+    graphitiPort: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    falkorDataDir: z.ZodOptional<z.ZodString>;
+    falkorSnapshotSeconds: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    falkorSnapshotMinChanges: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    graphitiArgs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/** Graphiti options represented as Commander flags rather than positional arguments. */
+export declare const GraphitiCliOptionsSchema: z.ZodObject<{
+    profile: z.ZodOptional<z.ZodString>;
+    python: z.ZodDefault<z.ZodString>;
+    graphitiHome: z.ZodOptional<z.ZodString>;
+    model: z.ZodDefault<z.ZodString>;
+    embedderModel: z.ZodDefault<z.ZodString>;
+    embedderDimensions: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    modelGatewayUrl: z.ZodOptional<z.ZodString>;
+    modelGatewayHost: z.ZodDefault<z.ZodString>;
+    modelGatewayPort: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    modelGatewayCommand: z.ZodOptional<z.ZodString>;
+    manageModelGateway: z.ZodOptional<z.ZodBoolean>;
+    openAiApiKey: z.ZodOptional<z.ZodString>;
+    structuredOutputMode: z.ZodDefault<z.ZodString>;
+    graphitiHost: z.ZodDefault<z.ZodString>;
+    graphitiPort: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    falkorDataDir: z.ZodOptional<z.ZodString>;
+    falkorSnapshotSeconds: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    falkorSnapshotMinChanges: z.ZodDefault<z.ZodCoercedNumber<number>>;
+}, z.core.$strict>;
+export type GraphitiOptions = z.input<typeof GraphitiOptionsSchema>;
+/** Defaults derived from the owning schema rather than maintained separately. */
+export declare const GRAPHITI_DEFAULTS: Readonly<{
+    python: string;
+    model: string;
+    embedderModel: string;
+    embedderDimensions: number;
+    modelGatewayHost: string;
+    modelGatewayPort: number;
+    structuredOutputMode: string;
+    graphitiHost: string;
+    graphitiPort: number;
+    falkorSnapshotSeconds: number;
+    falkorSnapshotMinChanges: number;
+    graphitiArgs: string[];
+    profile?: string | undefined;
+    graphitiHome?: string | undefined;
+    modelGatewayUrl?: string | undefined;
+    modelGatewayCommand?: string | undefined;
+    manageModelGateway?: boolean | undefined;
+    openAiApiKey?: string | undefined;
+    falkorDataDir?: string | undefined;
+}>;
+/** Keep only explicitly supplied Graphiti fields and validate their values. */
+export declare function graphitiOptionOverrides(value: unknown): GraphitiOptions;
+export declare const ResolvedGraphitiOptionsSchema: z.ZodPipe<z.ZodObject<{
+    python: z.ZodDefault<z.ZodString>;
+    profile: z.ZodOptional<z.ZodString>;
+    graphitiHome: z.ZodOptional<z.ZodString>;
+    model: z.ZodDefault<z.ZodString>;
+    embedderModel: z.ZodDefault<z.ZodString>;
+    embedderDimensions: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    modelGatewayUrl: z.ZodOptional<z.ZodString>;
+    modelGatewayHost: z.ZodDefault<z.ZodString>;
+    modelGatewayPort: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    modelGatewayCommand: z.ZodOptional<z.ZodString>;
+    manageModelGateway: z.ZodOptional<z.ZodBoolean>;
+    openAiApiKey: z.ZodOptional<z.ZodString>;
+    structuredOutputMode: z.ZodDefault<z.ZodString>;
+    graphitiHost: z.ZodDefault<z.ZodString>;
+    graphitiPort: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    falkorDataDir: z.ZodOptional<z.ZodString>;
+    falkorSnapshotSeconds: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    falkorSnapshotMinChanges: z.ZodDefault<z.ZodCoercedNumber<number>>;
+    graphitiArgs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodTransform<{
+    modelGatewayUrl: string;
+    manageModelGateway: boolean;
+    openAiApiKey: string;
+    python: string;
+    model: string;
+    embedderModel: string;
+    embedderDimensions: number;
+    modelGatewayHost: string;
+    modelGatewayPort: number;
+    structuredOutputMode: string;
+    graphitiHost: string;
+    graphitiPort: number;
+    falkorSnapshotSeconds: number;
+    falkorSnapshotMinChanges: number;
+    graphitiArgs: string[];
+    profile?: string | undefined;
+    graphitiHome?: string | undefined;
+    modelGatewayCommand?: string | undefined;
+    falkorDataDir?: string | undefined;
+}, {
+    python: string;
+    model: string;
+    embedderModel: string;
+    embedderDimensions: number;
+    modelGatewayHost: string;
+    modelGatewayPort: number;
+    structuredOutputMode: string;
+    graphitiHost: string;
+    graphitiPort: number;
+    falkorSnapshotSeconds: number;
+    falkorSnapshotMinChanges: number;
+    graphitiArgs: string[];
+    profile?: string | undefined;
+    graphitiHome?: string | undefined;
+    modelGatewayUrl?: string | undefined;
+    modelGatewayCommand?: string | undefined;
+    manageModelGateway?: boolean | undefined;
+    openAiApiKey?: string | undefined;
+    falkorDataDir?: string | undefined;
+}>>;
+export type ResolvedGraphitiOptions = z.output<typeof ResolvedGraphitiOptionsSchema>;
+/** Apply shared defaults and validate cross-runtime invariants. */
+export declare function resolveGraphitiOptions(options?: GraphitiOptions): ResolvedGraphitiOptions;
+/** Serialize resolved options for the internal Python runtime boundary. */
+export declare function serializeGraphitiOptions(options?: GraphitiOptions): string;
+/** Parse Graphiti option overrides from an explicit environment record. */
+export declare function graphitiOptionsFromEnvironment(environment: Readonly<Record<string, string | undefined>>): GraphitiOptions;
+/** Return the managed model gateway health endpoint. */
+export declare function graphitiGatewayHealthUrl(options?: GraphitiOptions): string;
+/** Return Graphiti provider environment variables from resolved shared options. */
+export declare function graphitiEnvironment(options?: GraphitiOptions): Record<string, string>;

package/lib/src/options.js

@@ -0,0 +1,141 @@
+/**
+ * Browser-safe Graphiti configuration shared by every runtime.
+ *
+ * This module owns the Graphiti option schema, defaults, environment mapping,
+ * and derived gateway settings. CLIs, AppKit integrations, and generated
+ * bindings should pass this configuration through rather than recreating it.
+ *
+ * @module
+ */
+import { options } from "@dbx-tools/shared-core";
+import { z } from "zod";
+/** Environment variable carrying one serialized {@link GraphitiOptions} object. */
+export const GRAPHITI_OPTIONS_ENV = "DBX_GRAPHITI_OPTIONS";
+const graphitiText = (description) => z.string().trim().min(1).describe(description);
+const graphitiPort = (description) => options.tcpPortOrZeroSchema.describe(description);
+export const GraphitiOptionsSchema = z
+    .object({
+    python: graphitiText("Python executable used to run the matching Graphiti package.").default("python3"),
+    profile: options.DatabricksOptionsSchema.shape.profile.describe("Databricks profile used for model discovery and authentication."),
+    graphitiHome: graphitiText("Application-owned Graphiti runtime directory.").optional(),
+    model: graphitiText("Fuzzy chat-model name or endpoint identifier.")
+        .default("databricks-gpt-5-nano")
+        .meta({ env: "MODEL_NAME" }),
+    embedderModel: graphitiText("Fuzzy embedding-model name or endpoint identifier.").default("databricks-gte-large-en"),
+    embedderDimensions: z.coerce
+        .number()
+        .int()
+        .positive()
+        .default(1024)
+        .describe("Embedding vector dimensions expected by Graphiti."),
+    modelGatewayUrl: options.normalizedUrlSchema
+        .optional()
+        .describe("Existing OpenAI-compatible model gateway base URL, including /v1.")
+        .meta({ env: ["MODEL_GATEWAY_URL", "OPENAI_API_URL"] }),
+    modelGatewayHost: graphitiText("Listener host for a locally managed model gateway.").default("127.0.0.1"),
+    modelGatewayPort: graphitiPort("Listener port for a locally managed model gateway.").default(4400),
+    modelGatewayCommand: graphitiText("Command used to start a locally managed model gateway.").optional(),
+    manageModelGateway: z
+        .boolean()
+        .optional()
+        .describe("Whether Graphiti starts and stops a local model gateway."),
+    openAiApiKey: graphitiText("API key used only with an externally managed OpenAI-compatible endpoint.")
+        .optional()
+        .meta({ env: "OPENAI_API_KEY" }),
+    structuredOutputMode: graphitiText("Structured-output mode forwarded to Graphiti's OpenAI provider.")
+        .default("json_object")
+        .meta({ env: "LLM_STRUCTURED_OUTPUT_MODE" }),
+    graphitiHost: graphitiText("Graphiti MCP listener host.").default("127.0.0.1"),
+    graphitiPort: graphitiPort("Graphiti MCP listener port.").default(8000),
+    falkorDataDir: graphitiText("Local directory containing the active FalkorDB RDB.")
+        .optional()
+        .meta({ env: "FALKORDB_DATA_DIR" }),
+    falkorSnapshotSeconds: z.coerce
+        .number()
+        .int()
+        .positive()
+        .default(300)
+        .describe("Seconds between change-aware FalkorDB snapshot checks."),
+    falkorSnapshotMinChanges: z.coerce
+        .number()
+        .int()
+        .positive()
+        .default(1)
+        .describe("Minimum writes required before FalkorDB creates an RDB snapshot."),
+    graphitiArgs: z
+        .array(z.string())
+        .default([])
+        .describe("Arguments forwarded to the pinned upstream Graphiti MCP server."),
+})
+    .strict()
+    .describe("Graphiti options accepted by JavaScript, Python, and generated bindings.");
+/** Graphiti options represented as Commander flags rather than positional arguments. */
+export const GraphitiCliOptionsSchema = GraphitiOptionsSchema.omit({ graphitiArgs: true }).describe("Graphiti options represented as Commander flags rather than positional arguments.");
+/** Defaults derived from the owning schema rather than maintained separately. */
+export const GRAPHITI_DEFAULTS = Object.freeze(GraphitiOptionsSchema.parse({}));
+const graphitiOptionKeys = Object.keys(GraphitiOptionsSchema.shape);
+/** Keep only explicitly supplied Graphiti fields and validate their values. */
+export function graphitiOptionOverrides(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("Graphiti options must be an object");
+    }
+    const source = value;
+    const keys = graphitiOptionKeys.filter((key) => source[key] !== undefined);
+    const parsed = GraphitiOptionsSchema.parse(Object.fromEntries(keys.map((key) => [key, source[key]])));
+    return Object.fromEntries(keys.map((key) => [key, parsed[key]]));
+}
+export const ResolvedGraphitiOptionsSchema = GraphitiOptionsSchema.transform((options, context) => {
+    const manageModelGateway = options.manageModelGateway ?? options.modelGatewayUrl === undefined;
+    const modelGatewayUrl = (options.modelGatewayUrl ?? `http://${options.modelGatewayHost}:${options.modelGatewayPort}/v1`).replace(/\/$/, "");
+    if (options.manageModelGateway !== false &&
+        options.graphitiPort &&
+        options.modelGatewayPort &&
+        options.graphitiPort === options.modelGatewayPort) {
+        context.addIssue({
+            code: "custom",
+            message: "graphitiPort and modelGatewayPort must be distinct",
+            path: ["modelGatewayPort"],
+        });
+    }
+    return {
+        ...options,
+        modelGatewayUrl,
+        manageModelGateway,
+        openAiApiKey: options.openAiApiKey ?? "not-required",
+    };
+}).describe("Graphiti options after defaults and gateway ownership are resolved.");
+/** Apply shared defaults and validate cross-runtime invariants. */
+export function resolveGraphitiOptions(options = {}) {
+    return ResolvedGraphitiOptionsSchema.parse(options);
+}
+/** Serialize resolved options for the internal Python runtime boundary. */
+export function serializeGraphitiOptions(options = {}) {
+    return JSON.stringify(resolveGraphitiOptions(options));
+}
+/** Parse Graphiti option overrides from an explicit environment record. */
+export function graphitiOptionsFromEnvironment(environment) {
+    return options.parseOpts(GraphitiOptionsSchema, null, environment);
+}
+/** Return the managed model gateway health endpoint. */
+export function graphitiGatewayHealthUrl(options = {}) {
+    return `${resolveGraphitiOptions(options).modelGatewayUrl.replace(/\/v1$/, "")}/api/healthz`;
+}
+/** Return Graphiti provider environment variables from resolved shared options. */
+export function graphitiEnvironment(options = {}) {
+    const resolved = resolveGraphitiOptions(options);
+    return {
+        OPENAI_API_URL: resolved.modelGatewayUrl,
+        OPENAI_API_KEY: resolved.openAiApiKey,
+        LLM__PROVIDERS__OPENAI__API_URL: resolved.modelGatewayUrl,
+        LLM__PROVIDERS__OPENAI__API_KEY: resolved.openAiApiKey,
+        MODEL_NAME: resolved.model,
+        EMBEDDER_MODEL: resolved.embedderModel,
+        EMBEDDER__PROVIDERS__OPENAI__API_URL: resolved.modelGatewayUrl,
+        EMBEDDER__PROVIDERS__OPENAI__API_KEY: resolved.openAiApiKey,
+        EMBEDDER_DIMENSIONS: String(resolved.embedderDimensions),
+        EMBEDDER__DIMENSIONS: String(resolved.embedderDimensions),
+        EMBEDDING_DIM: String(resolved.embedderDimensions),
+        LLM_STRUCTURED_OUTPUT_MODE: resolved.structuredOutputMode,
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3B0aW9ucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9vcHRpb25zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7OztHQVFHO0FBRUgsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQ2pELE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsbUZBQW1GO0FBQ25GLE1BQU0sQ0FBQyxNQUFNLG9CQUFvQixHQUFHLHNCQUFzQixDQUFDO0FBRTNELE1BQU0sWUFBWSxHQUFHLENBQUMsV0FBbUIsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLElBQUksRUFBRSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMsV0FBVyxDQUFDLENBQUM7QUFDN0YsTUFBTSxZQUFZLEdBQUcsQ0FBQyxXQUFtQixFQUFFLEVBQUUsQ0FBQyxPQUFPLENBQUMsbUJBQW1CLENBQUMsUUFBUSxDQUFDLFdBQVcsQ0FBQyxDQUFDO0FBRWhHLE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLENBQUM7S0FDbkMsTUFBTSxDQUFDO0lBQ04sTUFBTSxFQUFFLFlBQVksQ0FBQyw4REFBOEQsQ0FBQyxDQUFDLE9BQU8sQ0FDMUYsU0FBUyxDQUNWO0lBQ0QsT0FBTyxFQUFFLE9BQU8sQ0FBQyx1QkFBdUIsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FDN0QsaUVBQWlFLENBQ2xFO0lBQ0QsWUFBWSxFQUFFLFlBQVksQ0FBQywrQ0FBK0MsQ0FBQyxDQUFDLFFBQVEsRUFBRTtJQUN0RixLQUFLLEVBQUUsWUFBWSxDQUFDLCtDQUErQyxDQUFDO1NBQ2pFLE9BQU8sQ0FBQyx1QkFBdUIsQ0FBQztTQUNoQyxJQUFJLENBQUMsRUFBRSxHQUFHLEVBQUUsWUFBWSxFQUFFLENBQUM7SUFDOUIsYUFBYSxFQUFFLFlBQVksQ0FBQyxvREFBb0QsQ0FBQyxDQUFD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Q0FBQyxjQUFjLENBQUM7QUFDL0YsQ0FBQztBQUVELG1GQUFtRjtBQUNuRixNQUFNLFVBQVUsbUJBQW1CLENBQUMsVUFBMkIsRUFBRTtJQUMvRCxNQUFNLFFBQVEsR0FBRyxzQkFBc0IsQ0FBQyxPQUFPLENBQUMsQ0FBQztJQUNqRCxPQUFPO1FBQ0wsY0FBYyxFQUFFLFFBQVEsQ0FBQyxlQUFlO1FBQ3hDLGNBQWMsRUFBRSxRQUFRLENBQUMsWUFBWTtRQUNyQywrQkFBK0IsRUFBRSxRQUFRLENBQUMsZUFBZTtRQUN6RCwrQkFBK0IsRUFBRSxRQUFRLENBQUMsWUFBWTtRQUN0RCxVQUFVLEVBQUUsUUFBUSxDQUFDLEtBQUs7UUFDMUIsY0FBYyxFQUFFLFFBQVEsQ0FBQyxhQUFhO1FBQ3RDLG9DQUFvQyxFQUFFLFFBQVEsQ0FBQyxlQUFlO1FBQzlELG9DQUFvQyxFQUFFLFFBQVEsQ0FBQyxZQUFZO1FBQzNELG1CQUFtQixFQUFFLE1BQU0sQ0FBQyxRQUFRLENBQUMsa0JBQWtCLENBQUM7UUFDeEQsb0JBQW9CLEVBQUUsTUFBTSxDQUFDLFFBQVEsQ0FBQyxrQkFBa0IsQ0FBQztRQUN6RCxhQUFhLEVBQUUsTUFBTSxDQUFDLFFBQVEsQ0FBQyxrQkFBa0IsQ0FBQztRQUNsRCwwQkFBMEIsRUFBRSxRQUFRLENBQUMsb0JBQW9CO0tBQzFELENBQUM7QUFDSixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBCcm93c2VyLXNhZmUgR3JhcGhpdGkgY29uZmlndXJhdGlvbiBzaGFyZWQgYnkgZXZlcnkgcnVudGltZS5cbiAqXG4gKiBUaGlzIG1vZHVsZSBvd25zIHRoZSBHcmFwaGl0aSBvcHRpb24gc2NoZW1hLCBkZWZhdWx0cywgZW52aXJvbm1lbnQgbWFwcGluZyxcbiAqIGFuZCBkZXJpdmVkIGdhdGV3YXkgc2V0dGluZ3MuIENMSXMsIEFwcEtpdCBpbnRlZ3JhdGlvbnMsIGFuZCBnZW5lcmF0ZWRcbiAqIGJpbmRpbmdzIHNob3VsZCBwYXNzIHRoaXMgY29uZmlndXJhdGlvbiB0aHJvdWdoIHJhdGhlciB0aGFuIHJlY3JlYXRpbmcgaXQuXG4gKlxuICogQG1vZHVsZVxuICovXG5cbmltcG9ydCB7IG9wdGlvbnMgfSBmcm9tIFwiQGRieC10b29scy9zaGFyZWQtY29yZVwiO1xuaW1wb3J0IHsgeiB9IGZyb20gXCJ6b2RcIjtcblxuLyoqIEVudmlyb25tZW50IHZhcmlhYmxlIGNhcnJ5aW5nIG9uZSBzZXJpYWxpemVkIHtAbGluayBHcmFwaGl0aU9wdGlvbnN9IG9iamVjdC4gKi9cbmV4cG9ydCBjb25zdCBHUkFQSElUSV9PUFRJT05TX0VOViA9IFwiREJYX0dSQVBISVRJX09QVElPTlNcIjtcblxuY29uc3QgZ3JhcGhpdGlUZXh0ID0gKGRlc2NyaXB0aW9uOiBzdHJpbmcpID0+IHouc3RyaW5nKCkudHJpbSgpLm1pbigxKS5kZXNjcmliZShkZXNjcmlwdGlvbik7XG5jb25zdCBncmFwaGl0aVBvcnQgPSAoZGVzY3JpcHRpb246IHN0cmluZykgPT4gb3B0aW9ucy50Y3BQb3J0T3JaZXJvU2NoZW1hLmRlc2NyaWJlKGRlc2NyaXB0aW9uKTtcblxuZXhwb3J0IGNvbnN0IEdyYXBoaXRpT3B0aW9uc1NjaGVtYSA9IHpcbiAgLm9iamVjdCh7XG4gICAgcHl0aG9uOiBncmFwaGl0aVRleHQoXCJQeXRob24gZXhlY3V0YWJsZSB1c2VkIHRvIHJ1biB0aGUgbWF0Y2hpbmcgR3JhcGhpdGkgcGFja2FnZS5cIikuZGVmYXVsdChcbiAgICAgIFwicHl0aG9uM1wiLFxuICAgICksXG4gICAgcHJvZmlsZTogb3B0aW9ucy5EYXRhYnJpY2tzT3B0aW9uc1NjaGVtYS5zaGFwZS5wcm9maWxlLmRlc2NyaWJlKFxuICAgICAgXCJEYXRhYnJpY2tzIHByb2ZpbGUgdXNlZCBmb3IgbW9kZWwgZGlzY292ZXJ5IGFuZCBhdXRoZW50aWNhdGlvbi5cIixcbiAgICApLFxuICAgIGdyYXBoaXRpSG9tZTogZ3JhcGhpdGlUZXh0KFwiQXBwbGljYXRpb24tb3duZWQgR3JhcGhpdGkgcnVudGltZSBkaXJlY3RvcnkuXCIpLm9wdGlvbmFsKCksXG4gICAgbW9kZWw6IGdyYXBoaXRpVGV4dChcIkZ1enp5IGNoYXQtbW9kZWwgbmFtZSBvciBlbmRwb2ludCBpZGVudGlmaWVyLlwiKVxuICAgICAgLmRlZmF1bHQoXCJkYXRhYnJpY2tzLWdwdC01LW5hbm9cIilcbiAgICAgIC5tZXRhKHsgZW52OiBcIk1PREVMX05BTUVcIiB9KSxcbiAgICBlbWJlZGRlck1vZGVsOiBncmFwaGl0aVRleHQoXCJGdXp6eSBlbWJlZGRpbmctbW9kZWwgbmFtZSBvciBlbmRwb2ludCBpZGVudGlmaWVyLlwiKS5kZWZhdWx0KFxuICAgICAgXCJkYXRhYnJpY2tzLWd0ZS1sYXJnZS1lblwiLFxuICAgICksXG4gICAgZW1iZWRkZXJEaW1lbnNpb25zOiB6LmNvZXJjZVxuICAgICAgLm51bWJlcjxudW1iZXI+KClcbiAgICAgIC5pbnQoKVxuICAgICAgLnBvc2l0aXZlKClcbiAgICAgIC5kZWZhdWx0KDEwMjQpXG4gICAgICAuZGVzY3JpYmUoXCJFbWJlZGRpbmcgdmVjdG9yIGRpbWVuc2lvbnMgZXhwZWN0ZWQgYnkgR3JhcGhpdGkuXCIpLFxuICAgIG1vZGVsR2F0ZXdheVVybDogb3B0aW9ucy5ub3JtYWxpemVkVXJsU2NoZW1hXG4gICAgICAub3B0aW9uYWwoKVxuICAgICAgLmRlc2NyaWJlKFwiRXhpc3RpbmcgT3BlbkFJLWNvbXBhdGlibGUgbW9kZWwgZ2F0ZXdheSBiYXNlIFVSTCwgaW5jbHVkaW5nIC92MS5cIilcbiAgICAgIC5tZXRhKHsgZW52OiBbXCJNT0RFTF9HQVRFV0FZX1VSTFwiLCBcIk9QRU5BSV9BUElfVVJMXCJdIH0pLFxuICAgIG1vZGVsR2F0ZXdheUhvc3Q6IGdyYXBoaXRpVGV4dChcIkxpc3RlbmVyIGhvc3QgZm9yIGEgbG9jYWxseSBtYW5hZ2VkIG1vZGVsIGdhdGV3YXkuXCIpLmRlZmF1bHQoXG4gICAgICBcIjEyNy4wLjAuMVwiLFxuICAgICksXG4gICAgbW9kZWxHYXRld2F5UG9ydDogZ3JhcGhpdGlQb3J0KFwiTGlzdGVuZXIgcG9ydCBmb3IgYSBsb2NhbGx5IG1hbmFnZWQgbW9kZWwgZ2F0ZXdheS5cIikuZGVmYXVsdChcbiAgICAgIDQ0MDAsXG4gICAgKSxcbiAgICBtb2RlbEdhdGV3YXlDb21tYW5kOiBncmFwaGl0aVRleHQoXG4gICAgICBcIkNvbW1hbmQgdXNlZCB0byBzdGFydCBhIGxvY2FsbHkgbWFuYWdlZCBtb2RlbCBnYXRld2F5LlwiLFxuICAgICkub3B0aW9uYWwoKSxcbiAgICBtYW5hZ2VNb2RlbEdhdGV3YXk6IHpcbiAgICAgIC5ib29sZWFuKClcbiAgICAgIC5vcHRpb25hbCgpXG4gICAgICAuZGVzY3JpYmUoXCJXaGV0aGVyIEdyYXBoaXRpIHN0YXJ0cyBhbmQgc3RvcHMgYSBsb2NhbCBtb2RlbCBnYXRld2F5LlwiKSxcbiAgICBvcGVuQWlBcGlLZXk6IGdyYXBoaXRpVGV4dChcbiAgICAgIFwiQVBJIGtleSB1c2VkIG9ubHkgd2l0aCBhbiBleHRlcm5hbGx5IG1hbmFnZWQgT3BlbkFJLWNvbXBhdGlibGUgZW5kcG9pbnQuXCIsXG4gICAgKVxuICAgICAgLm9wdGlvbmFsKClcbiAgICAgIC5tZXRhKHsgZW52OiBcIk9QRU5BSV9BUElfS0VZXCIgfSksXG4gICAgc3RydWN0dXJlZE91dHB1dE1vZGU6IGdyYXBoaXRpVGV4dChcbiAgICAgIFwiU3RydWN0dXJlZC1vdXRwdXQgbW9kZSBmb3J3YXJkZWQgdG8gR3JhcGhpdGkncyBPcGVuQUkgcHJvdmlkZXIuXCIsXG4gICAgKVxuICAgICAgLmRlZmF1bHQoXCJqc29uX29iamVjdFwiKVxuICAgICAgLm1ldGEoeyBlbnY6IFwiTExNX1NUUlVDVFVSRURfT1VUUFVUX01PREVcIiB9KSxcbiAgICBncmFwaGl0aUhvc3Q6IGdyYXBoaXRpVGV4dChcIkdyYXBoaXRpIE1DUCBsaXN0ZW5lciBob3N0LlwiKS5kZWZhdWx0KFwiMTI3LjAuMC4xXCIpLFxuICAgIGdyYXBoaXRpUG9ydDogZ3JhcGhpdGlQb3J0KFwiR3JhcGhpdGkgTUNQIGxpc3RlbmVyIHBvcnQuXCIpLmRlZmF1bHQoODAwMCksXG4gICAgZmFsa29yRGF0YURpcjogZ3JhcGhpdGlUZXh0KFwiTG9jYWwgZGlyZWN0b3J5IGNvbnRhaW5pbmcgdGhlIGFjdGl2ZSBGYWxrb3JEQiBSREIuXCIpXG4gICAgICAub3B0aW9uYWwoKVxuICAgICAgLm1ldGEoeyBlbnY6IFwiRkFMS09SREJfREFUQV9ESVJcIiB9KSxcbiAgICBmYWxrb3JTbmFwc2hvdFNlY29uZHM6IHouY29lcmNlXG4gICAgICAubnVtYmVyPG51bWJlcj4oKVxuICAgICAgLmludCgpXG4gICAgICAucG9zaXRpdmUoKVxuICAgICAgLmRlZmF1bHQoMzAwKVxuICAgICAgLmRlc2NyaWJlKFwiU2Vjb25kcyBiZXR3ZWVuIGNoYW5nZS1hd2FyZSBGYWxrb3JEQiBzbmFwc2hvdCBjaGVja3MuXCIpLFxuICAgIGZhbGtvclNuYXBzaG90TWluQ2hhbmdlczogei5jb2VyY2VcbiAgICAgIC5udW1iZXI8bnVtYmVyPigpXG4gICAgICAuaW50KClcbiAgICAgIC5wb3NpdGl2ZSgpXG4gICAgICAuZGVmYXVsdCgxKVxuICAgICAgLmRlc2NyaWJlKFwiTWluaW11bSB3cml0ZXMgcmVxdWlyZWQgYmVmb3JlIEZhbGtvckRCIGNyZWF0ZXMgYW4gUkRCIHNuYXBzaG90LlwiKSxcbiAgICBncmFwaGl0aUFyZ3M6IHpcbiAgICAgIC5hcnJheSh6LnN0cmluZygpKVxuICAgICAgLmRlZmF1bHQoW10pXG4gICAgICAuZGVzY3JpYmUoXCJBcmd1bWVudHMgZm9yd2FyZGVkIHRvIHRoZSBwaW5uZWQgdXBzdHJlYW0gR3JhcGhpdGkgTUNQIHNlcnZlci5cIiksXG4gIH0pXG4gIC5zdHJpY3QoKVxuICAuZGVzY3JpYmUoXCJHcmFwaGl0aSBvcHRpb25zIGFjY2VwdGVkIGJ5IEphdmFTY3JpcHQsIFB5dGhvbiwgYW5kIGdlbmVyYXRlZCBiaW5kaW5ncy5cIik7XG5cbi8qKiBHcmFwaGl0aSBvcHRpb25zIHJlcHJlc2VudGVkIGFzIENvbW1hbmRlciBmbGFncyByYXRoZXIgdGhhbiBwb3NpdGlvbmFsIGFyZ3VtZW50cy4gKi9cbmV4cG9ydCBjb25zdCBHcmFwaGl0aUNsaU9wdGlvbnNTY2hlbWEgPSBHcmFwaGl0aU9wdGlvbnNTY2hlbWEub21pdCh7IGdyYXBoaXRpQXJnczogdHJ1ZSB9KS5kZXNjcmliZShcbiAgXCJHcmFwaGl0aSBvcHRpb25zIHJlcHJlc2VudGVkIGFzIENvbW1hbmRlciBmbGFncyByYXRoZXIgdGhhbiBwb3NpdGlvbmFsIGFyZ3VtZW50cy5cIixcbik7XG5cbmV4cG9ydCB0eXBlIEdyYXBoaXRpT3B0aW9ucyA9IHouaW5wdXQ8dHlwZW9mIEdyYXBoaXRpT3B0aW9uc1NjaGVtYT47XG5cbi8qKiBEZWZhdWx0cyBkZXJpdmVkIGZyb20gdGhlIG93bmluZyBzY2hlbWEgcmF0aGVyIHRoYW4gbWFpbnRhaW5lZCBzZXBhcmF0ZWx5LiAqL1xuZXhwb3J0IGNvbnN0IEdSQVBISVRJX0RFRkFVTFRTID0gT2JqZWN0LmZyZWV6ZShHcmFwaGl0aU9wdGlvbnNTY2hlbWEucGFyc2Uoe30pKTtcblxuY29uc3QgZ3JhcGhpdGlPcHRpb25LZXlzID0gT2JqZWN0LmtleXMoR3JhcGhpdGlPcHRpb25zU2NoZW1hLnNoYXBlKSBhcyBBcnJheTxcbiAga2V5b2YgdHlwZW9mIEdSQVBISVRJX0RFRkFVTFRTXG4+O1xuXG4vKiogS2VlcCBvbmx5IGV4cGxpY2l0bHkgc3VwcGxpZWQgR3JhcGhpdGkgZmllbGRzIGFuZCB2YWxpZGF0ZSB0aGVpciB2YWx1ZXMuICovXG5leHBvcnQgZnVuY3Rpb24gZ3JhcGhpdGlPcHRpb25PdmVycmlkZXModmFsdWU6IHVua25vd24pOiBHcmFwaGl0aU9wdGlvbnMge1xuICBpZiAoIXZhbHVlIHx8IHR5cGVvZiB2YWx1ZSAhPT0gXCJvYmplY3RcIiB8fCBBcnJheS5pc0FycmF5KHZhbHVlKSkge1xuICAgIHRocm93IG5ldyBFcnJvcihcIkdyYXBoaXRpIG9wdGlvbnMgbXVzdCBiZSBhbiBvYmplY3RcIik7XG4gIH1cbiAgY29uc3Qgc291cmNlID0gdmFsdWUgYXMgUmVhZG9ubHk8UmVjb3JkPHN0cmluZywgdW5rbm93bj4+O1xuICBjb25zdCBrZXlzID0gZ3JhcGhpdGlPcHRpb25LZXlzLmZpbHRlcigoa2V5KSA9PiBzb3VyY2Vba2V5XSAhPT0gdW5kZWZpbmVkKTtcbiAgY29uc3QgcGFyc2VkID0gR3JhcGhpdGlPcHRpb25zU2NoZW1hLnBhcnNlKFxuICAgIE9iamVjdC5mcm9tRW50cmllcyhrZXlzLm1hcCgoa2V5KSA9PiBba2V5LCBzb3VyY2Vba2V5XV0pKSxcbiAgKTtcbiAgcmV0dXJuIE9iamVjdC5mcm9tRW50cmllcyhrZXlzLm1hcCgoa2V5KSA9PiBba2V5LCBwYXJzZWRba2V5XV0pKSBhcyBHcmFwaGl0aU9wdGlvbnM7XG59XG5cbmV4cG9ydCBjb25zdCBSZXNvbHZlZEdyYXBoaXRpT3B0aW9uc1NjaGVtYSA9IEdyYXBoaXRpT3B0aW9uc1NjaGVtYS50cmFuc2Zvcm0oKG9wdGlvbnMsIGNvbnRleHQpID0+IHtcbiAgY29uc3QgbWFuYWdlTW9kZWxHYXRld2F5ID0gb3B0aW9ucy5tYW5hZ2VNb2RlbEdhdGV3YXkgPz8gb3B0aW9ucy5tb2RlbEdhdGV3YXlVcmwgPT09IHVuZGVmaW5lZDtcbiAgY29uc3QgbW9kZWxHYXRld2F5VXJsID0gKFxuICAgIG9wdGlvbnMubW9kZWxHYXRld2F5VXJsID8/IGBodHRwOi8vJHtvcHRpb25zLm1vZGVsR2F0ZXdheUhvc3R9OiR7b3B0aW9ucy5tb2RlbEdhdGV3YXlQb3J0fS92MWBcbiAgKS5yZXBsYWNlKC9cXC8kLywgXCJcIik7XG4gIGlmIChcbiAgICBvcHRpb25zLm1hbmFnZU1vZGVsR2F0ZXdheSAhPT0gZmFsc2UgJiZcbiAgICBvcHRpb25zLmdyYXBoaXRpUG9ydCAmJlxuICAgIG9wdGlvbnMubW9kZWxHYXRld2F5UG9ydCAmJlxuICAgIG9wdGlvbnMuZ3JhcGhpdGlQb3J0ID09PSBvcHRpb25zLm1vZGVsR2F0ZXdheVBvcnRcbiAgKSB7XG4gICAgY29udGV4dC5hZGRJc3N1ZSh7XG4gICAgICBjb2RlOiBcImN1c3RvbVwiLFxuICAgICAgbWVzc2FnZTogXCJncmFwaGl0aVBvcnQgYW5kIG1vZGVsR2F0ZXdheVBvcnQgbXVzdCBiZSBkaXN0aW5jdFwiLFxuICAgICAgcGF0aDogW1wibW9kZWxHYXRld2F5UG9ydFwiXSxcbiAgICB9KTtcbiAgfVxuICByZXR1cm4ge1xuICAgIC4uLm9wdGlvbnMsXG4gICAgbW9kZWxHYXRld2F5VXJsLFxuICAgIG1hbmFnZU1vZGVsR2F0ZXdheSxcbiAgICBvcGVuQWlBcGlLZXk6IG9wdGlvbnMub3BlbkFpQXBpS2V5ID8/IFwibm90LXJlcXVpcmVkXCIsXG4gIH07XG59KS5kZXNjcmliZShcIkdyYXBoaXRpIG9wdGlvbnMgYWZ0ZXIgZGVmYXVsdHMgYW5kIGdhdGV3YXkgb3duZXJzaGlwIGFyZSByZXNvbHZlZC5cIik7XG5cbmV4cG9ydCB0eXBlIFJlc29sdmVkR3JhcGhpdGlPcHRpb25zID0gei5vdXRwdXQ8dHlwZW9mIFJlc29sdmVkR3JhcGhpdGlPcHRpb25zU2NoZW1hPjtcblxuLyoqIEFwcGx5IHNoYXJlZCBkZWZhdWx0cyBhbmQgdmFsaWRhdGUgY3Jvc3MtcnVudGltZSBpbnZhcmlhbnRzLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlc29sdmVHcmFwaGl0aU9wdGlvbnMob3B0aW9uczogR3JhcGhpdGlPcHRpb25zID0ge30pOiBSZXNvbHZlZEdyYXBoaXRpT3B0aW9ucyB7XG4gIHJldHVybiBSZXNvbHZlZEdyYXBoaXRpT3B0aW9uc1NjaGVtYS5wYXJzZShvcHRpb25zKTtcbn1cblxuLyoqIFNlcmlhbGl6ZSByZXNvbHZlZCBvcHRpb25zIGZvciB0aGUgaW50ZXJuYWwgUHl0aG9uIHJ1bnRpbWUgYm91bmRhcnkuICovXG5leHBvcnQgZnVuY3Rpb24gc2VyaWFsaXplR3JhcGhpdGlPcHRpb25zKG9wdGlvbnM6IEdyYXBoaXRpT3B0aW9ucyA9IHt9KTogc3RyaW5nIHtcbiAgcmV0dXJuIEpTT04uc3RyaW5naWZ5KHJlc29sdmVHcmFwaGl0aU9wdGlvbnMob3B0aW9ucykpO1xufVxuXG4vKiogUGFyc2UgR3JhcGhpdGkgb3B0aW9uIG92ZXJyaWRlcyBmcm9tIGFuIGV4cGxpY2l0IGVudmlyb25tZW50IHJlY29yZC4gKi9cbmV4cG9ydCBmdW5jdGlvbiBncmFwaGl0aU9wdGlvbnNGcm9tRW52aXJvbm1lbnQoXG4gIGVudmlyb25tZW50OiBSZWFkb25seTxSZWNvcmQ8c3RyaW5nLCBzdHJpbmcgfCB1bmRlZmluZWQ+Pixcbik6IEdyYXBoaXRpT3B0aW9ucyB7XG4gIHJldHVybiBvcHRpb25zLnBhcnNlT3B0cyhHcmFwaGl0aU9wdGlvbnNTY2hlbWEsIG51bGwsIGVudmlyb25tZW50KTtcbn1cblxuLyoqIFJldHVybiB0aGUgbWFuYWdlZCBtb2RlbCBnYXRld2F5IGhlYWx0aCBlbmRwb2ludC4gKi9cbmV4cG9ydCBmdW5jdGlvbiBncmFwaGl0aUdhdGV3YXlIZWFsdGhVcmwob3B0aW9uczogR3JhcGhpdGlPcHRpb25zID0ge30pOiBzdHJpbmcge1xuICByZXR1cm4gYCR7cmVzb2x2ZUdyYXBoaXRpT3B0aW9ucyhvcHRpb25zKS5tb2RlbEdhdGV3YXlVcmwucmVwbGFjZSgvXFwvdjEkLywgXCJcIil9L2FwaS9oZWFsdGh6YDtcbn1cblxuLyoqIFJldHVybiBHcmFwaGl0aSBwcm92aWRlciBlbnZpcm9ubWVudCB2YXJpYWJsZXMgZnJvbSByZXNvbHZlZCBzaGFyZWQgb3B0aW9ucy4gKi9cbmV4cG9ydCBmdW5jdGlvbiBncmFwaGl0aUVudmlyb25tZW50KG9wdGlvbnM6IEdyYXBoaXRpT3B0aW9ucyA9IHt9KTogUmVjb3JkPHN0cmluZywgc3RyaW5nPiB7XG4gIGNvbnN0IHJlc29sdmVkID0gcmVzb2x2ZUdyYXBoaXRpT3B0aW9ucyhvcHRpb25zKTtcbiAgcmV0dXJuIHtcbiAgICBPUEVOQUlfQVBJX1VSTDogcmVzb2x2ZWQubW9kZWxHYXRld2F5VXJsLFxuICAgIE9QRU5BSV9BUElfS0VZOiByZXNvbHZlZC5vcGVuQWlBcGlLZXksXG4gICAgTExNX19QUk9WSURFUlNfX09QRU5BSV9fQVBJX1VSTDogcmVzb2x2ZWQubW9kZWxHYXRld2F5VXJsLFxuICAgIExMTV9fUFJPVklERVJTX19PUEVOQUlfX0FQSV9LRVk6IHJlc29sdmVkLm9wZW5BaUFwaUtleSxcbiAgICBNT0RFTF9OQU1FOiByZXNvbHZlZC5tb2RlbCxcbiAgICBFTUJFRERFUl9NT0RFTDogcmVzb2x2ZWQuZW1iZWRkZXJNb2RlbCxcbiAgICBFTUJFRERFUl9fUFJPVklERVJTX19PUEVOQUlfX0FQSV9VUkw6IHJlc29sdmVkLm1vZGVsR2F0ZXdheVVybCxcbiAgICBFTUJFRERFUl9fUFJPVklERVJTX19PUEVOQUlfX0FQSV9LRVk6IHJlc29sdmVkLm9wZW5BaUFwaUtleSxcbiAgICBFTUJFRERFUl9ESU1FTlNJT05TOiBTdHJpbmcocmVzb2x2ZWQuZW1iZWRkZXJEaW1lbnNpb25zKSxcbiAgICBFTUJFRERFUl9fRElNRU5TSU9OUzogU3RyaW5nKHJlc29sdmVkLmVtYmVkZGVyRGltZW5zaW9ucyksXG4gICAgRU1CRURESU5HX0RJTTogU3RyaW5nKHJlc29sdmVkLmVtYmVkZGVyRGltZW5zaW9ucyksXG4gICAgTExNX1NUUlVDVFVSRURfT1VUUFVUX01PREU6IHJlc29sdmVkLnN0cnVjdHVyZWRPdXRwdXRNb2RlLFxuICB9O1xufVxuIl19

package/lib/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/options.ts","../index.ts"],"version":"5.9.3"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@dbx-tools/shared-graphiti",
+  "description": "Browser-safe Graphiti options, defaults, and runtime configuration",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reggie-db/dbx-tools.git",
+    "directory": "packages/js/shared/graphiti"
+  },
+  "scripts": {
+    "build": "projen build",
+    "compile": "projen compile",
+    "default": "projen default",
+    "package": "projen package",
+    "post-compile": "projen post-compile",
+    "pre-compile": "projen pre-compile",
+    "prepack": "projen prepack",
+    "test": "projen test",
+    "watch": "projen watch",
+    "projen": "projen"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@dbx-tools/shared-core": "^0.9.43",
+    "zod": "4.3.6"
+  },
+  "main": "./lib/index.js",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "main": "./lib/index.js",
+    "types": "./lib/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./lib/index.d.ts",
+        "default": "./lib/index.js"
+      },
+      "./options": {
+        "types": "./lib/src/options.d.ts",
+        "default": "./lib/src/options.js"
+      },
+      "./package.json": "./package.json"
+    }
+  },
+  "version": "0.9.43",
+  "types": "./lib/index.d.ts",
+  "dbxToolsConfig": {
+    "tags": [
+      "shared"
+    ]
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./options": {
+      "types": "./lib/src/options.d.ts",
+      "default": "./lib/src/options.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "exports.ts",
+    "lib"
+  ],
+  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"bunx projen\"."
+}

package/src/options.ts

@@ -0,0 +1,186 @@
+/**
+ * Browser-safe Graphiti configuration shared by every runtime.
+ *
+ * This module owns the Graphiti option schema, defaults, environment mapping,
+ * and derived gateway settings. CLIs, AppKit integrations, and generated
+ * bindings should pass this configuration through rather than recreating it.
+ *
+ * @module
+ */
+
+import { options } from "@dbx-tools/shared-core";
+import { z } from "zod";
+
+/** Environment variable carrying one serialized {@link GraphitiOptions} object. */
+export const GRAPHITI_OPTIONS_ENV = "DBX_GRAPHITI_OPTIONS";
+
+const graphitiText = (description: string) => z.string().trim().min(1).describe(description);
+const graphitiPort = (description: string) => options.tcpPortOrZeroSchema.describe(description);
+
+export const GraphitiOptionsSchema = z
+  .object({
+    python: graphitiText("Python executable used to run the matching Graphiti package.").default(
+      "python3",
+    ),
+    profile: options.DatabricksOptionsSchema.shape.profile.describe(
+      "Databricks profile used for model discovery and authentication.",
+    ),
+    graphitiHome: graphitiText("Application-owned Graphiti runtime directory.").optional(),
+    model: graphitiText("Fuzzy chat-model name or endpoint identifier.")
+      .default("databricks-gpt-5-nano")
+      .meta({ env: "MODEL_NAME" }),
+    embedderModel: graphitiText("Fuzzy embedding-model name or endpoint identifier.").default(
+      "databricks-gte-large-en",
+    ),
+    embedderDimensions: z.coerce
+      .number<number>()
+      .int()
+      .positive()
+      .default(1024)
+      .describe("Embedding vector dimensions expected by Graphiti."),
+    modelGatewayUrl: options.normalizedUrlSchema
+      .optional()
+      .describe("Existing OpenAI-compatible model gateway base URL, including /v1.")
+      .meta({ env: ["MODEL_GATEWAY_URL", "OPENAI_API_URL"] }),
+    modelGatewayHost: graphitiText("Listener host for a locally managed model gateway.").default(
+      "127.0.0.1",
+    ),
+    modelGatewayPort: graphitiPort("Listener port for a locally managed model gateway.").default(
+      4400,
+    ),
+    modelGatewayCommand: graphitiText(
+      "Command used to start a locally managed model gateway.",
+    ).optional(),
+    manageModelGateway: z
+      .boolean()
+      .optional()
+      .describe("Whether Graphiti starts and stops a local model gateway."),
+    openAiApiKey: graphitiText(
+      "API key used only with an externally managed OpenAI-compatible endpoint.",
+    )
+      .optional()
+      .meta({ env: "OPENAI_API_KEY" }),
+    structuredOutputMode: graphitiText(
+      "Structured-output mode forwarded to Graphiti's OpenAI provider.",
+    )
+      .default("json_object")
+      .meta({ env: "LLM_STRUCTURED_OUTPUT_MODE" }),
+    graphitiHost: graphitiText("Graphiti MCP listener host.").default("127.0.0.1"),
+    graphitiPort: graphitiPort("Graphiti MCP listener port.").default(8000),
+    falkorDataDir: graphitiText("Local directory containing the active FalkorDB RDB.")
+      .optional()
+      .meta({ env: "FALKORDB_DATA_DIR" }),
+    falkorSnapshotSeconds: z.coerce
+      .number<number>()
+      .int()
+      .positive()
+      .default(300)
+      .describe("Seconds between change-aware FalkorDB snapshot checks."),
+    falkorSnapshotMinChanges: z.coerce
+      .number<number>()
+      .int()
+      .positive()
+      .default(1)
+      .describe("Minimum writes required before FalkorDB creates an RDB snapshot."),
+    graphitiArgs: z
+      .array(z.string())
+      .default([])
+      .describe("Arguments forwarded to the pinned upstream Graphiti MCP server."),
+  })
+  .strict()
+  .describe("Graphiti options accepted by JavaScript, Python, and generated bindings.");
+
+/** Graphiti options represented as Commander flags rather than positional arguments. */
+export const GraphitiCliOptionsSchema = GraphitiOptionsSchema.omit({ graphitiArgs: true }).describe(
+  "Graphiti options represented as Commander flags rather than positional arguments.",
+);
+
+export type GraphitiOptions = z.input<typeof GraphitiOptionsSchema>;
+
+/** Defaults derived from the owning schema rather than maintained separately. */
+export const GRAPHITI_DEFAULTS = Object.freeze(GraphitiOptionsSchema.parse({}));
+
+const graphitiOptionKeys = Object.keys(GraphitiOptionsSchema.shape) as Array<
+  keyof typeof GRAPHITI_DEFAULTS
+>;
+
+/** Keep only explicitly supplied Graphiti fields and validate their values. */
+export function graphitiOptionOverrides(value: unknown): GraphitiOptions {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("Graphiti options must be an object");
+  }
+  const source = value as Readonly<Record<string, unknown>>;
+  const keys = graphitiOptionKeys.filter((key) => source[key] !== undefined);
+  const parsed = GraphitiOptionsSchema.parse(
+    Object.fromEntries(keys.map((key) => [key, source[key]])),
+  );
+  return Object.fromEntries(keys.map((key) => [key, parsed[key]])) as GraphitiOptions;
+}
+
+export const ResolvedGraphitiOptionsSchema = GraphitiOptionsSchema.transform((options, context) => {
+  const manageModelGateway = options.manageModelGateway ?? options.modelGatewayUrl === undefined;
+  const modelGatewayUrl = (
+    options.modelGatewayUrl ?? `http://${options.modelGatewayHost}:${options.modelGatewayPort}/v1`
+  ).replace(/\/$/, "");
+  if (
+    options.manageModelGateway !== false &&
+    options.graphitiPort &&
+    options.modelGatewayPort &&
+    options.graphitiPort === options.modelGatewayPort
+  ) {
+    context.addIssue({
+      code: "custom",
+      message: "graphitiPort and modelGatewayPort must be distinct",
+      path: ["modelGatewayPort"],
+    });
+  }
+  return {
+    ...options,
+    modelGatewayUrl,
+    manageModelGateway,
+    openAiApiKey: options.openAiApiKey ?? "not-required",
+  };
+}).describe("Graphiti options after defaults and gateway ownership are resolved.");
+
+export type ResolvedGraphitiOptions = z.output<typeof ResolvedGraphitiOptionsSchema>;
+
+/** Apply shared defaults and validate cross-runtime invariants. */
+export function resolveGraphitiOptions(options: GraphitiOptions = {}): ResolvedGraphitiOptions {
+  return ResolvedGraphitiOptionsSchema.parse(options);
+}
+
+/** Serialize resolved options for the internal Python runtime boundary. */
+export function serializeGraphitiOptions(options: GraphitiOptions = {}): string {
+  return JSON.stringify(resolveGraphitiOptions(options));
+}
+
+/** Parse Graphiti option overrides from an explicit environment record. */
+export function graphitiOptionsFromEnvironment(
+  environment: Readonly<Record<string, string | undefined>>,
+): GraphitiOptions {
+  return options.parseOpts(GraphitiOptionsSchema, null, environment);
+}
+
+/** Return the managed model gateway health endpoint. */
+export function graphitiGatewayHealthUrl(options: GraphitiOptions = {}): string {
+  return `${resolveGraphitiOptions(options).modelGatewayUrl.replace(/\/v1$/, "")}/api/healthz`;
+}
+
+/** Return Graphiti provider environment variables from resolved shared options. */
+export function graphitiEnvironment(options: GraphitiOptions = {}): Record<string, string> {
+  const resolved = resolveGraphitiOptions(options);
+  return {
+    OPENAI_API_URL: resolved.modelGatewayUrl,
+    OPENAI_API_KEY: resolved.openAiApiKey,
+    LLM__PROVIDERS__OPENAI__API_URL: resolved.modelGatewayUrl,
+    LLM__PROVIDERS__OPENAI__API_KEY: resolved.openAiApiKey,
+    MODEL_NAME: resolved.model,
+    EMBEDDER_MODEL: resolved.embedderModel,
+    EMBEDDER__PROVIDERS__OPENAI__API_URL: resolved.modelGatewayUrl,
+    EMBEDDER__PROVIDERS__OPENAI__API_KEY: resolved.openAiApiKey,
+    EMBEDDER_DIMENSIONS: String(resolved.embedderDimensions),
+    EMBEDDER__DIMENSIONS: String(resolved.embedderDimensions),
+    EMBEDDING_DIM: String(resolved.embedderDimensions),
+    LLM_STRUCTURED_OUTPUT_MODE: resolved.structuredOutputMode,
+  };
+}