@indexnetwork/protocol 6.12.0-rc.403.1 → 6.13.22-rc.405.1

package/dist/intent/intent.state.js

@@ -1,191 +1,10 @@
-import { Annotation } from "@langchain/langgraph";
 /**
- * The Graph State using LangGraph Annotations.
- * This acts as the central bus for data flowing through our graph.
+ * @deprecated — canonical location is `signals/domain/intent.state`.
+ * This module is a backward-compatibility re-export retained so existing
+ * imports inside `intent/` continue to resolve without change while the
+ * signals module migration (IND-544) proceeds incrementally.
+ *
+ * Do not add new exports here; add them to `signals/domain/intent.state.ts`
+ * and let them flow through this shim.
  */
-export const IntentGraphState = Annotation.Root({
-    // --- Inputs (Required at start) ---
-    /**
-     * The unique identifier of the user whose intents are being processed.
-     * Required for database operations.
-     */
-    userId: (Annotation),
-    /**
-     * The user's profile context (Identity, Narrative, etc.)
-     */
-    userProfile: (Annotation),
-    /**
-     * Explicit input content (e.g., user message).
-     * Optional - graph might run on implicit only.
-     */
-    inputContent: (Annotation),
-    /**
-     * Conversation history for context-aware intent inference.
-     * Used to resolve anaphoric references ("that intent", "this goal").
-     * Limited to recent messages (typically last 10) for token efficiency.
-     * Optional - if not provided, intent inference uses only inputContent.
-     */
-    conversationContext: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /**
-     * Operation mode controls graph flow and determines which nodes execute.
-     * - 'create': Full pipeline (prep → inference → verification → reconciliation → execution)
-     * - 'update': Skip verification if no new intents (prep → inference → reconciliation → execution)
-     * - 'delete': Skip inference and verification (prep → reconciliation → execution)
-     * - 'read': Fast path (prep → queryNode → END) — reads intents without LLM calls
-     * - 'propose': Inference + verification only, stops before reconciliation (no DB writes)
-     *
-     * Defaults to 'create' for backward compatibility.
-     */
-    operationMode: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => 'create',
-    }),
-    /**
-     * For update/delete operations, specifies which intent IDs to target.
-     * Optional - used when modifying or removing specific intents.
-     */
-    targetIntentIds: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /**
-     * Optional material compare-and-set guard used only by recovery-answer
-     * updates. The database rechecks it while holding the final intent row lock.
-     */
-    expectedIntentFingerprint: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /**
-     * Optional network scope (network ID). Used for linking created intents to a network
-     * and for scoping read operations. Prep always fetches ALL user intents via
-     * getActiveIntents(userId) regardless of network scope (for global dedup/reconciliation).
-     */
-    networkId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** Focused request scope type for write-side assignment and follow-up queues. */
-    scopeType: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** Focused request scope id. When scopeType is `network`, this is the focused network id. */
-    scopeId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    // --- Populated by Graph (Prep Node) ---
-    /**
-     * The formatted string of currently active intents.
-     * Always populated by prep via getActiveIntents(userId).
-     */
-    activeIntents: Annotation({
-        reducer: (curr, next) => next,
-        default: () => "",
-    }),
-    /** IDs of active intents owned by the graph user, used to fail closed on explicit updates. */
-    activeIntentIds: Annotation({
-        reducer: (curr, next) => next,
-        default: () => [],
-    }),
-    // --- Intermediate State ---
-    /**
-     * List of raw intents extracted from text.
-     */
-    inferredIntents: Annotation({
-        reducer: (curr, next) => next, // Overwrite with new inference
-        default: () => [],
-    }),
-    /**
-     * List of intents that have passed semantic verification.
-     * Invalid intents are filtered out before reaching this state.
-     */
-    verifiedIntents: Annotation({
-        reducer: (curr, next) => next,
-        default: () => [],
-    }),
-    /** Structured reasons for candidates rejected before persistence. */
-    validationFailures: Annotation({
-        reducer: (curr, next) => next,
-        default: () => [],
-    }),
-    // --- Output ---
-    /**
-     * Final actions to be performed on the DB (Create, Update, Expire).
-     */
-    actions: Annotation({
-        reducer: (curr, next) => next,
-        default: () => [],
-    }),
-    /**
-     * Results of executing actions against the database.
-     * Populated by executorNode after actions are persisted.
-     */
-    executionResults: Annotation({
-        reducer: (curr, next) => next,
-        default: () => [],
-    }),
-    // --- Error State ---
-    /**
-     * If set, indicates a fatal error that should short-circuit the graph to END.
-     * Populated by prep when a precondition fails (e.g. missing profile).
-     */
-    error: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    // --- Trace Output ---
-    /**
-     * Accumulated trace entries from each graph node.
-     * Used for observability: surfaces internal processing steps (inference,
-     * verification with Felicity scores, reconciliation) to the frontend.
-     */
-    trace: Annotation({
-        reducer: (curr, next) => [...curr, ...(next || [])],
-        default: () => [],
-    }),
-    /** Timing records for each agent invocation within this graph run. */
-    agentTimings: Annotation({
-        reducer: (acc, val) => [...acc, ...val],
-        default: () => [],
-    }),
-    // --- Read Mode Fields ---
-    /**
-     * For read mode: the set of network IDs the caller's agent can reach.
-     * When set and neither networkId nor queryUserId is provided, the graph
-     * returns the caller's own intents across all networks in this set (scope-aware
-     * default path). Derived by the tool layer from the scope envelope plus memberships.
-     */
-    indexScope: Annotation({
-        reducer: (_curr, next) => next,
-        default: () => undefined,
-    }),
-    /**
-     * For read mode: filter intents by a specific user when reading in a network.
-     * When omitted and network-scoped, returns all intents in the network.
-     */
-    queryUserId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /**
-     * For read mode: when true, return all of the current user's intents
-     * ignoring network scope. Used before create_intent to detect duplicates.
-     */
-    allUserIntents: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => false,
-    }),
-    /**
-     * Output of read mode: queried intents with count and optional metadata.
-     */
-    readResult: Annotation({
-        reducer: (curr, next) => next,
-        default: () => undefined,
-    }),
-});
-//# sourceMappingURL=intent.state.js.map
+export { IntentGraphState, } from "../signals/domain/intent.state.js";

package/dist/intent/intent.tools.d.ts

@@ -1,24 +1,6 @@
-import { IntentClarifier } from "./intent.clarifier.js";
-import type { ExecutionResult, IntentValidationFailure } from "./intent.state.js";
-import type { DefineTool, ToolDeps } from "../shared/agent/tool.helpers.js";
-type IntentClarifierLike = Pick<IntentClarifier, "invoke">;
-/** Replace the lazy clarifier in deterministic tool tests. */
-export declare function setIntentClarifierForTesting(clarifier: IntentClarifierLike | null): void;
-type IntentUpdateGraphResult = {
-    executionResults?: ExecutionResult[];
-    validationFailures?: IntentValidationFailure[];
-    trace?: Array<{
-        node: string;
-        detail?: string;
-        data?: Record<string, unknown>;
-    }>;
-};
-/** Convert graph failures into an accurate, machine-readable update-tool error. */
-export declare function describeIntentUpdateFailure(result: IntentUpdateGraphResult): {
-    failureCategory: string;
-    error: string;
-    details?: string;
-};
-export declare function createIntentTools(defineTool: DefineTool, deps: ToolDeps): readonly [any, any, any, any, any, any, any, any];
-export {};
-//# sourceMappingURL=intent.tools.d.ts.map
+/**
+ * @deprecated Canonical location: signals/application/intent.tools (tool factory)
+ * and runtime/foreground/signals/intent.tools (foreground adapter).
+ * Retained for backward compatibility during IND-544 migration.
+ */
+export { createIntentTools, setIntentClarifierForTesting, describeIntentUpdateFailure, } from "../signals/application/intent.tools.js";