@indexnetwork/protocol 4.5.0-rc.337.1 → 4.5.0-rc.339.1

package/dist/shared/interfaces/agent-dispatcher.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-dispatcher.interface.js","sourceRoot":"/","sources":["shared/interfaces/agent-dispatcher.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * AgentDispatcher interface for the negotiation graph.\n *\n * The graph calls dispatch() per turn and receives a result.\n * It never knows about webhooks, MCP, transports, or agent resolution.\n * The concrete implementation lives in the host application.\n */\n\nimport type { NegotiationTurn, UserNegotiationContext, SeedAssessment } from '../schemas/negotiation-state.schema.js';\n\n/** Payload sent to the dispatcher for each negotiation turn. */\nexport interface NegotiationTurnPayload {\n  negotiationId: string;\n  ownUser: UserNegotiationContext;\n  otherUser: UserNegotiationContext;\n  indexContext: { networkId: string; prompt?: string };\n  seedAssessment: SeedAssessment;\n  history: NegotiationTurn[];\n  isFinalTurn: boolean;\n  /** Whether ownUser is the party that initiated the discovery. */\n  isDiscoverer: boolean;\n  /** The explicit search query that triggered this discovery (if any). Takes priority over background intents. */\n  discoveryQuery?: string;\n  /** The acting user's seat under the v2 client-advocate protocol (`initiator` | `counterparty`). */\n  seat?: string;\n  /** Negotiation protocol version for this task (`v1` | `v2`). */\n  protocolVersion?: string;\n  /** Actions the acting seat may submit on this turn (seat + version + final-turn scoped). */\n  allowedActions?: string[];\n}\n\n/** Result of a dispatch attempt. */\nexport type AgentDispatchResult =\n  | { handled: true; turn: NegotiationTurn }\n  | { handled: false; reason: 'no_agent' | 'timeout' }\n  | { handled: false; reason: 'waiting'; resumeToken: string };\n\n/**\n * Dispatches a negotiation turn to the appropriate agent.\n * Tries external (poller) agents first, falls back to system agent.\n */\nexport interface AgentDispatcher {\n  /**\n   * Attempt to dispatch a negotiation turn to an external (poller) agent.\n   * @param userId - The user whose agent should handle this turn\n   * @param scope - Permission scope for agent resolution\n   * @param payload - Turn context (users, history, seed assessment)\n   * @param options - Timeout configuration\n   * @returns Handled result with turn, or unhandled result with reason\n   */\n  dispatch(\n    userId: string,\n    scope: { action: string; scopeType: string; scopeId?: string },\n    payload: NegotiationTurnPayload,\n    options: { timeoutMs: number },\n  ): Promise<AgentDispatchResult>;\n\n  /**\n   * Check whether a user has an authorized external (poller) agent for the given\n   * scope. Used at init to determine scenario-based turn caps. Type-only by design\n   * (no heartbeat freshness) — see IND-410.\n   */\n  hasExternalAgent(\n    userId: string,\n    scope: { action: string; scopeType: string; scopeId?: string },\n  ): Promise<boolean>;\n}\n"]}
+{"version":3,"file":"agent-dispatcher.interface.js","sourceRoot":"/","sources":["shared/interfaces/agent-dispatcher.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * AgentDispatcher interface for the negotiation graph.\n *\n * The graph calls dispatch() per turn and receives a result.\n * It never knows about webhooks, MCP, transports, or agent resolution.\n * The concrete implementation lives in the host application.\n */\n\nimport type { NegotiationTurn, UserNegotiationContext, SeedAssessment } from '../schemas/negotiation-state.schema.js';\nimport type { NegotiatorMemoryEntry } from '../../negotiation/negotiation.memory.js';\n\n/** Payload sent to the dispatcher for each negotiation turn. */\nexport interface NegotiationTurnPayload {\n  negotiationId: string;\n  ownUser: UserNegotiationContext;\n  otherUser: UserNegotiationContext;\n  indexContext: { networkId: string; prompt?: string };\n  seedAssessment: SeedAssessment;\n  history: NegotiationTurn[];\n  isFinalTurn: boolean;\n  /** Whether ownUser is the party that initiated the discovery. */\n  isDiscoverer: boolean;\n  /** The explicit search query that triggered this discovery (if any). Takes priority over background intents. */\n  discoveryQuery?: string;\n  /** The acting user's seat under the v2 client-advocate protocol (`initiator` | `counterparty`). */\n  seat?: string;\n  /** Negotiation protocol version for this task (`v1` | `v2`). */\n  protocolVersion?: string;\n  /** Actions the acting seat may submit on this turn (seat + version + final-turn scoped). */\n  allowedActions?: string[];\n  /**\n   * The acting user's OWN negotiator memories (P5.3 read path) — private\n   * context for the dispatched agent. Never contains the counterparty's\n   * memory; absent when `NEGOTIATOR_MEMORY_INJECT` is off or nothing was\n   * retrieved.\n   */\n  negotiatorMemory?: NegotiatorMemoryEntry[];\n}\n\n/** Result of a dispatch attempt. */\nexport type AgentDispatchResult =\n  | { handled: true; turn: NegotiationTurn }\n  | { handled: false; reason: 'no_agent' | 'timeout' }\n  | { handled: false; reason: 'waiting'; resumeToken: string };\n\n/**\n * Dispatches a negotiation turn to the appropriate agent.\n * Tries external (poller) agents first, falls back to system agent.\n */\nexport interface AgentDispatcher {\n  /**\n   * Attempt to dispatch a negotiation turn to an external (poller) agent.\n   * @param userId - The user whose agent should handle this turn\n   * @param scope - Permission scope for agent resolution\n   * @param payload - Turn context (users, history, seed assessment)\n   * @param options - Timeout configuration\n   * @returns Handled result with turn, or unhandled result with reason\n   */\n  dispatch(\n    userId: string,\n    scope: { action: string; scopeType: string; scopeId?: string },\n    payload: NegotiationTurnPayload,\n    options: { timeoutMs: number },\n  ): Promise<AgentDispatchResult>;\n\n  /**\n   * Check whether a user has an authorized external (poller) agent for the given\n   * scope. Used at init to determine scenario-based turn caps. Type-only by design\n   * (no heartbeat freshness) — see IND-410.\n   */\n  hasExternalAgent(\n    userId: string,\n    scope: { action: string; scopeType: string; scopeId?: string },\n  ): Promise<boolean>;\n}\n"]}

package/dist/shared/interfaces/negotiator-memory.interface.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Host bridge for the negotiator persona's `remember`/`forget` chat tools
+ * (P5.4 / IND-408).
+ *
+ * The negotiator's private memory store lives on the host (API) side; the
+ * protocol package only ever sees this narrow surface. The bridge is
+ * injected by the composition root ONLY into the negotiator persona's
+ * toolset — the orchestrator registry never registers these tools — and
+ * only when the host's memory write flag is on.
+ */
+/** Memory kinds the client can create directly from chat. Deliberately
+ *  excludes `counterparty_dossier`: dossiers are distilled from negotiation
+ *  transcripts, not dictated. */
+export type RememberableMemoryKind = "disclosure_rule" | "playbook" | "threshold";
+export interface NegotiatorMemoryRememberInput {
+    kind: RememberableMemoryKind;
+    /** The rule as one self-contained sentence (what the client actually said). */
+    content: string;
+    /** Chat session the instruction came from (provenance). */
+    sessionId?: string;
+}
+/** A remembered/deleted row, shaped for chat rendering (no embedding, no refs). */
+export interface NegotiatorMemoryToolView {
+    id: string;
+    kind: string;
+    content: string;
+}
+export type NegotiatorMemoryForgetResult = 
+/** Exactly one memory matched and was deleted. */
+{
+    status: "deleted";
+    memory: NegotiatorMemoryToolView;
+}
+/** Several memories matched; the client must pick one (re-call with memoryId). */
+ | {
+    status: "ambiguous";
+    candidates: NegotiatorMemoryToolView[];
+}
+/** Nothing matched the reference/description. */
+ | {
+    status: "not_found";
+};
+export interface NegotiatorMemoryToolsHost {
+    /**
+     * Persist a standing rule the client just stated in chat.
+     * Returns null when memory writes are disabled on the host.
+     */
+    remember(userId: string, input: NegotiatorMemoryRememberInput): Promise<NegotiatorMemoryToolView | null>;
+    /**
+     * Delete a memory by id or by the client's description of it.
+     * Deletion is always honored regardless of the write flag — forgetting is
+     * the client's standing right.
+     */
+    forget(userId: string, input: {
+        memoryId?: string;
+        description?: string;
+    }): Promise<NegotiatorMemoryForgetResult>;
+}
+//# sourceMappingURL=negotiator-memory.interface.d.ts.map

package/dist/shared/interfaces/negotiator-memory.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiator-memory.interface.d.ts","sourceRoot":"/","sources":["shared/interfaces/negotiator-memory.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;iCAEiC;AACjC,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,GAAG,UAAU,GAAG,WAAW,CAAC;AAElF,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,sBAAsB,CAAC;IAC7B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mFAAmF;AACnF,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,4BAA4B;AACtC,kDAAkD;AAChD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE;AACzD,kFAAkF;GAChF;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,wBAAwB,EAAE,CAAA;CAAE;AACjE,iDAAiD;GAC/C;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5B,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAAC;IAC5C;;;;OAIG;IACH,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjD,OAAO,CAAC,4BAA4B,CAAC,CAAC;CAC1C"}

package/dist/shared/interfaces/negotiator-memory.interface.js

@@ -0,0 +1,12 @@
+/**
+ * Host bridge for the negotiator persona's `remember`/`forget` chat tools
+ * (P5.4 / IND-408).
+ *
+ * The negotiator's private memory store lives on the host (API) side; the
+ * protocol package only ever sees this narrow surface. The bridge is
+ * injected by the composition root ONLY into the negotiator persona's
+ * toolset — the orchestrator registry never registers these tools — and
+ * only when the host's memory write flag is on.
+ */
+export {};
+//# sourceMappingURL=negotiator-memory.interface.js.map

package/dist/shared/interfaces/negotiator-memory.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiator-memory.interface.js","sourceRoot":"/","sources":["shared/interfaces/negotiator-memory.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG","sourcesContent":["/**\n * Host bridge for the negotiator persona's `remember`/`forget` chat tools\n * (P5.4 / IND-408).\n *\n * The negotiator's private memory store lives on the host (API) side; the\n * protocol package only ever sees this narrow surface. The bridge is\n * injected by the composition root ONLY into the negotiator persona's\n * toolset — the orchestrator registry never registers these tools — and\n * only when the host's memory write flag is on.\n */\n\n/** Memory kinds the client can create directly from chat. Deliberately\n *  excludes `counterparty_dossier`: dossiers are distilled from negotiation\n *  transcripts, not dictated. */\nexport type RememberableMemoryKind = \"disclosure_rule\" | \"playbook\" | \"threshold\";\n\nexport interface NegotiatorMemoryRememberInput {\n  kind: RememberableMemoryKind;\n  /** The rule as one self-contained sentence (what the client actually said). */\n  content: string;\n  /** Chat session the instruction came from (provenance). */\n  sessionId?: string;\n}\n\n/** A remembered/deleted row, shaped for chat rendering (no embedding, no refs). */\nexport interface NegotiatorMemoryToolView {\n  id: string;\n  kind: string;\n  content: string;\n}\n\nexport type NegotiatorMemoryForgetResult =\n  /** Exactly one memory matched and was deleted. */\n  | { status: \"deleted\"; memory: NegotiatorMemoryToolView }\n  /** Several memories matched; the client must pick one (re-call with memoryId). */\n  | { status: \"ambiguous\"; candidates: NegotiatorMemoryToolView[] }\n  /** Nothing matched the reference/description. */\n  | { status: \"not_found\" };\n\nexport interface NegotiatorMemoryToolsHost {\n  /**\n   * Persist a standing rule the client just stated in chat.\n   * Returns null when memory writes are disabled on the host.\n   */\n  remember(\n    userId: string,\n    input: NegotiatorMemoryRememberInput,\n  ): Promise<NegotiatorMemoryToolView | null>;\n  /**\n   * Delete a memory by id or by the client's description of it.\n   * Deletion is always honored regardless of the write flag — forgetting is\n   * the client's standing right.\n   */\n  forget(\n    userId: string,\n    input: { memoryId?: string; description?: string },\n  ): Promise<NegotiatorMemoryForgetResult>;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "4.5.0-rc.337.1",
+  "version": "4.5.0-rc.339.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",