@owlmeans/viable-common 0.0.43 → 0.0.45

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/build/topology/types.d.ts

@@ -80,4 +80,9 @@ export interface ResolvedTopology extends TopologyDescriptor {
     /** Role → the packages holding it, in topology order. */
     byRole: Partial<Record<SubProject, TargetPackageDescriptor[]>>;
 }
+/** What `.agents/memory/topology.md` carries in its frontmatter. */
+export interface TopologyMeta extends TopologyDescriptor {
+    version: number;
+    updatedAt: string;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/topology/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;;OAOG;IACH,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB;;;;;;;OAOG;IACH,IAAI,EAAE,iBAAiB,CAAA;IACvB,8FAA8F;IAC9F,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,CAAA;IACrB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEpD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,iGAAiG;IACjG,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,uBAAuB,EAAE,CAAA;CACpC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,wDAAwD;IACxD,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAA;CAC/D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/topology/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;;OAOG;IACH,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB;;;;;;;OAOG;IACH,IAAI,EAAE,iBAAiB,CAAA;IACvB,8FAA8F;IAC9F,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,CAAA;IACrB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEpD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,iGAAiG;IACjG,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,uBAAuB,EAAE,CAAA;CACpC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,wDAAwD;IACxD,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAA;CAC/D;AAED,oEAAoE;AACpE,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/viable-common",
-  "version": "0.0.43",
+  "version": "0.0.45",
   "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",
@@ -58,24 +58,24 @@
     }
   },
   "devDependencies": {
-    "@langchain/core": "^1.2.9",
+    "@langchain/core": "^1.2.14",
     "@owlmeans/dep-config": "workspace:*",
-    "ajv": "^8.17.1",
+    "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },
   "dependencies": {
-    "@owlmeans/agent-common": "^0.1.18-rc.45",
-    "@owlmeans/auth": "^0.1.18-rc.38",
-    "@owlmeans/context": "^0.1.18-rc.32",
-    "@owlmeans/entrypoint": "^0.1.18-rc.39",
-    "@owlmeans/error": "^0.1.18-rc.36",
-    "@owlmeans/flow": "^0.1.18-rc.42",
-    "@owlmeans/llm-common": "^0.1.18-rc.37",
-    "@owlmeans/planning": "^0.1.18-rc.17",
-    "@owlmeans/resource": "^0.1.18-rc.37",
-    "@owlmeans/route": "^0.1.18-rc.33"
+    "@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.19",
+    "@owlmeans/resource": "^0.1.18-rc.40",
+    "@owlmeans/route": "^0.1.18-rc.35"
   },
   "publishConfig": {
     "access": "public"

package/src/agent/consts.local.ts

@@ -0,0 +1,47 @@
+import { AgentMarkdownKind, AgentStructuredKind } from './consts.js'
+
+export const documentActions: Record<string, AgentMarkdownKind> = {
+  'write-specification': AgentMarkdownKind.Specification,
+  'summarize-specification': AgentMarkdownKind.Specification,
+  'write-design-concept': AgentMarkdownKind.DesignDocument,
+  'describe-ui-component': AgentMarkdownKind.DesignDocument,
+  'describe-ui-screen': AgentMarkdownKind.DesignDocument,
+  'describe-ui-layout': AgentMarkdownKind.DesignDocument,
+}
+
+export const codeActions = new Set(['code', 'update-code', 'update-code-full'])
+
+/**
+ * The model's schema makes the final output self-describing; while it streams, the helper action
+ * gives the client the same semantic cue before a complete JSON value exists.
+ */
+export const structuredActions: Record<string, AgentStructuredKind> = {
+  'choose-files-for-fix': AgentStructuredKind.ArtifactSelection,
+  'list-files-to-fix': AgentStructuredKind.ArtifactSelection,
+  'extract-user-stories-from-spec': AgentStructuredKind.StoryPlan,
+  'derive-connecting-stories': AgentStructuredKind.StoryPlan,
+  'derive-area-scaffold-stories': AgentStructuredKind.StoryPlan,
+  'describe-ux-story-transitions': AgentStructuredKind.TransitionPlan,
+  'find-entrypoint-for-screen': AgentStructuredKind.EntrypointSelection,
+  'describe-api-access': AgentStructuredKind.AccessPolicy,
+  'describe-screen-access': AgentStructuredKind.AccessPolicy,
+  'plan-scaffold': AgentStructuredKind.ScaffoldPlan,
+  'runtime-gate': AgentStructuredKind.RuntimeDecision,
+  'detect-story-with-home-screen': AgentStructuredKind.CandidateRanking,
+}
+
+/**
+ * Classifies known model output by source AND shape. The `value` comes from a caller's JSON
+ * parser; this runtime-free package intentionally never repairs or parses streamed JSON itself.
+ */
+/**
+ * Actions run by an unconstrained tool-calling loop (the coding agent, the repair/architect/
+ * lookup sub-agents, source extraction) rather than a single pinned-schema call. Their tool calls
+ * are file/shell operations, not model-schema output, so they always render as ToolCalls even
+ * when a call's arguments happen to shape-match a schema kind — `read_sources({ files })` looks
+ * exactly like an ArtifactSelection.
+ */
+export const agentLoopActions = new Set([
+  'coding-agent-ask', 'arbitrary-modification', 'fix-agent', 'architect', 'declaration-lookup',
+  'source-extract',
+])

package/src/agent/consts.ts

@@ -0,0 +1,61 @@
+/**
+ * A compact, runtime-free description of how an agent message should be presented.
+ *
+ * The server emits this with thinking events and the browser refines it as streaming output
+ * becomes parseable. Keeping the vocabulary here prevents the two runtimes from drifting into
+ * their own guesses about the same model response.
+ */
+export enum AgentMessageCategory {
+  Code = 'code',
+  Diff = 'diff',
+  Structured = 'structured',
+  Markdown = 'markdown',
+  Plain = 'plain',
+}
+
+export enum AgentCodeLanguage {
+  ReactTsx = 'react-tsx',
+  Css = 'css',
+  TypeScript = 'typescript',
+  Json = 'json',
+  Other = 'other',
+}
+
+/** A semantic shape that the manager can render as a purpose-built card. */
+export enum AgentStructuredKind {
+  ToolCalls = 'tool-calls',
+  ArtifactSelection = 'artifact-selection',
+  EntitySelection = 'entity-selection',
+  StoryPlan = 'story-plan',
+  ScreenPlan = 'screen-plan',
+  ComponentPlan = 'component-plan',
+  TransitionPlan = 'transition-plan',
+  EntrypointSelection = 'entrypoint-selection',
+  AccessPolicy = 'access-policy',
+  ScaffoldPlan = 'scaffold-plan',
+  RuntimeDecision = 'runtime-decision',
+  CandidateRanking = 'candidate-ranking',
+  Decision = 'decision',
+  GenericRecord = 'generic-record',
+  GenericList = 'generic-list',
+  GenericValue = 'generic-value',
+}
+
+export enum AgentMarkdownKind {
+  Specification = 'specification',
+  DesignDocument = 'design-document',
+  Documentation = 'documentation',
+}
+
+/** The family of specialist that produced an output, not an authorization role. */
+export enum AgentMessageRole {
+  Technical = 'technical',
+  Analytical = 'analytical',
+  Product = 'product',
+  Ux = 'ux',
+  VisualDesign = 'visual-design',
+  Architect = 'architect',
+  Developer = 'developer',
+  Repair = 'repair',
+  Orchestrator = 'orchestrator',
+}

package/src/agent/index.ts

@@ -1,5 +1,7 @@
 
 export type * from './types.js'
+export type * from './presentation/types.js'
 export * from './spectator/index.js'
 export * from './memory.js'
 export * from './presentation.js'
+export * from './consts.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
+}