@tangle-network/agent-app 0.63.46 → 0.63.48

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -104,4 +104,4 @@ function displayPath(file) {
104
104
  export {
105
105
  checkThemeContract
106
106
  };
107
- //# sourceMappingURL=chunk-LUKLQDIK.js.map
107
+ //# sourceMappingURL=chunk-ISNEHOOO.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/theme-contract/index.ts"],"sourcesContent":["/**\n * Exportable theme-token contract checker — the incident guard for the\n * invisible-popover class of bugs.\n *\n * The failure mode (tax-agent's transparent model dropdown; the whole\n * `bg-surface-container-*` family): a consumer app ships a component that\n * references a theme token — either as `var(--popover)` or as a Tailwind class\n * like `bg-surface-container-high` that the agent-app preset maps to\n * `hsl(var(--popover))` — but the app's OWN build never emits that custom\n * property (it forgot `import '@tangle-network/agent-app/styles'`, or dropped a\n * token in its local tokens.css). CSS resolves the missing var to nothing, the\n * surface paints transparent, and NOTHING errors. It ships invisible.\n *\n * Consumer apps scan their own source against the tokens.css agent-app ships\n * plus any extra CSS they define. `tests/theme/packed-styles-consumer.mjs`\n * exercises this public API with the packed stylesheet in a browser.\n *\n * ── What each check covers (scope is deliberately honest) ────────────────────\n *\n * 1. var(--…) check — COMPLETE. Every `var(--name)` literal in the scanned\n * source (inline styles, `bg-[var(--name)]` arbitrary Tailwind values, CSS\n * template strings) is matched and compared against the defined token set.\n * This is exact: a `var(--x)` reference is unambiguous. It is a raw-text\n * scan (no AST), so a `var(--x)` written inside a comment or string literal\n * counts too. Suppress intentional runtime-defined variables with `allowlist`.\n *\n * 2. Tailwind-utility check — INTENTIONALLY PARTIAL. Bare classes like\n * `bg-card` carry no `var(--)` and so are invisible to check 1; Tailwind\n * resolves them to `hsl(var(--card))` at build via the preset. Fully\n * resolving arbitrary Tailwind config is out of scope (it would mean\n * re-implementing Tailwind). Instead we check the SPECIFIC known-dangerous\n * families that have actually shipped invisible: the MD3 surface ladder\n * (`surface-container` / `-high` / `-highest`) and the `card` / `popover`\n * elevation pairs — exactly the utilities the agent-app tailwind-preset\n * registers onto elevation tokens (see src/theme/tailwind-preset.ts, the\n * source of truth for this mapping). The canvas/sequence aliases\n * (`--bg-input`, `--text-primary`, …) are consumed as `bg-[var(--…)]`\n * arbitrary values and so are already covered fully by check 1 — they need\n * no entry here.\n *\n * Node-only (reads the filesystem) → this lives in the `./theme-contract`\n * subpath, NOT `./theme`, which must stay browser-clean (it's in the\n * browser-safe manifest test).\n */\n\nimport { existsSync, readFileSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { dirname, relative, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { walkSources } from '../legibility/walk-sources'\n\n/** Define options for scanning source directories and CSS token files in a theme contract */\nexport interface ThemeContractOptions {\n /** Consumer source directories to scan for token references (recursively). */\n srcDirs: string[]\n /**\n * Path to the base tokens.css whose `--name:` definitions are the ground\n * truth. Defaults to the tokens.css agent-app ships (`./styles`) — the set a\n * consumer gets from `import '@tangle-network/agent-app/styles'`.\n */\n tokensCss?: string\n /**\n * Additional CSS files whose `--name:` definitions also count as defined —\n * the app's own overrides/extensions layered on top of the base tokens.\n */\n extraTokensCss?: string[]\n /**\n * Token names (e.g. `--my-app-accent`) to treat as always-defined, suppressing\n * them from the missing list. For app-specific vars defined outside any CSS\n * the checker can see (injected at runtime, from a third-party stylesheet, …).\n */\n allowlist?: string[]\n}\n\n/** Describe a missing theme contract variable and where it was referenced */\nexport interface ThemeContractMiss {\n /** The undefined custom property, e.g. `--popover`. */\n varName: string\n /**\n * Where it was referenced: `path/to/file.tsx`, or\n * `path/to/file.tsx (via bg-surface-container-high)` when the reference is a\n * Tailwind utility that resolves to the token rather than a literal var().\n */\n referencedIn: string\n}\n\n/** Describe the result of validating a theme contract including success status and missing items */\nexport interface ThemeContractResult {\n ok: boolean\n missing: ThemeContractMiss[]\n}\n\n/**\n * Known-dangerous Tailwind utility families and the elevation token each\n * resolves to, mirroring src/theme/tailwind-preset.ts. Ordered longest-suffix\n * first so `surface-container-highest` is matched before `surface-container`.\n * The negative look-around in {@link buildUtilityRe} makes ordering belt-and-\n * suspenders rather than load-bearing.\n */\nconst DANGEROUS_UTILITIES: ReadonlyArray<{ suffix: string; varName: string }> = [\n { suffix: 'surface-container-highest', varName: '--md3-surface-container-highest' },\n { suffix: 'surface-container-high', varName: '--md3-surface-container-high' },\n { suffix: 'surface-container', varName: '--md3-surface-container' },\n { suffix: 'card-foreground', varName: '--card-foreground' },\n { suffix: 'popover-foreground', varName: '--popover-foreground' },\n { suffix: 'card', varName: '--card' },\n { suffix: 'popover', varName: '--popover' },\n]\n\n/** Tailwind color-utility prefixes that can carry a background/text/border color. */\nconst UTILITY_PREFIXES = 'bg|text|border|ring|fill|stroke'\n\n/**\n * Match a whole utility class for `suffix`, tolerant of variants (`hover:`,\n * `dark:`) and opacity (`/95`) but not of longer siblings: the trailing\n * `(?![\\w-])` stops `bg-surface-container` from matching inside\n * `bg-surface-container-high`, and `bg-card` from matching inside\n * `bg-card-foreground`.\n */\nfunction buildUtilityRe(suffix: string): RegExp {\n return new RegExp(`(?<![\\\\w-])(?:${UTILITY_PREFIXES})-${suffix}(?![\\\\w-])`, 'g')\n}\n\n/**\n * Every `--name:` DEFINITION across the given CSS files. A definition is\n * `--name:` at the start of a (trimmed) line; RHS references like\n * `hsl(var(--card))` are mid-line and are never counted as definitions.\n */\nfunction definedVars(cssFiles: string[]): Set<string> {\n const defs = new Set<string>()\n const visited = new Set<string>()\n const visit = (inputFile: string): void => {\n // CLI paths are relative to cwd; createRequire needs an absolute filename.\n const file = resolve(inputFile)\n if (visited.has(file)) return\n visited.add(file)\n let css: string\n try {\n css = readFileSync(file, 'utf8')\n } catch {\n return\n }\n for (const m of css.matchAll(/^\\s*(--[a-z0-9-]+)\\s*:/gim)) if (m[1]) defs.add(m[1])\n // Source tokens.css imports the published Brand sheet and its checked\n // projection. The packed public sheet has already inlined both. Follow\n // local imports here so the source and installed consumer see the same\n // definitions without making Brand a runtime dependency of the package.\n for (const m of css.matchAll(/@import\\s+['\"]([^'\"]+)['\"]/g)) {\n if (!m[1]) continue\n let imported: string\n try {\n imported = m[1].startsWith('.')\n ? resolve(dirname(file), m[1])\n : createRequire(file).resolve(m[1])\n } catch (error) {\n // CSS build tools can resolve packages/exports unavailable to Node\n // (e.g. tailwindcss). Keep scanning local definitions and imports;\n // references to any uncollected tokens still fail the contract.\n const code = (error as NodeJS.ErrnoException).code\n if (code === 'MODULE_NOT_FOUND' || code === 'ERR_PACKAGE_PATH_NOT_EXPORTED') continue\n throw error\n }\n visit(imported)\n }\n }\n for (const file of cssFiles) visit(file)\n return defs\n}\n\n/**\n * Default tokens.css: the one agent-app ships as `./styles`. Resolved relative\n * to this module's URL, but tolerant of where the bundler lands the running\n * code — tsup code-splits shared logic into a chunk at the dist ROOT, so the\n * tokens.css sits one directory DIFFERENTLY depending on layout:\n * - source (src/theme-contract/index.ts) → ../theme/tokens.css (src/theme)\n * - split chunk (dist/contract-*.js) → ./theme/tokens.css (dist/theme)\n * - unsplit entry (dist/theme-contract/index.js) → ../theme/tokens.css\n * Probe both and return the one that exists; fall back to the first for a\n * sensible error path if neither is present.\n */\nfunction defaultTokensCss(): string {\n const candidates = ['../theme/tokens.css', './theme/tokens.css'].map((rel) =>\n fileURLToPath(new URL(rel, import.meta.url)),\n )\n return candidates.find((p) => existsSync(p)) ?? candidates[0]!\n}\n\n/**\n * Check that every theme token a consumer's source references is actually\n * defined in the CSS that consumer ships. Returns the full missing set; the\n * caller decides how to fail (the bin exits non-zero on any miss).\n */\nexport function checkThemeContract(opts: ThemeContractOptions): ThemeContractResult {\n const tokensCss = opts.tokensCss ?? defaultTokensCss()\n const defined = definedVars([tokensCss, ...(opts.extraTokensCss ?? [])])\n const allow = new Set(opts.allowlist ?? [])\n const isDefined = (name: string) => defined.has(name) || allow.has(name)\n\n const files = opts.srcDirs.flatMap((dir) => walkSources(dir, ['.d.ts']))\n const utilityMatchers = DANGEROUS_UTILITIES.map((u) => ({ ...u, re: buildUtilityRe(u.suffix) }))\n\n // Dedupe by varName (literal check) and by varName+utility (utility check),\n // keeping the FIRST referencing file — enough to locate the offender without\n // drowning the report when one token is referenced across many files.\n const seenVar = new Map<string, string>()\n const seenUtility = new Map<string, string>()\n\n for (const file of files) {\n let text: string\n try {\n text = readFileSync(file, 'utf8')\n } catch {\n continue\n }\n const where = displayPath(file)\n\n // Check 1 — literal var(--…) references.\n for (const m of text.matchAll(/var\\(\\s*(--[a-z0-9-]+)/gi)) {\n const name = m[1]\n if (!name || isDefined(name) || seenVar.has(name)) continue\n seenVar.set(name, where)\n }\n\n // Check 2 — known-dangerous Tailwind utility classes.\n for (const u of utilityMatchers) {\n if (isDefined(u.varName)) continue\n const key = `${u.varName}::${u.suffix}`\n if (seenUtility.has(key)) continue\n u.re.lastIndex = 0\n if (u.re.test(text)) seenUtility.set(key, `${where} (via ${firstUtilityHit(text, u.suffix)})`)\n }\n }\n\n const missing: ThemeContractMiss[] = [\n ...[...seenVar].map(([varName, referencedIn]) => ({ varName, referencedIn })),\n ...[...seenUtility].map(([key, referencedIn]) => ({ varName: key.split('::')[0]!, referencedIn })),\n ]\n return { ok: missing.length === 0, missing }\n}\n\n/** The literal utility class (with prefix) first seen in `text` for `suffix`, for the report. */\nfunction firstUtilityHit(text: string, suffix: string): string {\n const m = buildUtilityRe(suffix).exec(text)\n return m?.[0] ?? `<utility>-${suffix}`\n}\n\n/** Path relative to cwd when it stays inside it, else the path as given — for readable reports. */\nfunction displayPath(file: string): string {\n const rel = relative(process.cwd(), file)\n return rel && !rel.startsWith('..') ? rel : file\n}\n"],"mappings":"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","names":[]}
@@ -27,7 +27,7 @@ import {
27
27
  sandboxRunFailureDetail,
28
28
  streamSandboxPrompt,
29
29
  turnStorageBindings
30
- } from "./chunk-HHIEHETJ.js";
30
+ } from "./chunk-GQW4DBFS.js";
31
31
  import {
32
32
  redactErrorMessage
33
33
  } from "./chunk-MH74DY2I.js";
@@ -3936,4 +3936,4 @@ export {
3936
3936
  createChatTurnRoutes,
3937
3937
  streamChatRouteAsSandboxEvents
3938
3938
  };
3939
- //# sourceMappingURL=chunk-IMFJMFHK.js.map
3939
+ //# sourceMappingURL=chunk-LCOKBYAS.js.map
@@ -1,13 +1,13 @@
1
1
  import {
2
2
  createChatTurnRoutes,
3
3
  streamChatRouteAsSandboxEvents
4
- } from "../chunk-IMFJMFHK.js";
4
+ } from "../chunk-LCOKBYAS.js";
5
5
  import "../chunk-CWO2LHXH.js";
6
6
  import "../chunk-H6BRJU5M.js";
7
7
  import "../chunk-4DBHC63F.js";
8
8
  import "../chunk-RN4WPTBH.js";
9
9
  import "../chunk-MM6RLOXF.js";
10
- import "../chunk-HHIEHETJ.js";
10
+ import "../chunk-GQW4DBFS.js";
11
11
  import "../chunk-F4TUZYMX.js";
12
12
  import "../chunk-MH74DY2I.js";
13
13
  import "../chunk-BMCC2BUP.js";
@@ -112,7 +112,7 @@ import {
112
112
  warmKey,
113
113
  warmReceiptId,
114
114
  warmWeekdayOf
115
- } from "../chunk-HHIEHETJ.js";
115
+ } from "../chunk-GQW4DBFS.js";
116
116
  import {
117
117
  createWarmCache
118
118
  } from "../chunk-F4TUZYMX.js";
@@ -39,8 +39,11 @@ import { type Outcome } from './outcome';
39
39
  * @param message the prompt as handed to the stream, so an echo of it is dropped
40
40
  * @param history folded into the dispatched prompt by `streamSandboxPrompt`;
41
41
  * pass whatever was passed there, since the echo replays the FOLDED text
42
+ * @param observe called with each raw event before it is folded
42
43
  */
43
- export declare function collectSandboxPromptText(events: AsyncIterable<unknown>, message: string | PromptInputPart[], history?: StreamSandboxPromptOptions['history']): Promise<string>;
44
+ export declare function collectSandboxPromptText(events: AsyncIterable<unknown>, message: string | PromptInputPart[], history?: StreamSandboxPromptOptions['history'],
45
+ /** Sees every raw event as it arrives, so a product can stream progress without forking the fold. */
46
+ observe?: (event: unknown) => void): Promise<string>;
44
47
  /**
45
48
  * Resolve a sandbox prompt by streaming it and aggregating the turn down to one
46
49
  * final string. The shell's profile / model / MCP resolution and severed-stream
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  checkThemeContract
4
- } from "../chunk-LUKLQDIK.js";
4
+ } from "../chunk-ISNEHOOO.js";
5
5
  import "../chunk-EMLGWEHV.js";
6
6
  import {
7
7
  invokedAsScript
@@ -11,10 +11,9 @@
11
11
  * token in its local tokens.css). CSS resolves the missing var to nothing, the
12
12
  * surface paints transparent, and NOTHING errors. It ships invisible.
13
13
  *
14
- * `tests/theme/tokens-contract.test.ts` guards agent-app's OWN components. This
15
- * module lifts that walking logic into a function every CONSUMER app can run
16
- * against ITS OWN source in CI, comparing references to the tokens.css agent-app
17
- * ships plus any extra CSS the app defines.
14
+ * Consumer apps scan their own source against the tokens.css agent-app ships
15
+ * plus any extra CSS they define. `tests/theme/packed-styles-consumer.mjs`
16
+ * exercises this public API with the packed stylesheet in a browser.
18
17
  *
19
18
  * ── What each check covers (scope is deliberately honest) ────────────────────
20
19
  *
@@ -23,9 +22,7 @@
23
22
  * template strings) is matched and compared against the defined token set.
24
23
  * This is exact: a `var(--x)` reference is unambiguous. It is a raw-text
25
24
  * scan (no AST), so a `var(--x)` written inside a comment or string literal
26
- * counts too — deliberate: it keeps the single-source logic identical to the
27
- * agent-app self-test, and a dangling `var(--x)` in a comment is a smell
28
- * worth surfacing. Suppress a deliberate one with `allowlist`.
25
+ * counts too. Suppress intentional runtime-defined variables with `allowlist`.
29
26
  *
30
27
  * 2. Tailwind-utility check — INTENTIONALLY PARTIAL. Bare classes like
31
28
  * `bg-card` carry no `var(--)` and so are invisible to check 1; Tailwind
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  checkThemeContract
3
- } from "../chunk-LUKLQDIK.js";
3
+ } from "../chunk-ISNEHOOO.js";
4
4
  import "../chunk-EMLGWEHV.js";
5
5
  export {
6
6
  checkThemeContract
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@tangle-network/agent-app",
3
- "version": "0.63.46",
4
- "packageManager": "pnpm@11.24.0",
3
+ "version": "0.63.48",
4
+ "packageManager": "pnpm@11.28.8",
5
5
  "description": "Build agent applications with typed chat, tools, sandboxes, integrations, billing, and evaluation.",
6
6
  "keywords": [
7
7
  "tangle",