@skein-js/config 0.6.3 → 0.8.0

package/dist/index.d.ts

@@ -491,6 +491,7 @@ interface GraphRegistry {
     /** Extract the graph's JSON schemas via langgraph-api (for assistant introspection). */
     schemas(graphId: string): Promise<GraphSchemas>;
 }
+/** The result of {@link loadConfig}: the validated config plus its declared, on-demand graphs. */
 interface SkeinConfig {
     /** The validated `langgraph.json` contents. */
     config: LanggraphJson;
@@ -501,6 +502,7 @@ interface SkeinConfig {
     /** The declared graphs. */
     graphs: GraphRegistry;
 }
+/** Options for {@link loadConfig} — where to find `langgraph.json` and how to import its graphs. */
 interface LoadConfigOptions {
     /** Directory to resolve `configPath` (and default discovery) against. Defaults to `process.cwd()`. */
     cwd?: string;
@@ -521,6 +523,26 @@ interface LoadConfigOptions {
      */
     staticSchemas?: Record<string, GraphSchemas>;
 }
+/**
+ * Find, read, and validate a `langgraph.json`, resolve each declared graph to an absolute
+ * `path:export` spec, and return a {@link SkeinConfig} whose {@link GraphRegistry} loads a resolved
+ * graph (and its JSON schemas) on demand. This is the entry point every downstream consumer
+ * (`buildRuntime`, the adapters, the CLI) builds on.
+ *
+ * Loading is lazy and cached: pointing at a config whose graph needs a key (e.g. an LLM) doesn't
+ * import that graph until something asks for it, and a *failed* load is not memoized — a transient
+ * error (missing env, a syntax slip) can be retried without a restart.
+ *
+ * @throws {SkeinConfigError} when the file is missing, is not valid JSON, or fails schema validation.
+ *
+ * @example
+ * ```ts
+ * import { loadConfig } from "@skein-js/config";
+ *
+ * const { graphs } = await loadConfig(); // finds ./langgraph.json
+ * const agent = await graphs.load("agent");
+ * ```
+ */
 declare function loadConfig(options?: LoadConfigOptions): Promise<SkeinConfig>;
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skein-js/config",
-  "version": "0.6.3",
+  "version": "0.8.0",
   "description": "langgraph.json parser and graph loader (path:export) for skein-js.",
   "license": "Apache-2.0",
   "author": "Maina Wycliffe <wmmaina7@gmail.com>",
@@ -42,7 +42,7 @@
   "dependencies": {
     "@langchain/langgraph-api": "^1.4.0",
     "zod": "^3.25.76",
-    "@skein-js/core": "0.6.3"
+    "@skein-js/core": "0.8.0"
   },
   "peerDependencies": {
     "@langchain/langgraph": "^1.4.0",