@storyshelf/ai 0.7.0 → 0.8.0

package/dist/client.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { TASK_DEFAULTS } from "./types.mjs";
-//#region src/client.ts
+// src/client.ts
 /** True for the object form `{ model, ... }` (a bare model has a spec version). */
 function isObjectSlot(slot) {
 	return typeof slot === "object" && slot !== null && "model" in slot && !("specificationVersion" in slot);
@@ -62,7 +62,6 @@ function pickDefaultProfile(options) {
 	const names = Object.keys(options.profiles);
 	return options.defaultProfile ?? (names.includes("default") ? "default" : names[0] ?? "");
 }
-//#endregion
 export { effectiveSlot, modelId, pickDefaultProfile, resolveSlot, validateOptions };
 
 //# sourceMappingURL=client.mjs.map

package/dist/codec.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { APICallError, JSONParseError, NoObjectGeneratedError, Output, TypeValidationError, generateText } from "ai";
 import { AiError } from "@storyshelf/core/ai";
-//#region src/codec.ts
+// src/codec.ts
 /** Evidence → messages, one structured call, one schema-repair retry. */
 function userMessage(evidence, withImages) {
 	const images = withImages ? evidence.images : [];
@@ -122,7 +122,6 @@ async function runStructured(call) {
 		imagesSent
 	};
 }
-//#endregion
 export { isSchemaFailure, runStructured, toAiError, toUsage };
 
 //# sourceMappingURL=codec.mjs.map

package/dist/index.d.mts

@@ -2,9 +2,7 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { BudgetOptions, CreateAiOptions, ModelSlot, ProfileConfig, ProfileModels, SlotProviderOptions } from "./types.mjs";
 import { Ai } from "@storyshelf/core/ai";
-//#region src/index.d.ts
 /** Create the AI surface from named profiles of deployer-supplied models. */
 declare function createAi<const P extends string>(options: CreateAiOptions<P>): Ai;
-//#endregion
 export { type BudgetOptions, type CreateAiOptions, type ModelSlot, type ProfileConfig, type ProfileModels, type SlotProviderOptions, createAi };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -4,7 +4,7 @@ import.meta.url;
 import { modelId, pickDefaultProfile, validateOptions } from "./client.mjs";
 import { health, setup } from "./lifecycle.mjs";
 import { slotFor, summarize } from "./operations.mjs";
-//#region src/index.ts
+// src/index.ts
 /** Create the AI surface from named profiles of deployer-supplied models. */
 function createAi(options) {
 	validateOptions(options);
@@ -51,7 +51,6 @@ function otelEnabled(override) {
 	const env = process.env;
 	return env["OTEL_SDK_DISABLED"] !== "true" && (Boolean(env["OTEL_EXPORTER_OTLP_ENDPOINT"]) || env["OTEL_DENO"] === "true");
 }
-//#endregion
 export { createAi };
 
 //# sourceMappingURL=index.mjs.map

package/dist/lifecycle.mjs

@@ -3,7 +3,7 @@ import "node:url";
 import.meta.url;
 import { effectiveSlot, modelId } from "./client.mjs";
 import { registerOtelOnce } from "./telemetry.mjs";
-//#region src/lifecycle.ts
+// src/lifecycle.ts
 const SUPPORTED_SPECS = /* @__PURE__ */ new Set([
 	"v2",
 	"v3",
@@ -37,7 +37,6 @@ async function health(state) {
 		detail: `unsupported model specification: ${bad.join(", ")}`
 	};
 }
-//#endregion
 export { health, setup, unsupportedModels };
 
 //# sourceMappingURL=lifecycle.mjs.map

package/dist/metrics.mjs

@@ -2,7 +2,7 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { metrics } from "@opentelemetry/api";
-//#region src/metrics.ts
+// src/metrics.ts
 /** Bounded-cardinality OTEL instruments (task + outcome only; ADR 0016 §8). */
 let cached;
 function instruments() {
@@ -28,7 +28,6 @@ function recordSummarize(task, outcome, durationMs, tokens) {
 	tokenHistogram.record(tokens, attributes);
 	(outcome === "ok" ? completed : failed).add(1, { "ai.task": task });
 }
-//#endregion
 export { recordSummarize };
 
 //# sourceMappingURL=metrics.mjs.map

package/dist/operations.mjs

@@ -6,7 +6,7 @@ import { withSpan } from "./telemetry.mjs";
 import { runStructured, toAiError } from "./codec.mjs";
 import { recordSummarize } from "./metrics.mjs";
 import { AiError } from "@storyshelf/core/ai";
-//#region src/operations.ts
+// src/operations.ts
 /** `summarize`: profile resolution, vision fallback, timeout and spans. */
 /** Resolve the requested profile; unknown names fall back with a warning. */
 function resolveProfile(state, requested) {
@@ -117,7 +117,6 @@ async function summarize(state, input, logger) {
 		"ai.model": ctx.model
 	});
 }
-//#endregion
 export { resolveProfile, slotFor, summarize };
 
 //# sourceMappingURL=operations.mjs.map

package/dist/telemetry.mjs

@@ -3,8 +3,9 @@ import "node:url";
 import.meta.url;
 import { OpenTelemetry } from "@ai-sdk/otel";
 import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
+import { HttpError, redactSecrets } from "@storyshelf/core/utils";
 import { registerTelemetry } from "ai";
-//#region src/telemetry.ts
+// src/telemetry.ts
 /** OTEL wiring: idempotent integration registration and a local span helper. */
 let registered = false;
 /** Register the SDK's OpenTelemetry integration once per process. */
@@ -14,6 +15,22 @@ function registerOtelOnce() {
 	registerTelemetry(new OpenTelemetry());
 }
 /**
+* What a span records of a caught error: a copy with the same `name` and a `redactSecrets` message
+* (connection strings, tokens and keys stay out of exported spans), and for an `HttpError` its
+* status only, never the response body. The caller still gets the original error rethrown.
+* Intentional copy of core's `spanException` (ADR 0015 §5 no-cycle rule: do not deduplicate).
+*/
+function recordedError(error) {
+	if (!(error instanceof Error)) return redactSecrets(String(error));
+	const message = error instanceof HttpError ? `HTTP ${String(error.status)}` : redactSecrets(error.message);
+	const copy = new Error(message);
+	copy.name = error.name;
+	const header = `${error.name}: ${error.message}`;
+	const frames = error.stack?.startsWith(header) ? error.stack.slice(header.length) : "";
+	copy.stack = `${error.name}: ${message}${redactSecrets(frames)}`;
+	return copy;
+}
+/**
 * Run `fn` inside an internal span (intentional copy of the core/observability
 * helper: ADR 0015 §5 no-cycle rule — do not deduplicate).
 */
@@ -25,7 +42,7 @@ async function withSpan(name, fn, attributes) {
 		try {
 			return await fn(span);
 		} catch (error) {
-			span.recordException(error instanceof Error ? error : String(error));
+			span.recordException(recordedError(error));
 			span.setStatus({ code: SpanStatusCode.ERROR });
 			throw error;
 		} finally {
@@ -33,7 +50,6 @@ async function withSpan(name, fn, attributes) {
 		}
 	});
 }
-//#endregion
 export { registerOtelOnce, withSpan };
 
 //# sourceMappingURL=telemetry.mjs.map

package/dist/telemetry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.mjs","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":["/** OTEL wiring: idempotent integration registration and a local span helper. */\nimport { OpenTelemetry } from \"@ai-sdk/otel\";\nimport { SpanKind, SpanStatusCode, trace, type Attributes, type Span } from \"@opentelemetry/api\";\nimport { registerTelemetry } from \"ai\";\n\nlet registered = false;\n\n/** Register the SDK's OpenTelemetry integration once per process. */\nexport function registerOtelOnce(): void {\n  if (registered) {\n    return;\n  }\n  registered = true;\n  registerTelemetry(new OpenTelemetry());\n}\n\n/** Test hook: forget the registration flag. */\nexport function resetOtelRegistrationForTests(): void {\n  registered = false;\n}\n\n/**\n * Run `fn` inside an internal span (intentional copy of the core/observability\n * helper: ADR 0015 §5 no-cycle rule — do not deduplicate).\n */\nexport async function withSpan<T>(\n  name: string,\n  fn: (span: Span) => Promise<T>,\n  attributes?: Attributes,\n): Promise<T> {\n  const tracer = trace.getTracer(\"storyshelf.ai\");\n  return await tracer.startActiveSpan(\n    name,\n    { kind: SpanKind.INTERNAL, attributes },\n    async (span) => {\n      try {\n        return await fn(span);\n      } catch (error) {\n        span.recordException(error instanceof Error ? error : String(error));\n        span.setStatus({ code: SpanStatusCode.ERROR });\n        throw error;\n      } finally {\n        span.end();\n      }\n    },\n  );\n}\n"],"mappings":";;;;;;;;AAKA,IAAI,aAAa;;AAGjB,SAAgB,mBAAyB;CACvC,IAAI,YACF;CAEF,aAAa;CACb,kBAAkB,IAAI,cAAc,CAAC;AACvC;;;;;AAWA,eAAsB,SACpB,MACA,IACA,YACY;CAEZ,OAAO,MADQ,MAAM,UAAU,eACb,CAAC,CAAC,gBAClB,MACA;EAAE,MAAM,SAAS;EAAU;CAAW,GACtC,OAAO,SAAS;EACd,IAAI;GACF,OAAO,MAAM,GAAG,IAAI;EACtB,SAAS,OAAO;GACd,KAAK,gBAAgB,iBAAiB,QAAQ,QAAQ,OAAO,KAAK,CAAC;GACnE,KAAK,UAAU,EAAE,MAAM,eAAe,MAAM,CAAC;GAC7C,MAAM;EACR,UAAU;GACR,KAAK,IAAI;EACX;CACF,CACF;AACF"}
+{"version":3,"file":"telemetry.mjs","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":["/** OTEL wiring: idempotent integration registration and a local span helper. */\nimport { OpenTelemetry } from \"@ai-sdk/otel\";\nimport { SpanKind, SpanStatusCode, trace, type Attributes, type Span } from \"@opentelemetry/api\";\nimport { HttpError, redactSecrets } from \"@storyshelf/core/utils\";\nimport { registerTelemetry } from \"ai\";\n\nlet registered = false;\n\n/** Register the SDK's OpenTelemetry integration once per process. */\nexport function registerOtelOnce(): void {\n  if (registered) {\n    return;\n  }\n  registered = true;\n  registerTelemetry(new OpenTelemetry());\n}\n\n/** Test hook: forget the registration flag. */\nexport function resetOtelRegistrationForTests(): void {\n  registered = false;\n}\n\n/**\n * What a span records of a caught error: a copy with the same `name` and a `redactSecrets` message\n * (connection strings, tokens and keys stay out of exported spans), and for an `HttpError` its\n * status only, never the response body. The caller still gets the original error rethrown.\n * Intentional copy of core's `spanException` (ADR 0015 §5 no-cycle rule: do not deduplicate).\n */\nfunction recordedError(error: unknown): Error | string {\n  if (!(error instanceof Error)) {\n    return redactSecrets(String(error));\n  }\n  const message =\n    error instanceof HttpError ? `HTTP ${String(error.status)}` : redactSecrets(error.message);\n  const copy = new Error(message);\n  copy.name = error.name;\n  const header = `${error.name}: ${error.message}`;\n  const frames = error.stack?.startsWith(header) ? error.stack.slice(header.length) : \"\";\n  copy.stack = `${error.name}: ${message}${redactSecrets(frames)}`;\n  return copy;\n}\n\n/**\n * Run `fn` inside an internal span (intentional copy of the core/observability\n * helper: ADR 0015 §5 no-cycle rule — do not deduplicate).\n */\nexport async function withSpan<T>(\n  name: string,\n  fn: (span: Span) => Promise<T>,\n  attributes?: Attributes,\n): Promise<T> {\n  const tracer = trace.getTracer(\"storyshelf.ai\");\n  return await tracer.startActiveSpan(\n    name,\n    { kind: SpanKind.INTERNAL, attributes },\n    async (span) => {\n      try {\n        return await fn(span);\n      } catch (error) {\n        span.recordException(recordedError(error));\n        span.setStatus({ code: SpanStatusCode.ERROR });\n        throw error;\n      } finally {\n        span.end();\n      }\n    },\n  );\n}\n"],"mappings":";;;;;;;;;AAMA,IAAI,aAAa;;AAGjB,SAAgB,mBAAyB;CACvC,IAAI,YACF;CAEF,aAAa;CACb,kBAAkB,IAAI,cAAc,CAAC;AACvC;;;;;;;AAaA,SAAS,cAAc,OAAgC;CACrD,IAAI,EAAE,iBAAiB,QACrB,OAAO,cAAc,OAAO,KAAK,CAAC;CAEpC,MAAM,UACJ,iBAAiB,YAAY,QAAQ,OAAO,MAAM,MAAM,MAAM,cAAc,MAAM,OAAO;CAC3F,MAAM,OAAO,IAAI,MAAM,OAAO;CAC9B,KAAK,OAAO,MAAM;CAClB,MAAM,SAAS,GAAG,MAAM,KAAK,IAAI,MAAM;CACvC,MAAM,SAAS,MAAM,OAAO,WAAW,MAAM,IAAI,MAAM,MAAM,MAAM,OAAO,MAAM,IAAI;CACpF,KAAK,QAAQ,GAAG,MAAM,KAAK,IAAI,UAAU,cAAc,MAAM;CAC7D,OAAO;AACT;;;;;AAMA,eAAsB,SACpB,MACA,IACA,YACY;CAEZ,OAAO,MADQ,MAAM,UAAU,eACb,CAAC,CAAC,gBAClB,MACA;EAAE,MAAM,SAAS;EAAU;CAAW,GACtC,OAAO,SAAS;EACd,IAAI;GACF,OAAO,MAAM,GAAG,IAAI;EACtB,SAAS,OAAO;GACd,KAAK,gBAAgB,cAAc,KAAK,CAAC;GACzC,KAAK,UAAU,EAAE,MAAM,eAAe,MAAM,CAAC;GAC7C,MAAM;EACR,UAAU;GACR,KAAK,IAAI;EACX;CACF,CACF;AACF"}

package/dist/types.d.mts

@@ -2,7 +2,6 @@ import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { LanguageModel, generateText } from "ai";
 import { EvidenceLimits } from "@storyshelf/core/insights";
-//#region src/types.d.ts
 /** Provider-specific call settings, forwarded unchanged (opaque to this package). */
 type SlotProviderOptions = NonNullable<Parameters<typeof generateText>[0]["providerOptions"]>;
 /** A model, or a model with per-slot overrides. */
@@ -49,6 +48,5 @@ interface CreateAiOptions<P extends string> {
   /** Evidence limit overrides (ADR 0016 §5 defaults otherwise). */
   limits?: Partial<EvidenceLimits>;
 }
-//#endregion
 export { BudgetOptions, CreateAiOptions, ModelSlot, ProfileConfig, ProfileModels, SlotProviderOptions };
 //# sourceMappingURL=types.d.mts.map

package/dist/types.mjs

@@ -1,7 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
-//#region src/types.ts
+// src/types.ts
 /** Task token/time defaults. */
 const TASK_DEFAULTS = {
 	triage: {
@@ -13,7 +13,6 @@ const TASK_DEFAULTS = {
 		timeoutMs: 18e4
 	}
 };
-//#endregion
 export { TASK_DEFAULTS };
 
 //# sourceMappingURL=types.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storyshelf/ai",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "StoryShelf AI insights engine on the Vercel AI SDK: build triage and project health (providers are supplied by the deployer).",
   "keywords": [
     "ai",
@@ -54,7 +54,7 @@
   "dependencies": {
     "@ai-sdk/otel": "1.0.133",
     "@opentelemetry/api": "^1.9.0",
-    "@storyshelf/core": "0.7.0",
+    "@storyshelf/core": "0.8.0",
     "ai": "7.0.133"
   },
   "devDependencies": {
@@ -68,8 +68,8 @@
     "oxlint-tsgolint": "^7.0.2001",
     "tsdown": "^0.22.14",
     "typescript": "^7.0.2",
-    "vitest": "^5.0.0",
-    "zod": "^4.2.0"
+    "vitest": "^5.0.5",
+    "zod": "^4.6.7"
   },
   "engines": {
     "node": ">=24"