@owlmeans/viable-common 0.0.44 → 0.0.46

package/build/topology/resolve/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/topology/resolve/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhG,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;OASG;IACH,aAAa,EAAE,CAAC,QAAQ,EAAE,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,CAAA;IACjF,kFAAkF;IAClF,eAAe,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,gBAAgB,CAAA;IACnE,yDAAyD;IACzD,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,kBAAkB,CAAA;IACxD;;;;;;OAMG;IACH,cAAc,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,KAAK,uBAAuB,GAAG,IAAI,CAAA;IAChG,2FAA2F;IAC3F,eAAe,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,KAAK,uBAAuB,EAAE,CAAA;IAC5F,8FAA8F;IAC9F,cAAc,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,KAAK,uBAAuB,GAAG,IAAI,CAAA;IACnH,2EAA2E;IAC3E,UAAU,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,EAAE,uBAAuB,KAAK,MAAM,CAAA;IAClF;;;;;;OAMG;IACH,WAAW,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,EAAE,uBAAuB,KAAK,kBAAkB,CAAA;IAC/F,8FAA8F;IAC9F,YAAY,EAAE,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAA;CACxE"}

package/build/topology/resolve/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/topology/resolve/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/topology/resolve/types.ts"],"names":[],"mappings":""}

package/build/topology/resolve.d.ts

@@ -0,0 +1,4 @@
+import type { TopologyHelper } from './resolve/types.js';
+export declare const createTopologyHelper: () => TopologyHelper;
+export declare const topologyHelper: TopologyHelper;
+//# sourceMappingURL=resolve.d.ts.map

package/build/topology/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/topology/resolve.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD,eAAO,MAAM,oBAAoB,QAAO,cA0GvC,CAAA;AAED,eAAO,MAAM,cAAc,gBAAyB,CAAA"}

package/build/topology/resolve.js

@@ -0,0 +1,89 @@
+import { LAYOUT_TOPOLOGIES, DEFAULT_TOPOLOGY } from './consts.js';
+export const createTopologyHelper = () => {
+    const orderPackages = (packages) => {
+        const known = new Set(packages.map(pkg => pkg.name));
+        const index = new Map(packages.map((pkg, at) => [pkg.name, at]));
+        const pending = new Map(packages.map(pkg => [
+            pkg.name, pkg.dependsOn.filter(dep => known.has(dep) && dep !== pkg.name).length,
+        ]));
+        const dependents = new Map();
+        for (const pkg of packages) {
+            for (const dep of pkg.dependsOn) {
+                if (!known.has(dep) || dep === pkg.name)
+                    continue;
+                dependents.set(dep, [...dependents.get(dep) ?? [], pkg.name]);
+            }
+        }
+        const byName = new Map(packages.map(pkg => [pkg.name, pkg]));
+        const out = [];
+        // Ready packages are taken in DECLARATION order, not in the order they became ready. Both are
+        // correct builds; only one is the same list every time and the same list a person wrote, and
+        // this order is compared against the shipped layout tables by a test.
+        const ready = packages.filter(pkg => pending.get(pkg.name) === 0).map(pkg => pkg.name);
+        const take = () => {
+            if (ready.length === 0)
+                return undefined;
+            let at = 0;
+            for (let i = 1; i < ready.length; i++) {
+                if ((index.get(ready[i]) ?? 0) < (index.get(ready[at]) ?? 0))
+                    at = i;
+            }
+            return ready.splice(at, 1)[0];
+        };
+        for (let name = take(); name != null; name = take()) {
+            const pkg = byName.get(name);
+            if (pkg == null)
+                continue;
+            out.push(pkg);
+            for (const next of dependents.get(name) ?? []) {
+                const left = (pending.get(next) ?? 0) - 1;
+                pending.set(next, left);
+                if (left === 0)
+                    ready.push(next);
+            }
+        }
+        const seen = new Set(out.map(pkg => pkg.name));
+        return [...out, ...packages.filter(pkg => !seen.has(pkg.name))];
+    };
+    const resolveTopology = (topology) => {
+        const ordered = orderPackages(topology.packages);
+        const byRole = {};
+        for (const pkg of ordered) {
+            for (const role of pkg.roles) {
+                byRole[role] = [...byRole[role] ?? [], pkg];
+            }
+        }
+        return {
+            ...topology,
+            packages: ordered,
+            build: ordered.map(pkg => pkg.name),
+            libraries: ordered.filter(pkg => pkg.kind === 'library').map(pkg => pkg.name),
+            byRole,
+        };
+    };
+    const topologyOf = (layout) => LAYOUT_TOPOLOGIES[layout] ?? DEFAULT_TOPOLOGY;
+    const packageForRole = (topology, role) => topology.byRole[role]?.[0] ?? null;
+    const packagesForRole = (topology, role) => topology.byRole[role] ?? [];
+    const packageForArea = (topology, role, area) => {
+        const candidates = packagesForRole(topology, role);
+        return candidates.find(pkg => pkg.areas?.includes(area) === true)
+            ?? candidates.find(pkg => pkg.areas == null)
+            ?? candidates[0]
+            ?? null;
+    };
+    const packageDir = (topology, pkg) => `${topology.dir}/${pkg.name}`;
+    const withPackage = (topology, pkg) => ({
+        ...topology,
+        packages: topology.packages.some(known => known.name === pkg.name)
+            ? topology.packages.map(known => known.name === pkg.name ? pkg : known)
+            : [...topology.packages, pkg],
+    });
+    const sameTopology = (a, b) => JSON.stringify(orderPackages(a.packages)) === JSON.stringify(orderPackages(b.packages))
+        && a.dir === b.dir;
+    return {
+        orderPackages, resolveTopology, topologyOf, packageForRole, packagesForRole, packageForArea, packageDir,
+        withPackage, sameTopology,
+    };
+};
+export const topologyHelper = createTopologyHelper();
+//# sourceMappingURL=resolve.js.map

package/build/topology/resolve.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/viable-common",
-  "version": "0.0.44",
+  "version": "0.0.46",
   "license": "MIT",
   "description": "Runtime-free contracts of the OwlMeans Viable platform — the analysis, design and metadata shapes of a generated project, its target-shape manifest, the slot command vocabulary, the connector protocol and the conversion vocabulary, and the intent-first hand-off from the public site to the platform.",
   "type": "module",
@@ -49,6 +49,13 @@
       "module": "./build/integrity/index.js",
       "types": "./build/integrity/index.d.ts"
     },
+    "./legal": {
+      "import": "./build/legal/index.js",
+      "require": "./build/legal/index.js",
+      "default": "./build/legal/index.js",
+      "module": "./build/legal/index.js",
+      "types": "./build/legal/index.d.ts"
+    },
     "./intent": {
       "import": "./build/intent/index.js",
       "require": "./build/intent/index.js",
@@ -66,16 +73,16 @@
     "typescript": "^7.0.2"
   },
   "dependencies": {
-    "@owlmeans/agent-common": "^0.1.18-rc.47",
-    "@owlmeans/auth": "^0.1.18-rc.39",
-    "@owlmeans/context": "^0.1.18-rc.33",
-    "@owlmeans/entrypoint": "^0.1.18-rc.40",
-    "@owlmeans/error": "^0.1.18-rc.37",
-    "@owlmeans/flow": "^0.1.18-rc.44",
-    "@owlmeans/llm-common": "^0.1.18-rc.38",
-    "@owlmeans/planning": "^0.1.18-rc.18",
-    "@owlmeans/resource": "^0.1.18-rc.39",
-    "@owlmeans/route": "^0.1.18-rc.34"
+    "@owlmeans/agent-common": "^0.1.18-rc.48",
+    "@owlmeans/auth": "^0.1.18-rc.40",
+    "@owlmeans/context": "^0.1.18-rc.34",
+    "@owlmeans/entrypoint": "^0.1.18-rc.41",
+    "@owlmeans/error": "^0.1.18-rc.38",
+    "@owlmeans/flow": "^0.1.18-rc.45",
+    "@owlmeans/llm-common": "^0.1.18-rc.39",
+    "@owlmeans/planning": "^0.1.18-rc.20",
+    "@owlmeans/resource": "^0.1.18-rc.40",
+    "@owlmeans/route": "^0.1.18-rc.35"
   },
   "publishConfig": {
     "access": "public"

package/src/agent/index.ts

@@ -1,5 +1,6 @@
 
 export type * from './types.js'
+export type * from './presentation/types.js'
 export * from './spectator/index.js'
 export * from './memory.js'
 export * from './presentation.js'

package/src/agent/presentation/types.ts

@@ -0,0 +1,21 @@
+import type { AgentCodeLanguage, AgentMessageRole } from '../consts.js'
+import type { AgentMessageClassificationInput, AgentMessagePresentation } from '../types.js'
+
+/** How an agent's thinking event is presented: its specialist family, its language, its card. */
+export interface AgentPresentationHelper {
+  /**
+   * Source extraction is an internal context-reduction pass. Its terminal tool call contains only
+   * line ranges, which are useful to the coder but add no useful information to a person's journal.
+   */
+  isAgentMessageHidden: (input: AgentMessageClassificationInput) => boolean
+  /** Maps the attribution that reached the event boundary to the visual specialist family. */
+  agentMessageRoleOf: (input: AgentMessageClassificationInput) => AgentMessageRole
+  /** Pulls a schema argument out of LangChain's serialised tool-call shape. */
+  agentToolCallArguments: (value: unknown) => unknown
+  /** Finds the language of a unified diff from its destination (or source) file path. */
+  agentDiffLanguageOf: (text: string) => AgentCodeLanguage
+  /** Conservative code detection; prose with one identifier remains plain text. */
+  agentCodeLanguageOf: (text: string) => AgentCodeLanguage
+  isUnifiedDiff: (text: string) => boolean
+  classifyAgentMessage: (input: AgentMessageClassificationInput) => AgentMessagePresentation
+}

package/src/agent/presentation.ts

@@ -3,190 +3,224 @@ import { agentLoopActions, codeActions, documentActions, structuredActions } fro
 import { AgentCodeLanguage, AgentMarkdownKind, AgentMessageCategory, AgentMessageRole, AgentStructuredKind } from './consts.js'
 import type { RecordValue } from './types.local.js'
 import type { AgentMessageClassificationInput, AgentMessagePresentation } from './types.js'
+import type { AgentPresentationHelper } from './presentation/types.js'
+
+export const createAgentPresentationHelper = (): AgentPresentationHelper => {
+  const asRecord = (value: unknown): RecordValue | undefined =>
+    value != null && typeof value === 'object' && !Array.isArray(value)
+      ? value as RecordValue
+      : undefined
+
+  const actionOf = (input: AgentMessageClassificationInput): string => input.action?.toLowerCase() ?? ''
+
+  const sourceOf = (input: AgentMessageClassificationInput): string =>
+    `${input.agent ?? ''} ${input.helper ?? ''}`.toLowerCase()
+
+  const contentOf = (input: AgentMessageClassificationInput): string => input.text?.trim() ?? ''
+
+  /**
+   * Source extraction is an internal context-reduction pass. Its terminal tool call contains only
+   * line ranges, which are useful to the coder but add no useful information to a person's journal.
+   */
+  const isAgentMessageHidden = (input: AgentMessageClassificationInput): boolean =>
+    actionOf(input) === 'source-extract'
+
+  /** Maps the attribution that reached the event boundary to the visual specialist family. */
+  const agentMessageRoleOf = (input: AgentMessageClassificationInput): AgentMessageRole => {
+    const source = sourceOf(input)
+    const action = actionOf(input)
+
+    if (action === 'arbitrary-modification' || source.includes('orchestrator')) return AgentMessageRole.Orchestrator
+    if (source.includes('fix')) return AgentMessageRole.Repair
+    if (source.includes('coder') || source.includes('developer') || codeActions.has(action)) return AgentMessageRole.Developer
+    if (source.includes('visual') || source.includes('ui-helper')) return AgentMessageRole.VisualDesign
+    if (source.includes('ux-')) return AgentMessageRole.Ux
+    if (source.includes('business') || source.includes('ba-') || source.includes('analysis') || source.includes('analyst')) return AgentMessageRole.Analytical
+    if (source.includes('product') || source.includes('naming')) return AgentMessageRole.Product
+    if (source.includes('architect') || source.includes('arch') || source.includes('layout-helper') ||
+      source.includes('api-helper') || source.includes('access-helper') || source.includes('datalayer-helper') ||
+      source.includes('domain') || source.includes('nav-helper') || source.includes('ui-com-helper') ||
+      source.includes('ui-state-helper')) return AgentMessageRole.Architect
+    return AgentMessageRole.Technical
+  }
 
-const asRecord = (value: unknown): RecordValue | undefined =>
-  value != null && typeof value === 'object' && !Array.isArray(value)
-    ? value as RecordValue
-    : undefined
+  /** Pulls a schema argument out of LangChain's serialised tool-call shape. */
+  const agentToolCallArguments = (value: unknown): unknown => {
+    if (!Array.isArray(value) || value.length !== 1) return value
+    const call = asRecord(value[0])
+    return call?.args ?? value
+  }
 
-const actionOf = (input: AgentMessageClassificationInput): string => input.action?.toLowerCase() ?? ''
+  const structuredKindOf = (value: unknown): AgentStructuredKind | undefined => {
+    if (value == null) return undefined
 
-const sourceOf = (input: AgentMessageClassificationInput): string =>
-  `${input.agent ?? ''} ${input.helper ?? ''}`.toLowerCase()
+    const toolArgs = agentToolCallArguments(value)
+    const object = asRecord(toolArgs)
+    if (object == null) {
+      if (Array.isArray(toolArgs)) return AgentStructuredKind.GenericList
+      return undefined
+    }
 
-const contentOf = (input: AgentMessageClassificationInput): string => input.text?.trim() ?? ''
+    // Checked ahead of the single-array shapes below: a scaffold plan carries its own `stories`
+    // array (so the StoryPlan check would otherwise swallow it), and a runtime decision straight
+    // from the MODEL never carries `actor`/`worker` — those are added only once the decision is
+    // persisted onto a StoryDesign — so requiring them here missed every live model call.
+    if ('identity' in object && 'guestHome' in object && 'areas' in object && 'stories' in object) {
+      return AgentStructuredKind.ScaffoldPlan
+    }
+    if (Array.isArray(object.jobs) && Array.isArray(object.agents) && 'kv' in object) {
+      return AgentStructuredKind.RuntimeDecision
+    }
 
-/**
- * Source extraction is an internal context-reduction pass. Its terminal tool call contains only
- * line ranges, which are useful to the coder but add no useful information to a person's journal.
- */
-export const isAgentMessageHidden = (input: AgentMessageClassificationInput): boolean =>
-  actionOf(input) === 'source-extract'
-
-/** Maps the attribution that reached the event boundary to the visual specialist family. */
-export const agentMessageRoleOf = (input: AgentMessageClassificationInput): AgentMessageRole => {
-  const source = sourceOf(input)
-  const action = actionOf(input)
-
-  if (action === 'arbitrary-modification' || source.includes('orchestrator')) return AgentMessageRole.Orchestrator
-  if (source.includes('fix')) return AgentMessageRole.Repair
-  if (source.includes('coder') || source.includes('developer') || codeActions.has(action)) return AgentMessageRole.Developer
-  if (source.includes('visual') || source.includes('ui-helper')) return AgentMessageRole.VisualDesign
-  if (source.includes('ux-')) return AgentMessageRole.Ux
-  if (source.includes('business') || source.includes('ba-') || source.includes('analysis') || source.includes('analyst')) return AgentMessageRole.Analytical
-  if (source.includes('product') || source.includes('naming')) return AgentMessageRole.Product
-  if (source.includes('architect') || source.includes('arch') || source.includes('layout-helper') ||
-    source.includes('api-helper') || source.includes('access-helper') || source.includes('datalayer-helper') ||
-    source.includes('domain') || source.includes('nav-helper') || source.includes('ui-com-helper') ||
-    source.includes('ui-state-helper')) return AgentMessageRole.Architect
-  return AgentMessageRole.Technical
-}
+    if (Array.isArray(object.files)) return AgentStructuredKind.ArtifactSelection
+    if (Array.isArray(object.entities)) return AgentStructuredKind.EntitySelection
+    if (Array.isArray(object.stories)) return AgentStructuredKind.StoryPlan
+    if (Array.isArray(object.screens)) return AgentStructuredKind.ScreenPlan
+    if (Array.isArray(object.components)) return AgentStructuredKind.ComponentPlan
+    if (Array.isArray(object.transitions)) return AgentStructuredKind.TransitionPlan
+    if (Array.isArray(object.entries)) return AgentStructuredKind.EntrypointSelection
+    if (Array.isArray(object.candidates)) return AgentStructuredKind.CandidateRanking
+    if (Object.values(object).some(value => {
+      const entry = asRecord(value)
+      return entry != null && Array.isArray(entry.permissions) && 'level' in entry
+    })) return AgentStructuredKind.AccessPolicy
+    return AgentStructuredKind.GenericRecord
+  }
 
-/** Pulls a schema argument out of LangChain's serialised tool-call shape. */
-export const agentToolCallArguments = (value: unknown): unknown => {
-  if (!Array.isArray(value) || value.length !== 1) return value
-  const call = asRecord(value[0])
-  return call?.args ?? value
-}
+  const decisionAction = (action: string): boolean =>
+    action.startsWith('should-') || action.startsWith('is-') || action.includes('blueprint-case') || action.includes('choose-case')
 
-const structuredKindOf = (value: unknown): AgentStructuredKind | undefined => {
-  if (value == null) return undefined
+  const fileExtensionLanguage = (path: string): AgentCodeLanguage => {
+    const name = path.toLowerCase().split('?')[0]
+    if (/\.(tsx|jsx)$/.test(name)) return AgentCodeLanguage.ReactTsx
+    if (/\.css$/.test(name)) return AgentCodeLanguage.Css
+    if (/\.(ts|mts|cts|js|mjs|cjs)$/.test(name)) return AgentCodeLanguage.TypeScript
+    if (/\.json$/.test(name)) return AgentCodeLanguage.Json
+    return AgentCodeLanguage.Other
+  }
 
-  const toolArgs = agentToolCallArguments(value)
-  const object = asRecord(toolArgs)
-  if (object == null) {
-    if (Array.isArray(toolArgs)) return AgentStructuredKind.GenericList
-    return undefined
+  /** Finds the language of a unified diff from its destination (or source) file path. */
+  const agentDiffLanguageOf = (text: string): AgentCodeLanguage => {
+    const match = text.match(/^\+\+\+\s+(?:b\/)?(.+)$/m) ?? text.match(/^---\s+(?:a\/)?(.+)$/m)
+    return match == null ? AgentCodeLanguage.Other : fileExtensionLanguage(match[1])
   }
 
-  // Checked ahead of the single-array shapes below: a scaffold plan carries its own `stories`
-  // array (so the StoryPlan check would otherwise swallow it), and a runtime decision straight
-  // from the MODEL never carries `actor`/`worker` — those are added only once the decision is
-  // persisted onto a StoryDesign — so requiring them here missed every live model call.
-  if ('identity' in object && 'guestHome' in object && 'areas' in object && 'stories' in object) {
-    return AgentStructuredKind.ScaffoldPlan
+  const fencedLanguageOf = (text: string): AgentCodeLanguage | undefined => {
+    const match = text.match(/^```([\w+-]+)/m)
+    const language = match?.[1]?.toLowerCase()
+    if (language == null) return undefined
+    if (['tsx', 'jsx', 'react'].includes(language)) return AgentCodeLanguage.ReactTsx
+    if (language === 'css') return AgentCodeLanguage.Css
+    if (['ts', 'typescript', 'js', 'javascript'].includes(language)) return AgentCodeLanguage.TypeScript
+    if (language === 'json') return AgentCodeLanguage.Json
+    return AgentCodeLanguage.Other
   }
-  if (Array.isArray(object.jobs) && Array.isArray(object.agents) && 'kv' in object) {
-    return AgentStructuredKind.RuntimeDecision
+
+  /** Conservative code detection; prose with one identifier remains plain text. */
+  const agentCodeLanguageOf = (text: string): AgentCodeLanguage => {
+    const content = text.trim().replace(/^```[\w+-]*\n?|\n?```$/g, '')
+    const fenced = fencedLanguageOf(text)
+    if (fenced != null) return fenced
+    if (content === '') return AgentCodeLanguage.Other
+    try {
+      JSON.parse(content)
+      if (/^[{[]/.test(content)) return AgentCodeLanguage.Json
+    } catch {
+      // The remaining heuristics deliberately require source-like syntax.
+    }
+    if (/<[A-Za-z][\w.:-]*(?:\s[^>]*)?\/>|<[A-Za-z][\w.:-]*(?:\s[^>]*)?>/.test(content) &&
+      /\b(import|export|const|function|return)\b/.test(content)) return AgentCodeLanguage.ReactTsx
+    if (/(^|\n)\s*(?:[.#][\w-]+|[a-z][\w-]*(?:\[[^\]]+\])?)\s*\{[^}]*:[^}]*\}/.test(content)) {
+      return AgentCodeLanguage.Css
+    }
+    if (/\b(import|export|interface|type|const|let|function|class)\b/.test(content) &&
+      /[;{}]|=>/.test(content)) return AgentCodeLanguage.TypeScript
+    return AgentCodeLanguage.Other
   }
 
-  if (Array.isArray(object.files)) return AgentStructuredKind.ArtifactSelection
-  if (Array.isArray(object.entities)) return AgentStructuredKind.EntitySelection
-  if (Array.isArray(object.stories)) return AgentStructuredKind.StoryPlan
-  if (Array.isArray(object.screens)) return AgentStructuredKind.ScreenPlan
-  if (Array.isArray(object.components)) return AgentStructuredKind.ComponentPlan
-  if (Array.isArray(object.transitions)) return AgentStructuredKind.TransitionPlan
-  if (Array.isArray(object.entries)) return AgentStructuredKind.EntrypointSelection
-  if (Array.isArray(object.candidates)) return AgentStructuredKind.CandidateRanking
-  if (Object.values(object).some(value => {
-    const entry = asRecord(value)
-    return entry != null && Array.isArray(entry.permissions) && 'level' in entry
-  })) return AgentStructuredKind.AccessPolicy
-  return AgentStructuredKind.GenericRecord
-}
+  const isUnifiedDiff = (text: string): boolean =>
+    /^---\s+.+\n\+\+\+\s+.+/m.test(text) || (/^@@\s+[-+]/m.test(text) && /^(?:\+|-)[^+-]/m.test(text))
 
-const decisionAction = (action: string): boolean =>
-  action.startsWith('should-') || action.startsWith('is-') || action.includes('blueprint-case') || action.includes('choose-case')
+  const markdownKindOf = (text: string): AgentMarkdownKind | undefined => {
+    if (/^#{1,6}\s+/m.test(text) || /^>\s+/m.test(text) || /^\|.+\|\s*$/m.test(text)) {
+      return AgentMarkdownKind.Documentation
+    }
+    const listItems = text.match(/^\s*(?:[-*+]\s+|\d+[.)]\s+)/gm)?.length ?? 0
+    return listItems >= 2 ? AgentMarkdownKind.Documentation : undefined
+  }
 
-const fileExtensionLanguage = (path: string): AgentCodeLanguage => {
-  const name = path.toLowerCase().split('?')[0]
-  if (/\.(tsx|jsx)$/.test(name)) return AgentCodeLanguage.ReactTsx
-  if (/\.css$/.test(name)) return AgentCodeLanguage.Css
-  if (/\.(ts|mts|cts|js|mjs|cjs)$/.test(name)) return AgentCodeLanguage.TypeScript
-  if (/\.json$/.test(name)) return AgentCodeLanguage.Json
-  return AgentCodeLanguage.Other
-}
+  const isGenericStructure = (kind: AgentStructuredKind | undefined): boolean =>
+    kind == null || kind === AgentStructuredKind.GenericRecord || kind === AgentStructuredKind.GenericList ||
+    kind === AgentStructuredKind.GenericValue
+
+  const classifyAgentMessage = (input: AgentMessageClassificationInput): AgentMessagePresentation => {
+    const role = agentMessageRoleOf(input)
+    const action = actionOf(input)
+    const text = contentOf(input)
+    const structure = structuredKindOf(input.value)
+
+    if (input.outputType === 'tool_calls') {
+      // A single pinned-schema call resolves to its own card; everything else — several calls in
+      // one turn, an unconstrained agent-loop action, or a shape too generic to be informative —
+      // is a tool call, not a schema result.
+      const isMultiCall = Array.isArray(input.value) && input.value.length > 1
+      const isToolCalls = isMultiCall || agentLoopActions.has(action) || isGenericStructure(structure)
+      return {
+        category: AgentMessageCategory.Structured,
+        structure: isToolCalls ? AgentStructuredKind.ToolCalls : structure!,
+        role,
+      }
+    }
+    if (structure != null) return { category: AgentMessageCategory.Structured, structure, role }
+    const actionStructure = structuredActions[action]
+    if (actionStructure != null) return { category: AgentMessageCategory.Structured, structure: actionStructure, role }
+    if (decisionAction(action)) return { category: AgentMessageCategory.Structured, structure: AgentStructuredKind.Decision, role }
+    if (isUnifiedDiff(text) || action === 'update-code') {
+      return { category: AgentMessageCategory.Diff, language: agentDiffLanguageOf(text), role }
+    }
+    if (codeActions.has(action) || fencedLanguageOf(text) != null || agentCodeLanguageOf(text) !== AgentCodeLanguage.Other) {
+      return { category: AgentMessageCategory.Code, language: agentCodeLanguageOf(text), role }
+    }
+    const document = documentActions[action] ?? markdownKindOf(text)
+    if (document != null) return { category: AgentMessageCategory.Markdown, document, role }
+    if (input.value != null) {
+      return {
+        category: AgentMessageCategory.Structured,
+        structure: Array.isArray(input.value) ? AgentStructuredKind.GenericList : AgentStructuredKind.GenericValue,
+        role,
+      }
+    }
+    return { category: AgentMessageCategory.Plain, role }
+  }
 
-/** Finds the language of a unified diff from its destination (or source) file path. */
-export const agentDiffLanguageOf = (text: string): AgentCodeLanguage => {
-  const match = text.match(/^\+\+\+\s+(?:b\/)?(.+)$/m) ?? text.match(/^---\s+(?:a\/)?(.+)$/m)
-  return match == null ? AgentCodeLanguage.Other : fileExtensionLanguage(match[1])
+  return {
+    isAgentMessageHidden, agentMessageRoleOf, agentToolCallArguments, agentDiffLanguageOf, agentCodeLanguageOf,
+    isUnifiedDiff, classifyAgentMessage,
+  }
 }
 
-const fencedLanguageOf = (text: string): AgentCodeLanguage | undefined => {
-  const match = text.match(/^```([\w+-]+)/m)
-  const language = match?.[1]?.toLowerCase()
-  if (language == null) return undefined
-  if (['tsx', 'jsx', 'react'].includes(language)) return AgentCodeLanguage.ReactTsx
-  if (language === 'css') return AgentCodeLanguage.Css
-  if (['ts', 'typescript', 'js', 'javascript'].includes(language)) return AgentCodeLanguage.TypeScript
-  if (language === 'json') return AgentCodeLanguage.Json
-  return AgentCodeLanguage.Other
-}
+export const agentPresentationHelper = createAgentPresentationHelper()
 
-/** Conservative code detection; prose with one identifier remains plain text. */
-export const agentCodeLanguageOf = (text: string): AgentCodeLanguage => {
-  const content = text.trim().replace(/^```[\w+-]*\n?|\n?```$/g, '')
-  const fenced = fencedLanguageOf(text)
-  if (fenced != null) return fenced
-  if (content === '') return AgentCodeLanguage.Other
-  try {
-    JSON.parse(content)
-    if (/^[{[]/.test(content)) return AgentCodeLanguage.Json
-  } catch {
-    // The remaining heuristics deliberately require source-like syntax.
-  }
-  if (/<[A-Za-z][\w.:-]*(?:\s[^>]*)?\/>|<[A-Za-z][\w.:-]*(?:\s[^>]*)?>/.test(content) &&
-    /\b(import|export|const|function|return)\b/.test(content)) return AgentCodeLanguage.ReactTsx
-  if (/(^|\n)\s*(?:[.#][\w-]+|[a-z][\w-]*(?:\[[^\]]+\])?)\s*\{[^}]*:[^}]*\}/.test(content)) {
-    return AgentCodeLanguage.Css
-  }
-  if (/\b(import|export|interface|type|const|let|function|class)\b/.test(content) &&
-    /[;{}]|=>/.test(content)) return AgentCodeLanguage.TypeScript
-  return AgentCodeLanguage.Other
-}
+/** @deprecated compat:factory-refactor — use `agentPresentationHelper.isAgentMessageHidden(…)` */
+export const isAgentMessageHidden = (input: AgentMessageClassificationInput): boolean =>
+  agentPresentationHelper.isAgentMessageHidden(input)
 
-export const isUnifiedDiff = (text: string): boolean =>
-  /^---\s+.+\n\+\+\+\s+.+/m.test(text) || (/^@@\s+[-+]/m.test(text) && /^(?:\+|-)[^+-]/m.test(text))
+/** @deprecated compat:factory-refactor — use `agentPresentationHelper.agentMessageRoleOf(…)` */
+export const agentMessageRoleOf = (input: AgentMessageClassificationInput): AgentMessageRole =>
+  agentPresentationHelper.agentMessageRoleOf(input)
 
-const markdownKindOf = (text: string): AgentMarkdownKind | undefined => {
-  if (/^#{1,6}\s+/m.test(text) || /^>\s+/m.test(text) || /^\|.+\|\s*$/m.test(text)) {
-    return AgentMarkdownKind.Documentation
-  }
-  const listItems = text.match(/^\s*(?:[-*+]\s+|\d+[.)]\s+)/gm)?.length ?? 0
-  return listItems >= 2 ? AgentMarkdownKind.Documentation : undefined
-}
+/** @deprecated compat:factory-refactor — use `agentPresentationHelper.agentToolCallArguments(…)` */
+export const agentToolCallArguments = (value: unknown): unknown => agentPresentationHelper.agentToolCallArguments(value)
 
-const isGenericStructure = (kind: AgentStructuredKind | undefined): boolean =>
-  kind == null || kind === AgentStructuredKind.GenericRecord || kind === AgentStructuredKind.GenericList ||
-  kind === AgentStructuredKind.GenericValue
-
-export const classifyAgentMessage = (input: AgentMessageClassificationInput): AgentMessagePresentation => {
-  const role = agentMessageRoleOf(input)
-  const action = actionOf(input)
-  const text = contentOf(input)
-  const structure = structuredKindOf(input.value)
-
-  if (input.outputType === 'tool_calls') {
-    // A single pinned-schema call resolves to its own card; everything else — several calls in
-    // one turn, an unconstrained agent-loop action, or a shape too generic to be informative —
-    // is a tool call, not a schema result.
-    const isMultiCall = Array.isArray(input.value) && input.value.length > 1
-    const isToolCalls = isMultiCall || agentLoopActions.has(action) || isGenericStructure(structure)
-    return {
-      category: AgentMessageCategory.Structured,
-      structure: isToolCalls ? AgentStructuredKind.ToolCalls : structure!,
-      role,
-    }
-  }
-  if (structure != null) return { category: AgentMessageCategory.Structured, structure, role }
-  const actionStructure = structuredActions[action]
-  if (actionStructure != null) return { category: AgentMessageCategory.Structured, structure: actionStructure, role }
-  if (decisionAction(action)) return { category: AgentMessageCategory.Structured, structure: AgentStructuredKind.Decision, role }
-  if (isUnifiedDiff(text) || action === 'update-code') {
-    return { category: AgentMessageCategory.Diff, language: agentDiffLanguageOf(text), role }
-  }
-  if (codeActions.has(action) || fencedLanguageOf(text) != null || agentCodeLanguageOf(text) !== AgentCodeLanguage.Other) {
-    return { category: AgentMessageCategory.Code, language: agentCodeLanguageOf(text), role }
-  }
-  const document = documentActions[action] ?? markdownKindOf(text)
-  if (document != null) return { category: AgentMessageCategory.Markdown, document, role }
-  if (input.value != null) {
-    return {
-      category: AgentMessageCategory.Structured,
-      structure: Array.isArray(input.value) ? AgentStructuredKind.GenericList : AgentStructuredKind.GenericValue,
-      role,
-    }
-  }
-  return { category: AgentMessageCategory.Plain, role }
-}
+/** @deprecated compat:factory-refactor — use `agentPresentationHelper.agentDiffLanguageOf(…)` */
+export const agentDiffLanguageOf = (text: string): AgentCodeLanguage => agentPresentationHelper.agentDiffLanguageOf(text)
+
+/** @deprecated compat:factory-refactor — use `agentPresentationHelper.agentCodeLanguageOf(…)` */
+export const agentCodeLanguageOf = (text: string): AgentCodeLanguage => agentPresentationHelper.agentCodeLanguageOf(text)
+
+/** @deprecated compat:factory-refactor — use `agentPresentationHelper.isUnifiedDiff(…)` */
+export const isUnifiedDiff = (text: string): boolean => agentPresentationHelper.isUnifiedDiff(text)
+
+/** @deprecated compat:factory-refactor — use `agentPresentationHelper.classifyAgentMessage(…)` */
+export const classifyAgentMessage = (input: AgentMessageClassificationInput): AgentMessagePresentation =>
+  agentPresentationHelper.classifyAgentMessage(input)

package/src/agent/types.local.ts

@@ -1 +1,3 @@
-export type RecordValue = Record<string, unknown>
+export interface RecordValue {
+  [key: string]: unknown
+}

package/src/areas/index.ts

@@ -1,4 +1,5 @@
 export type * from './types.js'
+export type * from './tenancy/types.js'
 
 export * from './consts.js'
 export * from './tenancy.js'