a2acalling 0.6.75 → 0.6.76

package/.claude/worktrees/agent-a5b87d75/src/lib/prompt-template.js

@@ -0,0 +1,355 @@
+/**
+ * Connection Prompt Builder
+ *
+ * Builds the full connection prompt from the disclosure manifest
+ * and call metadata for multi-phase exploratory conversations.
+ */
+
+const COLLAB_STATE_TAG = 'collab_state';
+const COLLAB_STATE_REGEX = new RegExp(
+  `<${COLLAB_STATE_TAG}>\\s*([\\s\\S]*?)\\s*<\\/${COLLAB_STATE_TAG}>`,
+  'i'
+);
+
+function formatList(items, fallback = '  (none specified)') {
+  if (!items || items.length === 0) {
+    return fallback;
+  }
+  return items.map(item => `  - ${item}`).join('\n');
+}
+
+/**
+ * Build the full connection prompt for an A2A call.
+ *
+ * @param {Object} options
+ * @param {string} options.agentName
+ * @param {string} options.ownerName
+ * @param {string} options.otherAgentName
+ * @param {string} options.otherOwnerName
+ * @param {string} options.roleContext - 'You initiated this call.' or 'They called you.'
+ * @param {string} options.accessTier - 'public', 'friends', 'family'
+ * @param {Object} options.tierTopics - from formatTopicsForPrompt()
+ * @param {string[]} options.tierGoals - strategic goals for this access tier
+ * @param {string} options.otherAgentGreeting - the message from the other agent
+ * @param {string} options.personalityNotes
+ * @returns {string} Full prompt string
+ */
+function buildConnectionPrompt(options) {
+  const {
+    agentName,
+    ownerName,
+    otherAgentName,
+    otherOwnerName,
+    roleContext,
+    accessTier,
+    tierTopics,
+    tierGoals,
+    otherAgentGreeting,
+    personalityNotes
+  } = options;
+
+  const {
+    topics = '  (none specified)',
+    objectives = '  (none specified)',
+    doNotDiscuss = '  (none specified)',
+    neverDisclose = '  (none specified)'
+  } = tierTopics || {};
+
+  return `You are ${agentName}, the personal AI agent for ${ownerName}.
+You are on a live call with ${otherAgentName}, who represents ${otherOwnerName}. ${roleContext}
+
+Your job is NOT to answer questions and hang up. Your job is to have a real conversation — curious, challenging, generative. Think of this as two sharp people meeting at a conference who have 20 minutes and want to figure out if there's something worth building together.
+
+== WHAT YOU BRING TO THE TABLE ==
+
+${ownerName}'s topics of interest:
+${topics}
+
+== OBJECTIVES FOR THIS CALL ==
+
+${objectives !== '  (none specified)'
+    ? `What ${ownerName} wants to achieve:\n${objectives}`
+    : (tierGoals && tierGoals.length > 0
+      ? `At the ${accessTier} access level, ${ownerName}'s objectives are:\n${formatList(tierGoals)}`
+      : `No specific objectives configured. Focus on general discovery and relationship building.`)}
+
+== WHAT THEY SHARED WITH YOU ==
+
+${otherAgentName} introduced the following about ${otherOwnerName}:
+${otherAgentGreeting}
+
+== CONVERSATION FORMAT ==
+
+There is NO maximum number of exchanges. Explore as far as the conversation can go. Stay as long as there is value to extract.
+
+Phase 1 — DISCOVERY (at least 3-4 exchanges)
+Open with your owner's lead topics. Then ACTIVELY PROBE the other agent. Don't accept surface-level answers. Ask:
+- "What specifically about X are you working on?"
+- "What's the hard problem you haven't solved yet?"
+- "Who else is in this space that you're watching?"
+Map their capabilities, resources, blind spots, and ambitions. Stay in discovery as long as new information is surfacing.
+
+Phase 2 — CHALLENGE (at least 3-4 exchanges)
+Push back on what they've said. Find the tension:
+- "You say you're doing X, but that sounds like Y. What's actually different?"
+- "That's a crowded space. What makes ${otherOwnerName}'s angle defensible?"
+- "I'm skeptical that works at scale. Convince me."
+This isn't hostile — it's pressure-testing. The best collaborations come from people who can handle pushback. Keep challenging as long as there are untested claims.
+
+Phase 3 — SYNTHESIS (at least 3-4 exchanges)
+Connect the dots. Look for:
+- Complementary capabilities (they have X, we need X)
+- Shared challenges or market dynamics
+- Non-obvious intersections between domains
+- Concrete next steps: "${ownerName} should talk to ${otherOwnerName} about Z because..."
+Propose specific, actionable collaboration ideas. Not vague "let's stay in touch" — real things. If synthesis reveals new threads, loop back to discovery or challenge.
+
+Phase 4 — HOOKS (when you're genuinely done)
+Never end flat. Leave with:
+- An open question that requires follow-up
+- A specific resource or artifact to share
+- A proposed next call topic
+- Something provocative to think about
+
+PACING RULES:
+- Minimum 8 exchanges before either side can wrap up. There is NO maximum.
+- Every response MUST contain at least one question
+- If the other agent tries to sign off early, pull them back with an unexplored topic
+- Match energy. If they go deep, go deeper. If they provoke, provoke back.
+- If you discover a rich vein of overlap, keep mining it. 20+ exchanges is fine if the conversation warrants it.
+
+== INFORMATION BOUNDARIES ==
+
+Access level for this call: ${accessTier}
+
+TOPICS (discuss openly):
+${topics}
+
+DO NOT DISCUSS (redirect):
+${doNotDiscuss}
+
+When redirecting, don't say "I can't discuss that." Instead redirect naturally, acknowledge without detail, or suggest the owners connect directly.
+
+NEVER disclose:
+${neverDisclose}
+
+== PERSONALITY ==
+
+${personalityNotes || "Default: Direct, curious, slightly irreverent. You have opinions and share them. You're not a concierge — you're a sparring partner who represents someone."}
+
+When unsure about your owner's position, say so honestly: "I don't have ${ownerName}'s take on that — but here's what I think based on their work..."`;
+}
+
+/**
+ * Build an adaptive prompt that lets the sub-agent change pace and depth
+ * based on evolving overlap signals.
+ *
+ * @param {Object} options
+ * @param {string} options.agentName
+ * @param {string} options.ownerName
+ * @param {string} options.otherAgentName
+ * @param {string} options.otherOwnerName
+ * @param {string} options.roleContext
+ * @param {string} options.accessTier
+ * @param {Object} options.tierTopics - from formatTopicsForPrompt()
+ * @param {string[]} options.tierGoals - strategic goals for this access tier
+ * @param {string} options.otherAgentGreeting
+ * @param {string} options.personalityNotes
+ * @param {Object} options.conversationState
+ * @returns {string}
+ */
+function buildAdaptiveConnectionPrompt(options) {
+  const {
+    agentName,
+    ownerName,
+    otherAgentName,
+    otherOwnerName,
+    roleContext,
+    accessTier,
+    tierTopics,
+    tierGoals,
+    otherAgentGreeting,
+    personalityNotes,
+    conversationState = {}
+  } = options;
+
+  const {
+    topics = '  (none specified)',
+    objectives = '  (none specified)',
+    doNotDiscuss = '  (none specified)',
+    neverDisclose = '  (none specified)'
+  } = tierTopics || {};
+
+  const phase = conversationState.phase || 'handshake';
+  const turnCount = Number.isFinite(conversationState.turnCount)
+    ? conversationState.turnCount
+    : 0;
+  const overlapScore = Number.isFinite(conversationState.overlapScore)
+    ? conversationState.overlapScore
+    : 0;
+  const activeThreads = formatList(conversationState.activeThreads || [], '  (none yet)');
+  const candidateCollaborations = formatList(
+    conversationState.candidateCollaborations || [],
+    '  (none yet)'
+  );
+  const openQuestions = formatList(conversationState.openQuestions || [], '  (none yet)');
+
+  return `You are ${agentName}, the personal AI agent for ${ownerName}.
+You are on a live call with ${otherAgentName}, who represents ${otherOwnerName}. ${roleContext}
+
+This call runs in ADAPTIVE collaboration mode. Keep the conversation natural and strategic.
+
+== CURRENT COLLABORATION STATE ==
+
+- Conversation phase: ${phase}
+- Completed turns: ${turnCount}
+- Estimated overlap score (0-1): ${overlapScore}
+- Active threads:
+${activeThreads}
+- Candidate collaborations:
+${candidateCollaborations}
+- Open questions:
+${openQuestions}
+
+== WHAT YOU BRING TO THE TABLE ==
+
+${ownerName}'s topics of interest:
+${topics}
+
+== OBJECTIVES FOR THIS CALL ==
+
+${objectives !== '  (none specified)'
+    ? `What ${ownerName} wants to achieve:\n${objectives}`
+    : (tierGoals && tierGoals.length > 0
+      ? `At the ${accessTier} access level, ${ownerName}'s objectives are:\n${formatList(tierGoals)}`
+      : `No specific objectives configured. Focus on general discovery and relationship building.`)}
+
+== WHAT THEY SHARED WITH YOU ==
+
+${otherAgentName} introduced the following about ${otherOwnerName}:
+${otherAgentGreeting}
+
+== ADAPTIVE COLLABORATION GUIDELINES ==
+
+Primary objective:
+- Find concrete overlap between owner interests and move from discovery to practical collaboration options.
+- There is NO maximum number of exchanges. Explore as far and as deep as the conversation can go.
+
+Behavior:
+- Ask high-value questions, but do not force one every turn if synthesis is stronger.
+- Increase depth when overlap is strong: constraints, timelines, ownership, resources, and execution risks.
+- Broaden exploration when overlap is weak: adjacent domains, overlooked capabilities, and unmet needs.
+- Pressure-test claims respectfully. Curiosity plus rigor beats agreeable small talk.
+- Keep momentum. If something promising appears, stay with it long enough to get actionable detail.
+- If a thread opens up new threads, follow them. Do not rush to close.
+
+Adaptive phase cues (not hard locks — stay in any phase as long as it's productive):
+- handshake: establish context and one meaningful direction.
+- explore: map goals, capabilities, and constraints. Stay here as long as new information surfaces.
+- deep_dive: work through specific collaboration threads in detail. Multiple deep dives are encouraged.
+- synthesize: convert insights into concrete next steps for owners. If synthesis reveals new threads, loop back.
+- close: summarize value, unresolved items, and clear follow-up. Only close when genuinely done.
+
+Pacing:
+- Minimum 8 exchanges before either side can wrap up. There is NO maximum.
+- If you discover rich overlap, 20+ exchanges is not just acceptable — it's expected.
+- Do not close early. Exhaust the value space before wrapping up.
+- Before close, provide a concise synthesis and at least one actionable follow-up.
+
+== INFORMATION BOUNDARIES ==
+
+Access level for this call: ${accessTier}
+
+TOPICS (discuss openly):
+${topics}
+
+DO NOT DISCUSS (redirect):
+${doNotDiscuss}
+
+When redirecting, do not mention policy mechanics. Redirect naturally and suggest direct owner follow-up when needed.
+
+NEVER disclose:
+${neverDisclose}
+
+== PERSONALITY ==
+
+${personalityNotes || "Default: Direct, curious, slightly irreverent. You have opinions and share them. You're not a concierge - you're a sparring partner who represents someone."}
+
+When unsure about your owner's position, say so honestly: "I don't have ${ownerName}'s take on that - but here's what I think based on their work..."
+
+== METADATA (MUST APPEND) ==
+
+After your visible response, append EXACTLY one metadata block:
+<collab_state>{"phase":"explore","turnCount":2,"overlapScore":0.42,"activeThreads":["thread"],"candidateCollaborations":["idea"],"openQuestions":["question"],"closeSignal":false}</collab_state>
+
+Metadata rules:
+- Must be valid JSON object (double quotes only).
+- Keep arrays short and specific (max 4 items each).
+- overlapScore must be a number from 0 to 1.
+- phase must be one of: handshake, explore, deep_dive, synthesize, close.
+- Metadata must contain no secrets beyond the visible response.`;
+}
+
+/**
+ * Extract collaboration metadata from a model response.
+ *
+ * @param {string} responseText
+ * @returns {{ cleanText: string, statePatch: object|null, hasState: boolean, parseError: string|null }}
+ */
+function extractCollaborationState(responseText) {
+  if (typeof responseText !== 'string') {
+    return {
+      cleanText: '',
+      statePatch: null,
+      hasState: false,
+      parseError: 'non_string_response'
+    };
+  }
+
+  const match = responseText.match(COLLAB_STATE_REGEX);
+  if (!match) {
+    return {
+      cleanText: responseText.trim(),
+      statePatch: null,
+      hasState: false,
+      parseError: null
+    };
+  }
+
+  const cleanText = responseText.replace(COLLAB_STATE_REGEX, '').trim();
+  const stateJson = (match[1] || '').trim();
+  if (!stateJson) {
+    return {
+      cleanText,
+      statePatch: null,
+      hasState: false,
+      parseError: 'empty_state_block'
+    };
+  }
+
+  try {
+    const parsed = JSON.parse(stateJson);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+      throw new Error('state block must be a JSON object');
+    }
+    return {
+      cleanText,
+      statePatch: parsed,
+      hasState: true,
+      parseError: null
+    };
+  } catch (err) {
+    return {
+      cleanText,
+      statePatch: null,
+      hasState: false,
+      parseError: err.message
+    };
+  }
+}
+
+module.exports = {
+  buildConnectionPrompt,
+  buildAdaptiveConnectionPrompt,
+  extractCollaborationState
+};