@indexnetwork/protocol 22.0.0-rc.499.1 → 64.0.0-rc.604.2

package/dist/shared/interfaces/negotiation-summary.interface.d.ts

@@ -1,25 +0,0 @@
-/**
- * Protocol-side contract for summarizing discovery negotiations into compact
- * digests. The protocol layer only sees this shape; the LLM implementation
- * (NegotiationSummarizer) is injected through dependency wiring.
- *
- * Pattern mirrors ChatSummaryReader: protocol defines the read shape, the
- * backend (or any consumer) provides the implementation.
- */
-import type { DiscoveryNegotiation } from "../schemas/discovery-question.schema.js";
-import type { DiscoveryNegotiationDigest } from "../schemas/negotiation-digest.schema.js";
-export interface NegotiationSummaryReader {
-    /**
-     * Summarize a single negotiation into a compact digest.
-     *
-     * @param negotiation  The raw negotiation to compress.
-     * @param options.signal  Optional AbortSignal. When aborted (deadline reached or
-     *   upstream cancel) the in-flight LLM call is cancelled and `null` is returned —
-     *   callers fall back to a deterministic digest so question generation can
-     *   still proceed.
-     * @returns the digest, or `null` when summarization fails or is aborted.
-     */
-    summarize(negotiation: DiscoveryNegotiation, options?: {
-        signal?: AbortSignal;
-    }): Promise<DiscoveryNegotiationDigest | null>;
-}

package/dist/shared/interfaces/negotiation-summary.interface.js

@@ -1 +0,0 @@
-export {};

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

@@ -1,58 +0,0 @@
-/**
- * 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>;
-}

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

@@ -1,11 +0,0 @@
-/**
- * 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 {};

package/dist/shared/interfaces/queue.interface.d.ts

@@ -1,23 +0,0 @@
-/**
- * Queue types for protocol layer.
- */
-import type { ToolScopeType } from "../agent/tool.scope.js";
-export interface IntentGraphQueueScope {
-    scopeType?: ToolScopeType;
-    scopeId?: string;
-    /** @deprecated networkScopeId is legacy; use `scopeType: 'network'` + `scopeId`. */
-    networkScopeId?: string;
-}
-/**
- * Operations the Intent Graph needs to enqueue follow-up work (e.g. HyDE generation/deletion).
- * Implemented by the intent queue; protocol layer depends only on this interface.
- */
-export interface IntentGraphQueue {
-    addGenerateHydeJob(data: {
-        intentId: string;
-        userId: string;
-    } & IntentGraphQueueScope): Promise<unknown>;
-    addDeleteHydeJob(data: {
-        intentId: string;
-    }): Promise<unknown>;
-}

package/dist/shared/interfaces/queue.interface.js

@@ -1,4 +0,0 @@
-/**
- * Queue types for protocol layer.
- */
-export {};

package/dist/shared/interfaces/scraper.interface.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/interfaces/tool-request-context.interface.d.ts

@@ -1,11 +0,0 @@
-/** Persistable, privacy-bounded request context for asynchronous tool runs. */
-export interface ToolRequestContext {
-    userId: string;
-    userName: string;
-    userEmail: string;
-    scopeType?: "network" | "intent";
-    scopeId?: string;
-    indexName?: string;
-    sessionId?: string;
-    agentId?: string;
-}

package/dist/shared/interfaces/tool-request-context.interface.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/observability/request-context.d.ts

@@ -1,27 +0,0 @@
-import { AsyncLocalStorage } from "async_hooks";
-/**
- * Callback for streaming trace events from deep inside graph nodes back to
- * the caller (typically chat.agent's stream pipeline). Kept as a single emitter
- * to minimize AsyncLocalStorage plumbing.
- */
-export type TraceEmitter = (event: {
-    type: "graph_start" | "graph_end" | "agent_start" | "agent_end";
-    name: string;
-    durationMs?: number;
-    summary?: string;
-} | {
-    type: "status";
-    message: string;
-}) => void;
-interface RequestContext {
-    originUrl?: string;
-    traceEmitter?: TraceEmitter;
-    /** Signal for cooperative cancellation in long-running graph nodes. */
-    abortSignal?: AbortSignal;
-}
-/**
- * AsyncLocalStorage for propagating request-scoped context through the protocol layer.
- * The host application is responsible for calling `requestContext.run()` to set the context.
- */
-export declare const requestContext: AsyncLocalStorage<RequestContext>;
-export {};

package/dist/shared/observability/request-context.js

@@ -1,6 +0,0 @@
-import { AsyncLocalStorage } from "async_hooks";
-/**
- * AsyncLocalStorage for propagating request-scoped context through the protocol layer.
- * The host application is responsible for calling `requestContext.run()` to set the context.
- */
-export const requestContext = new AsyncLocalStorage();

package/dist/shared/schemas/mcp-auth.schema.d.ts

@@ -1,87 +0,0 @@
-import { z } from 'zod';
-/**
- * Transport-neutral auth input extracted at the HTTP boundary.
- */
-export declare const McpAuthInputSchema: z.ZodObject<{
-    bearerToken: z.ZodOptional<z.ZodString>;
-    apiKey: z.ZodOptional<z.ZodString>;
-    telegramHandle: z.ZodOptional<z.ZodString>;
-    telegramUsername: z.ZodOptional<z.ZodString>;
-}, "strict", z.ZodTypeAny, {
-    apiKey?: string | undefined;
-    bearerToken?: string | undefined;
-    telegramHandle?: string | undefined;
-    telegramUsername?: string | undefined;
-}, {
-    apiKey?: string | undefined;
-    bearerToken?: string | undefined;
-    telegramHandle?: string | undefined;
-    telegramUsername?: string | undefined;
-}>;
-export type McpAuthInput = z.infer<typeof McpAuthInputSchema>;
-/**
- * Trusted API-key metadata used by the host auth composition.
- *
- * Enrollment and delivery flags are explicit opt-ins. Unknown metadata is
- * ignored so unrelated Better Auth metadata remains forward-compatible.
- */
-export declare const McpApiKeyMetadataSchema: z.ZodObject<{
-    agentId: z.ZodOptional<z.ZodString>;
-    enrollmentCapable: z.ZodOptional<z.ZodBoolean>;
-    isDeliveryAgent: z.ZodOptional<z.ZodBoolean>;
-}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-    agentId: z.ZodOptional<z.ZodString>;
-    enrollmentCapable: z.ZodOptional<z.ZodBoolean>;
-    isDeliveryAgent: z.ZodOptional<z.ZodBoolean>;
-}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-    agentId: z.ZodOptional<z.ZodString>;
-    enrollmentCapable: z.ZodOptional<z.ZodBoolean>;
-    isDeliveryAgent: z.ZodOptional<z.ZodBoolean>;
-}, z.ZodTypeAny, "passthrough">>;
-export type McpApiKeyMetadata = z.infer<typeof McpApiKeyMetadataSchema>;
-/**
- * Protocol-owned result boundary for host authentication.
- */
-export declare const McpResolvedIdentitySchema: z.ZodEffects<z.ZodObject<{
-    userId: z.ZodString;
-    agentId: z.ZodOptional<z.ZodString>;
-    isSessionAuth: z.ZodOptional<z.ZodBoolean>;
-    enrollmentCapable: z.ZodOptional<z.ZodBoolean>;
-    isDeliveryAgent: z.ZodOptional<z.ZodBoolean>;
-    /** Host-authenticated marker for the dedicated full standalone Hermes audience. */
-    isHermesAgent: z.ZodOptional<z.ZodBoolean>;
-    networkScopeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strict", z.ZodTypeAny, {
-    userId: string;
-    networkScopeId?: string | null | undefined;
-    agentId?: string | undefined;
-    enrollmentCapable?: boolean | undefined;
-    isDeliveryAgent?: boolean | undefined;
-    isSessionAuth?: boolean | undefined;
-    isHermesAgent?: boolean | undefined;
-}, {
-    userId: string;
-    networkScopeId?: string | null | undefined;
-    agentId?: string | undefined;
-    enrollmentCapable?: boolean | undefined;
-    isDeliveryAgent?: boolean | undefined;
-    isSessionAuth?: boolean | undefined;
-    isHermesAgent?: boolean | undefined;
-}>, {
-    userId: string;
-    networkScopeId?: string | null | undefined;
-    agentId?: string | undefined;
-    enrollmentCapable?: boolean | undefined;
-    isDeliveryAgent?: boolean | undefined;
-    isSessionAuth?: boolean | undefined;
-    isHermesAgent?: boolean | undefined;
-}, {
-    userId: string;
-    networkScopeId?: string | null | undefined;
-    agentId?: string | undefined;
-    enrollmentCapable?: boolean | undefined;
-    isDeliveryAgent?: boolean | undefined;
-    isSessionAuth?: boolean | undefined;
-    isHermesAgent?: boolean | undefined;
-}>;
-export type McpResolvedIdentity = z.infer<typeof McpResolvedIdentitySchema>;

package/dist/shared/schemas/mcp-auth.schema.js

@@ -1,56 +0,0 @@
-import { z } from 'zod';
-/**
- * Transport-neutral auth input extracted at the HTTP boundary.
- */
-export const McpAuthInputSchema = z.object({
-    bearerToken: z.string().min(1).optional(),
-    apiKey: z.string().min(1).optional(),
-    telegramHandle: z.string().min(1).optional(),
-    telegramUsername: z.string().min(1).optional(),
-}).strict();
-/**
- * Trusted API-key metadata used by the host auth composition.
- *
- * Enrollment and delivery flags are explicit opt-ins. Unknown metadata is
- * ignored so unrelated Better Auth metadata remains forward-compatible.
- */
-export const McpApiKeyMetadataSchema = z.object({
-    agentId: z.string().min(1).optional(),
-    enrollmentCapable: z.boolean().optional(),
-    isDeliveryAgent: z.boolean().optional(),
-}).passthrough();
-/**
- * Protocol-owned result boundary for host authentication.
- */
-export const McpResolvedIdentitySchema = z.object({
-    userId: z.string().min(1),
-    agentId: z.string().min(1).optional(),
-    isSessionAuth: z.boolean().optional(),
-    enrollmentCapable: z.boolean().optional(),
-    isDeliveryAgent: z.boolean().optional(),
-    /** Host-authenticated marker for the dedicated full standalone Hermes audience. */
-    isHermesAgent: z.boolean().optional(),
-    networkScopeId: z.string().min(1).nullable().optional(),
-}).strict().superRefine((identity, ctx) => {
-    if (identity.isSessionAuth === true && identity.agentId) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ['agentId'],
-            message: 'Session-authenticated identities cannot carry an agent ID.',
-        });
-    }
-    if (identity.isDeliveryAgent === true && !identity.agentId) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ['isDeliveryAgent'],
-            message: 'Delivery-agent designation requires an agent ID.',
-        });
-    }
-    if (identity.isHermesAgent === true && !identity.agentId) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ['isHermesAgent'],
-            message: 'Hermes-agent designation requires an agent ID.',
-        });
-    }
-});

package/dist/shared/schemas/negotiation-digest.schema.d.ts

@@ -1,58 +0,0 @@
-/**
- * NegotiationDigest — compact, fixed-size structured summary of one discovery
- * negotiation. Produced by the negotiation summarizer; consumed by the
- * decision-question generator in place of raw negotiations.
- *
- * Goal: cap the question generator's per-negotiation prompt budget so that a
- * 10-candidate discovery turn produces a ~1.5 KB prompt instead of a 60+ KB
- * blob that stalls upstream LLM providers.
- */
-import { z } from "zod";
-export declare const DiscoveryNegotiationDigestSchema: z.ZodObject<{
-    /** Abstract counterparty descriptor (no PII, no IDs). E.g. "AI infra founder, Berlin". */
-    counterpartyHint: z.ZodEffects<z.ZodString, string, unknown>;
-    /** The network the negotiation ran under (community prompt). */
-    indexContext: z.ZodEffects<z.ZodString, string, unknown>;
-    /** Whether the negotiation produced an opportunity. */
-    outcomeRole: z.ZodEnum<["opportunity", "no-opportunity"]>;
-    /** When `outcomeRole === "no-opportunity"`, why the negotiation didn't yield one. Null otherwise. */
-    outcomeReason: z.ZodNullable<z.ZodEnum<["turn_cap", "timeout", "rejected", "stalled", "screened_out"]>>;
-    /**
-     * One-sentence (≤180 chars) summary of the decisive moment or pattern in
-     * this negotiation. Written for the downstream question generator — should
-     * highlight a fact or tension that could inform a clarifying question.
-     */
-    keyTake: z.ZodEffects<z.ZodString, string, unknown>;
-    /** Suggested roles agreed by both parties. Null when no agreement reached. */
-    suggestedRoles: z.ZodNullable<z.ZodObject<{
-        ownUser: z.ZodEnum<["agent", "patient", "peer"]>;
-        otherUser: z.ZodEnum<["agent", "patient", "peer"]>;
-    }, "strip", z.ZodTypeAny, {
-        ownUser: "agent" | "patient" | "peer";
-        otherUser: "agent" | "patient" | "peer";
-    }, {
-        ownUser: "agent" | "patient" | "peer";
-        otherUser: "agent" | "patient" | "peer";
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    suggestedRoles: {
-        ownUser: "agent" | "patient" | "peer";
-        otherUser: "agent" | "patient" | "peer";
-    } | null;
-    indexContext: string;
-    counterpartyHint: string;
-    outcomeRole: "opportunity" | "no-opportunity";
-    outcomeReason: "timeout" | "stalled" | "rejected" | "turn_cap" | "screened_out" | null;
-    keyTake: string;
-}, {
-    suggestedRoles: {
-        ownUser: "agent" | "patient" | "peer";
-        otherUser: "agent" | "patient" | "peer";
-    } | null;
-    outcomeRole: "opportunity" | "no-opportunity";
-    outcomeReason: "timeout" | "stalled" | "rejected" | "turn_cap" | "screened_out" | null;
-    indexContext?: unknown;
-    counterpartyHint?: unknown;
-    keyTake?: unknown;
-}>;
-export type DiscoveryNegotiationDigest = z.infer<typeof DiscoveryNegotiationDigestSchema>;

package/dist/shared/schemas/negotiation-digest.schema.js

@@ -1,38 +0,0 @@
-/**
- * NegotiationDigest — compact, fixed-size structured summary of one discovery
- * negotiation. Produced by the negotiation summarizer; consumed by the
- * decision-question generator in place of raw negotiations.
- *
- * Goal: cap the question generator's per-negotiation prompt budget so that a
- * 10-candidate discovery turn produces a ~1.5 KB prompt instead of a 60+ KB
- * blob that stalls upstream LLM providers.
- */
-import { z } from "zod";
-// LLMs ignore .max() length constraints often enough that strict validation
-// throws every call and forces a fallback. Slice strings down before validating
-// so JSON schema still advertises the limit but a small overshoot doesn't drop
-// the whole digest.
-const clampedString = (maxLen) => z.preprocess((v) => (typeof v === "string" ? v.slice(0, maxLen) : v), z.string().min(1).max(maxLen));
-export const DiscoveryNegotiationDigestSchema = z.object({
-    /** Abstract counterparty descriptor (no PII, no IDs). E.g. "AI infra founder, Berlin". */
-    counterpartyHint: clampedString(120),
-    /** The network the negotiation ran under (community prompt). */
-    indexContext: clampedString(120),
-    /** Whether the negotiation produced an opportunity. */
-    outcomeRole: z.enum(["opportunity", "no-opportunity"]),
-    /** When `outcomeRole === "no-opportunity"`, why the negotiation didn't yield one. Null otherwise. */
-    outcomeReason: z.enum(["turn_cap", "timeout", "rejected", "stalled", "screened_out"]).nullable(),
-    /**
-     * One-sentence (≤180 chars) summary of the decisive moment or pattern in
-     * this negotiation. Written for the downstream question generator — should
-     * highlight a fact or tension that could inform a clarifying question.
-     */
-    keyTake: clampedString(180),
-    /** Suggested roles agreed by both parties. Null when no agreement reached. */
-    suggestedRoles: z
-        .object({
-        ownUser: z.enum(["agent", "patient", "peer"]),
-        otherUser: z.enum(["agent", "patient", "peer"]),
-    })
-        .nullable(),
-});