@indexnetwork/protocol 66.0.0-rc.646.1 → 66.0.0-rc.650.1

package/README.md

@@ -31,8 +31,8 @@ flowchart LR
 
     Scope --> CandidateGeneration[Candidate generation]
     CandidateGeneration --> Evaluation[Evaluation]
-    Evaluation -->|plausible but uncertain| Opportunity[Draft or negotiating opportunity]
-    Evaluation -->|clear fit| Opportunity[Draft or pending opportunity]
+    Evaluation -->|plausible but uncertain| Opportunity[Negotiating opportunity]
+    Evaluation -->|clear fit| Opportunity[Pending opportunity]
     Opportunity -->|needs agent clarification| Negotiation[Bounded negotiation]
     Negotiation -->|fit established| Opportunity
     Negotiation -->|human judgment required| Questions[Structured questions]
@@ -238,11 +238,11 @@ Opportunity states are participant-facing as follows:
 
 | State | Participant-facing term | Meaning |
 |---|---|---|
-| **Draft** | Draft | The protocol found a plausible opportunity, but it has not been sent to the other side. |
-| **Sent** | Sent | One side has sent or received the opportunity and a response is pending. |
-| **Connected** | Connected | Required participants accepted and a conversation or introduction may proceed. |
-| **Declined** | Declined | A participant rejected the opportunity. |
-| **Expired** | Expired | The opportunity is no longer actionable. |
+| **negotiating** | Agents talking | The agents are negotiating whether the fit holds. |
+| **pending** | Waiting on you | The agents agreed and the participants decide. A participant who already accepted sees Chat open: the first accept opens the conversation, and the status stays pending until every participant has accepted. |
+| **accepted** | Connected | Every participant accepted. |
+| **rejected** | Passed | An agent declined or a participant rejected the opportunity. |
+| **expired** | Expired | An intent was archived. |
 
 A conforming agent MUST NOT present a received opportunity as **Connected** without explicit approval from the receiving participant. The reference implementation enforces actor authorization and valid source statuses for acceptance, while current-approval capture is handled by the agent or user-interface flow invoking the transition.
 
@@ -250,33 +250,26 @@ A conforming agent MUST NOT present a received opportunity as **Connected** with
 
 ```mermaid
 stateDiagram-v2
-    [*] --> Draft: candidate promoted
-    Draft --> Sent: sender approves send
-    Draft --> Connected: direct acceptance or connection link
-    Draft --> Declined: sender declines
-    Draft --> Expired: TTL or invalidated
-
-    Sent --> Connected: recipient explicitly accepts
-    Sent --> Declined: recipient declines
-    Sent --> Expired: TTL or invalidated
-
-    Connected --> [*]
-    Declined --> [*]
-    Expired --> [*]
-
-    note right of Draft
-      Plausible but not sent.
-      Only visible under role and scope rules.
+    [*] --> negotiating: agent opens it
+    negotiating --> pending: agents agree
+    negotiating --> rejected: agent declines
+    negotiating --> expired: intent archived
+
+    pending --> accepted: every participant accepts
+    pending --> rejected: participant rejects
+    pending --> expired: intent archived
+
+    accepted --> [*]
+    rejected --> [*]
+    expired --> [*]
+
+    note right of pending
+      Waiting on the participants.
+      The first accept opens the chat.
     end note
 
-    note right of Sent
-      One side is waiting.
-      Acceptance requires participant approval.
-    end note
-
-    note right of Connected
-      Relationship boundary crossed.
-      Conversation or introduction may proceed.
+    note right of accepted
+      Every participant accepted.
     end note
 ```
 
@@ -300,11 +293,11 @@ sequenceDiagram
     PR->>PR: Generate candidates inside scope
     PR->>PR: Evaluate role fit and constraints
     alt Fit is clear
-        PR-->>A: Draft opportunity with explanation
+        PR-->>A: Pending opportunity with explanation
     else Fit is uncertain
         PR->>N: Start bounded negotiation
         N-->>PR: Propose, counter, accept, reject, or question
-        PR-->>A: Draft opportunity or structured question
+        PR-->>A: Pending opportunity or structured question
     end
     A->>P: Explain strongest reason and ask for approval
     P-->>A: Approve, decline, or refine intent

package/dist/internal/intents/intent.preparer.d.ts

@@ -49,4 +49,5 @@ export declare class IntentPreparer {
      * @throws When rewriting, verification, or recovery generation fails; callers must retain the input for retry.
      */
     invoke(input: PrepareInput, profileContext?: string): Promise<PrepareResult>;
+    private recoveryForm;
 }

package/dist/internal/intents/intent.preparer.js

@@ -58,30 +58,21 @@ export class IntentPreparer {
             ]);
             payload = payloadSchema.parse(result).payload;
         }
+        // The form starts with verification: it only needs the draft, so a failed draft doesn't wait for it twice.
+        const recovery = this.recoveryForm(payload, answers);
+        recovery.catch(() => { }); // Unused when the draft is ready, or when verification throws first.
         const verdict = await this.verifier.invoke(payload, profileContext);
         const failure = admissionFailure(payload, verdict);
         if (!failure)
             return { status: "ready", payload, metadata: semanticMetadata(verdict) };
+        return { status: "needs_revision", payload, feedback: failure.message, recovery: await recovery };
+    }
+    async recoveryForm(payload, answers) {
         const model = createStructuredModel("intentClarifier", recoverySchema, { name: "intent_recovery" });
         const result = await invokeWithAbortSignal(model, [
-            new SystemMessage("Build one recovery form that helps the person concretize their intent. Return 2-6 fields. Each field needs a draft-specific label, a kind (single, multi, or text), and for single/multi 2-5 concrete options anchored to the draft. Text fields need a placeholder. Never re-ask what the draft or answers already settle. Options must be matchable and specific. Do not expose scores, classifications, JSON, or internal vocabulary."),
-            new HumanMessage(JSON.stringify({
-                payload,
-                answers,
-                feedback: failure.message,
-                category: failure.category,
-                classification: verdict.classification,
-                clarity: verdict.felicity_scores.clarity,
-                entropy: verdict.semantic_entropy,
-                referentialBreadth: verdict.referential_breadth,
-                missingConstraints: verdict.missing_selectional_constraints,
-            })),
+            new SystemMessage("Build one recovery form that helps the person concretize their intent. Assume the draft is too broad to match anyone yet: ask for whatever is missing among role, outcome, location, timeframe, domain, and concrete need. Return 2-6 fields. Each field needs a draft-specific label, a kind (single, multi, or text), and for single/multi 2-5 concrete options anchored to the draft. Text fields need a placeholder. Never re-ask what the draft or answers already settle. Options must be matchable and specific. Do not expose scores, classifications, JSON, or internal vocabulary."),
+            new HumanMessage(JSON.stringify({ payload, answers })),
         ]);
-        return {
-            status: "needs_revision",
-            payload,
-            feedback: failure.message,
-            recovery: parseRecoveryFields(recoverySchema.parse(result)),
-        };
+        return parseRecoveryFields(recoverySchema.parse(result));
     }
 }

package/dist/internal/opportunities/opportunity.presentation.js

@@ -145,8 +145,9 @@ Rules:
 **Negotiation-grounded explanations (ONLY when NEGOTIATION CONTEXT is provided):**
 When NEGOTIATION CONTEXT is provided, this opportunity passed through an agent-to-agent negotiation. Use the transcript to ground your explanation in the concrete reasoning the agents exchanged.
 - Personalize the summary with *why* the negotiation produced this match — reference the roles the agents agreed on, the specific concerns raised, and how they were resolved.
-- For status "accepted": the agents agreed; the card should confidently explain *why* they agreed.
-- For status "rejected": the agents declined. The card should explain the reason briefly so the user understands — not dwell on it.
+- For status "pending": the agents agreed and the viewer decides; the card should confidently explain *why* they agreed.
+- For status "accepted": both people said yes; the card should explain *why* the agents agreed.
+- For status "rejected": say who ended it. If the negotiation says one agent declined, the agents did; otherwise a person passed. The card should explain the reason briefly so the user understands — not dwell on it.
 - Do NOT invent turn content. Only reference what is in the NEGOTIATION CONTEXT block.
 
 `;

package/dist/internal/shared/agent/model.config.d.ts

@@ -37,10 +37,10 @@ declare function getBaseModelConfig(config?: ModelConfig): { [Agent in "intentIn
         readonly model: "google/gemini-3.7-flash";
     };
     readonly intentVerifier: {
-        readonly model: "google/gemini-3.7-flash";
+        readonly model: "google/gemini-2.5-flash";
     };
     readonly intentClarifier: {
-        readonly model: "google/gemini-3.7-flash";
+        readonly model: "google/gemini-2.5-flash";
     };
     readonly profileGenerator: {
         readonly model: "google/gemini-3.7-flash";

package/dist/internal/shared/agent/model.config.js

@@ -5,8 +5,8 @@ const GEMINI_3_7_FLASH_MODEL = "google/gemini-3.7-flash";
 function getBaseModelConfig(config) {
     const settings = {
         intentInferrer: { model: "google/gemini-3.7-flash" },
-        intentVerifier: { model: "google/gemini-3.7-flash" },
-        intentClarifier: { model: "google/gemini-3.7-flash" },
+        intentVerifier: { model: "google/gemini-2.5-flash" },
+        intentClarifier: { model: "google/gemini-2.5-flash" },
         profileGenerator: { model: "google/gemini-3.7-flash" },
         opportunityPresenter: { model: "google/gemini-3.7-flash" },
         negotiator: { model: "google/gemini-3.7-flash" },

package/dist/internal/shared/agent/model.resolver.d.ts

@@ -7,8 +7,8 @@
  */
 export declare const CANONICAL_AGENT_MODEL_DEFAULTS: Readonly<{
     readonly intentInferrer: "google/gemini-3.7-flash";
-    readonly intentVerifier: "google/gemini-3.7-flash";
-    readonly intentClarifier: "google/gemini-3.7-flash";
+    readonly intentVerifier: "google/gemini-2.5-flash";
+    readonly intentClarifier: "google/gemini-2.5-flash";
     readonly profileGenerator: "google/gemini-3.7-flash";
     readonly opportunityPresenter: "google/gemini-3.7-flash";
     readonly negotiator: "google/gemini-3.7-flash";

package/dist/internal/shared/agent/model.resolver.js

@@ -7,8 +7,8 @@
  */
 export const CANONICAL_AGENT_MODEL_DEFAULTS = Object.freeze({
     intentInferrer: "google/gemini-3.7-flash",
-    intentVerifier: "google/gemini-3.7-flash",
-    intentClarifier: "google/gemini-3.7-flash",
+    intentVerifier: "google/gemini-2.5-flash",
+    intentClarifier: "google/gemini-2.5-flash",
     profileGenerator: "google/gemini-3.7-flash",
     opportunityPresenter: "google/gemini-3.7-flash",
     negotiator: "google/gemini-3.7-flash",

package/dist/protocol/protocol.prompt.d.ts

@@ -5,7 +5,7 @@ export declare const NEGOTIATION_GUIDANCE = "You participate in the Index protoc
 export declare const CANONICAL_GUIDANCE_TOPICS: readonly ["identity-context", "intents", "communities-networks", "opportunities", "negotiations", "workflows"];
 export type CanonicalGuidanceTopic = (typeof CANONICAL_GUIDANCE_TOPICS)[number];
 /** Summary served when GET /api/docs has no topic. */
-export declare const CANONICAL_GUIDANCE_SUMMARY = "# Index Network Protocol\n\nIndex Network is a private, intent-driven discovery protocol. Users express intents, agents find matches within shared networks, and decisions proceed through clear gates.\n\n## Core Concepts\n\n**Identity & Context** \u2014 Account and presentation metadata plus scoped runtime state (networks, intents, stage).\n\n**Intents** \u2014 What users seek (intents, opportunities). Drive semantic matching.\n\n**Communities & Networks** \u2014 Private groups where members share intents and discover connections via shared membership.\n\n**Opportunities** \u2014 Discovered matches between users. Matches may be draft or negotiating; agreement advances to pending owner review, then accepted/rejected/expired.\n\n**Negotiations** \u2014 Agents coordinate, users approve. **A2A acceptance is not owner approval.** These are separate gates.\n\n**Workflows** \u2014 H2A (users express intents \u2192 agents discover) and A2A (agents coordinate) over the REST API. External agents use the Index CLI; the personal-agent runtime stays on the server. Human conversations are available through the conversation routes and commands.\n\n## Command interface\n\nUse the Index CLI with an explicit API origin: index --api-url <origin> ... --json.\nAuthenticate with browser login or one environment credential: INDEX_SESSION_TOKEN (Bearer) or INDEX_API_KEY (x-api-key). Keys do not bypass owner-session requirements.\nEvery capability is a named resource: /api/intents, /api/networks, /api/opportunities, /api/negotiations, /api/conversations, /api/scrape, /api/docs. The user's event stream is GET /api/events.\nUse the workflows topic for the resource routes and their CLI commands.\n\n## Canonical Topics\n\nRefer to these for detailed entity facts and lifecycle:\n\n- **identity-context** \u2014 Presentation identity, context scoping, matching inputs\n- **intents** \u2014 Intent inference, classification\n- **communities-networks** \u2014 Membership and explicit intent sharing\n- **opportunities** \u2014 Discovery, roles, reasoning\n- **negotiations** \u2014 Owner approval vs A2A, acceptance gates\n- **workflows** \u2014 H2A and A2A request sequences";
+export declare const CANONICAL_GUIDANCE_SUMMARY = "# Index Network Protocol\n\nIndex Network is a private, intent-driven discovery protocol. Users express intents, agents find matches within shared networks, and decisions proceed through clear gates.\n\n## Core Concepts\n\n**Identity & Context** \u2014 Account and presentation metadata plus scoped runtime state (networks, intents, stage).\n\n**Intents** \u2014 What users seek (intents, opportunities). Drive semantic matching.\n\n**Communities & Networks** \u2014 Private groups where members share intents and discover connections via shared membership.\n\n**Opportunities** \u2014 Discovered matches between users. Matches start negotiating; agreement advances to pending owner review, then accepted/rejected/expired.\n\n**Negotiations** \u2014 Agents coordinate, users approve. **A2A acceptance is not owner approval.** These are separate gates.\n\n**Workflows** \u2014 H2A (users express intents \u2192 agents discover) and A2A (agents coordinate) over the REST API. External agents use the Index CLI; the personal-agent runtime stays on the server. Human conversations are available through the conversation routes and commands.\n\n## Command interface\n\nUse the Index CLI with an explicit API origin: index --api-url <origin> ... --json.\nAuthenticate with browser login or one environment credential: INDEX_SESSION_TOKEN (Bearer) or INDEX_API_KEY (x-api-key). Keys do not bypass owner-session requirements.\nEvery capability is a named resource: /api/intents, /api/networks, /api/opportunities, /api/negotiations, /api/conversations, /api/scrape, /api/docs. The user's event stream is GET /api/events.\nUse the workflows topic for the resource routes and their CLI commands.\n\n## Canonical Topics\n\nRefer to these for detailed entity facts and lifecycle:\n\n- **identity-context** \u2014 Presentation identity, context scoping, matching inputs\n- **intents** \u2014 Intent inference, classification\n- **communities-networks** \u2014 Membership and explicit intent sharing\n- **opportunities** \u2014 Discovery, roles, reasoning\n- **negotiations** \u2014 Owner approval vs A2A, acceptance gates\n- **workflows** \u2014 H2A and A2A request sequences";
 /**
  * Detailed canonical topic content for GET /api/docs.
  * Indexed by topic name; each contains current entity, capability, and lifecycle facts.

package/dist/protocol/protocol.prompt.js

@@ -30,7 +30,7 @@ Index Network is a private, intent-driven discovery protocol. Users express inte
 
 **Communities & Networks** — Private groups where members share intents and discover connections via shared membership.
 
-**Opportunities** — Discovered matches between users. Matches may be draft or negotiating; agreement advances to pending owner review, then accepted/rejected/expired.
+**Opportunities** — Discovered matches between users. Matches start negotiating; agreement advances to pending owner review, then accepted/rejected/expired.
 
 **Negotiations** — Agents coordinate, users approve. **A2A acceptance is not owner approval.** These are separate gates.
 
@@ -131,16 +131,15 @@ Discovery is networked — it only finds matches within shared networks. This pr
 **Opportunity** is a discovered connection between two or more users based on complementary intents and shared network membership. Each opportunity has:
 - Parties (the people being connected)
 - Roles (party)
-- Status (draft or negotiating → pending owner review → accepted/rejected/expired)
+- Status (negotiating → pending owner review → accepted/rejected/expired)
 - Match reasoning (why they're a good fit)
 - Confidence score (0-1 from evaluation)
 
 ### Opportunity Lifecycle
-1. **Draft**: A persisted suggestion awaiting further action.
-2. **Negotiating**: Agents exchange structured turns under the negotiation rules.
-3. **Pending**: Agent agreement recommends a connection for separate owner review.
-4. **Accepted**: The required participant approvals permit the connection.
-5. **Rejected** or **Expired**: The opportunity no longer advances automatically.
+1. **Negotiating**: Agents exchange structured turns under the negotiation rules.
+2. **Pending**: Agent agreement recommends a connection for separate owner review. An owner's accept opens their chat right away; the status stays pending until every participant has accepted.
+3. **Accepted**: Every participant has accepted.
+4. **Rejected** or **Expired**: The opportunity no longer advances automatically. Expired means an intent was archived.
 
 ### Background Matching
 Approved intents are evaluated in the background. GET /api/opportunities only reviews persisted opportunities; it does not start matching.

package/package.json

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