@exellix/graph-composer 2.1.0 → 2.1.9

package/.env.example

@@ -11,6 +11,10 @@ OPENROUTER_API_KEY=
 # Optional — @x12i/logxer: package log level (verbose|debug|info|warn|error|off).
 # GRAPH_COMPOSER_LOGS_LEVEL=info
 #
+# Optional — bulk package levels (host registry; also applied when graph-composer loads):
+# LOGXER_PACKAGE_LEVELS=GRAPH_COMPOSER:debug
+# LOGXER_PACKAGE_LOGS_DEFAULT=warn
+#
 # Optional — Mongo log sink (see @x12i/logxer). Loaded via @x12i/env before Logxer is constructed.
 # MONGO_URI=
 # Mongo persistence defaults to warn; set info (or lower) to persist info-level package logs:

package/README.md

@@ -38,7 +38,9 @@ Requires **Node.js 20+** (Catalox embedder and this package align on `>=20`).
 | `OPENROUTER_API_KEY` | **Yes** (for API runs) | OpenRouter API key. |
 | `LLM_MODEL_STRONG` | No | Model slug when using `mode: "strong"` (default preset from @x12i/funcx). |
 | `LLM_MODEL_NORMAL` | No | Model slug for `normal` mode. |
-| `GRAPH_COMPOSER_LOGS_LEVEL` | No | Log level for [@x12i/logxer](https://www.npmjs.com/package/@x12i/logxer) (`debug`, `info`, `warn`, `off`, …). Overridable in code via `configureGraphComposerLogging` or per-call `logsLevel`. Uses diagnostic catalog `functions/graph-composer/metadata/log-diagnostics.json` (code `GRAPH_COMPOSER_WORKER_FAILED` on worker errors). |
+| `GRAPH_COMPOSER_LOGS_LEVEL` | No | Per-package log level for [@x12i/logxer](https://www.npmjs.com/package/@x12i/logxer) (`debug`, `info`, `warn`, `off`, …). Overridable via `configureGraphComposerLogging`, per-call `logsLevel`, or parent `logging` (`StackLoggingOptions`). |
+| `LOGXER_PACKAGE_LEVELS` | No | Bulk levels, e.g. `GRAPH_COMPOSER:debug,GRAPH_ENGINE:warn` (applied at module load). |
+| `LOGXER_PACKAGE_LOGS_DEFAULT` | No | Registry default when a prefix has no override (default `warn`). |
 
 Copy [`.env.example`](./.env.example) to `.env` for local development. **Do not commit secrets.**
 
@@ -290,7 +292,9 @@ graph-composer explain-basic
 | `parseGraphConceptStory`, `isGraphConceptStoryDescription`, `GRAPH_CONCEPT_STORY_MARKER`, … | Parse **graph concept story** text for `create` / `modify` / reviews. |
 | `redactSecretsForLog` | Deep-redact sensitive key names for logging (used by `reviewConcept` tracing). |
 
-`RunGraphComposerOptions`: `client`, `mode`, `model`, `temperature`, `maxTokens`, `askTimeoutMs`, `connectTimeoutMs`, **`catalogMatchListsAssist`**, **`traceReviewConceptIo`** — see [integration handoff](./docs/integration-handoff.md).
+`RunGraphComposerOptions`: `client`, `mode`, `model`, `temperature`, `maxTokens`, `askTimeoutMs`, `connectTimeoutMs`, **`catalogMatchListsAssist`**, **`traceReviewConceptIo`**, **`logsLevel`**, **`logging`** — see [integration handoff](./docs/integration-handoff.md).
+
+**Deep stacks (@x12i/logxer ≥ 4.5):** Call `applyPackageLogLevelsFromEnv()` / `configurePackageLogLevels()` in the host before importing graph-composer, or pass `logging: { packageLevels: { GRAPH_COMPOSER: 'debug' } }` on `runGraphComposer`. Re-exported: `configurePackageLogLevels`, `applyPackageLogLevelsFromEnv`, `StackLoggingOptions`.
 
 ## Bundled content
 

package/dist/graphComposerLogging.d.ts

@@ -1,7 +1,7 @@
-import { type LogLevel, type Logxer } from "@x12i/logxer";
+import { type LogLevel, type Logxer, type PackageLogLevelsConfig, type StackLoggingOptions } from "@x12i/logxer";
 /** Canonical env prefix for graph-composer logs (`GRAPH_COMPOSER_LOGS_LEVEL`, …). */
 export declare const GRAPH_COMPOSER_LOG_ENV_PREFIX = "GRAPH_COMPOSER";
-export type { LogLevel };
+export type { LogLevel, PackageLogLevelsConfig, StackLoggingOptions };
 /** Accepted inputs for `configureGraphComposerLogging` and `RunGraphComposerOptions.logsLevel`. */
 export type GraphComposerLogsLevelInput = LogLevel | "off" | "none" | "silent" | (string & {});
 export type GraphComposerLoggingConfig = {
@@ -16,6 +16,21 @@ export type GraphComposerLoggingConfig = {
         legacy: string;
     };
 };
+export type ConfigureGraphComposerLoggingOptions = {
+    /** Process-wide threshold (wins over stack / env / registry for this package). */
+    logsLevel?: GraphComposerLogsLevelInput;
+    /** Parent stack levels (`packageLevels`, default `logLevel`). See logxer `package-log-levels-stack.md`. */
+    logging?: StackLoggingOptions;
+    /** Merge into the process-wide logxer registry (`configurePackageLogLevels`). */
+    packageLogLevels?: PackageLogLevelsConfig;
+};
+/**
+ * Factory for a graph-composer Logxer (for hosts that need a dedicated instance).
+ * Default export is `getGraphComposerLogger()`.
+ */
+export declare function createGraphComposerLogger(options?: {
+    logging?: StackLoggingOptions;
+}): Logxer;
 /**
  * Parse a log-level string (case-insensitive). Unknown values disable logging (`off`).
  * Accepts logxer synonyms: `off`, `none`, `silent`.
@@ -28,18 +43,18 @@ export declare function parseGraphComposerLogsLevel(raw: string | undefined): {
  * Process-wide logging for graph-composer (downstream hosts, servers, CLIs).
  *
  * Precedence for each `runGraphComposer` / `runGraphComposerAgent` call:
- * `options.logsLevel` → `configureGraphComposerLogging` → `GRAPH_COMPOSER_LOGS_LEVEL` env → default `warn`.
+ * `options.logsLevel` → `configureGraphComposerLogging.logsLevel` → parent `options.logging` /
+ * `configureGraphComposerLogging.logging` → `GRAPH_COMPOSER_LOGS_LEVEL` env →
+ * `LOGXER_PACKAGE_LEVELS` / `configurePackageLogLevels` registry → default `warn`.
  */
-export declare function configureGraphComposerLogging(options: {
-    logsLevel?: GraphComposerLogsLevelInput;
-}): void;
+export declare function configureGraphComposerLogging(options?: ConfigureGraphComposerLoggingOptions): void;
 /** Current effective logging configuration (after env + programmatic overrides). */
-export declare function getGraphComposerLoggingConfig(perCall?: GraphComposerLogsLevelInput): GraphComposerLoggingConfig;
+export declare function getGraphComposerLoggingConfig(perCall?: GraphComposerLogsLevelInput, perCallStack?: StackLoggingOptions): GraphComposerLoggingConfig;
 /** Shared @x12i/logxer instance for graph-composer (diagnostics catalog attached). */
 export declare function getGraphComposerLogger(): Logxer;
 /**
  * Run `fn` with a temporary log threshold (`options.logsLevel` on workers).
  * Restores the previous threshold when `fn` completes.
  */
-export declare function withGraphComposerLogsLevel<T>(logsLevel: GraphComposerLogsLevelInput | undefined, fn: () => T | Promise<T>): Promise<T>;
+export declare function withGraphComposerLogsLevel<T>(logsLevel: GraphComposerLogsLevelInput | undefined, fn: () => T | Promise<T>, logging?: StackLoggingOptions): Promise<T>;
 //# sourceMappingURL=graphComposerLogging.d.ts.map

package/dist/graphComposerLogging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphComposerLogging.d.ts","sourceRoot":"","sources":["../src/graphComposerLogging.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,QAAQ,EACb,KAAK,MAAM,EACZ,MAAM,cAAc,CAAC;AAGtB,qFAAqF;AACrF,eAAO,MAAM,6BAA6B,mBAAmB,CAAC;AAE9D,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,mGAAmG;AACnG,MAAM,MAAM,2BAA2B,GACnC,QAAQ,GACR,KAAK,GACL,MAAM,GACN,QAAQ,GACR,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,0BAA0B,GAAG;IACvC,4EAA4E;IAC5E,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,yEAAyE;IACzE,YAAY,EAAE,OAAO,CAAC;IACtB,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AA+DF;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB;IAAE,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAMxD;AAoCD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,SAAS,CAAC,EAAE,2BAA2B,CAAC;CACzC,GAAG,IAAI,CAMP;AAED,oFAAoF;AACpF,wBAAgB,6BAA6B,CAC3C,OAAO,CAAC,EAAE,2BAA2B,GACpC,0BAA0B,CAY5B;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,CAAC,EAChD,SAAS,EAAE,2BAA2B,GAAG,SAAS,EAClD,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAYZ"}
+{"version":3,"file":"graphComposerLogging.d.ts","sourceRoot":"","sources":["../src/graphComposerLogging.ts"],"names":[],"mappings":"AAEA,OAAO,EASL,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAC;AAGtB,qFAAqF;AACrF,eAAO,MAAM,6BAA6B,mBAAmB,CAAC;AAE9D,YAAY,EAAE,QAAQ,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,CAAC;AAEtE,mGAAmG;AACnG,MAAM,MAAM,2BAA2B,GACnC,QAAQ,GACR,KAAK,GACL,MAAM,GACN,QAAQ,GACR,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,0BAA0B,GAAG;IACvC,4EAA4E;IAC5E,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,yEAAyE;IACzE,YAAY,EAAE,OAAO,CAAC;IACtB,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAOF,MAAM,MAAM,oCAAoC,GAAG;IACjD,kFAAkF;IAClF,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,2GAA2G;IAC3G,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C,CAAC;AAiEF;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE;IAClD,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,GAAG,MAAM,CAiBT;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB;IAAE,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAMxD;AAyDD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,oCAAyC,GACjD,IAAI,CAWN;AAED,oFAAoF;AACpF,wBAAgB,6BAA6B,CAC3C,OAAO,CAAC,EAAE,2BAA2B,EACrC,YAAY,CAAC,EAAE,mBAAmB,GACjC,0BAA0B,CAe5B;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,CAAC,EAChD,SAAS,EAAE,2BAA2B,GAAG,SAAS,EAClD,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,CAAC,CAAC,CAcZ"}

package/dist/graphComposerLogging.js

@@ -1,20 +1,15 @@
 import path from "node:path";
 import { initConfig } from "@x12i/env";
-import { createLogxer, legacyPackageLogLevelEnvKey, packageLogsLevelEnvKey, parsePackageLogsLevelString, resolvePackageLogsLevel, } from "@x12i/logxer";
+import { applyPackageLogLevelsFromEnv, createLogxer, legacyPackageLogLevelEnvKey, mergePackageLogLevelsConfig, packageLogsLevelEnvKey, parsePackageLogsLevelString, resolvePackageLogsLevel, resolveStackLogLevelForPrefix, } from "@x12i/logxer";
 import { graphComposerPackRoot } from "./packDir.js";
 /** Canonical env prefix for graph-composer logs (`GRAPH_COMPOSER_LOGS_LEVEL`, …). */
 export const GRAPH_COMPOSER_LOG_ENV_PREFIX = "GRAPH_COMPOSER";
 // Load .env before Logxer reads MONGO_URI (and related vars) at construction.
 initConfig({}, { dotenvPath: ".env", throwOnMissing: false });
-const logger = createLogxer({
-    packageName: "graph-composer",
-    envPrefix: GRAPH_COMPOSER_LOG_ENV_PREFIX,
-}, {
-    diagnostics: {
-        catalogPath: path.join(graphComposerPackRoot(), "metadata", "log-diagnostics.json"),
-    },
-});
+applyPackageLogLevelsFromEnv();
 let processWideLogsLevel;
+let processWideStack;
+const logger = createGraphComposerLogger();
 function logxerMutableConfig(logxer) {
     return logxer.config;
 }
@@ -41,6 +36,35 @@ const LOG_LEVELS = new Set([
 function isLogLevel(value) {
     return LOG_LEVELS.has(value);
 }
+function mergeStackLogging(base, overlay) {
+    if (base === undefined && overlay === undefined) {
+        return undefined;
+    }
+    return {
+        ...(base?.logLevel !== undefined || overlay?.logLevel !== undefined
+            ? { logLevel: overlay?.logLevel ?? base?.logLevel }
+            : {}),
+        packageLevels: {
+            ...base?.packageLevels,
+            ...overlay?.packageLevels,
+        },
+    };
+}
+/**
+ * Factory for a graph-composer Logxer (for hosts that need a dedicated instance).
+ * Default export is `getGraphComposerLogger()`.
+ */
+export function createGraphComposerLogger(options) {
+    return createLogxer({
+        packageName: "graph-composer",
+        envPrefix: GRAPH_COMPOSER_LOG_ENV_PREFIX,
+    }, {
+        diagnostics: {
+            catalogPath: path.join(graphComposerPackRoot(), "metadata", "log-diagnostics.json"),
+        },
+        stack: options?.logging,
+    });
+}
 /**
  * Parse a log-level string (case-insensitive). Unknown values disable logging (`off`).
  * Accepts logxer synonyms: `off`, `none`, `silent`.
@@ -65,36 +89,55 @@ function resolveFromInput(input) {
     }
     return { packageLogsDisabled: false, logLevel: parsed.logLevel };
 }
-function resolveGraphComposerLogsLevel(perCall) {
-    if (perCall !== undefined) {
-        return resolveFromInput(perCall);
+function resolveGraphComposerLogsLevel(options) {
+    if (options?.perCallLevel !== undefined) {
+        return resolveFromInput(options.perCallLevel);
     }
     if (processWideLogsLevel !== undefined) {
-        return resolveFromInput(processWideLogsLevel);
+        const fromConfigure = resolveFromInput(processWideLogsLevel);
+        if (fromConfigure.packageLogsDisabled) {
+            return fromConfigure;
+        }
+        return resolvePackageLogsLevel({
+            envPrefix: GRAPH_COMPOSER_LOG_ENV_PREFIX,
+            userLogLevel: fromConfigure.logLevel,
+            stackLogLevel: resolveStackLogLevelForPrefix(GRAPH_COMPOSER_LOG_ENV_PREFIX, mergeStackLogging(processWideStack, options?.perCallStack)),
+        });
     }
     return resolvePackageLogsLevel({
         envPrefix: GRAPH_COMPOSER_LOG_ENV_PREFIX,
+        stackLogLevel: resolveStackLogLevelForPrefix(GRAPH_COMPOSER_LOG_ENV_PREFIX, mergeStackLogging(processWideStack, options?.perCallStack)),
     });
 }
-function syncLoggerToEffectiveLevel(perCall) {
-    applyResolvedToLogger(resolveGraphComposerLogsLevel(perCall));
+function syncLoggerToEffectiveLevel(options) {
+    applyResolvedToLogger(resolveGraphComposerLogsLevel(options));
 }
 /**
  * Process-wide logging for graph-composer (downstream hosts, servers, CLIs).
  *
  * Precedence for each `runGraphComposer` / `runGraphComposerAgent` call:
- * `options.logsLevel` → `configureGraphComposerLogging` → `GRAPH_COMPOSER_LOGS_LEVEL` env → default `warn`.
+ * `options.logsLevel` → `configureGraphComposerLogging.logsLevel` → parent `options.logging` /
+ * `configureGraphComposerLogging.logging` → `GRAPH_COMPOSER_LOGS_LEVEL` env →
+ * `LOGXER_PACKAGE_LEVELS` / `configurePackageLogLevels` registry → default `warn`.
  */
-export function configureGraphComposerLogging(options) {
-    if (options.logsLevel === undefined) {
-        return;
+export function configureGraphComposerLogging(options = {}) {
+    if (options.packageLogLevels !== undefined) {
+        mergePackageLogLevelsConfig(options.packageLogLevels);
+    }
+    if ("logging" in options) {
+        processWideStack = options.logging;
+    }
+    if ("logsLevel" in options) {
+        processWideLogsLevel = options.logsLevel;
     }
-    processWideLogsLevel = options.logsLevel;
     syncLoggerToEffectiveLevel();
 }
 /** Current effective logging configuration (after env + programmatic overrides). */
-export function getGraphComposerLoggingConfig(perCall) {
-    const resolved = resolveGraphComposerLogsLevel(perCall);
+export function getGraphComposerLoggingConfig(perCall, perCallStack) {
+    const resolved = resolveGraphComposerLogsLevel({
+        perCallLevel: perCall,
+        perCallStack,
+    });
     const logsDisabled = resolved.packageLogsDisabled;
     return {
         logsLevel: logsDisabled ? "off" : resolved.logLevel,
@@ -114,12 +157,12 @@ export function getGraphComposerLogger() {
  * Run `fn` with a temporary log threshold (`options.logsLevel` on workers).
  * Restores the previous threshold when `fn` completes.
  */
-export async function withGraphComposerLogsLevel(logsLevel, fn) {
-    if (logsLevel === undefined) {
+export async function withGraphComposerLogsLevel(logsLevel, fn, logging) {
+    if (logsLevel === undefined && logging === undefined) {
         syncLoggerToEffectiveLevel();
         return fn();
     }
-    const restore = applyResolvedToLogger(resolveGraphComposerLogsLevel(logsLevel));
+    const restore = applyResolvedToLogger(resolveGraphComposerLogsLevel({ perCallLevel: logsLevel, perCallStack: logging }));
     try {
         return await fn();
     }
@@ -128,5 +171,5 @@ export async function withGraphComposerLogsLevel(logsLevel, fn) {
         syncLoggerToEffectiveLevel();
     }
 }
-// Apply env / default level at module load (before first log line).
+// Apply env / registry / default level at module load (before first log line).
 syncLoggerToEffectiveLevel();

package/dist/index.d.ts

@@ -3,8 +3,9 @@ export { GRAPH_COMPOSER_ACTION_REGISTRY, getActionDefinition, getActionDefinitio
 export { graphComposerPackRoot, readGraphComposerPromptFile, } from "./packDir.js";
 export { DEFAULT_UTILITY_SKILLS } from "./defaultUtilitySkills.js";
 export { runGraphComposer, runGraphWorker, resolveGraphComposerClient, getGraphComposerLlmClient, getPackDir, normalizeGraphComposerExplainOutput, normalizeReviewConceptComposerOutput, redactSecretsForLog, type RunGraphComposerOptions, } from "./runGraphComposer.js";
-export type { LogRuntimeContext, LogLevel } from "@x12i/logxer";
-export { GRAPH_COMPOSER_LOG_ENV_PREFIX, configureGraphComposerLogging, getGraphComposerLogger, getGraphComposerLoggingConfig, parseGraphComposerLogsLevel, withGraphComposerLogsLevel, type GraphComposerLoggingConfig, type GraphComposerLogsLevelInput, } from "./graphComposerLogging.js";
+export type { LogRuntimeContext, LogLevel, PackageLogLevelsConfig, StackLoggingOptions, } from "@x12i/logxer";
+export { applyPackageLogLevelsFromEnv, configurePackageLogLevels, } from "@x12i/logxer";
+export { GRAPH_COMPOSER_LOG_ENV_PREFIX, configureGraphComposerLogging, createGraphComposerLogger, getGraphComposerLogger, getGraphComposerLoggingConfig, parseGraphComposerLogsLevel, withGraphComposerLogsLevel, type ConfigureGraphComposerLoggingOptions, type GraphComposerLoggingConfig, type GraphComposerLogsLevelInput, } from "./graphComposerLogging.js";
 export { applyGraphConceptPatchOnlyIfEmpty } from "./graphConceptPatchMerge.js";
 export { runGraphComposerAgent, type GraphComposerAgentResult, type GraphComposerAgentOrchestrationStep, type RunGraphComposerAgentOptions, } from "./graphComposerAgent.js";
 export type { GraphComposerInput, GraphComposerAgentInput, GraphComposerIntent, GraphComposerConstraints, SkillDescriptor, PrimaryIntentType, GraphConceptStatus, GraphConceptEntityBindings, GraphConceptPatch, GraphConceptPatchKey, GraphConceptRequirementsPatch, GraphConceptCoreTaskPatchItem, RequirementOptionCandidate, RequirementOptionEntry, CatalogCandidates, ScopingMapCandidate, NarrixTemplateCandidate, } from "./types.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -3,7 +3,8 @@ export { GRAPH_COMPOSER_ACTION_REGISTRY, getActionDefinition, getActionDefinitio
 export { graphComposerPackRoot, readGraphComposerPromptFile, } from "./packDir.js";
 export { DEFAULT_UTILITY_SKILLS } from "./defaultUtilitySkills.js";
 export { runGraphComposer, runGraphWorker, resolveGraphComposerClient, getGraphComposerLlmClient, getPackDir, normalizeGraphComposerExplainOutput, normalizeReviewConceptComposerOutput, redactSecretsForLog, } from "./runGraphComposer.js";
-export { GRAPH_COMPOSER_LOG_ENV_PREFIX, configureGraphComposerLogging, getGraphComposerLogger, getGraphComposerLoggingConfig, parseGraphComposerLogsLevel, withGraphComposerLogsLevel, } from "./graphComposerLogging.js";
+export { applyPackageLogLevelsFromEnv, configurePackageLogLevels, } from "@x12i/logxer";
+export { GRAPH_COMPOSER_LOG_ENV_PREFIX, configureGraphComposerLogging, createGraphComposerLogger, getGraphComposerLogger, getGraphComposerLoggingConfig, parseGraphComposerLogsLevel, withGraphComposerLogsLevel, } from "./graphComposerLogging.js";
 export { applyGraphConceptPatchOnlyIfEmpty } from "./graphConceptPatchMerge.js";
 export { runGraphComposerAgent, } from "./graphComposerAgent.js";
 export { buildCatalogMatchHints, } from "./catalogMatchAssist.js";

package/dist/runGraphComposer.d.ts

@@ -1,5 +1,5 @@
 import { type LogRuntimeContext } from "@x12i/logxer";
-import { type GraphComposerLogsLevelInput } from "./graphComposerLogging.js";
+import { type GraphComposerLogsLevelInput, type StackLoggingOptions } from "./graphComposerLogging.js";
 import type { Client } from "@x12i/funcx";
 import { type LlmMode } from "@x12i/funcx/functions";
 import type { GraphComposerInput } from "./types.js";
@@ -44,6 +44,11 @@ export type RunGraphComposerOptions = {
      * Use `off` / `none` / `silent` to silence graph-composer logs for one invocation.
      */
     logsLevel?: GraphComposerLogsLevelInput;
+    /**
+     * Parent stack logging for this invocation (`StackLoggingOptions` from @x12i/logxer).
+     * Forward from the host when graph-composer is embedded in a larger app.
+     */
+    logging?: StackLoggingOptions;
     /**
      * Optional correlation ids merged into every log via @x12i/logxer `runWithLogContext`
      * (jobId, runId, graphId, nodeId, taskId, sessionId, correlationId).

package/dist/runGraphComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runGraphComposer.d.ts","sourceRoot":"","sources":["../src/runGraphComposer.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAIL,KAAK,OAAO,EACb,MAAM,uBAAuB,CAAC;AAc/B,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,OAAO,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAC;AAgHhF;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,IAAI,CASN;AAuDD;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,OAAO,GACd,OAAO,CAKT;AA0ED,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,2FAA2F;IAC3F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC;;;OAGG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAmDF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,uBAAuB,GAC/B,MAAM,GAAG,SAAS,CA4BpB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAYR;AAqLD,wBAAsB,cAAc,CAClC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}
+{"version":3,"file":"runGraphComposer.d.ts","sourceRoot":"","sources":["../src/runGraphComposer.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAGL,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAIL,KAAK,OAAO,EACb,MAAM,uBAAuB,CAAC;AAc/B,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,OAAO,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAC;AAgHhF;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,IAAI,CASN;AAuDD;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,OAAO,GACd,OAAO,CAKT;AA0ED,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,2FAA2F;IAC3F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAmDF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,uBAAuB,GAC/B,MAAM,GAAG,SAAS,CA4BpB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAYR;AAqLD,wBAAsB,cAAc,CAClC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/runGraphComposer.js

@@ -459,7 +459,7 @@ export async function runGraphWorker(input, options = {}) {
             return runWithLogContext(ctx, () => runGraphWorkerInner(input, options));
         }
         return runGraphWorkerInner(input, options);
-    });
+    }, options.logging);
 }
 export async function runGraphComposer(input, options = {}) {
     return runGraphWorker(input, options);

package/functions/graph-composer/prompts/shared/graph-format.md

@@ -1,6 +1,6 @@
-## Format reference (GraphModelObject)
+## Format reference (worox-graph / GraphModelObject)
 
-Normative contracts: `docs/formats-documentations/graph-model-object-format.md` and `task-node-model-object-format.md`. Graph-composer emits **static model** JSON consumed by `@exellix/graph-engine`.
+Normative contracts for the **worox-graph** DAG JSON model: `docs/formats-documentations/graph-model-object-format.md` and `task-node-model-object-format.md`. Graph-composer emits **static model** JSON consumed by `@exellix/graph-engine`.
 
 A graph is a single JSON object. Top-level fields (canonical root keys only):
 
@@ -68,7 +68,7 @@ A graph is a single JSON object. Top-level fields (canonical root keys only):
 | Planning / UX | `metadata.*` | `graphReadability`, `catalogBinding`, `name`, `description` — **not** `aiTaskProfile` or `narrix`. |
 | Result wiring | `executionMapping` | Writes into execution memory after the task succeeds. |
 
-- **AI task nodes** must include **`taskConfiguration.aiTaskProfile`** with non-empty **`preStrategyKey`** and **`postStrategyKey`** (deployment catalog row ids). Add **`taskConfiguration.narrix`** when discovery applies. Add **`webScoping`** / **`inputSynthesis`** under **`aiTaskProfile`** when needed.
+- **AI task nodes** must include **`taskConfiguration.aiTaskProfile`** with non-empty **`preStrategyKey`** and **`postStrategyKey`** (deployment catalog row ids). Add **`taskConfiguration.narrix`** when discovery applies. Add **`webScoping`** / **`inputSynthesis`** under **`aiTaskProfile`** when needed. Legacy **`metadata.aiTaskProfile`** is dual-read and canonicalized to **`taskConfiguration`** on output — do not author new graphs under `metadata`.
 - `skillKey` must come from the provided skill catalog unless extensible mode is active.
 - Do **not** put `question`, literals, or `$path` variable refs under `inputsConfig`. Do **not** use deprecated task-node `inputs` or `outputMapping` (graph-composer renames them on output).
 - `taskVariable.question` should be clear and self-contained.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/graph-composer",
-  "version": "2.1.0",
+  "version": "2.1.9",
   "publishConfig": {
     "access": "public"
   },
@@ -63,7 +63,7 @@
   },
   "homepage": "https://github.com/woroces/graph-composer#readme",
   "peerDependencies": {
-    "@exellix/graph-engine": "^7.2.0"
+    "@exellix/graph-engine": "^7.3.9"
   },
   "peerDependenciesMeta": {
     "@exellix/graph-engine": {
@@ -71,14 +71,14 @@
     }
   },
   "dependencies": {
-    "@x12i/ai-profiles": "^1.7.0",
+    "@x12i/ai-profiles": "^1.7.2",
     "@x12i/catalox": "^5.1.3",
     "@x12i/env": "^4.0.1",
-    "@x12i/funcx": "^4.2.4",
+    "@x12i/funcx": "^4.2.8",
     "@x12i/logxer": "^4.6.0"
   },
   "devDependencies": {
-    "@exellix/graph-engine": "^7.2.0",
+    "@exellix/graph-engine": "^7.3.9",
     "@types/node": "^22.10.2",
     "nx-config2": "^3.6.5",
     "tsx": "^4.19.2",