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

package/dist/intents/intent.indexer.d.ts

@@ -1,82 +0,0 @@
-import { z } from "zod";
-export declare const IntentIndexerOutputSchema: z.ZodObject<{
-    indexScore: z.ZodNumber;
-    memberScore: z.ZodNumber;
-    reasoning: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    reasoning: string;
-    indexScore: number;
-    memberScore: number;
-}, {
-    reasoning: string;
-    indexScore: number;
-    memberScore: number;
-}>;
-/**
- * Output structure for the Intent Indexer agent.
- */
-export type IntentIndexerOutput = z.infer<typeof IntentIndexerOutputSchema>;
-export declare class IntentIndexer {
-    private model;
-    constructor();
-    /**
-     * Converts the structured response into a string for logging or embedding.
-     * Used when the output needs to be serialized (e.g. for traces).
-     */
-    private toString;
-    /**
-     * Main entry point. Evaluates the appropriateness of an intent for a given index and member context.
-     *
-     * @param intent - The intent payload.
-     * @param indexPrompt - The purpose of the index (community).
-     * @param memberPrompt - The member's sharing preferences (optional).
-     * @param sourceName - Optional source name for context (e.g. file, link).
-     * @param networkContext - Optional rendered network context (type, dates, metadata).
-     * @returns Structured output with indexScore, memberScore, and reasoning, or null on error.
-     */
-    invoke(intent: string, indexPrompt: string | null, memberPrompt: string | null, sourceName?: string | null, networkContext?: string | null): Promise<IntentIndexerOutput | null>;
-    /**
-     * Alias for invoke. Evaluates the appropriateness of an intent for a given index and member context.
-     * Kept for compatibility with callers (e.g. Network Graph) that use evaluate().
-     */
-    evaluate(intent: string, indexPrompt: string | null, memberPrompt: string | null, sourceName?: string | null, networkContext?: string | null): Promise<IntentIndexerOutput | null>;
-    /**
-     * Factory method to expose the agent as a LangChain tool.
-     * Useful for composing agents into larger graphs.
-     */
-    static asTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
-        intent: z.ZodString;
-        indexPrompt: z.ZodNullable<z.ZodString>;
-        memberPrompt: z.ZodNullable<z.ZodString>;
-        sourceName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        networkContext: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        intent: string;
-        indexPrompt: string | null;
-        memberPrompt: string | null;
-        sourceName?: string | null | undefined;
-        networkContext?: string | null | undefined;
-    }, {
-        intent: string;
-        indexPrompt: string | null;
-        memberPrompt: string | null;
-        sourceName?: string | null | undefined;
-        networkContext?: string | null | undefined;
-    }>, {
-        intent: string;
-        indexPrompt: string | null;
-        memberPrompt: string | null;
-        sourceName?: string | null | undefined;
-        networkContext?: string | null | undefined;
-    }, {
-        intent: string;
-        indexPrompt: string | null;
-        memberPrompt: string | null;
-        sourceName?: string | null | undefined;
-        networkContext?: string | null | undefined;
-    }, {
-        reasoning: string;
-        indexScore: number;
-        memberScore: number;
-    } | null, unknown, "intent_indexer">;
-}

package/dist/intents/intent.indexer.js

@@ -1,170 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(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";
-// ──────────────────────────────────────────────────────────────
-// Response schema
-// ──────────────────────────────────────────────────────────────
-export const IntentIndexerOutputSchema = z.object({
-    indexScore: z.number().min(0).max(1).describe("Score for index appropriateness (0.0-1.0)"),
-    memberScore: z.number().min(0).max(1).describe("Score for member preference match (0.0-1.0)"),
-    reasoning: z.string().describe("Brief reasoning for the scores"),
-});
-const logger = log.lib.from("IntentIndexer");
-const invokeLog = log.lib.from("IntentIndexer:invoke");
-// ──────────────────────────────────────────────────────────────
-// 1. SYSTEM PROMPT
-// ──────────────────────────────────────────────────────────────
-const systemPrompt = `
-You are an expert Intent Evaluator for a social networking protocol.
-
-TASK:
-Determine if a User Intent is appropriate for a specific Index (community) and matches a Member's sharing preferences.
-
-INPUTS:
-1. Intent: The content/action the user wants to perform.
-2. Network Prompt: The purpose/scope of the target community (Index).
-3. Member Prompt: The specific sharing preferences of the user in that community (optional).
-4. Source: Origin of the intent (file, link, etc.) (optional).
-5. Network Context: Rendered context about the network including type, dates, location, and events (optional).
-
-NETWORK TYPE AWARENESS:
-- When Network Context is provided, use it to inform your scoring.
-- For EVENT networks: consider temporal relevance. An intent about "meeting at the venue" is highly relevant to an upcoming event but irrelevant after it ends. Intents about topics aligned with the event's themes should score higher.
-- For COMMUNITY networks: score based on the network prompt and member preferences as usual.
-- If the network context includes dates and the intent is time-sensitive, factor temporal proximity into the score.
-
-SCORING RUBRIC:
-- 0.9-1.0: Highly appropriate, perfect match.
-- 0.7-0.8: Good match, relevant.
-- 0.5-0.6: Moderate, borderline.
-- 0.3-0.4: Low appropriateness, poor fit.
-- 0.0-0.2: Not appropriate.
-
-OUTPUT RULES:
-- Provide \`indexScore\` based on how well the Intent fits the Network Prompt.
-- Provide \`memberScore\` based on how well the Intent fits the Member Prompt (if provided). If Member Prompt is missing/empty, return 0.0 for memberScore.
-- Provide concise \`reasoning\`.
-`;
-// ──────────────────────────────────────────────────────────────
-// 2. RESPONSE SCHEMA (Zod)
-// ──────────────────────────────────────────────────────────────
-const responseFormat = IntentIndexerOutputSchema;
-// ──────────────────────────────────────────────────────────────
-// 4. CLASS DEFINITION
-// ──────────────────────────────────────────────────────────────
-export class IntentIndexer {
-    constructor() {
-        this.model = createStructuredModel("intentIndexer", responseFormat, {
-            name: "intent_indexer",
-        });
-    }
-    /**
-     * Converts the structured response into a string for logging or embedding.
-     * Used when the output needs to be serialized (e.g. for traces).
-     */
-    toString(output) {
-        return [
-            `indexScore: ${output.indexScore}`,
-            `memberScore: ${output.memberScore}`,
-            `reasoning: ${output.reasoning}`,
-        ].join("\n");
-    }
-    /**
-     * Main entry point. Evaluates the appropriateness of an intent for a given index and member context.
-     *
-     * @param intent - The intent payload.
-     * @param indexPrompt - The purpose of the index (community).
-     * @param memberPrompt - The member's sharing preferences (optional).
-     * @param sourceName - Optional source name for context (e.g. file, link).
-     * @param networkContext - Optional rendered network context (type, dates, metadata).
-     * @returns Structured output with indexScore, memberScore, and reasoning, or null on error.
-     */
-    async invoke(intent, indexPrompt, memberPrompt, sourceName, networkContext) {
-        invokeLog.verbose("Evaluating intent");
-        const contextParts = [];
-        if (sourceName)
-            contextParts.push(`Source: ${sourceName}`);
-        contextParts.push(indexPrompt ? `Index Purpose: ${indexPrompt}` : "Index Purpose: (Not provided)");
-        contextParts.push(memberPrompt ? `Member Preferences: ${memberPrompt}` : "Member Preferences: (Not provided)");
-        if (networkContext)
-            contextParts.push(`Network Context:\n${networkContext}`);
-        const prompt = `
-      # Context
-      ${contextParts.join("\n")}
-
-      # Intent
-      ${intent}
-
-      Evaluate the appropriateness of this intent.
-    `;
-        const messages = [
-            new SystemMessage(systemPrompt),
-            new HumanMessage(prompt),
-        ];
-        try {
-            const result = await invokeWithAbortSignal(this.model, messages);
-            const output = responseFormat.parse(result);
-            invokeLog.verbose("Evaluation complete", {
-                indexScore: output.indexScore,
-                memberScore: output.memberScore,
-            });
-            return output;
-        }
-        catch (error) {
-            logger.error("Error during execution", { error });
-            return null;
-        }
-    }
-    /**
-     * Alias for invoke. Evaluates the appropriateness of an intent for a given index and member context.
-     * Kept for compatibility with callers (e.g. Network Graph) that use evaluate().
-     */
-    async evaluate(intent, indexPrompt, memberPrompt, sourceName, networkContext) {
-        return this.invoke(intent, indexPrompt, memberPrompt, sourceName, networkContext);
-    }
-    /**
-     * Factory method to expose the agent as a LangChain tool.
-     * Useful for composing agents into larger graphs.
-     */
-    static asTool() {
-        return tool(async (args) => {
-            const agent = new IntentIndexer();
-            return await agent.invoke(args.intent, args.indexPrompt, args.memberPrompt, args.sourceName, args.networkContext);
-        }, {
-            name: "intent_indexer",
-            description: "Evaluates whether an intent is appropriate for a specific index (community or event) and matches member sharing preferences.",
-            schema: z.object({
-                intent: z.string().describe("The intent payload to evaluate"),
-                indexPrompt: z.string().nullable().describe("The purpose of the index (community)"),
-                memberPrompt: z.string().nullable().describe("The member's sharing preferences"),
-                sourceName: z.string().nullable().optional().describe("Optional source name for context"),
-                networkContext: z.string().nullable().optional().describe("Optional rendered network context (type, dates, metadata)"),
-            }),
-        });
-    }
-}
-__decorate([
-    Timed(),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, Object, Object, Object, Object]),
-    __metadata("design:returntype", Promise)
-], IntentIndexer.prototype, "invoke", null);
-__decorate([
-    Timed(),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, Object, Object, Object, Object]),
-    __metadata("design:returntype", Promise)
-], IntentIndexer.prototype, "evaluate", null);

package/dist/intents/intent.module.js

@@ -1,103 +0,0 @@
-/**
- * intents — the capability's single public surface.
- *
- * Everything the rest of the package (and every host) may reach lives on the
- * {@link Intents} class. The directories beside this file are private
- * implementation, grouped by what they do rather than by layer:
- *
- *   graph/               the lifecycle graph — prep, infer, verify, reconcile, execute
- *   intake/              the guided first-signal interview
- *   intent.inferrer      an utterance into candidate signals
- *   intent.reconciler    candidate signals into create/update/expire actions
- *   intent.verifier      felicity and entropy verdicts
- *   intent.clarifier     the clarification path when a signal is underspecified
- *   intent.indexer       scoring one signal against one network
- *   intent.proposal      the persisted proposal record and description normalization
- *   intent.tools         the agent-facing tool definitions
- *
- * Only the two multi-file stages keep a directory. Nothing outside `intents/`
- * imports any of it; the layout may change freely as long as this class keeps
- * its shape.
- */
-import { IntentGraphFactory } from "./graph/intent.graph.js";
-import { IntentIndexer } from "./intent.indexer.js";
-import { FALLBACK_WHO_QUESTION, SignalIntakeOrchestrator } from "./intake/intake.orchestrator.js";
-import { SignalIntakePackGenerator } from "./intake/intake.pack.generator.js";
-import { normalizeIntentDescription } from "./intent.proposal.js";
-import { createIntentTools } from "./intent.tools.js";
-import { SemanticVerifier } from "./intent.verifier.js";
-/**
- * The intents capability.
- *
- * One instance is cheap: the model-backed collaborators behind each method are
- * constructed on first use and then reused, so a host can hold a single
- * `Intents` and call only the parts it needs without paying for the rest.
- */
-export class Intents {
-    constructor(deps = {}) {
-        this.deps = deps;
-    }
-    // ── Lifecycle graph ─────────────────────────────────────────────────────────
-    /**
-     * Build the intent lifecycle graph — load, infer, verify, reconcile, execute.
-     *
-     * @throws If the instance was constructed without a `database`.
-     */
-    createGraph() {
-        const { database, embedder, queue, agents } = this.deps;
-        if (!database) {
-            throw new Error("Intents.createGraph() requires a `database` dependency.");
-        }
-        return new IntentGraphFactory(database, embedder, queue, agents).createGraph();
-    }
-    // ── Verification ────────────────────────────────────────────────────────────
-    /**
-     * Verify one utterance against the speaker's profile — felicity conditions,
-     * speech-act classification, semantic entropy, and specificity.
-     *
-     * @param content - The raw utterance.
-     * @param profileContext - The speaker's profile, serialized as JSON.
-     */
-    async verifyIntent(content, profileContext) {
-        this.verifier ?? (this.verifier = new SemanticVerifier());
-        return this.verifier.invoke(content, profileContext);
-    }
-    // ── Indexing ────────────────────────────────────────────────────────────────
-    /**
-     * Score how well one signal fits one network, from the network's purpose and
-     * the member's sharing preferences.
-     *
-     * @returns Scores and reasoning, or `null` when the model call fails.
-     */
-    async indexIntent(intent, indexPrompt, memberPrompt, sourceName, networkContext) {
-        this.indexer ?? (this.indexer = new IntentIndexer());
-        return this.indexer.invoke(intent, indexPrompt, memberPrompt, sourceName, networkContext);
-    }
-    // ── Guided intake ───────────────────────────────────────────────────────────
-    /** Generate a participant's intake brief and round-1 question. */
-    async generateIntakePack(input) {
-        this.packGenerator ?? (this.packGenerator = new SignalIntakePackGenerator());
-        return this.packGenerator.generate(input);
-    }
-    /** Plan and write the next intake follow-up questions. */
-    async generateIntakeFollowUps(input) {
-        this.orchestrator ?? (this.orchestrator = new SignalIntakeOrchestrator());
-        return this.orchestrator.generateFollowUps(input);
-    }
-    /** Turn answered intake rounds into a signal description and card summary. */
-    async synthesizeIntake(input) {
-        this.orchestrator ?? (this.orchestrator = new SignalIntakeOrchestrator());
-        return this.orchestrator.synthesize(input);
-    }
-    /** Normalize a signal description to its persisted form. */
-    static normalizeDescription(description) {
-        return normalizeIntentDescription(description);
-    }
-    /** Register the agent-facing intent tools against a tool definer. */
-    static createTools(defineTool, deps) {
-        return createIntentTools(defineTool, deps);
-    }
-}
-// ── Stateless surface ───────────────────────────────────────────────────────
-/** The static round-1 question used when pack generation is unavailable. */
-Intents.FALLBACK_INTAKE_QUESTION = FALLBACK_WHO_QUESTION;

package/dist/intents/intent.proposal.d.ts

@@ -1,37 +0,0 @@
-/** Default user-facing warning for broad attributive intent proposals. */
-export declare const DEFAULT_SPECIFICITY_WARNING = "This signal is broad and may produce many weak matches. Add a more concrete role, outcome, location, timeframe, domain, or specific need to get better recommendations.";
-/** Verifier output retained verbatim across the host persistence boundary. */
-export interface IntentProposalVerifierOutput {
-    reasoning: string;
-    classification: "COMMISSIVE" | "DIRECTIVE" | "ASSERTIVE" | "EXPRESSIVE" | "DECLARATION" | "UNKNOWN";
-    felicity_scores: {
-        clarity: number;
-        authority: number;
-        sincerity: number;
-    };
-    semantic_entropy: number;
-    referential_anchor: string | null;
-    referential_breadth: "narrow" | "moderate" | "broad";
-    missing_selectional_constraints: Array<"role" | "outcome" | "location" | "timeframe" | "domain" | "concrete_need">;
-    specificity_warning: string | null;
-    flags: string[];
-}
-/** Complete server-authoritative analysis captured for a verified intent proposal. */
-export interface IntentProposalAnalysis {
-    verifierOutput: IntentProposalVerifierOutput;
-    combinedScore: number | null;
-}
-/** One proposal persisted by the host before its display card is emitted. */
-export interface PersistableIntentProposal {
-    proposalId: string;
-    userId: string;
-    description: string;
-    networkId?: string;
-    analysis: IntentProposalAnalysis;
-}
-/** Host persistence boundary for durable, owner-scoped intent proposals. */
-export interface IntentProposalStore {
-    createProposals(proposals: PersistableIntentProposal[]): Promise<void>;
-}
-/** Normalize intent text exactly as the direct graph write path does. */
-export declare function normalizeIntentDescription(description: string): string;

package/dist/intents/intent.proposal.js

@@ -1,14 +0,0 @@
-/** Default user-facing warning for broad attributive intent proposals. */
-export const DEFAULT_SPECIFICITY_WARNING = "This signal is broad and may produce many weak matches. Add a more concrete role, outcome, location, timeframe, domain, or specific need to get better recommendations.";
-/** Normalize intent text exactly as the direct graph write path does. */
-export function normalizeIntentDescription(description) {
-    if (!description || typeof description !== "string")
-        return description;
-    const normalized = description
-        .replace(/\s*More details at\s*:?\s*https?:\/\/[^\s"'<>)\]]+/gi, "")
-        .replace(/\s*See\s+https?:\/\/[^\s"'<>)\]]+\s+for\s+more[^.]*\.?/gi, "")
-        .replace(/https?:\/\/[^\s"'<>)\]]+/g, "")
-        .replace(/\s{2,}/g, " ")
-        .trim();
-    return normalized.replace(/[.,;]\s*$/, "").trim() || description;
-}

package/dist/intents/intent.reconciler.d.ts

@@ -1,105 +0,0 @@
-import { z } from "zod";
-declare const CreateIntentActionSchema: z.ZodObject<{
-    type: z.ZodUnion<[z.ZodLiteral<"create">, z.ZodLiteral<"CREATE">]>;
-    payload: z.ZodString;
-    score: z.ZodNullable<z.ZodNumber>;
-    reasoning: z.ZodNullable<z.ZodString>;
-    intentMode: z.ZodNullable<z.ZodEnum<["REFERENTIAL", "ATTRIBUTIVE"]>>;
-    referentialAnchor: z.ZodNullable<z.ZodString>;
-    semanticEntropy: z.ZodNullable<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    reasoning: string | null;
-    type: "create" | "CREATE";
-    score: number | null;
-    payload: string;
-    semanticEntropy: number | null;
-    referentialAnchor: string | null;
-    intentMode: "REFERENTIAL" | "ATTRIBUTIVE" | null;
-}, {
-    reasoning: string | null;
-    type: "create" | "CREATE";
-    score: number | null;
-    payload: string;
-    semanticEntropy: number | null;
-    referentialAnchor: string | null;
-    intentMode: "REFERENTIAL" | "ATTRIBUTIVE" | null;
-}>;
-declare const UpdateIntentActionSchema: z.ZodObject<{
-    type: z.ZodUnion<[z.ZodLiteral<"update">, z.ZodLiteral<"UPDATE">]>;
-    id: z.ZodString;
-    payload: z.ZodString;
-    score: z.ZodNullable<z.ZodNumber>;
-    reasoning: z.ZodNullable<z.ZodString>;
-    intentMode: z.ZodNullable<z.ZodEnum<["REFERENTIAL", "ATTRIBUTIVE"]>>;
-}, "strip", z.ZodTypeAny, {
-    reasoning: string | null;
-    id: string;
-    type: "update" | "UPDATE";
-    score: number | null;
-    payload: string;
-    intentMode: "REFERENTIAL" | "ATTRIBUTIVE" | null;
-}, {
-    reasoning: string | null;
-    id: string;
-    type: "update" | "UPDATE";
-    score: number | null;
-    payload: string;
-    intentMode: "REFERENTIAL" | "ATTRIBUTIVE" | null;
-}>;
-declare const ExpireIntentActionSchema: z.ZodObject<{
-    type: z.ZodUnion<[z.ZodLiteral<"expire">, z.ZodLiteral<"EXPIRE">]>;
-    id: z.ZodString;
-    reason: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    type: "expire" | "EXPIRE";
-    reason: string;
-}, {
-    id: string;
-    type: "expire" | "EXPIRE";
-    reason: string;
-}>;
-export type NormalizedIntentAction = Omit<z.infer<typeof CreateIntentActionSchema>, "type"> & {
-    type: "create";
-} | Omit<z.infer<typeof UpdateIntentActionSchema>, "type"> & {
-    type: "update";
-} | Omit<z.infer<typeof ExpireIntentActionSchema>, "type"> & {
-    type: "expire";
-};
-export type IntentReconcilerOutput = {
-    actions: NormalizedIntentAction[];
-};
-export declare class IntentReconciler {
-    private model;
-    constructor();
-    /**
-     * Reconciles inferred intents with active intents.
-     * @param inferredIntentsFormatted - Formatted string of inferred intents.
-     * @param activeIntentsContext - Formatted string of active intents.
-     */
-    invoke(inferredIntentsFormatted: string, activeIntentsContext: string): Promise<{
-        actions: NormalizedIntentAction[];
-    }>;
-    /**
-     * Factory method to expose the agent as a LangChain tool.
-     */
-    static asTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
-        inferredIntents: z.ZodString;
-        activeIntents: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        inferredIntents: string;
-        activeIntents: string;
-    }, {
-        inferredIntents: string;
-        activeIntents: string;
-    }>, {
-        inferredIntents: string;
-        activeIntents: string;
-    }, {
-        inferredIntents: string;
-        activeIntents: string;
-    }, {
-        actions: NormalizedIntentAction[];
-    }, unknown, "intent_reconciler">;
-}
-export {};