@nhtio/adk 1.20260607.0 → 1.20260607.2

package/eslint/rules/thought_payload_requires_replay_tag.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thought_payload_requires_replay_tag.mjs","names":[],"sources":["../../../src/eslint/rules/thought_payload_requires_replay_tag.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/eslint/rules/thought_payload_requires_replay_tag\n *\n * Flags `new Thought({ … })` whose options literal sets a `payload` but omits a\n * `replayCompatibility` tag.\n *\n * Why: a `Thought` may carry a vendor-opaque `payload` that the harness cannot interpret, to be\n * replayed back to a matching model wire. The ADK can only route that payload if the thought also\n * declares which adapter wire-shape it is replayable into, via `replayCompatibility`. A `payload`\n * with no `replayCompatibility` is a footgun: the harness has no way to know which adapter can\n * consume it, so it is dropped silently. The `Thought` constructor enforces this cross-field\n * invariant at runtime (`payload` present ⇒ `replayCompatibility` required); this rule surfaces it\n * statically at the construction site so it fails lint, not just at runtime.\n *\n * Detects the common literal form: a `new Thought({ … })` options object that has a `payload`\n * property but no `replayCompatibility` property. Spreads or computed keys are not analyzable here —\n * those fall back to the runtime check.\n *\n * Opt-out:\n *   // eslint-disable-next-line adk/thought-payload-requires-replay-tag -- <reason>\n */\n\nimport { createRule } from './common'\n\nimport type { TSESTree } from '@typescript-eslint/utils'\n\nconst literalKey = (prop: TSESTree.Property): string | undefined => {\n  if (prop.computed) return undefined\n  if (prop.key.type === 'Identifier') return prop.key.name\n  if (prop.key.type === 'Literal' && typeof prop.key.value === 'string') return prop.key.value\n  return undefined\n}\n\n// True when the property value is statically `undefined` (the absent case) — `payload: undefined`\n// is equivalent to omitting it, so it should not trigger the rule.\nconst isUndefinedValue = (node: TSESTree.Node): boolean =>\n  node.type === 'Identifier' && node.name === 'undefined'\n\nconst thoughtPayloadRequiresReplayTagRule = createRule({\n  name: 'thought-payload-requires-replay-tag',\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'A `Thought` carrying a `payload` must declare `replayCompatibility`; otherwise the harness cannot route the opaque payload to a matching adapter and drops it. Enforced at runtime by the Thought constructor; this surfaces it at the construction site.',\n    },\n    schema: [],\n    messages: {\n      requireReplayTag:\n        '`new Thought({ payload })` requires a `replayCompatibility` tag — without it the harness cannot route the opaque payload to an adapter and silently drops it. Add `replayCompatibility: \"<wire-shape-id>\"`, or remove the payload. Opt out with an eslint-disable-next-line adk/thought-payload-requires-replay-tag comment + reason.',\n    },\n  },\n  defaultOptions: [],\n  create(context) {\n    return {\n      NewExpression(node: TSESTree.NewExpression) {\n        if (node.callee.type !== 'Identifier' || node.callee.name !== 'Thought') return\n        const arg = node.arguments[0]\n        if (!arg || arg.type !== 'ObjectExpression') return\n\n        let payloadProp: TSESTree.Property | undefined\n        let hasReplayTag = false\n        let hasSpread = false\n        for (const p of arg.properties) {\n          if (p.type === 'SpreadElement') {\n            hasSpread = true\n            continue\n          }\n          const key = literalKey(p)\n          if (key === 'payload' && !isUndefinedValue(p.value)) payloadProp = p\n          else if (key === 'replayCompatibility' && !isUndefinedValue(p.value)) hasReplayTag = true\n        }\n\n        // A spread could supply replayCompatibility we can't see — stay conservative, don't flag.\n        if (payloadProp && !hasReplayTag && !hasSpread) {\n          context.report({ node: payloadProp, messageId: 'requireReplayTag' })\n        }\n      },\n    }\n  },\n})\n\nexport default thoughtPayloadRequiresReplayTagRule\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0BA,IAAM,cAAc,SAAgD;CAClE,IAAI,KAAK,UAAU,OAAO,KAAA;CAC1B,IAAI,KAAK,IAAI,SAAS,cAAc,OAAO,KAAK,IAAI;CACpD,IAAI,KAAK,IAAI,SAAS,aAAa,OAAO,KAAK,IAAI,UAAU,UAAU,OAAO,KAAK,IAAI;AAEzF;AAIA,IAAM,oBAAoB,SACxB,KAAK,SAAS,gBAAgB,KAAK,SAAS;AAE9C,IAAM,sCAAsC,WAAW;CACrD,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,4PACJ;EACA,QAAQ,CAAC;EACT,UAAU,EACR,kBACE,0UACJ;CACF;CACA,gBAAgB,CAAC;CACjB,OAAO,SAAS;EACd,OAAO,EACL,cAAc,MAA8B;GAC1C,IAAI,KAAK,OAAO,SAAS,gBAAgB,KAAK,OAAO,SAAS,WAAW;GACzE,MAAM,MAAM,KAAK,UAAU;GAC3B,IAAI,CAAC,OAAO,IAAI,SAAS,oBAAoB;GAE7C,IAAI;GACJ,IAAI,eAAe;GACnB,IAAI,YAAY;GAChB,KAAK,MAAM,KAAK,IAAI,YAAY;IAC9B,IAAI,EAAE,SAAS,iBAAiB;KAC9B,YAAY;KACZ;IACF;IACA,MAAM,MAAM,WAAW,CAAC;IACxB,IAAI,QAAQ,aAAa,CAAC,iBAAiB,EAAE,KAAK,GAAG,cAAc;SAC9D,IAAI,QAAQ,yBAAyB,CAAC,iBAAiB,EAAE,KAAK,GAAG,eAAe;GACvF;GAGA,IAAI,eAAe,CAAC,gBAAgB,CAAC,WACnC,QAAQ,OAAO;IAAE,MAAM;IAAa,WAAW;GAAmB,CAAC;EAEvE,EACF;CACF;AACF,CAAC"}

package/eslint/rules/token_encoding_requires_context_window.cjs

@@ -0,0 +1,70 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+require("../../chunk-Ble4zEEl.js");
+const require_common = require("../../common-DeNipTQI.js");
+//#region src/eslint/rules/token_encoding_requires_context_window.ts
+/**
+* @module @nhtio/adk/eslint/rules/token_encoding_requires_context_window
+*
+* Flags a Chat Completions adapter options literal that sets a non-null `tokenEncoding` but omits
+* `contextWindow`.
+*
+* Why: the OpenAI / WebLLM Chat Completions batteries only perform local token counting + overflow
+* protection when BOTH `tokenEncoding` (how to count) and `contextWindow` (the budget to count
+* against) are provided. Setting `tokenEncoding` alone is a footgun — the encoding is configured but
+* there is no ceiling to enforce, so the overflow guard silently never runs. The adapters throw on
+* this cross-field mismatch at iteration time; this rule surfaces it at the construction site.
+*
+* Detects `new OpenAIChatCompletionsAdapter({ … })` / `new WebLLMChatCompletionsAdapter({ … })`
+* (and any `*ChatCompletionsAdapter`) where `tokenEncoding` is present and not `null`/`undefined`
+* while `contextWindow` is absent.
+*
+* Opt-out:
+*   // eslint-disable-next-line adk/token-encoding-requires-context-window -- <reason>
+*/
+var literalKey = (prop) => {
+	if (prop.computed) return void 0;
+	if (prop.key.type === "Identifier") return prop.key.name;
+	if (prop.key.type === "Literal" && typeof prop.key.value === "string") return prop.key.value;
+};
+var isNullOrUndefined = (node) => node.type === "Literal" && node.value === null || node.type === "Identifier" && node.name === "undefined";
+var tokenEncodingRequiresContextWindowRule = require_common.createRule({
+	name: "token-encoding-requires-context-window",
+	meta: {
+		type: "problem",
+		docs: { description: "A Chat Completions adapter configured with a non-null `tokenEncoding` must also set `contextWindow`; otherwise token counting is configured but the overflow guard has no budget and never runs. The adapters enforce this at runtime; this surfaces it at the construction site." },
+		schema: [],
+		messages: { requireContextWindow: "`tokenEncoding` is set but `contextWindow` is missing — the adapter counts tokens with no budget to enforce, so the context-overflow guard never runs. Add `contextWindow`, or drop `tokenEncoding`. Opt out with an eslint-disable-next-line adk/token-encoding-requires-context-window comment + reason." }
+	},
+	defaultOptions: [],
+	create(context) {
+		return { NewExpression(node) {
+			if (node.callee.type !== "Identifier") return;
+			if (!/ChatCompletionsAdapter$/.test(node.callee.name)) return;
+			const arg = node.arguments[0];
+			if (!arg || arg.type !== "ObjectExpression") return;
+			let tokenEncodingProp;
+			let hasContextWindow = false;
+			let hasSpread = false;
+			for (const p of arg.properties) {
+				if (p.type === "SpreadElement") {
+					hasSpread = true;
+					continue;
+				}
+				const key = literalKey(p);
+				if (key === "tokenEncoding" && !isNullOrUndefined(p.value)) tokenEncodingProp = p;
+				else if (key === "contextWindow" && !isNullOrUndefined(p.value)) hasContextWindow = true;
+			}
+			if (tokenEncodingProp && !hasContextWindow && !hasSpread) context.report({
+				node: tokenEncodingProp,
+				messageId: "requireContextWindow"
+			});
+		} };
+	}
+});
+//#endregion
+exports.default = tokenEncodingRequiresContextWindowRule;
+
+//# sourceMappingURL=token_encoding_requires_context_window.cjs.map

package/eslint/rules/token_encoding_requires_context_window.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"token_encoding_requires_context_window.cjs","names":[],"sources":["../../../src/eslint/rules/token_encoding_requires_context_window.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/eslint/rules/token_encoding_requires_context_window\n *\n * Flags a Chat Completions adapter options literal that sets a non-null `tokenEncoding` but omits\n * `contextWindow`.\n *\n * Why: the OpenAI / WebLLM Chat Completions batteries only perform local token counting + overflow\n * protection when BOTH `tokenEncoding` (how to count) and `contextWindow` (the budget to count\n * against) are provided. Setting `tokenEncoding` alone is a footgun — the encoding is configured but\n * there is no ceiling to enforce, so the overflow guard silently never runs. The adapters throw on\n * this cross-field mismatch at iteration time; this rule surfaces it at the construction site.\n *\n * Detects `new OpenAIChatCompletionsAdapter({ … })` / `new WebLLMChatCompletionsAdapter({ … })`\n * (and any `*ChatCompletionsAdapter`) where `tokenEncoding` is present and not `null`/`undefined`\n * while `contextWindow` is absent.\n *\n * Opt-out:\n *   // eslint-disable-next-line adk/token-encoding-requires-context-window -- <reason>\n */\n\nimport { createRule } from './common'\n\nimport type { TSESTree } from '@typescript-eslint/utils'\n\nconst literalKey = (prop: TSESTree.Property): string | undefined => {\n  if (prop.computed) return undefined\n  if (prop.key.type === 'Identifier') return prop.key.name\n  if (prop.key.type === 'Literal' && typeof prop.key.value === 'string') return prop.key.value\n  return undefined\n}\n\nconst isNullOrUndefined = (node: TSESTree.Node): boolean =>\n  (node.type === 'Literal' && node.value === null) ||\n  (node.type === 'Identifier' && node.name === 'undefined')\n\nconst tokenEncodingRequiresContextWindowRule = createRule({\n  name: 'token-encoding-requires-context-window',\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'A Chat Completions adapter configured with a non-null `tokenEncoding` must also set `contextWindow`; otherwise token counting is configured but the overflow guard has no budget and never runs. The adapters enforce this at runtime; this surfaces it at the construction site.',\n    },\n    schema: [],\n    messages: {\n      requireContextWindow:\n        '`tokenEncoding` is set but `contextWindow` is missing — the adapter counts tokens with no budget to enforce, so the context-overflow guard never runs. Add `contextWindow`, or drop `tokenEncoding`. Opt out with an eslint-disable-next-line adk/token-encoding-requires-context-window comment + reason.',\n    },\n  },\n  defaultOptions: [],\n  create(context) {\n    return {\n      NewExpression(node: TSESTree.NewExpression) {\n        if (node.callee.type !== 'Identifier') return\n        if (!/ChatCompletionsAdapter$/.test(node.callee.name)) return\n        const arg = node.arguments[0]\n        if (!arg || arg.type !== 'ObjectExpression') return\n\n        let tokenEncodingProp: TSESTree.Property | undefined\n        let hasContextWindow = false\n        let hasSpread = false\n        for (const p of arg.properties) {\n          if (p.type === 'SpreadElement') {\n            hasSpread = true\n            continue\n          }\n          const key = literalKey(p)\n          if (key === 'tokenEncoding' && !isNullOrUndefined(p.value)) tokenEncodingProp = p\n          else if (key === 'contextWindow' && !isNullOrUndefined(p.value)) hasContextWindow = true\n        }\n\n        // A spread could supply contextWindow we can't see — stay conservative, don't flag.\n        if (tokenEncodingProp && !hasContextWindow && !hasSpread) {\n          context.report({ node: tokenEncodingProp, messageId: 'requireContextWindow' })\n        }\n      },\n    }\n  },\n})\n\nexport default tokenEncodingRequiresContextWindowRule\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,IAAM,cAAc,SAAgD;CAClE,IAAI,KAAK,UAAU,OAAO,KAAA;CAC1B,IAAI,KAAK,IAAI,SAAS,cAAc,OAAO,KAAK,IAAI;CACpD,IAAI,KAAK,IAAI,SAAS,aAAa,OAAO,KAAK,IAAI,UAAU,UAAU,OAAO,KAAK,IAAI;AAEzF;AAEA,IAAM,qBAAqB,SACxB,KAAK,SAAS,aAAa,KAAK,UAAU,QAC1C,KAAK,SAAS,gBAAgB,KAAK,SAAS;AAE/C,IAAM,yCAAyC,eAAA,WAAW;CACxD,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,oRACJ;EACA,QAAQ,CAAC;EACT,UAAU,EACR,sBACE,6SACJ;CACF;CACA,gBAAgB,CAAC;CACjB,OAAO,SAAS;EACd,OAAO,EACL,cAAc,MAA8B;GAC1C,IAAI,KAAK,OAAO,SAAS,cAAc;GACvC,IAAI,CAAC,0BAA0B,KAAK,KAAK,OAAO,IAAI,GAAG;GACvD,MAAM,MAAM,KAAK,UAAU;GAC3B,IAAI,CAAC,OAAO,IAAI,SAAS,oBAAoB;GAE7C,IAAI;GACJ,IAAI,mBAAmB;GACvB,IAAI,YAAY;GAChB,KAAK,MAAM,KAAK,IAAI,YAAY;IAC9B,IAAI,EAAE,SAAS,iBAAiB;KAC9B,YAAY;KACZ;IACF;IACA,MAAM,MAAM,WAAW,CAAC;IACxB,IAAI,QAAQ,mBAAmB,CAAC,kBAAkB,EAAE,KAAK,GAAG,oBAAoB;SAC3E,IAAI,QAAQ,mBAAmB,CAAC,kBAAkB,EAAE,KAAK,GAAG,mBAAmB;GACtF;GAGA,IAAI,qBAAqB,CAAC,oBAAoB,CAAC,WAC7C,QAAQ,OAAO;IAAE,MAAM;IAAmB,WAAW;GAAuB,CAAC;EAEjF,EACF;CACF;AACF,CAAC"}

package/eslint/rules/token_encoding_requires_context_window.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module @nhtio/adk/eslint/rules/token_encoding_requires_context_window
+ *
+ * Flags a Chat Completions adapter options literal that sets a non-null `tokenEncoding` but omits
+ * `contextWindow`.
+ *
+ * Why: the OpenAI / WebLLM Chat Completions batteries only perform local token counting + overflow
+ * protection when BOTH `tokenEncoding` (how to count) and `contextWindow` (the budget to count
+ * against) are provided. Setting `tokenEncoding` alone is a footgun — the encoding is configured but
+ * there is no ceiling to enforce, so the overflow guard silently never runs. The adapters throw on
+ * this cross-field mismatch at iteration time; this rule surfaces it at the construction site.
+ *
+ * Detects `new OpenAIChatCompletionsAdapter({ … })` / `new WebLLMChatCompletionsAdapter({ … })`
+ * (and any `*ChatCompletionsAdapter`) where `tokenEncoding` is present and not `null`/`undefined`
+ * while `contextWindow` is absent.
+ *
+ * Opt-out:
+ *   // eslint-disable-next-line adk/token-encoding-requires-context-window -- <reason>
+ */
+declare const tokenEncodingRequiresContextWindowRule: import("@typescript-eslint/utils/ts-eslint").RuleModule<"requireContextWindow", [
+], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener> & {
+    name: string;
+};
+export default tokenEncodingRequiresContextWindowRule;

package/eslint/rules/token_encoding_requires_context_window.mjs

@@ -0,0 +1,65 @@
+import { t as createRule } from "../../common-BUIjZ6LV.mjs";
+//#region src/eslint/rules/token_encoding_requires_context_window.ts
+/**
+* @module @nhtio/adk/eslint/rules/token_encoding_requires_context_window
+*
+* Flags a Chat Completions adapter options literal that sets a non-null `tokenEncoding` but omits
+* `contextWindow`.
+*
+* Why: the OpenAI / WebLLM Chat Completions batteries only perform local token counting + overflow
+* protection when BOTH `tokenEncoding` (how to count) and `contextWindow` (the budget to count
+* against) are provided. Setting `tokenEncoding` alone is a footgun — the encoding is configured but
+* there is no ceiling to enforce, so the overflow guard silently never runs. The adapters throw on
+* this cross-field mismatch at iteration time; this rule surfaces it at the construction site.
+*
+* Detects `new OpenAIChatCompletionsAdapter({ … })` / `new WebLLMChatCompletionsAdapter({ … })`
+* (and any `*ChatCompletionsAdapter`) where `tokenEncoding` is present and not `null`/`undefined`
+* while `contextWindow` is absent.
+*
+* Opt-out:
+*   // eslint-disable-next-line adk/token-encoding-requires-context-window -- <reason>
+*/
+var literalKey = (prop) => {
+	if (prop.computed) return void 0;
+	if (prop.key.type === "Identifier") return prop.key.name;
+	if (prop.key.type === "Literal" && typeof prop.key.value === "string") return prop.key.value;
+};
+var isNullOrUndefined = (node) => node.type === "Literal" && node.value === null || node.type === "Identifier" && node.name === "undefined";
+var tokenEncodingRequiresContextWindowRule = createRule({
+	name: "token-encoding-requires-context-window",
+	meta: {
+		type: "problem",
+		docs: { description: "A Chat Completions adapter configured with a non-null `tokenEncoding` must also set `contextWindow`; otherwise token counting is configured but the overflow guard has no budget and never runs. The adapters enforce this at runtime; this surfaces it at the construction site." },
+		schema: [],
+		messages: { requireContextWindow: "`tokenEncoding` is set but `contextWindow` is missing — the adapter counts tokens with no budget to enforce, so the context-overflow guard never runs. Add `contextWindow`, or drop `tokenEncoding`. Opt out with an eslint-disable-next-line adk/token-encoding-requires-context-window comment + reason." }
+	},
+	defaultOptions: [],
+	create(context) {
+		return { NewExpression(node) {
+			if (node.callee.type !== "Identifier") return;
+			if (!/ChatCompletionsAdapter$/.test(node.callee.name)) return;
+			const arg = node.arguments[0];
+			if (!arg || arg.type !== "ObjectExpression") return;
+			let tokenEncodingProp;
+			let hasContextWindow = false;
+			let hasSpread = false;
+			for (const p of arg.properties) {
+				if (p.type === "SpreadElement") {
+					hasSpread = true;
+					continue;
+				}
+				const key = literalKey(p);
+				if (key === "tokenEncoding" && !isNullOrUndefined(p.value)) tokenEncodingProp = p;
+				else if (key === "contextWindow" && !isNullOrUndefined(p.value)) hasContextWindow = true;
+			}
+			if (tokenEncodingProp && !hasContextWindow && !hasSpread) context.report({
+				node: tokenEncodingProp,
+				messageId: "requireContextWindow"
+			});
+		} };
+	}
+});
+//#endregion
+export { tokenEncodingRequiresContextWindowRule as default };
+
+//# sourceMappingURL=token_encoding_requires_context_window.mjs.map

package/eslint/rules/token_encoding_requires_context_window.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"token_encoding_requires_context_window.mjs","names":[],"sources":["../../../src/eslint/rules/token_encoding_requires_context_window.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/eslint/rules/token_encoding_requires_context_window\n *\n * Flags a Chat Completions adapter options literal that sets a non-null `tokenEncoding` but omits\n * `contextWindow`.\n *\n * Why: the OpenAI / WebLLM Chat Completions batteries only perform local token counting + overflow\n * protection when BOTH `tokenEncoding` (how to count) and `contextWindow` (the budget to count\n * against) are provided. Setting `tokenEncoding` alone is a footgun — the encoding is configured but\n * there is no ceiling to enforce, so the overflow guard silently never runs. The adapters throw on\n * this cross-field mismatch at iteration time; this rule surfaces it at the construction site.\n *\n * Detects `new OpenAIChatCompletionsAdapter({ … })` / `new WebLLMChatCompletionsAdapter({ … })`\n * (and any `*ChatCompletionsAdapter`) where `tokenEncoding` is present and not `null`/`undefined`\n * while `contextWindow` is absent.\n *\n * Opt-out:\n *   // eslint-disable-next-line adk/token-encoding-requires-context-window -- <reason>\n */\n\nimport { createRule } from './common'\n\nimport type { TSESTree } from '@typescript-eslint/utils'\n\nconst literalKey = (prop: TSESTree.Property): string | undefined => {\n  if (prop.computed) return undefined\n  if (prop.key.type === 'Identifier') return prop.key.name\n  if (prop.key.type === 'Literal' && typeof prop.key.value === 'string') return prop.key.value\n  return undefined\n}\n\nconst isNullOrUndefined = (node: TSESTree.Node): boolean =>\n  (node.type === 'Literal' && node.value === null) ||\n  (node.type === 'Identifier' && node.name === 'undefined')\n\nconst tokenEncodingRequiresContextWindowRule = createRule({\n  name: 'token-encoding-requires-context-window',\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'A Chat Completions adapter configured with a non-null `tokenEncoding` must also set `contextWindow`; otherwise token counting is configured but the overflow guard has no budget and never runs. The adapters enforce this at runtime; this surfaces it at the construction site.',\n    },\n    schema: [],\n    messages: {\n      requireContextWindow:\n        '`tokenEncoding` is set but `contextWindow` is missing — the adapter counts tokens with no budget to enforce, so the context-overflow guard never runs. Add `contextWindow`, or drop `tokenEncoding`. Opt out with an eslint-disable-next-line adk/token-encoding-requires-context-window comment + reason.',\n    },\n  },\n  defaultOptions: [],\n  create(context) {\n    return {\n      NewExpression(node: TSESTree.NewExpression) {\n        if (node.callee.type !== 'Identifier') return\n        if (!/ChatCompletionsAdapter$/.test(node.callee.name)) return\n        const arg = node.arguments[0]\n        if (!arg || arg.type !== 'ObjectExpression') return\n\n        let tokenEncodingProp: TSESTree.Property | undefined\n        let hasContextWindow = false\n        let hasSpread = false\n        for (const p of arg.properties) {\n          if (p.type === 'SpreadElement') {\n            hasSpread = true\n            continue\n          }\n          const key = literalKey(p)\n          if (key === 'tokenEncoding' && !isNullOrUndefined(p.value)) tokenEncodingProp = p\n          else if (key === 'contextWindow' && !isNullOrUndefined(p.value)) hasContextWindow = true\n        }\n\n        // A spread could supply contextWindow we can't see — stay conservative, don't flag.\n        if (tokenEncodingProp && !hasContextWindow && !hasSpread) {\n          context.report({ node: tokenEncodingProp, messageId: 'requireContextWindow' })\n        }\n      },\n    }\n  },\n})\n\nexport default tokenEncodingRequiresContextWindowRule\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAwBA,IAAM,cAAc,SAAgD;CAClE,IAAI,KAAK,UAAU,OAAO,KAAA;CAC1B,IAAI,KAAK,IAAI,SAAS,cAAc,OAAO,KAAK,IAAI;CACpD,IAAI,KAAK,IAAI,SAAS,aAAa,OAAO,KAAK,IAAI,UAAU,UAAU,OAAO,KAAK,IAAI;AAEzF;AAEA,IAAM,qBAAqB,SACxB,KAAK,SAAS,aAAa,KAAK,UAAU,QAC1C,KAAK,SAAS,gBAAgB,KAAK,SAAS;AAE/C,IAAM,yCAAyC,WAAW;CACxD,MAAM;CACN,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,oRACJ;EACA,QAAQ,CAAC;EACT,UAAU,EACR,sBACE,6SACJ;CACF;CACA,gBAAgB,CAAC;CACjB,OAAO,SAAS;EACd,OAAO,EACL,cAAc,MAA8B;GAC1C,IAAI,KAAK,OAAO,SAAS,cAAc;GACvC,IAAI,CAAC,0BAA0B,KAAK,KAAK,OAAO,IAAI,GAAG;GACvD,MAAM,MAAM,KAAK,UAAU;GAC3B,IAAI,CAAC,OAAO,IAAI,SAAS,oBAAoB;GAE7C,IAAI;GACJ,IAAI,mBAAmB;GACvB,IAAI,YAAY;GAChB,KAAK,MAAM,KAAK,IAAI,YAAY;IAC9B,IAAI,EAAE,SAAS,iBAAiB;KAC9B,YAAY;KACZ;IACF;IACA,MAAM,MAAM,WAAW,CAAC;IACxB,IAAI,QAAQ,mBAAmB,CAAC,kBAAkB,EAAE,KAAK,GAAG,oBAAoB;SAC3E,IAAI,QAAQ,mBAAmB,CAAC,kBAAkB,EAAE,KAAK,GAAG,mBAAmB;GACtF;GAGA,IAAI,qBAAqB,CAAC,oBAAoB,CAAC,WAC7C,QAAQ,OAAO;IAAE,MAAM;IAAmB,WAAW;GAAuB,CAAC;EAEjF,EACF;CACF;AACF,CAAC"}

package/eslint/rules.cjs

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../chunk-Ble4zEEl.js");
+const require_eslint_rules_no_model_in_tool_handler = require("./rules/no_model_in_tool_handler.cjs");
+const require_eslint_rules_require_validator_any_required = require("./rules/require_validator_any_required.cjs");
+const require_eslint_rules_thought_payload_requires_replay_tag = require("./rules/thought_payload_requires_replay_tag.cjs");
+const require_eslint_rules_token_encoding_requires_context_window = require("./rules/token_encoding_requires_context_window.cjs");
+const require_eslint_rules_artifact_tool_forbids_artifact_constructor = require("./rules/artifact_tool_forbids_artifact_constructor.cjs");
+exports.artifactToolForbidsArtifactConstructor = require_eslint_rules_artifact_tool_forbids_artifact_constructor.default;
+exports.noModelInToolHandler = require_eslint_rules_no_model_in_tool_handler.default;
+exports.requireValidatorAnyRequired = require_eslint_rules_require_validator_any_required.default;
+exports.thoughtPayloadRequiresReplayTag = require_eslint_rules_thought_payload_requires_replay_tag.default;
+exports.tokenEncodingRequiresContextWindow = require_eslint_rules_token_encoding_requires_context_window.default;

package/eslint/rules.mjs

@@ -0,0 +1,6 @@
+import noModelInToolHandlerRule from "./rules/no_model_in_tool_handler.mjs";
+import requireValidatorAnyRequiredRule from "./rules/require_validator_any_required.mjs";
+import thoughtPayloadRequiresReplayTagRule from "./rules/thought_payload_requires_replay_tag.mjs";
+import tokenEncodingRequiresContextWindowRule from "./rules/token_encoding_requires_context_window.mjs";
+import artifactToolForbidsArtifactConstructorRule from "./rules/artifact_tool_forbids_artifact_constructor.mjs";
+export { artifactToolForbidsArtifactConstructorRule as artifactToolForbidsArtifactConstructor, noModelInToolHandlerRule as noModelInToolHandler, requireValidatorAnyRequiredRule as requireValidatorAnyRequired, thoughtPayloadRequiresReplayTagRule as thoughtPayloadRequiresReplayTag, tokenEncodingRequiresContextWindowRule as tokenEncodingRequiresContextWindow };

package/eslint.cjs

@@ -0,0 +1,82 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+require("./chunk-Ble4zEEl.js");
+const require_eslint_rules_no_model_in_tool_handler = require("./eslint/rules/no_model_in_tool_handler.cjs");
+const require_eslint_rules_require_validator_any_required = require("./eslint/rules/require_validator_any_required.cjs");
+const require_eslint_rules_thought_payload_requires_replay_tag = require("./eslint/rules/thought_payload_requires_replay_tag.cjs");
+const require_eslint_rules_token_encoding_requires_context_window = require("./eslint/rules/token_encoding_requires_context_window.cjs");
+const require_eslint_rules_artifact_tool_forbids_artifact_constructor = require("./eslint/rules/artifact_tool_forbids_artifact_constructor.cjs");
+//#region src/eslint/index.ts
+/**
+* @module @nhtio/adk/eslint
+*
+* The `@nhtio/adk` ESLint plugin: machine-checkable enforcement of the harness contracts that
+* implementors of bring-your-own batteries, tools, and primitives are most likely to get wrong.
+*
+* @remarks
+* These rules turn documented footguns into lint errors. They are report-only (no autofix) — each
+* names the contract it enforces and the fix; carve out a deliberate exception with an inline
+* `// eslint-disable-next-line adk/<rule> -- <reason>` comment.
+*
+* `@typescript-eslint/utils` and `eslint` are OPTIONAL peer dependencies of `@nhtio/adk` — installed
+* only by consumers who lint with this plugin. The main library never imports this module.
+*
+* @example Flat config
+* ```ts
+* import adk from '@nhtio/adk/eslint'
+*
+* export default [
+*   { plugins: { adk: adk.plugin }, rules: adk.configs.recommended.rules },
+* ]
+* ```
+*/
+/**
+* Map of rule id (without the `adk/` plugin prefix) to its rule object. Registered on the plugin as
+* `rules`, so configs reference them as `adk/<id>`.
+*/
+var rules = {
+	"require-validator-any-required": require_eslint_rules_require_validator_any_required.default,
+	"no-model-in-tool-handler": require_eslint_rules_no_model_in_tool_handler.default,
+	"thought-payload-requires-replay-tag": require_eslint_rules_thought_payload_requires_replay_tag.default,
+	"token-encoding-requires-context-window": require_eslint_rules_token_encoding_requires_context_window.default,
+	"artifact-tool-forbids-artifact-constructor": require_eslint_rules_artifact_tool_forbids_artifact_constructor.default
+};
+/**
+* The ESLint plugin object. Register under the `adk` namespace: `plugins: { adk: plugin }`.
+*/
+var plugin = {
+	meta: {
+		name: "@nhtio/adk/eslint",
+		version: "1.20260607.2"
+	},
+	rules
+};
+/** Every rule enabled at `error`, keyed `adk/<id>` (assumes the plugin is registered as `adk`). */
+var recommendedRules = Object.fromEntries(Object.keys(rules).map((id) => [`adk/${id}`, "error"]));
+/**
+* Named config presets. `recommended` enables every rule at `error` and registers the plugin under
+* the `adk` namespace — spread it into a flat config to adopt the full set.
+*/
+var configs = { recommended: {
+	name: "@nhtio/adk/eslint/recommended",
+	plugins: { adk: plugin },
+	rules: recommendedRules
+} };
+/**
+* Default export bundles the plugin and its config presets, mirroring the shape ESLint flat configs
+* expect from a plugin module.
+*/
+var eslint_default = {
+	plugin,
+	rules,
+	configs
+};
+//#endregion
+exports.configs = configs;
+exports.default = eslint_default;
+exports.plugin = plugin;
+exports.rules = rules;
+
+//# sourceMappingURL=eslint.cjs.map

package/eslint.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.cjs","names":[],"sources":["../src/eslint/index.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/eslint\n *\n * The `@nhtio/adk` ESLint plugin: machine-checkable enforcement of the harness contracts that\n * implementors of bring-your-own batteries, tools, and primitives are most likely to get wrong.\n *\n * @remarks\n * These rules turn documented footguns into lint errors. They are report-only (no autofix) — each\n * names the contract it enforces and the fix; carve out a deliberate exception with an inline\n * `// eslint-disable-next-line adk/<rule> -- <reason>` comment.\n *\n * `@typescript-eslint/utils` and `eslint` are OPTIONAL peer dependencies of `@nhtio/adk` — installed\n * only by consumers who lint with this plugin. The main library never imports this module.\n *\n * @example Flat config\n * ```ts\n * import adk from '@nhtio/adk/eslint'\n *\n * export default [\n *   { plugins: { adk: adk.plugin }, rules: adk.configs.recommended.rules },\n * ]\n * ```\n */\n\nimport { default as noModelInToolHandler } from './rules/no_model_in_tool_handler'\nimport { default as requireValidatorAnyRequired } from './rules/require_validator_any_required'\nimport { default as thoughtPayloadRequiresReplayTag } from './rules/thought_payload_requires_replay_tag'\nimport { default as tokenEncodingRequiresContextWindow } from './rules/token_encoding_requires_context_window'\nimport { default as artifactToolForbidsArtifactConstructor } from './rules/artifact_tool_forbids_artifact_constructor'\nimport type { FlatConfig } from '@typescript-eslint/utils/ts-eslint'\n\n/**\n * Map of rule id (without the `adk/` plugin prefix) to its rule object. Registered on the plugin as\n * `rules`, so configs reference them as `adk/<id>`.\n */\nexport const rules = {\n  'require-validator-any-required': requireValidatorAnyRequired,\n  'no-model-in-tool-handler': noModelInToolHandler,\n  'thought-payload-requires-replay-tag': thoughtPayloadRequiresReplayTag,\n  'token-encoding-requires-context-window': tokenEncodingRequiresContextWindow,\n  'artifact-tool-forbids-artifact-constructor': artifactToolForbidsArtifactConstructor,\n} satisfies FlatConfig.Plugin['rules']\n\n/**\n * The ESLint plugin object. Register under the `adk` namespace: `plugins: { adk: plugin }`.\n */\nexport const plugin: FlatConfig.Plugin = {\n  meta: { name: '@nhtio/adk/eslint', version: __VERSION__ },\n  rules,\n}\n\n/** Every rule enabled at `error`, keyed `adk/<id>` (assumes the plugin is registered as `adk`). */\nconst recommendedRules: NonNullable<FlatConfig.Config['rules']> = Object.fromEntries(\n  Object.keys(rules).map((id) => [`adk/${id}`, 'error'])\n)\n\n/**\n * Named config presets. `recommended` enables every rule at `error` and registers the plugin under\n * the `adk` namespace — spread it into a flat config to adopt the full set.\n */\nexport const configs = {\n  recommended: {\n    name: '@nhtio/adk/eslint/recommended',\n    plugins: { adk: plugin },\n    rules: recommendedRules,\n  } satisfies FlatConfig.Config,\n}\n\n/**\n * Default export bundles the plugin and its config presets, mirroring the shape ESLint flat configs\n * expect from a plugin module.\n */\nexport default { plugin, rules, configs }\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,IAAa,QAAQ;CACnB,kCAAkC,oDAAA;CAClC,4BAA4B,8CAAA;CAC5B,uCAAuC,yDAAA;CACvC,0CAA0C,4DAAA;CAC1C,8CAA8C,gEAAA;AAChD;;;;AAKA,IAAa,SAA4B;CACvC,MAAM;EAAE,MAAM;EAAqB,SAAA;CAAqB;CACxD;AACF;;AAGA,IAAM,mBAA4D,OAAO,YACvE,OAAO,KAAK,KAAK,EAAE,KAAK,OAAO,CAAC,OAAO,MAAM,OAAO,CAAC,CACvD;;;;;AAMA,IAAa,UAAU,EACrB,aAAa;CACX,MAAM;CACN,SAAS,EAAE,KAAK,OAAO;CACvB,OAAO;AACT,EACF;;;;;AAMA,IAAA,iBAAe;CAAE;CAAQ;CAAO;AAAQ"}

package/eslint.mjs

@@ -0,0 +1,74 @@
+import noModelInToolHandlerRule from "./eslint/rules/no_model_in_tool_handler.mjs";
+import requireValidatorAnyRequiredRule from "./eslint/rules/require_validator_any_required.mjs";
+import thoughtPayloadRequiresReplayTagRule from "./eslint/rules/thought_payload_requires_replay_tag.mjs";
+import tokenEncodingRequiresContextWindowRule from "./eslint/rules/token_encoding_requires_context_window.mjs";
+import artifactToolForbidsArtifactConstructorRule from "./eslint/rules/artifact_tool_forbids_artifact_constructor.mjs";
+//#region src/eslint/index.ts
+/**
+* @module @nhtio/adk/eslint
+*
+* The `@nhtio/adk` ESLint plugin: machine-checkable enforcement of the harness contracts that
+* implementors of bring-your-own batteries, tools, and primitives are most likely to get wrong.
+*
+* @remarks
+* These rules turn documented footguns into lint errors. They are report-only (no autofix) — each
+* names the contract it enforces and the fix; carve out a deliberate exception with an inline
+* `// eslint-disable-next-line adk/<rule> -- <reason>` comment.
+*
+* `@typescript-eslint/utils` and `eslint` are OPTIONAL peer dependencies of `@nhtio/adk` — installed
+* only by consumers who lint with this plugin. The main library never imports this module.
+*
+* @example Flat config
+* ```ts
+* import adk from '@nhtio/adk/eslint'
+*
+* export default [
+*   { plugins: { adk: adk.plugin }, rules: adk.configs.recommended.rules },
+* ]
+* ```
+*/
+/**
+* Map of rule id (without the `adk/` plugin prefix) to its rule object. Registered on the plugin as
+* `rules`, so configs reference them as `adk/<id>`.
+*/
+var rules = {
+	"require-validator-any-required": requireValidatorAnyRequiredRule,
+	"no-model-in-tool-handler": noModelInToolHandlerRule,
+	"thought-payload-requires-replay-tag": thoughtPayloadRequiresReplayTagRule,
+	"token-encoding-requires-context-window": tokenEncodingRequiresContextWindowRule,
+	"artifact-tool-forbids-artifact-constructor": artifactToolForbidsArtifactConstructorRule
+};
+/**
+* The ESLint plugin object. Register under the `adk` namespace: `plugins: { adk: plugin }`.
+*/
+var plugin = {
+	meta: {
+		name: "@nhtio/adk/eslint",
+		version: "1.20260607.2"
+	},
+	rules
+};
+/** Every rule enabled at `error`, keyed `adk/<id>` (assumes the plugin is registered as `adk`). */
+var recommendedRules = Object.fromEntries(Object.keys(rules).map((id) => [`adk/${id}`, "error"]));
+/**
+* Named config presets. `recommended` enables every rule at `error` and registers the plugin under
+* the `adk` namespace — spread it into a flat config to adopt the full set.
+*/
+var configs = { recommended: {
+	name: "@nhtio/adk/eslint/recommended",
+	plugins: { adk: plugin },
+	rules: recommendedRules
+} };
+/**
+* Default export bundles the plugin and its config presets, mirroring the shape ESLint flat configs
+* expect from a plugin module.
+*/
+var eslint_default = {
+	plugin,
+	rules,
+	configs
+};
+//#endregion
+export { configs, eslint_default as default, plugin, rules };
+
+//# sourceMappingURL=eslint.mjs.map

package/eslint.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.mjs","names":[],"sources":["../src/eslint/index.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/eslint\n *\n * The `@nhtio/adk` ESLint plugin: machine-checkable enforcement of the harness contracts that\n * implementors of bring-your-own batteries, tools, and primitives are most likely to get wrong.\n *\n * @remarks\n * These rules turn documented footguns into lint errors. They are report-only (no autofix) — each\n * names the contract it enforces and the fix; carve out a deliberate exception with an inline\n * `// eslint-disable-next-line adk/<rule> -- <reason>` comment.\n *\n * `@typescript-eslint/utils` and `eslint` are OPTIONAL peer dependencies of `@nhtio/adk` — installed\n * only by consumers who lint with this plugin. The main library never imports this module.\n *\n * @example Flat config\n * ```ts\n * import adk from '@nhtio/adk/eslint'\n *\n * export default [\n *   { plugins: { adk: adk.plugin }, rules: adk.configs.recommended.rules },\n * ]\n * ```\n */\n\nimport { default as noModelInToolHandler } from './rules/no_model_in_tool_handler'\nimport { default as requireValidatorAnyRequired } from './rules/require_validator_any_required'\nimport { default as thoughtPayloadRequiresReplayTag } from './rules/thought_payload_requires_replay_tag'\nimport { default as tokenEncodingRequiresContextWindow } from './rules/token_encoding_requires_context_window'\nimport { default as artifactToolForbidsArtifactConstructor } from './rules/artifact_tool_forbids_artifact_constructor'\nimport type { FlatConfig } from '@typescript-eslint/utils/ts-eslint'\n\n/**\n * Map of rule id (without the `adk/` plugin prefix) to its rule object. Registered on the plugin as\n * `rules`, so configs reference them as `adk/<id>`.\n */\nexport const rules = {\n  'require-validator-any-required': requireValidatorAnyRequired,\n  'no-model-in-tool-handler': noModelInToolHandler,\n  'thought-payload-requires-replay-tag': thoughtPayloadRequiresReplayTag,\n  'token-encoding-requires-context-window': tokenEncodingRequiresContextWindow,\n  'artifact-tool-forbids-artifact-constructor': artifactToolForbidsArtifactConstructor,\n} satisfies FlatConfig.Plugin['rules']\n\n/**\n * The ESLint plugin object. Register under the `adk` namespace: `plugins: { adk: plugin }`.\n */\nexport const plugin: FlatConfig.Plugin = {\n  meta: { name: '@nhtio/adk/eslint', version: __VERSION__ },\n  rules,\n}\n\n/** Every rule enabled at `error`, keyed `adk/<id>` (assumes the plugin is registered as `adk`). */\nconst recommendedRules: NonNullable<FlatConfig.Config['rules']> = Object.fromEntries(\n  Object.keys(rules).map((id) => [`adk/${id}`, 'error'])\n)\n\n/**\n * Named config presets. `recommended` enables every rule at `error` and registers the plugin under\n * the `adk` namespace — spread it into a flat config to adopt the full set.\n */\nexport const configs = {\n  recommended: {\n    name: '@nhtio/adk/eslint/recommended',\n    plugins: { adk: plugin },\n    rules: recommendedRules,\n  } satisfies FlatConfig.Config,\n}\n\n/**\n * Default export bundles the plugin and its config presets, mirroring the shape ESLint flat configs\n * expect from a plugin module.\n */\nexport default { plugin, rules, configs }\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,IAAa,QAAQ;CACnB,kCAAkC;CAClC,4BAA4B;CAC5B,uCAAuC;CACvC,0CAA0C;CAC1C,8CAA8C;AAChD;;;;AAKA,IAAa,SAA4B;CACvC,MAAM;EAAE,MAAM;EAAqB,SAAA;CAAqB;CACxD;AACF;;AAGA,IAAM,mBAA4D,OAAO,YACvE,OAAO,KAAK,KAAK,EAAE,KAAK,OAAO,CAAC,OAAO,MAAM,OAAO,CAAC,CACvD;;;;;AAMA,IAAa,UAAU,EACrB,aAAa;CACX,MAAM;CACN,SAAS,EAAE,KAAK,OAAO;CACvB,OAAO;AACT,EACF;;;;;AAMA,IAAA,iBAAe;CAAE;CAAQ;CAAO;AAAQ"}

package/index.cjs

@@ -26,7 +26,7 @@ require("./turn_runner.cjs");
 *
 * @tip This is a constant that is replaced during the build process with the actual version of the package.
 */
-var version = "1.20260607.0";
+var version = "1.20260607.2";
 //#endregion
 exports.ArtifactTool = require_spooled_artifact.ArtifactTool;
 exports.DispatchRunner = require_dispatch_runner.DispatchRunner;

package/index.mjs

@@ -24,7 +24,7 @@ import "./turn_runner.mjs";
 *
 * @tip This is a constant that is replaced during the build process with the actual version of the package.
 */
-var version = "1.20260607.0";
+var version = "1.20260607.2";
 //#endregion
 export { ArtifactTool, DispatchRunner, E_DISPATCH_PIPELINE_ERROR, E_INPUT_PIPELINE_ERROR, E_INVALID_INITIAL_IDENTITY_VALUE, E_INVALID_INITIAL_MEMORY_VALUE, E_INVALID_INITIAL_MESSAGE_VALUE, E_INVALID_INITIAL_REGISTRY_VALUE, E_INVALID_INITIAL_THOUGHT_VALUE, E_INVALID_INITIAL_TOOL_CALL_VALUE, E_INVALID_INITIAL_TOOL_VALUE, E_INVALID_INITIAL_TURN_GATE_VALUE, E_INVALID_LLM_DISPATCH_INPUT, E_INVALID_LLM_EXECUTION_CONTEXT, E_INVALID_TOOL_ARGS, E_INVALID_TURN_CONTEXT, E_INVALID_TURN_GATE_RESOLUTION, E_INVALID_TURN_RUNNER_CONFIG, E_LLM_EXECUTION_ALREADY_SIGNALLED, E_LLM_EXECUTION_EXECUTOR_ERROR, E_LLM_EXECUTION_GATE_NOT_SUPPORTED, E_NOT_A_SPOOL_READER, E_OUTPUT_PIPELINE_ERROR, E_PIPELINE_SHORT_CIRCUITED, E_TOOL_ALREADY_REGISTERED, E_TOOL_DOWNSTREAM_ERROR, E_TURN_GATE_ABORTED, E_TURN_GATE_TIMEOUT, Identity, Media, Memory, Message, Registry, Retrievable, SpooledArtifact, SpooledJsonArtifact, SpooledMarkdownArtifact, Thought, TokenEncoding, Tokenizable, Tool, ToolCall, ToolRegistry, TurnRunner, ValidationException, fromFetch, fromWebFile, implementsMediaReader, implementsSpoolReader, inMemoryMediaReader, isArtifactTool, isBaseException, isDispatchContext, isDispatchRunner, isError, isIdentity, isInstanceOf, isMedia, isMemory, isMessage, isObject, isRegistry, isSpooledArtifact, isSpooledArtifactConstructor, isSpooledJsonArtifact, isSpooledMarkdownArtifact, isThought, isTokenizable, isTool, isToolCall, isToolRegistry, isTurnContext, isTurnGate, isTurnRunner, mediaReaderSchema, version };