@indexnetwork/protocol 17.0.1-rc.480.1 → 19.0.0-rc.482.1

package/CHANGELOG.md

@@ -20,6 +20,71 @@ went 6.7.1 → 8.0.2 with no 7.x in between because the whole 7.x line shipped a
 prereleases between the two promotions. To track every change, read `rc`; to
 pin a supported release, use `latest`.
 
+## 19.0.0 - 2026-08-17
+
+### Removed
+
+- **BREAKING**: Retire ghost users. `softDeleteGhost`, `mergeGhostUser` and
+  `findDuplicateUser` are gone from the database port, along with `isGhost` on
+  every entity, contact payload, member row and opportunity card.
+- **BREAKING**: Remove `shouldEnrichGhostDisplayNameFromParallel` and
+  `isEnrichedNameMeaningful` (and the `enrichment.enricher` module). Both were
+  ghost-only: the first returned `false` for every real account.
+- **BREAKING**: `buildMinimalOpportunityCard` loses its trailing
+  `isCounterpartGhost` parameter and the `isGhost` field on its result. The
+  primary action label was never derived from it — it reads `viewerRole` alone —
+  so labels are unchanged.
+
+### Changed
+
+- The enrichment graph no longer soft-deletes or merges on the ghost paths. A
+  non-human enrichment result still aborts with `"Non-human entity detected"`;
+  it previously also called `softDeleteGhost`, which the host implemented as a
+  no-op for any non-ghost, so behaviour for real accounts is identical.
+- Low-confidence and failed enrichment now always fall through to basic info.
+  That was already the real-account path; only the ghost early-return is gone.
+
+## 18.0.0 - 2026-08-17
+
+### Changed
+
+- **BREAKING**: The `intents` capability now ships as a single class. `Intents`
+  replaces `IntentGraphFactory`, `SemanticVerifier`, `IntentIndexer`,
+  `SignalIntakePackGenerator`, `SignalIntakeOrchestrator`,
+  `normalizeIntentDescription`, and `FALLBACK_WHO_QUESTION`, all of which are
+  no longer exported. Dependencies move from positional constructor arguments
+  to a named `IntentsDeps` bag, and every field is optional — a host that wants
+  only the model-backed helpers can call `new Intents()`.
+
+  | Removed | Replacement |
+  |---|---|
+  | `new IntentGraphFactory(db, embedder, queue, enqueue).createGraph()` | `new Intents({ database, embedder, queue, questionerEnqueue }).createGraph()` |
+  | `new SemanticVerifier().invoke(content, context)` | `new Intents().verifyIntent(content, context)` |
+  | `new IntentIndexer().invoke(...)` / `.evaluate(...)` | `new Intents().indexIntent(...)` |
+  | `new SignalIntakePackGenerator().generate(input)` | `new Intents().generateIntakePack(input)` |
+  | `new SignalIntakeOrchestrator().generateFollowUps(input)` | `new Intents().generateIntakeFollowUps(input)` |
+  | `new SignalIntakeOrchestrator().synthesize(input)` | `new Intents().synthesizeIntake(input)` |
+  | `normalizeIntentDescription(text)` | `Intents.normalizeDescription(text)` |
+  | `FALLBACK_WHO_QUESTION` | `Intents.FALLBACK_INTAKE_QUESTION` |
+
+  Collaborators are constructed on first use rather than in the constructor, so
+  an unused method costs nothing. `new Intents()` no longer touches the model
+  provider at all — code that relied on construction failing without
+  `OPENROUTER_API_KEY` now fails on the first call instead.
+
+- **BREAKING**: `IntentNetworkGraphFactory`'s second argument is now an
+  `Intents` instance (anything with `indexIntent`) rather than an
+  `IntentIndexer`. Pass the same instance used for the intent graph.
+
+- Reorganize `src/intents/` by function rather than by layer, with
+  `intent.module.ts` as the capability barrel in place of `index.ts`. Files are
+  named for what they do and sit flat (`intent.inferrer`, `intent.verifier`,
+  `intent.indexer`, …); only `graph/` and `intake/` — the two multi-file stages
+  — keep a directory. The layout is private; only `Intents` crosses the
+  boundary.
+  `IntentIndexerOutput`, `IntakePack*`, `Intake{Answer,Round}`, `FollowUpPlan*`,
+  `Synthesis*`, `IntentToolDeps`, and `IntentsDeps` remain exported as types.
+
 ## 17.0.1 - 2026-08-17
 
 ### Removed

package/IMPLEMENTATION.md

@@ -20,7 +20,10 @@ and [CHANGELOG.md](./CHANGELOG.md) for release history.
 
 Internal source is domain-first: `signals`, `communities`, `questions`,
 `participant-agents`, `contacts`, and `integrations`; opportunity and negotiation
-place state/contracts in `domain/` and workflows/tools in `application/`.
+place state/contracts in `domain/` and workflows/tools in `application/`. The
+`intents` capability is instead organized by function behind a single exported
+class, `Intents`: files sit flat and named for what they do, with `graph/` and
+`intake/` the two multi-file stages that keep a directory.
 
 
 ## Install
@@ -140,7 +143,6 @@ For direct graph invocation (bypassing the tool layer), a `*GraphFactory` class
 ```typescript
 import {
   ChatGraphFactory,
-  IntentGraphFactory,
   OpportunityGraphFactory,
   EnrichmentGraphFactory,
   PremiseGraphFactory,
@@ -157,10 +159,12 @@ import {
 Each factory takes its typed dependencies in the constructor and exposes a
 `.createGraph()` method that returns a compiled LangGraph ready for `.invoke()`.
 
+The intent lifecycle graph is the exception: it is reached through the `Intents`
+module rather than a factory of its own (see [Intents](#intents) below).
+
 | Factory | Workflow |
 |---|---|
 | `ChatGraphFactory` | ReAct chat loop — LLM calls tools, responds to the user |
-| `IntentGraphFactory` | Clarify, infer, verify felicity, reconcile, and persist intents |
 | `OpportunityGraphFactory` | Background matching: search, evaluate (valency), rank, persist |
 | `EnrichmentGraphFactory` | Enrich users (scrape + embed) and decompose into premises |
 | `PremiseGraphFactory` | Decompose and index a user's premises |
@@ -176,6 +180,45 @@ Each factory takes its typed dependencies in the constructor and exposes a
 
 `ChatGraphFactory.withPersona()` keeps the runtime neutral while selecting an exported persona configuration. `SIGNAL_PERSONA`, `REPORTER_PERSONA`, and `ONBOARDING_PERSONA` each own an exact positive tool allowlist; shared tools added later remain unavailable until reviewed. `ONBOARDING_PERSONA` reuses Signal's proposal-only, live-membership-narrowed `create_intent` contract and otherwise exposes only privacy consent, approved self-context preview/confirmation, guided questions, and validated completion. Hosts must persist the exported persona ID on session creation and treat it as authoritative on follow-ups.
 
+## Intents
+
+Signals are the protocol's base unit, and the whole capability ships as one
+class. `Intents` covers the lifecycle graph, semantic verification, network
+indexing, the guided intake interview, and the agent-facing intent tools.
+
+```typescript
+import { Intents } from "@indexnetwork/protocol";
+
+const intents = new Intents({
+  database,           // IntentGraphDatabase — required only by createGraph()
+  embedder,           // EmbeddingGenerator
+  queue,              // IntentGraphQueue
+  questionerEnqueue,  // QuestionerEnqueueFn
+});
+```
+
+Every dependency is optional, so a host that only wants the model-backed
+helpers can construct `new Intents()` with nothing. Collaborators are built on
+first use, so an unused method costs nothing.
+
+| Method | Purpose |
+|---|---|
+| `createGraph()` | Compile the lifecycle graph — prep, infer, verify, reconcile, execute. Requires `database` |
+| `verifyIntent(content, profileContext)` | Felicity conditions, speech-act classification, semantic entropy, specificity |
+| `indexIntent(intent, indexPrompt, memberPrompt, sourceName?, networkContext?)` | Score one signal against one network; `null` when the model call fails |
+| `generateIntakePack(input)` | The participant's intake brief and round-1 question |
+| `generateIntakeFollowUps(input)` | Plan and write the next follow-up questions |
+| `synthesizeIntake(input)` | Turn answered rounds into a description and card summary |
+| `Intents.createTools(defineTool, deps)` | Register the agent-facing intent tools |
+| `Intents.normalizeDescription(description)` | Normalize a description to its persisted form |
+| `Intents.FALLBACK_INTAKE_QUESTION` | The static round-1 question used when generation is unavailable |
+
+`IntentNetworkGraphFactory` takes an `Intents` instance as its evaluator:
+
+```typescript
+const intentNetworkGraph = new IntentNetworkGraphFactory(database, intents).createGraph();
+```
+
 ## MCP server
 
 The package exports a factory that registers every chat tool over the Model Context Protocol and attaches a canonical `instructions` block (`MCP_INSTRUCTIONS`) that every connecting runtime follows. The factory takes three arguments:

package/STABILITY.md

@@ -18,7 +18,10 @@ change. It is the reference behind the tier annotations in `src/index.ts`.
   `src/index.ts` diff, and that is what triggers the major bump below.
 - Root exports are assembled through named capability facades. Those facades are
   implementation seams, not package subpath entry points: consumers must still
-  import only from `@indexnetwork/protocol`.
+  import only from `@indexnetwork/protocol`. A capability may state that facade
+  as a class rather than a re-export list — `intents` does, via `Intents` in
+  `intents/intent.module.ts` — which makes the whole capability one exported
+  symbol and its internal layout free to change without a contract change.
 
 ## Stability tiers
 
@@ -34,6 +37,7 @@ Covered by SemVer below. Breaking changes require a **major** bump.
 | **Interfaces** | Every `*.interface.ts` port you implement to inject infrastructure (databases, embedder, cache, scraper, queues, integration, agent dispatcher, …). |
 | **Shared schemas** | Zod schemas + inferred types that cross the boundary (questions, identity, network-assignment, chat-context, …). |
 | **Graph factories** | `*GraphFactory` classes (`ChatGraphFactory`, `OpportunityGraphFactory`, `NegotiationGraphFactory`, …). |
+| **Intents** | `Intents` — the whole signal capability as one class (lifecycle graph, verification, network indexing, guided intake, tools) plus `IntentsDeps` and the intake/indexer types. Replaced the six separate intent exports in 18.0.0. |
 | **Agents** | Structured LLM agents (`UserContextGenerator`, `IndexNegotiator`, `OpportunityEvaluator`, …). |
 | **MCP** | `createMcpServer` plus the types needed to call it: `ScopedDepsFactory`, `McpCapabilityPolicyOptions`, `CANONICAL_MCP_CAPABILITY_POLICY_OPTIONS`, `McpAuthorizationObserver`, `McpAuthorizationDenialEvent`. The rest of `mcp.authorization-policy.ts` is package-internal as of 15.0.0. |
 | **Capability tools** | `createEnrichmentTools` only. The other per-capability tool factories became package-internal in 15.0.0 — compose them through `createMcpServer` or `createToolRegistry`. |

package/dist/contacts/application/contact.tools.js

@@ -43,7 +43,6 @@ export function createContactTools(defineTool, deps) {
                         name: c.user.name,
                         email: c.user.email,
                         avatar: c.user.avatar,
-                        isGhost: c.user.isGhost,
                     })),
                 });
             }
@@ -81,7 +80,7 @@ export function createContactTools(defineTool, deps) {
             "Use when the user refers to a contact by partial name or email and you need their userId for another tool " +
             "(e.g. read_user_contexts).\n\n" +
             "**When to use:** Before list_contacts when the network is large — returns only matching contacts, bounded by limit.\n\n" +
-            "**Returns:** Array of matching contacts: userId, name, email, avatar, isGhost.",
+            "**Returns:** Array of matching contacts: userId, name, email, avatar.",
         querySchema: z.object({
             query: z.string().trim().min(1).describe('Free-text query matched against contact name and email (case-insensitive, substring).'),
             limit: z.number().int().positive().max(100).optional().describe('Maximum rows to return. Defaults to 25.'),
@@ -96,7 +95,6 @@ export function createContactTools(defineTool, deps) {
                         name: r.name,
                         email: r.email,
                         avatar: r.avatar,
-                        isGhost: r.isGhost,
                     })),
                 });
             }

package/dist/contacts/domain/contact.types.d.ts

@@ -13,7 +13,6 @@ export interface ContactEntry {
         name: string;
         email: string;
         avatar: string | null;
-        isGhost: boolean;
     };
 }
 /** Flat contact row returned by searchContacts. */
@@ -22,5 +21,4 @@ export interface ContactSearchResult {
     name: string;
     email: string;
     avatar: string | null;
-    isGhost: boolean;
 }

package/dist/contexts/application/index.d.ts

@@ -59,7 +59,6 @@ export { PremiseAnalyzer, type PremiseAnalyzerOutput, } from "../../premises/pre
 export { PremiseIndexer, type PremiseIndexerOutput, } from "../../premises/premise.indexer.js";
 export { EnrichmentGraphFactory, type CompiledPremiseGraph, } from "../../enrichment/enrichment.graph.js";
 export { EnrichmentGenerator, type GeneratedProfile } from "../../enrichment/enrichment.generator.js";
-export { shouldEnrichGhostDisplayNameFromParallel, isEnrichedNameMeaningful, } from "../../enrichment/enrichment.enricher.js";
 export { createEnrichmentTools } from "../../enrichment/enrichment.tools.js";
 export { createPremiseTools } from "../../premises/premise.tools.js";
 export { UserContextGenerator } from "../../contexts/context.generator.js";

package/dist/contexts/application/index.js

@@ -62,7 +62,6 @@ export { PremiseIndexer, } from "../../premises/premise.indexer.js";
 // ── Enrichment graph + service classes ───────────────────────────────────────
 export { EnrichmentGraphFactory, } from "../../enrichment/enrichment.graph.js";
 export { EnrichmentGenerator } from "../../enrichment/enrichment.generator.js";
-export { shouldEnrichGhostDisplayNameFromParallel, isEnrichedNameMeaningful, } from "../../enrichment/enrichment.enricher.js";
 // ── Tool factories (foreground adapters) ──────────────────────────────────────
 // These are foreground adapter entry points consumed by the tool composition root (shared/agent)
 // composition.  They accept compiled graphs and host deps through the tool-dep

package/dist/enrichment/enrichment.graph.js

@@ -1,6 +1,5 @@
 import { StateGraph, START, END } from "@langchain/langgraph";
 import { EnrichmentGraphState } from "./enrichment.state.js";
-import { shouldEnrichGhostDisplayNameFromParallel, isEnrichedNameMeaningful } from "./enrichment.enricher.js";
 import { socialsToEnrichmentRequest } from "../shared/utils/social-label.js";
 import { protocolLogger } from "../shared/observability/protocol.logger.js";
 import { timed } from "../shared/observability/performance.js";
@@ -376,8 +375,7 @@ export async function autoGenerateNode(state, deps) {
             try {
                 const enrichment = await deps.enricher.enrichUserProfile(request);
                 if (enrichment && !enrichment.isHuman) {
-                    logger.info("Enrichment detected non-human entity, soft-deleting ghost", { userId: state.userId });
-                    await deps.database.softDeleteGhost(state.userId);
+                    logger.info("Enrichment detected non-human entity, aborting", { userId: state.userId });
                     return { error: "Non-human entity detected" };
                 }
                 const hasMeaningfulEnrichment = !!enrichment &&
@@ -387,11 +385,6 @@ export async function autoGenerateNode(state, deps) {
                         enrichment.attributes.skills.length > 0 ||
                         enrichment.attributes.interests.length > 0);
                 if (hasMeaningfulEnrichment) {
-                    if (user.isGhost && !isEnrichedNameMeaningful(user.email || '', enrichment.identity.name || '')) {
-                        logger.info("Enrichment has content but no real name for ghost, soft-deleting", { userId: state.userId });
-                        await deps.database.softDeleteGhost(state.userId);
-                        return { error: "No real name found for ghost user" };
-                    }
                     logger.verbose("Chat API enrichment succeeded", {
                         userId: state.userId,
                         skillsCount: enrichment.attributes.skills.length,
@@ -399,11 +392,6 @@ export async function autoGenerateNode(state, deps) {
                     });
                     // Update user record with enriched data
                     const updatePayload = {};
-                    const enrichedName = enrichment.identity.name?.trim();
-                    if (enrichedName &&
-                        shouldEnrichGhostDisplayNameFromParallel({ isGhost: !!user.isGhost, name: user.name ?? '', email: user.email ?? '' }, enrichedName)) {
-                        updatePayload.name = enrichedName;
-                    }
                     if (enrichment.identity.bio?.trim())
                         updatePayload.intro = enrichment.identity.bio.trim();
                     if (enrichment.identity.location?.trim())
@@ -435,19 +423,6 @@ export async function autoGenerateNode(state, deps) {
                     if (Object.keys(updatePayload).length > 0) {
                         await deps.database.updateUser(state.userId, updatePayload);
                     }
-                    // Post-enrichment dedup: check if this ghost matches an existing user
-                    if (user.isGhost) {
-                        const currentSocials = await deps.database.getUserSocials(state.userId);
-                        const duplicate = await deps.database.findDuplicateUser(state.userId, currentSocials);
-                        if (duplicate) {
-                            logger.info("Post-enrichment dedup: merging ghost into existing user", {
-                                ghostId: state.userId,
-                                targetId: duplicate.id,
-                            });
-                            await deps.database.mergeGhostUser(state.userId, duplicate.id);
-                            return { error: `Merged as duplicate of user ${duplicate.id}` };
-                        }
-                    }
                     // Build a text blob from the enrichment result so it flows
                     // through premise decomposition (when available) rather than
                     // bypassing premises via prePopulatedProfile.
@@ -468,19 +443,9 @@ export async function autoGenerateNode(state, deps) {
                         operationsPerformed: { scraped: true },
                     };
                 }
-                if (user.isGhost) {
-                    logger.info("Low-confidence enrichment for ghost, soft-deleting", { userId: state.userId });
-                    await deps.database.softDeleteGhost(state.userId);
-                    return { error: "Enrichment not confident for ghost user" };
-                }
                 logger.warn("Chat API returned low-signal enrichment, falling back to basic info", { userId: state.userId });
             }
             catch (enrichErr) {
-                if (user.isGhost) {
-                    logger.info("Enrichment failed for ghost, soft-deleting", { userId: state.userId });
-                    await deps.database.softDeleteGhost(state.userId);
-                    return { error: "Enrichment failed for ghost user" };
-                }
                 logger.warn("Chat API enrichment failed, falling back to basic info", {
                     userId: state.userId,
                     error: enrichErr instanceof Error ? enrichErr.message : String(enrichErr),

package/dist/index.d.ts

@@ -41,9 +41,9 @@ export { RadarGraphFactory } from "./opportunities/index.js";
 export { HydeGraphFactory } from "./discovery/index.js";
 export { NetworkGraphFactory } from "./networks/index.js";
 export { NetworkMembershipGraphFactory } from "./networks/index.js";
-export { IntentGraphFactory } from "./intents/index.js";
-export { SemanticVerifier } from "./intents/index.js";
 export { IntentNetworkGraphFactory } from "./networks/index.js";
+export { Intents } from "./intents/intent.module.js";
+export type { FollowUpPlan, FollowUpPlanInput, IntakeAnswer, IntakePack, IntakePackInput, IntakePackQuestion, IntakePackQuestionOption, IntakeRound, IntentIndexerOutput, IntentsDeps, IntentToolDeps, SynthesisInput, SynthesisResult, } from "./intents/intent.module.js";
 export { MaintenanceGraphFactory } from "./maintenance/maintenance.graph.js";
 export type { MaintenanceGraphDatabase, MaintenanceGraphCache, MaintenanceGraphQueue } from "./maintenance/maintenance.graph.js";
 export { NegotiationGraphFactory, negotiateCandidates } from "./negotiations/index.js";
@@ -60,13 +60,6 @@ export { ChatInterruptClassifier } from "./agents/index.js";
 export { ChatSummarizer } from "./agents/index.js";
 export { HydeGenerator } from "./discovery/index.js";
 export { SuggestionGenerator } from "./agents/index.js";
-export { IntentIndexer } from "./intents/index.js";
-export type { IntentIndexerOutput } from "./intents/index.js";
-export { SignalIntakePackGenerator } from "./intents/index.js";
-export type { IntakePackQuestion } from "./intents/index.js";
-export { SignalIntakeOrchestrator, FALLBACK_WHO_QUESTION, } from "./intents/index.js";
-export type { IntakeAnswer, IntakeRound, } from "./intents/index.js";
-export { normalizeIntentDescription } from "./intents/index.js";
 export { LensInferrer } from "./discovery/index.js";
 export { NegotiationInsightsGenerator } from "./negotiations/index.js";
 export type { NegotiationDigest } from "./negotiations/index.js";

package/dist/index.js

@@ -37,9 +37,11 @@ export { RadarGraphFactory } from "./opportunities/index.js";
 export { HydeGraphFactory } from "./discovery/index.js";
 export { NetworkGraphFactory } from "./networks/index.js";
 export { NetworkMembershipGraphFactory } from "./networks/index.js";
-export { IntentGraphFactory } from "./intents/index.js";
-export { SemanticVerifier } from "./intents/index.js";
 export { IntentNetworkGraphFactory } from "./networks/index.js";
+// ─── Intents ──────────────────────────────────────────────────────────────────
+// The whole capability behind one class: lifecycle graph, verification,
+// network indexing, guided intake, and the agent-facing tools.
+export { Intents } from "./intents/intent.module.js";
 export { MaintenanceGraphFactory } from "./maintenance/maintenance.graph.js";
 export { NegotiationGraphFactory, negotiateCandidates } from "./negotiations/index.js";
 export { OpportunityGraphFactory } from "./opportunities/index.js";
@@ -54,10 +56,6 @@ export { ChatInterruptClassifier } from "./agents/index.js";
 export { ChatSummarizer } from "./agents/index.js";
 export { HydeGenerator } from "./discovery/index.js";
 export { SuggestionGenerator } from "./agents/index.js";
-export { IntentIndexer } from "./intents/index.js";
-export { SignalIntakePackGenerator } from "./intents/index.js";
-export { SignalIntakeOrchestrator, FALLBACK_WHO_QUESTION, } from "./intents/index.js";
-export { normalizeIntentDescription } from "./intents/index.js";
 export { LensInferrer } from "./discovery/index.js";
 export { NegotiationInsightsGenerator } from "./negotiations/index.js";
 export { IndexNegotiator } from "./negotiations/index.js";

package/dist/intents/{application → graph}/intent.graph.d.ts

@@ -5,9 +5,9 @@
  * state and an explicit {@link IntentGraphDeps}. This file composes the
  * dependency bag and wires the edges — nothing else.
  */
-import { ExplicitIntentInferrer } from "./intent.inferrer.js";
-import { SemanticVerifier } from "./intent.verifier.js";
-import { IntentReconciler } from "./intent.reconciler.js";
+import { ExplicitIntentInferrer } from "../intent.inferrer.js";
+import { SemanticVerifier } from "../intent.verifier.js";
+import { IntentReconciler } from "../intent.reconciler.js";
 import type { IntentGraphDatabase } from "../../shared/interfaces/database.interface.js";
 import type { EmbeddingGenerator } from "../../shared/interfaces/embedder.interface.js";
 import type { IntentGraphQueue } from "../../shared/interfaces/queue.interface.js";
@@ -42,10 +42,10 @@ export declare class IntentGraphFactory {
             confidence: "low" | "medium" | "high";
             description: string;
         }[];
-        verifiedIntents: import("../domain/intent.state.js").VerifiedIntent[];
-        validationFailures: import("../domain/intent.state.js").IntentValidationFailure[];
-        actions: import("./intent.reconciler.js").NormalizedIntentAction[];
-        executionResults: import("../domain/intent.state.js").ExecutionResult[];
+        verifiedIntents: import("./intent.graph.state.js").VerifiedIntent[];
+        validationFailures: import("./intent.graph.state.js").IntentValidationFailure[];
+        actions: import("../intent.reconciler.js").NormalizedIntentAction[];
+        executionResults: import("./intent.graph.state.js").ExecutionResult[];
         error: string | undefined;
         trace: {
             node: string;
@@ -93,10 +93,10 @@ export declare class IntentGraphFactory {
             confidence: "low" | "medium" | "high";
             description: string;
         }[]> | undefined;
-        verifiedIntents?: import("../domain/intent.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").VerifiedIntent[]> | undefined;
-        validationFailures?: import("../domain/intent.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").IntentValidationFailure[]> | undefined;
-        actions?: import("./intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("./intent.reconciler.js").NormalizedIntentAction[]> | undefined;
-        executionResults?: import("../domain/intent.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").ExecutionResult[]> | undefined;
+        verifiedIntents?: import("./intent.graph.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").VerifiedIntent[]> | undefined;
+        validationFailures?: import("./intent.graph.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").IntentValidationFailure[]> | undefined;
+        actions?: import("../intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("../intent.reconciler.js").NormalizedIntentAction[]> | undefined;
+        executionResults?: import("./intent.graph.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").ExecutionResult[]> | undefined;
         error?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         trace?: {
             node: string;
@@ -177,10 +177,10 @@ export declare class IntentGraphFactory {
             confidence: "low" | "medium" | "high";
             description: string;
         }[]>, unknown>;
-        verifiedIntents: import("@langchain/langgraph").BaseChannel<import("../domain/intent.state.js").VerifiedIntent[], import("../domain/intent.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").VerifiedIntent[]>, unknown>;
-        validationFailures: import("@langchain/langgraph").BaseChannel<import("../domain/intent.state.js").IntentValidationFailure[], import("../domain/intent.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").IntentValidationFailure[]>, unknown>;
-        actions: import("@langchain/langgraph").BaseChannel<import("./intent.reconciler.js").NormalizedIntentAction[], import("./intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("./intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
-        executionResults: import("@langchain/langgraph").BaseChannel<import("../domain/intent.state.js").ExecutionResult[], import("../domain/intent.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").ExecutionResult[]>, unknown>;
+        verifiedIntents: import("@langchain/langgraph").BaseChannel<import("./intent.graph.state.js").VerifiedIntent[], import("./intent.graph.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").VerifiedIntent[]>, unknown>;
+        validationFailures: import("@langchain/langgraph").BaseChannel<import("./intent.graph.state.js").IntentValidationFailure[], import("./intent.graph.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").IntentValidationFailure[]>, unknown>;
+        actions: import("@langchain/langgraph").BaseChannel<import("../intent.reconciler.js").NormalizedIntentAction[], import("../intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("../intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
+        executionResults: import("@langchain/langgraph").BaseChannel<import("./intent.graph.state.js").ExecutionResult[], import("./intent.graph.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").ExecutionResult[]>, unknown>;
         error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         trace: import("@langchain/langgraph").BaseChannel<{
             node: string;
@@ -277,10 +277,10 @@ export declare class IntentGraphFactory {
             confidence: "low" | "medium" | "high";
             description: string;
         }[]>, unknown>;
-        verifiedIntents: import("@langchain/langgraph").BaseChannel<import("../domain/intent.state.js").VerifiedIntent[], import("../domain/intent.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").VerifiedIntent[]>, unknown>;
-        validationFailures: import("@langchain/langgraph").BaseChannel<import("../domain/intent.state.js").IntentValidationFailure[], import("../domain/intent.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").IntentValidationFailure[]>, unknown>;
-        actions: import("@langchain/langgraph").BaseChannel<import("./intent.reconciler.js").NormalizedIntentAction[], import("./intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("./intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
-        executionResults: import("@langchain/langgraph").BaseChannel<import("../domain/intent.state.js").ExecutionResult[], import("../domain/intent.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").ExecutionResult[]>, unknown>;
+        verifiedIntents: import("@langchain/langgraph").BaseChannel<import("./intent.graph.state.js").VerifiedIntent[], import("./intent.graph.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").VerifiedIntent[]>, unknown>;
+        validationFailures: import("@langchain/langgraph").BaseChannel<import("./intent.graph.state.js").IntentValidationFailure[], import("./intent.graph.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").IntentValidationFailure[]>, unknown>;
+        actions: import("@langchain/langgraph").BaseChannel<import("../intent.reconciler.js").NormalizedIntentAction[], import("../intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("../intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
+        executionResults: import("@langchain/langgraph").BaseChannel<import("./intent.graph.state.js").ExecutionResult[], import("./intent.graph.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").ExecutionResult[]>, unknown>;
         error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         trace: import("@langchain/langgraph").BaseChannel<{
             node: string;
@@ -411,8 +411,8 @@ export declare class IntentGraphFactory {
             validationFailures?: undefined;
             trace?: undefined;
         } | {
-            verifiedIntents: import("../domain/intent.state.js").VerifiedIntent[];
-            validationFailures: import("../domain/intent.state.js").IntentValidationFailure[];
+            verifiedIntents: import("./intent.graph.state.js").VerifiedIntent[];
+            validationFailures: import("./intent.graph.state.js").IntentValidationFailure[];
             agentTimings: import("../../chat/chat-streaming.types.js").DebugMetaAgent[];
             trace: {
                 node: string;
@@ -471,10 +471,10 @@ export declare class IntentGraphFactory {
                 confidence: "low" | "medium" | "high";
                 description: string;
             }[]>, unknown>;
-            verifiedIntents: import("@langchain/langgraph").BaseChannel<import("../domain/intent.state.js").VerifiedIntent[], import("../domain/intent.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").VerifiedIntent[]>, unknown>;
-            validationFailures: import("@langchain/langgraph").BaseChannel<import("../domain/intent.state.js").IntentValidationFailure[], import("../domain/intent.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").IntentValidationFailure[]>, unknown>;
-            actions: import("@langchain/langgraph").BaseChannel<import("./intent.reconciler.js").NormalizedIntentAction[], import("./intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("./intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
-            executionResults: import("@langchain/langgraph").BaseChannel<import("../domain/intent.state.js").ExecutionResult[], import("../domain/intent.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("../domain/intent.state.js").ExecutionResult[]>, unknown>;
+            verifiedIntents: import("@langchain/langgraph").BaseChannel<import("./intent.graph.state.js").VerifiedIntent[], import("./intent.graph.state.js").VerifiedIntent[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").VerifiedIntent[]>, unknown>;
+            validationFailures: import("@langchain/langgraph").BaseChannel<import("./intent.graph.state.js").IntentValidationFailure[], import("./intent.graph.state.js").IntentValidationFailure[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").IntentValidationFailure[]>, unknown>;
+            actions: import("@langchain/langgraph").BaseChannel<import("../intent.reconciler.js").NormalizedIntentAction[], import("../intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("../intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
+            executionResults: import("@langchain/langgraph").BaseChannel<import("./intent.graph.state.js").ExecutionResult[], import("./intent.graph.state.js").ExecutionResult[] | import("@langchain/langgraph").OverwriteValue<import("./intent.graph.state.js").ExecutionResult[]>, unknown>;
             error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
             trace: import("@langchain/langgraph").BaseChannel<{
                 node: string;
@@ -532,7 +532,7 @@ export declare class IntentGraphFactory {
             } | undefined> | undefined, unknown>;
         }>;
         executor: {
-            executionResults: import("../domain/intent.state.js").ExecutionResult[];
+            executionResults: import("./intent.graph.state.js").ExecutionResult[];
         };
     }, unknown, unknown, []>;
 }

package/dist/intents/{application → graph}/intent.graph.execute.d.ts

@@ -1,7 +1,7 @@
 /**
  * Intent graph, stage 4 and the read fast path.
  */
-import { ExecutionResult } from "../domain/intent.state.js";
+import { ExecutionResult } from "./intent.graph.state.js";
 import { type IntentGraphDeps, type IntentState } from "./intent.graph.shared.js";
 /**
  * Node 4: Executor

package/dist/intents/{application → graph}/intent.graph.execute.js

@@ -1,7 +1,7 @@
 /**
  * Intent graph, stage 4 and the read fast path.
  */
-import { normalizeIntentDescription } from "../domain/intent.proposal.js";
+import { normalizeIntentDescription } from "../intent.proposal.js";
 import { timed } from "../../shared/observability/performance.js";
 import { enforceIntentActionBoundary, generateIntentEmbedding, logger, toSpeechActType } from "./intent.graph.shared.js";
 /**

package/dist/intents/{application → graph}/intent.graph.js

@@ -6,10 +6,10 @@
  * dependency bag and wires the edges — nothing else.
  */
 import { StateGraph, START, END } from "@langchain/langgraph";
-import { ExplicitIntentInferrer } from "./intent.inferrer.js";
-import { SemanticVerifier } from "./intent.verifier.js";
-import { IntentReconciler } from "./intent.reconciler.js";
-import { IntentGraphState } from "../domain/intent.state.js";
+import { ExplicitIntentInferrer } from "../intent.inferrer.js";
+import { SemanticVerifier } from "../intent.verifier.js";
+import { IntentReconciler } from "../intent.reconciler.js";
+import { IntentGraphState } from "./intent.graph.state.js";
 import { logger } from "./intent.graph.shared.js";
 import { inferenceNode, prepNode } from "./intent.graph.infer.js";
 import { reconciliationNode, verificationNode } from "./intent.graph.reconcile.js";

package/dist/intents/{application → graph}/intent.graph.reconcile.d.ts

@@ -1,8 +1,8 @@
 /**
  * Intent graph, stages 2-3: verify inferred signals, then reconcile against what exists.
  */
-import { VerifiedIntent, type IntentValidationFailure } from "../domain/intent.state.js";
-import type { NormalizedIntentAction } from "./intent.reconciler.js";
+import { VerifiedIntent, type IntentValidationFailure } from "./intent.graph.state.js";
+import type { NormalizedIntentAction } from "../intent.reconciler.js";
 import type { DebugMetaAgent } from "../../agents/index.js";
 import { type IntentGraphDeps, type IntentState } from "./intent.graph.shared.js";
 /**

package/dist/intents/{application → graph}/intent.graph.shared.d.ts

@@ -5,11 +5,11 @@
  * top-level functions now, each taking an explicit {@link IntentGraphDeps}.
  * This module owns the bag, the logger, and the pure helpers.
  */
-import { IntentGraphState, VerifiedIntent, type IntentValidationFailure } from "../domain/intent.state.js";
-import { ExplicitIntentInferrer } from "./intent.inferrer.js";
-import { SemanticVerifier } from "./intent.verifier.js";
-import { IntentReconciler } from "./intent.reconciler.js";
-import type { NormalizedIntentAction } from "./intent.reconciler.js";
+import { IntentGraphState, VerifiedIntent, type IntentValidationFailure } from "./intent.graph.state.js";
+import { ExplicitIntentInferrer } from "../intent.inferrer.js";
+import { SemanticVerifier } from "../intent.verifier.js";
+import { IntentReconciler } from "../intent.reconciler.js";
+import type { NormalizedIntentAction } from "../intent.reconciler.js";
 import { IntentGraphDatabase } from "../../shared/interfaces/database.interface.js";
 import type { EmbeddingGenerator } from "../../shared/interfaces/embedder.interface.js";
 import type { IntentGraphQueue } from "../../shared/interfaces/queue.interface.js";

package/dist/intents/{application → graph}/intent.graph.shared.js

@@ -5,7 +5,7 @@
  * top-level functions now, each taking an explicit {@link IntentGraphDeps}.
  * This module owns the bag, the logger, and the pure helpers.
  */
-import { DEFAULT_SPECIFICITY_WARNING } from "../domain/signal.specificity.js";
+import { DEFAULT_SPECIFICITY_WARNING } from "../intent.proposal.js";
 import { getAbortSignalConfig } from "../../shared/agent/model-signal.js";
 import { protocolLogger } from "../../shared/observability/protocol.logger.js";
 export const logger = protocolLogger("IntentGraphFactory");

package/dist/intents/{domain/intent.state.d.ts → graph/intent.graph.state.d.ts}

@@ -1,6 +1,6 @@
 import { BaseMessage } from "@langchain/core/messages";
-import { InferredIntent } from "../application/intent.inferrer.js";
-import { SemanticVerifierOutput } from "../application/intent.verifier.js";
+import { InferredIntent } from "../intent.inferrer.js";
+import { SemanticVerifierOutput } from "../intent.verifier.js";
 import type { DebugMetaAgent } from '../../agents/index.js';
 import type { ToolScopeType } from '../../shared/agent/tool.scope.js';
 /**
@@ -139,7 +139,7 @@ export declare const IntentGraphState: import("@langchain/langgraph").Annotation
     /**
      * Final actions to be performed on the DB (Create, Update, Expire).
      */
-    actions: import("@langchain/langgraph").BaseChannel<import("../application/intent.reconciler.js").NormalizedIntentAction[], import("../application/intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("../application/intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
+    actions: import("@langchain/langgraph").BaseChannel<import("../intent.reconciler.js").NormalizedIntentAction[], import("../intent.reconciler.js").NormalizedIntentAction[] | import("@langchain/langgraph").OverwriteValue<import("../intent.reconciler.js").NormalizedIntentAction[]>, unknown>;
     /**
      * Results of executing actions against the database.
      * Populated by executorNode after actions are persisted.

package/dist/intents/{application/intent.clarifier.js → intent.clarifier.js}

@@ -9,11 +9,11 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 import { HumanMessage, SystemMessage } from "@langchain/core/messages";
 import { z } from "zod";
-import { createStructuredModel } from "../../shared/agent/model.config.js";
-import { invokeWithAbortSignal } from "../../shared/agent/model-signal.js";
-import { protocolLogger } from "../../shared/observability/protocol.logger.js";
-import { Timed } from "../../shared/observability/performance.js";
-import { UnderspecificationTypeSchema } from "../../shared/schemas/underspecification.schema.js";
+import { createStructuredModel } from "../shared/agent/model.config.js";
+import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
+import { protocolLogger } from "../shared/observability/protocol.logger.js";
+import { Timed } from "../shared/observability/performance.js";
+import { UnderspecificationTypeSchema } from "../shared/schemas/underspecification.schema.js";
 const logger = protocolLogger("IntentClarifier");
 const clarificationSchema = z.discriminatedUnion("needsClarification", [
     z.object({

package/dist/intents/{application/intent.indexer.js → intent.indexer.js}

@@ -10,10 +10,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 import { HumanMessage, SystemMessage } from "@langchain/core/messages";
 import { tool } from "@langchain/core/tools";
 import { z } from "zod";
-import { log } from "../../shared/observability/log.js";
-import { Timed } from "../../shared/observability/performance.js";
-import { createStructuredModel } from "../../shared/agent/model.config.js";
-import { invokeWithAbortSignal } from "../../shared/agent/model-signal.js";
+import { log } from "../shared/observability/log.js";
+import { Timed } from "../shared/observability/performance.js";
+import { createStructuredModel } from "../shared/agent/model.config.js";
+import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
 // ──────────────────────────────────────────────────────────────
 // Response schema
 // ──────────────────────────────────────────────────────────────