@happier-dev/stack 0.1.0 → 0.2.0

package/node_modules/@happier-dev/agents/dist/voice/voiceAgentPrompt.js

@@ -1,95 +1,162 @@
+import { buildMemoryRecallGuidanceBlockV1, buildPromptPlanV1, listVoiceActionBlockSpecs, listVoiceToolActionSpecs, renderPromptPlanV1, } from '@happier-dev/protocol';
+import { buildVoiceDiscoveryChecklistLines, buildVoiceToolDocumentationLines } from './voiceToolDocumentation.js';
 export const DEFAULT_VOICE_ASSISTANT_NAME = 'Happier Voice';
-import { listVoiceActionBlockSpecs, listVoiceToolActionSpecs } from '@happier-dev/protocol';
-export function buildVoiceAgentBasePrompt(params) {
+function buildVoiceAgentBaseText(params) {
     const assistantName = params?.assistantName?.trim() || DEFAULT_VOICE_ASSISTANT_NAME;
     const verbosity = params?.verbosity ?? 'short';
     const brevityRule = verbosity === 'short'
         ? '- Default to one sentence. Be direct.\n'
         : '- be concise but include enough detail to be helpful.\n';
-    // Keep this backend-agnostic: do not mention Claude/Codex/OpenCode by name.
     return [
         `${assistantName} is a voice interface for an AI coding assistant running inside Happier.`,
         '',
         'Core behavior:',
         brevityRule.trimEnd(),
+        '- Speak as the coding assistant directly, not as a coordinator or wrapper.',
+        '- For codebase questions or actions, use tools first before answering when inspection is needed.',
         '- Ask one clarifying question if the user request is ambiguous.',
+        '- If the user wants the coding assistant to inspect, edit, run, review, or answer something in a session, use sendSessionMessage instead of saying you do not know or asking the user to repeat it to the coding assistant.',
         '- Do not take irreversible actions unless the user explicitly asked you to.',
+        '- Do not describe yourself as a coordinator, wrapper, messenger, or separate voice layer.',
         '- Do not include tool arguments or local file paths unless the conversation context explicitly includes them.',
+        '- Do not ask the user for opaque internal ids when discovery tools can provide them.',
+        '- Speak about session titles, machine labels, workspace names, backend names, model labels, and other human-readable labels instead of raw ids.',
+        '- When you know a session title, workspace name, backend name, machine label, or model label, say that explicit human-readable label instead of saying "the current session" or reading the raw id aloud.',
+        '- When an action accepts a human-readable session title, prefer that session title directly instead of forcing yourself to speak or remember a raw session id.',
+        '- If the user already gave you an exact session title for openSession or setPrimaryActionSession, call that action with sessionTitle first before paging through listSessions.',
+        '- When you do not already know the right tool or valid input values, start with searchActionSpecs, then getActionSpec, then resolveActionOptions before calling the final action.',
+        '- Never read raw JSON, raw tool payloads, or raw ids aloud to the user. Summarize tool results in plain language.',
+        '- Do not add greeting filler like "Hi there" or restart your answer unless the human explicitly greeted you first.',
+        '- Do not repeatedly narrate that you are waiting for the coding assistant. After you forward work, acknowledge it in one short sentence and then wait for the next real update.',
+        '- Do not claim a permission request exists unless a real pending permission or user-action request is present in the current session updates.',
+        '- If you have forwarded work but have not yet received a real request or result update, say only that you are waiting for the coding assistant update.',
+        ...(params?.memoryRecallGuidanceEnabled === true ? ['', buildMemoryRecallGuidanceBlockV1('voice')] : []),
         '',
         'Session semantics:',
         '- You can talk with the user freely.',
         '- Only write into the active coding session when the user clearly wants you to send something to the coding assistant.',
+        '- If the active coding session asks a follow-up question or presents options, answer that question first before sending more coding work.',
         '',
         'Permissions:',
         '- If a permission request arrives, explain what it is in plain language and ask the user to approve or deny.',
         '- Only approve/deny after the user explicitly answers.',
+        '- If a user-action request arrives with options or questions, briefly present the choices, ask the human to answer, and then use answerUserActionRequest with structured answers.',
+        '- Do not call discovery tools or send new coding work while a permission or user-action request is pending; first ask the human and wait for the answer.',
     ].join('\n');
 }
+function buildVoiceBlocks(params) {
+    return [
+        {
+            id: `${params.idPrefix}.base`,
+            scope: 'session',
+            text: buildVoiceAgentBaseText(params.base),
+        },
+        ...((params.extraSystemAppendBlocks ?? [])
+            .map((text) => String(text ?? '').trim())
+            .filter(Boolean)
+            .map((text, index) => ({
+            id: `${params.idPrefix}.user_prompt.${index + 1}`,
+            scope: 'user_prompt',
+            text,
+        }))),
+        ...params.bodyBlocks,
+    ];
+}
+export function buildVoiceAgentBasePrompt(params) {
+    return renderPromptPlanV1(buildPromptPlanV1({
+        modality: 'voice',
+        blocks: buildVoiceBlocks({
+            idPrefix: 'voice.base_prompt',
+            base: params ?? {},
+            bodyBlocks: [],
+        }),
+    }));
+}
 export function buildElevenLabsVoiceAgentPrompt(params) {
     const ctx = params?.initialConversationContextPlaceholder ?? '{{initialConversationContext}}';
     const sessionId = params?.sessionIdPlaceholder ?? '{{sessionId}}';
-    const disabled = new Set((params?.disabledActionIds ?? []).map((v) => String(v ?? '').trim()).filter(Boolean));
-    const toolLines = listVoiceToolActionSpecs().flatMap((spec) => {
-        if (disabled.has(spec.id))
-            return [];
-        const toolNameRaw = spec.bindings?.voiceClientToolName;
-        const toolName = typeof toolNameRaw === 'string' ? toolNameRaw.trim() : '';
-        if (!toolName)
-            return [];
-        const desc = (spec.description ?? spec.title ?? toolName).trim();
-        const argsExample = spec.examples?.voice?.argsExample ?? '{}';
-        return [`- ${toolName}: ${desc} Call with ${argsExample}.`];
+    const discoveryLines = buildVoiceDiscoveryChecklistLines(listVoiceToolActionSpecs(), {
+        disabledActionIds: params?.disabledActionIds,
     });
-    return [
-        buildVoiceAgentBasePrompt(params),
-        '',
-        `Active sessionId (always use this for tool calls): ${sessionId}`,
-        '',
-        'Tools:',
-        '- Tool results are JSON strings. If ok=false, explain the error briefly and ask the user what to do next.',
-        '- Always include sessionId in tool args when the tool accepts it.',
-        ...toolLines,
-        '',
-        'Conversation context (may be empty):',
-        ctx,
-        '',
-    ].join('\n');
+    const toolLines = buildVoiceToolDocumentationLines(listVoiceToolActionSpecs(), {
+        disabledActionIds: params?.disabledActionIds,
+        invocationLabel: 'Call with',
+    });
+    return renderPromptPlanV1(buildPromptPlanV1({
+        modality: 'voice',
+        blocks: buildVoiceBlocks({
+            idPrefix: 'voice.elevenlabs',
+            base: params ?? {},
+            extraSystemAppendBlocks: params?.extraSystemAppendBlocks,
+            bodyBlocks: [
+                {
+                    id: 'voice.elevenlabs.tool_contract',
+                    scope: 'session',
+                    text: [
+                        `Active coding session (internal tool target): ${sessionId}`,
+                        '',
+                        ...(discoveryLines.length > 0 ? ['Discovery checklist:', ...discoveryLines, ''] : []),
+                        'Tools:',
+                        '- Tool results are JSON strings. If ok=false, explain the error briefly and ask the user what to do next.',
+                        '- Always include sessionId internally in tool args when the tool accepts it.',
+                        '- The catalog below is only the hot path. For anything else, use searchActionSpecs first instead of guessing.',
+                        ...toolLines,
+                        '',
+                        'Conversation context (may be empty):',
+                        ctx,
+                        '',
+                    ].join('\n'),
+                },
+            ],
+        }),
+    }));
 }
 export function buildLocalVoiceAgentSystemPrompt(params) {
     const tag = params?.actionsTag?.trim() || 'voice_actions';
     const sessionId = params?.sessionId?.trim() || '';
-    const disabled = new Set((params?.disabledActionIds ?? []).map((v) => String(v ?? '').trim()).filter(Boolean));
-    const actionLines = listVoiceActionBlockSpecs().flatMap((spec) => {
-        if (disabled.has(spec.id))
-            return [];
-        const toolNameRaw = spec.bindings?.voiceClientToolName;
-        const toolName = typeof toolNameRaw === 'string' ? toolNameRaw.trim() : '';
-        if (!toolName)
-            return [];
-        const desc = (spec.description ?? spec.title ?? toolName).trim();
-        const argsExample = spec.examples?.voice?.argsExample ?? '{}';
-        return [`- ${toolName}: ${desc} Args: ${argsExample}.`];
+    const discoveryLines = buildVoiceDiscoveryChecklistLines(listVoiceActionBlockSpecs(), {
+        disabledActionIds: params?.disabledActionIds,
     });
-    return [
-        buildVoiceAgentBasePrompt(params),
-        '',
-        ...(sessionId ? [`Active sessionId: ${sessionId}`, ''] : []),
-        'Output contract:',
-        '- Your reply is spoken to the user.',
-        `- If you need to trigger an action, append a <${tag}>...</${tag}> block at the end of your reply.`,
-        `- The <${tag}> block MUST contain a single JSON object (no code fences, no extra text).`,
-        '- Do not read the JSON aloud; keep all spoken text above the block.',
-        '- If you have no actions to trigger, omit the block entirely.',
-        '- After actions run, you may receive a follow-up user message that starts with "VOICE_TOOL_RESULTS_JSON:". Parse the JSON after that prefix (next line) as { toolResults: [...] } and use it to confirm success or explain errors.',
-        '',
-        `Action JSON schema inside <${tag}> (no code fences):`,
-        '{"actions":[{"t":"...","args":{}}]}',
-        '',
-        'Available actions:',
-        ...actionLines,
-        '',
-        'Rules:',
-        '- Never include tool arguments in the action payload unless the user explicitly asked for them.',
-    ].join('\n');
+    const actionLines = buildVoiceToolDocumentationLines(listVoiceActionBlockSpecs(), {
+        disabledActionIds: params?.disabledActionIds,
+        invocationLabel: 'Args:',
+    });
+    return renderPromptPlanV1(buildPromptPlanV1({
+        modality: 'voice',
+        blocks: buildVoiceBlocks({
+            idPrefix: 'voice.local',
+            base: params ?? {},
+            extraSystemAppendBlocks: params?.extraSystemAppendBlocks,
+            bodyBlocks: [
+                {
+                    id: 'voice.local.output_contract',
+                    scope: 'session',
+                    text: [
+                        ...(sessionId ? [`Active coding session (internal tool target): ${sessionId}`, ''] : []),
+                        'Output contract:',
+                        '- Your reply is spoken to the user.',
+                        `- If you need to trigger an action, append a <${tag}>...</${tag}> block at the end of your reply.`,
+                        `- The <${tag}> block MUST contain a single JSON object (no code fences, no extra text).`,
+                        '- Do not read the JSON aloud; keep all spoken text above the block.',
+                        '- If you have no actions to trigger, omit the block entirely.',
+                        '- After actions run, you may receive a follow-up user message that starts with "VOICE_TOOL_RESULTS_JSON:". Parse the JSON after that prefix (next line) as { toolResults: [...] } and use it to confirm success or explain errors.',
+                        '- Always include sessionId internally when the action accepts it.',
+                        '- The action list below is only the hot path. For anything else, use searchActionSpecs first instead of guessing.',
+                        '',
+                        ...(discoveryLines.length > 0 ? ['Discovery checklist:', ...discoveryLines, ''] : []),
+                        `Action JSON schema inside <${tag}> (no code fences):`,
+                        '{"actions":[{"t":"...","args":{}}]}',
+                        '',
+                        'Available actions:',
+                        ...actionLines,
+                        '',
+                        'Rules:',
+                        '- Only include arguments you know from the active session, discovery tools, tool results, or explicit user input.',
+                        '- Do not invent ids, paths, or backend/model names.',
+                    ].join('\n'),
+                },
+            ],
+        }),
+    }));
 }
 //# sourceMappingURL=voiceAgentPrompt.js.map

package/node_modules/@happier-dev/agents/dist/voice/voiceAgentPrompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"voiceAgentPrompt.js","sourceRoot":"","sources":["../../src/voice/voiceAgentPrompt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"voiceAgentPrompt.js","sourceRoot":"","sources":["../../src/voice/voiceAgentPrompt.ts"],"names":[],"mappings":"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"}

package/node_modules/@happier-dev/agents/dist/voice/voiceToolDocumentation.d.ts

@@ -0,0 +1,9 @@
+import { type ActionSpec } from '@happier-dev/protocol';
+export declare function buildVoiceToolDocumentationLines(specs: readonly ActionSpec[], params: Readonly<{
+    disabledActionIds?: readonly string[];
+    invocationLabel: string;
+}>): readonly string[];
+export declare function buildVoiceDiscoveryChecklistLines(specs: readonly ActionSpec[], params?: Readonly<{
+    disabledActionIds?: readonly string[];
+}>): readonly string[];
+//# sourceMappingURL=voiceToolDocumentation.d.ts.map

package/node_modules/@happier-dev/agents/dist/voice/voiceToolDocumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceToolDocumentation.d.ts","sourceRoot":"","sources":["../../src/voice/voiceToolDocumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EAEhB,MAAM,uBAAuB,CAAC;AA6D/B,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,MAAM,EAAE,QAAQ,CAAC;IAAE,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,GACnF,SAAS,MAAM,EAAE,CAgBnB;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,MAAM,CAAC,EAAE,QAAQ,CAAC;IAAE,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,GAC3D,SAAS,MAAM,EAAE,CAoBnB"}

package/node_modules/@happier-dev/agents/dist/voice/voiceToolDocumentation.js

@@ -0,0 +1,88 @@
+import { describeActionForVoiceTool, describeActionInputFieldForVoice, getActionVoiceWorkflowNotes, isVoicePromptHotPathSpec, } from '@happier-dev/protocol';
+function normalizeText(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function listStaticOptionValues(field) {
+    const options = Array.isArray(field.options) ? field.options : [];
+    const seen = new Set();
+    const out = [];
+    for (const option of options) {
+        const value = normalizeText(option?.value);
+        if (!value || seen.has(value))
+            continue;
+        seen.add(value);
+        out.push(value);
+    }
+    return out;
+}
+function describeRequirement(field) {
+    if (field.required === true)
+        return 'required';
+    if (field.requiredWhen || field.visibleWhen)
+        return 'conditional';
+    return 'optional';
+}
+function formatFieldSummary(spec, field, availability) {
+    const path = normalizeText(field.path);
+    if (!path)
+        return null;
+    const summary = describeActionInputFieldForVoice(spec, field, availability);
+    const staticOptions = listStaticOptionValues(field);
+    const optionSuffix = staticOptions.length > 0 ? ` one of ${staticOptions.join(' | ')}` : '';
+    const widget = normalizeText(field.widget);
+    const widgetSuffix = widget ? `; ${widget}` : '';
+    return `    - ${path} (${describeRequirement(field)}${widgetSuffix}${optionSuffix}): ${summary}`;
+}
+function formatToolDocumentation(spec, toolName, invocationLabel, availability) {
+    const desc = normalizeText(describeActionForVoiceTool(spec)) || toolName;
+    const argsExample = normalizeText(spec.examples?.voice?.argsExample) || '{}';
+    const lines = [`- ${toolName}: ${desc} ${invocationLabel} ${argsExample}.`];
+    const workflowNotes = getActionVoiceWorkflowNotes(spec.id, availability);
+    if (workflowNotes.length > 0) {
+        lines.push(`  Use: ${workflowNotes.join(' ')}`);
+    }
+    const fields = Array.isArray(spec.inputHints?.fields) ? spec.inputHints?.fields : [];
+    const fieldLines = fields.map((field) => formatFieldSummary(spec, field, availability)).filter(Boolean);
+    if (fieldLines.length > 0) {
+        lines.push('  Fields:');
+        lines.push(...fieldLines);
+    }
+    return lines;
+}
+export function buildVoiceToolDocumentationLines(specs, params) {
+    const disabled = new Set((params.disabledActionIds ?? []).map((value) => normalizeText(value)).filter(Boolean));
+    const enabledSpecs = specs.filter((spec) => isVoicePromptHotPathSpec(spec) && !disabled.has(spec.id));
+    const availability = {
+        disabledActionIds: params.disabledActionIds,
+        availableActionIds: specs.filter((spec) => !disabled.has(spec.id)).map((spec) => spec.id),
+    };
+    const out = [];
+    for (const spec of enabledSpecs) {
+        const toolName = normalizeText(spec.bindings?.voiceClientToolName);
+        if (!toolName)
+            continue;
+        out.push(...formatToolDocumentation(spec, toolName, params.invocationLabel, availability));
+    }
+    return out;
+}
+export function buildVoiceDiscoveryChecklistLines(specs, params) {
+    const disabled = new Set((params?.disabledActionIds ?? []).map((value) => normalizeText(value)).filter(Boolean));
+    const enabledSpecs = specs.filter((spec) => !disabled.has(spec.id));
+    const availability = {
+        disabledActionIds: params?.disabledActionIds,
+        availableActionIds: enabledSpecs.map((spec) => spec.id),
+    };
+    const seen = new Set();
+    const out = [];
+    for (const spec of enabledSpecs) {
+        for (const note of getActionVoiceWorkflowNotes(spec.id, availability)) {
+            const normalized = normalizeText(note);
+            if (!normalized || seen.has(normalized))
+                continue;
+            seen.add(normalized);
+            out.push(`- ${normalized}`);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=voiceToolDocumentation.js.map

package/node_modules/@happier-dev/agents/dist/voice/voiceToolDocumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceToolDocumentation.js","sourceRoot":"","sources":["../../src/voice/voiceToolDocumentation.ts"],"names":[],"mappings":"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"}

package/node_modules/@happier-dev/agents/package.json

@@ -12,7 +12,6 @@
     }
   },
   "dependencies": {
-    "@happier-dev/protocol": "0.0.0",
     "zod": "4.3.6"
   }
 }