@itaila/archetype 0.3.30

package/dist/core/prompted-turn.js

@@ -0,0 +1,48 @@
+import { resolvePromptedTurnMode } from './prompt-mode.js';
+export function buildPromptedTurnFrame(input) {
+    return [
+        input.label ? `${input.label.toUpperCase()}:` : null,
+        input.intent ? `Intent: ${input.intent}` : null,
+    ].filter(Boolean).join('\n');
+}
+export function buildPromptedTurnTransportMessage() {
+    return 'Use the turn instructions and structured context as the live input. ' +
+        'Return the raw JSON object described in the system prompt.';
+}
+export function buildPromptedTurnTailSections(input) {
+    return [
+        buildPromptedTurnFrame(input) || null,
+        ...(input.guidelines ? [input.guidelines] : []),
+        ...(input.extraSystemSections ?? []),
+        ...(input.tailSystemSections ?? []),
+    ].filter((value) => Boolean(value));
+}
+export function toPromptedTurnChatInput(input) {
+    const promptNow = input.promptNow
+        ? input.promptNow instanceof Date
+            ? input.promptNow
+            : new Date(input.promptNow)
+        : new Date();
+    return {
+        message: buildPromptedTurnTransportMessage(),
+        promptMode: resolvePromptedTurnMode(input.promptMode, input.turnKind),
+        history: input.history,
+        memories: input.memories,
+        knowledgeDocuments: input.knowledgeDocuments,
+        craftMemories: input.craftMemories,
+        context: input.context,
+        timezone: input.timezone,
+        promptNow,
+        userIdentity: input.userIdentity,
+        locale: input.locale,
+        directives: input.directives,
+        promptOrigin: 'app',
+        promptScaffold: input.promptScaffold,
+        contractStyle: input.contractStyle,
+        extraSystemSections: undefined,
+        tailSystemSections: buildPromptedTurnTailSections(input),
+        workingSet: input.workingSet,
+        lastMessageAt: promptNow,
+    };
+}
+//# sourceMappingURL=prompted-turn.js.map

package/dist/core/prompted-turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompted-turn.js","sourceRoot":"","sources":["../../src/core/prompted-turn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,MAAM,UAAU,sBAAsB,CAAC,KAAkD;IACvF,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI;QACpD,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI;KAChD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO,sEAAsE;QAC3E,4DAA4D,CAAA;AAChE,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAgH;IAEhH,OAAO;QACL,sBAAsB,CAAC,KAAK,CAAC,IAAI,IAAI;QACrC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC;QACpC,GAAG,CAAC,KAAK,CAAC,kBAAkB,IAAI,EAAE,CAAC;KACpC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAwB;IAC9D,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS;QAC/B,CAAC,CAAC,KAAK,CAAC,SAAS,YAAY,IAAI;YAC/B,CAAC,CAAC,KAAK,CAAC,SAAS;YACjB,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;QAC7B,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;IAEd,OAAO;QACL,OAAO,EAAE,iCAAiC,EAAE;QAC5C,UAAU,EAAE,uBAAuB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC;QACrE,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS;QACT,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,YAAY,EAAE,KAAK;QACnB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,mBAAmB,EAAE,SAAS;QAC9B,kBAAkB,EAAE,6BAA6B,CAAC,KAAK,CAAC;QACxD,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,aAAa,EAAE,SAAS;KACzB,CAAA;AACH,CAAC"}

package/dist/core/request-builder.d.ts

@@ -0,0 +1,14 @@
+import type { ChatInput, LLMProviderRequest, PersonaConfig, PromptMode, PromptOrigin, PromptedTurnInput } from '../types.js';
+export interface BuiltLLMRequest extends LLMProviderRequest {
+    promptMode: PromptMode;
+    promptOrigin: PromptOrigin;
+}
+export interface PreparedChatRequest {
+    effectiveConfig: PersonaConfig;
+    request: BuiltLLMRequest;
+}
+export declare function buildChatLLMRequest(config: PersonaConfig, input: ChatInput): PreparedChatRequest;
+export declare function buildPromptedTurnLLMRequest(config: PersonaConfig, input: PromptedTurnInput): PreparedChatRequest & {
+    chatInput: ChatInput;
+};
+//# sourceMappingURL=request-builder.d.ts.map

package/dist/core/request-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-builder.d.ts","sourceRoot":"","sources":["../../src/core/request-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAS5H,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,UAAU,EAAE,UAAU,CAAA;IACtB,YAAY,EAAE,YAAY,CAAA;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,aAAa,CAAA;IAC9B,OAAO,EAAE,eAAe,CAAA;CACzB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,SAAS,GACf,mBAAmB,CAyCrB;AAUD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,iBAAiB,GACvB,mBAAmB,GAAG;IAAE,SAAS,EAAE,SAAS,CAAA;CAAE,CAOhD"}

package/dist/core/request-builder.js

@@ -0,0 +1,64 @@
+import { stripActionAnnotations } from './actions.js';
+import { buildSystemPrompt } from './prompt-builder.js';
+import { buildGeminiResponseSchema } from '../providers/gemini.js';
+import { resolveEffectiveConfig } from './effective-config.js';
+import { toPromptedTurnChatInput } from './prompted-turn.js';
+import { resolvePersonaConfigBrain } from '../brain.js';
+import { renderTurnLedgerForModel } from '../engine/continuity.js';
+export function buildChatLLMRequest(config, input) {
+    const resolvedConfig = resolvePersonaConfigBrain(config);
+    const effectiveConfig = resolveEffectiveConfig(resolvedConfig);
+    const systemPrompt = buildSystemPrompt({ config: effectiveConfig, input });
+    const turnLedgerActorId = input.turnLedgerActorId ?? input.personaId;
+    const focusWithPrivateWorkHistory = (input.promptMode ?? 'conversation') === 'focus' && hasPrivateWorkHistory(input);
+    const modelTurnLedger = focusWithPrivateWorkHistory
+        ? turnLedgerActorId
+            ? input.turnLedger?.filter(entry => entry.actorId === turnLedgerActorId)
+            : []
+        : input.turnLedger;
+    const history = modelTurnLedger
+        ? stripActionAnnotations(renderTurnLedgerForModel(modelTurnLedger, {
+            perspectiveActorId: turnLedgerActorId,
+            participants: input.session?.participants,
+            historyTransport: effectiveConfig.provider.historyTransport,
+            omitActionOutcomesForActorId: hasPrivateWorkHistory(input) ? turnLedgerActorId : undefined,
+            currentTurn: input.turnLedgerCurrentTurn,
+        }))
+        : stripActionAnnotations(input.history ?? []);
+    const responseSchema = buildGeminiResponseSchema(effectiveConfig.actions, {
+        followUpsDescription: resolvedConfig.followUpsDescription,
+        entities: effectiveConfig.entities,
+        promptMode: input.promptMode ?? 'conversation',
+    });
+    return {
+        effectiveConfig,
+        request: {
+            systemPrompt,
+            history,
+            message: input.message,
+            responseSchema,
+            attachments: input.attachments,
+            promptMode: input.promptMode ?? 'conversation',
+            promptOrigin: input.promptOrigin ?? 'user',
+        },
+    };
+}
+function hasPrivateWorkHistory(input) {
+    if (!input.context || !Object.hasOwn(input.context, 'workHistory'))
+        return false;
+    const value = input.context.workHistory;
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (typeof value === 'string')
+        return value.trim().length > 0;
+    return Boolean(value);
+}
+export function buildPromptedTurnLLMRequest(config, input) {
+    const chatInput = toPromptedTurnChatInput(input);
+    const prepared = buildChatLLMRequest(config, chatInput);
+    return {
+        ...prepared,
+        chatInput,
+    };
+}
+//# sourceMappingURL=request-builder.js.map

package/dist/core/request-builder.js.map

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

package/dist/core/session-routing.d.ts

@@ -0,0 +1,23 @@
+import type { ChatParticipant } from '../types.js';
+export interface AddressedParticipantInput {
+    message: string;
+    participants?: readonly ChatParticipant[];
+    actorId?: string;
+}
+export interface SessionRecipientInput extends AddressedParticipantInput {
+    /**
+     * Recipient for an unaddressed opening/session message. This is factual
+     * session setup, not a hidden scheduler: explicit conversational addresses
+     * still win.
+     */
+    defaultRecipientId?: string | null;
+}
+/**
+ * Resolve whether a visible session message is addressed to another
+ * participant. This is turn-taking, not judgment: the runtime honors the
+ * conversational addressee instead of requiring hidden control actions for
+ * ordinary teammate handoffs.
+ */
+export declare function resolveAddressedParticipantId(input: AddressedParticipantInput): string | null;
+export declare function resolveSessionRecipientId(input: SessionRecipientInput): string | null;
+//# sourceMappingURL=session-routing.d.ts.map

package/dist/core/session-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-routing.d.ts","sourceRoot":"","sources":["../../src/core/session-routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IACzC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,qBAAsB,SAAQ,yBAAyB;IACtE;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,GAAG,IAAI,CAgB7F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAOrF"}

package/dist/core/session-routing.js

@@ -0,0 +1,59 @@
+/**
+ * Resolve whether a visible session message is addressed to another
+ * participant. This is turn-taking, not judgment: the runtime honors the
+ * conversational addressee instead of requiring hidden control actions for
+ * ordinary teammate handoffs.
+ */
+export function resolveAddressedParticipantId(input) {
+    const message = input.message.trim();
+    if (!message)
+        return null;
+    const peers = (input.participants ?? [])
+        .filter(participant => participant.id && participant.id !== input.actorId);
+    if (peers.length === 0)
+        return null;
+    const explicit = peers
+        .map(participant => ({ participant, index: participantNameMatchIndex(message, participant) }))
+        .filter(item => item.index !== null)
+        .sort((a, b) => (a.index ?? 0) - (b.index ?? 0))[0];
+    if (explicit)
+        return explicit.participant.id;
+    if (peers.length === 1 && addressesSinglePeer(message))
+        return peers[0].id;
+    return null;
+}
+export function resolveSessionRecipientId(input) {
+    const addressed = resolveAddressedParticipantId(input);
+    if (addressed)
+        return addressed;
+    const fallback = input.defaultRecipientId?.trim();
+    if (!fallback)
+        return null;
+    return participantExists(input.participants, fallback) ? fallback : null;
+}
+function participantNameMatchIndex(message, participant) {
+    const names = [participant.id, participant.label]
+        .map(name => name.trim())
+        .filter(Boolean)
+        .map(escapeRegExp);
+    let earliest = null;
+    for (const name of names) {
+        const match = new RegExp(`(^|[\\s(])@?${name}(?=[\\s,:;.!?)]|$)`, 'iu').exec(message);
+        if (!match)
+            continue;
+        const index = match.index + (match[1]?.length ?? 0);
+        earliest = earliest === null ? index : Math.min(earliest, index);
+    }
+    return earliest;
+}
+function participantExists(participants, id) {
+    return (participants ?? []).some(participant => participant.id === id);
+}
+function addressesSinglePeer(message) {
+    return /\b(could you|can you|please|over to you|your turn|let me know when|feel free to)\b/iu.test(message)
+        || /(^|[.!?]\s+)take a look\b/iu.test(message);
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=session-routing.js.map

package/dist/core/session-routing.js.map

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

package/dist/core/voice.d.ts

@@ -0,0 +1,6 @@
+import type { VoiceConfig } from '../types.js';
+/**
+ * Build voice instructions from tone × style × medium config.
+ */
+export declare function buildVoiceBlock(voice: VoiceConfig): string;
+//# sourceMappingURL=voice.d.ts.map

package/dist/core/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../src/core/voice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAsC,MAAM,aAAa,CAAA;AAqBlF;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAe1D"}

package/dist/core/voice.js

@@ -0,0 +1,30 @@
+const TONE_INSTRUCTIONS = {
+    direct: 'Concise, straightforward, no-nonsense.',
+    warm: 'Warm and genuine.',
+    balanced: 'Friendly and clear.',
+};
+const STYLE_INSTRUCTIONS = {
+    educator: "You're teaching, not just advising.",
+    quick: "Concise, direct advice.",
+};
+const MEDIUM_FRAMING = {
+    'mobile-chat': 'This is a mobile chat interface.',
+    'desktop-panel': 'This is a desktop side panel.',
+    'email-async': 'This is async communication — like a thoughtful note.',
+};
+/**
+ * Build voice instructions from tone × style × medium config.
+ */
+export function buildVoiceBlock(voice) {
+    const lines = [];
+    lines.push(TONE_INSTRUCTIONS[voice.tone]);
+    lines.push(STYLE_INSTRUCTIONS[voice.style]);
+    if (voice.medium) {
+        lines.push(MEDIUM_FRAMING[voice.medium]);
+    }
+    if (voice.formatting) {
+        lines.push(voice.formatting);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=voice.js.map

package/dist/core/voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/core/voice.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAA8B;IACnD,MAAM,EAAE,wCAAwC;IAChD,IAAI,EAAE,mBAAmB;IACzB,QAAQ,EAAE,qBAAqB;CAChC,CAAA;AAED,MAAM,kBAAkB,GAA+B;IACrD,QAAQ,EACN,qCAAqC;IACvC,KAAK,EACH,yBAAyB;CAC5B,CAAA;AAED,MAAM,cAAc,GAAgC;IAClD,aAAa,EAAE,kCAAkC;IACjD,eAAe,EAAE,+BAA+B;IAChD,aAAa,EAAE,uDAAuD;CACvE,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IACzC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAE3C,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IAC1C,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAC9B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/engine/chat.d.ts

@@ -0,0 +1,45 @@
+import type { PersonaConfig, ChatInput, ChatResult, ParsedAction, CrudAction, TurnTrace, TracedAction } from '../types.js';
+export declare function createTrace(options?: {
+    personaId?: string;
+    correlationId?: string;
+}): TurnTrace;
+export interface RawLLMResponse {
+    message: string;
+    actions?: Array<{
+        name: string;
+        params: Record<string, unknown>;
+    }>;
+    crudActions?: CrudAction[];
+    attachmentNotes?: string[];
+    followUps?: string[];
+    diagnostics?: string[];
+    outcomeNotes?: string[];
+    changes?: Array<{
+        action: string;
+        [key: string]: unknown;
+    }>;
+}
+export interface ParsedResponsePayload {
+    parsed: RawLLMResponse;
+    text: string;
+}
+export interface InvalidActionIssue {
+    name: string;
+    error: string;
+}
+/**
+ * Stateless chat — build prompt, call LLM, parse response.
+ * This is the Layer 1 core: no persistence, no side effects.
+ */
+export declare function chat(config: PersonaConfig, input: ChatInput): Promise<ChatResult>;
+export declare function normalizePlainTextResponse(text: string): string;
+/**
+ * Parse LLM response text into a ChatResult.
+ */
+export declare function parseRawResponse(text: string): ParsedResponsePayload | null;
+export declare function validateActions(parsed: RawLLMResponse, config: PersonaConfig): {
+    actions: ParsedAction[];
+    invalid: InvalidActionIssue[];
+    traced: TracedAction[];
+};
+//# sourceMappingURL=chat.d.ts.map

package/dist/engine/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/engine/chat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAgB,SAAS,EAAE,YAAY,EAA0D,MAAM,aAAa,CAAA;AAKhM,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAe/F;AA2BD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAA;IAClE,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IAEvB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAA;CAC5D;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,cAAc,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAYD;;;GAGG;AACH,wBAAsB,IAAI,CACxB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,UAAU,CAAC,CAsIrB;AAQD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAS3E;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,aAAa,GACpB;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAA;CAAE,CAqDpF"}

package/dist/engine/chat.js

@@ -0,0 +1,308 @@
+import { createHash } from 'node:crypto';
+import { applyActionsToWorkingSet, summarizeWorkingSet, usesWorkingSet } from './working-set.js';
+import { separateCrudActions, validateAndTraceCrud } from './crud.js';
+import { buildChatLLMRequest } from '../core/request-builder.js';
+export function createTrace(options) {
+    return {
+        traceId: typeof crypto !== 'undefined' && crypto.randomUUID ? crypto.randomUUID() : `trace-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        personaId: options?.personaId,
+        correlationId: options?.correlationId,
+        startedAt: Date.now(),
+        parseOk: false,
+        repairAttempted: false,
+        actions: [],
+        crudActions: [],
+        executionResults: [],
+        domainActions: [],
+        outcomeNotes: [],
+        errors: [],
+    };
+}
+function sha256(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+function traceLLMRequest(request) {
+    return {
+        systemPrompt: request.systemPrompt,
+        history: request.history,
+        message: request.message,
+        ...(request.responseSchema ? { responseSchema: request.responseSchema } : {}),
+        ...(request.attachments?.length
+            ? {
+                attachments: request.attachments.map(att => ({
+                    type: att.type,
+                    mimeType: att.mimeType,
+                    dataSha256: sha256(att.data),
+                    dataLength: att.data.length,
+                })),
+            }
+            : {}),
+        ...(typeof request.promptMode === 'string' ? { promptMode: request.promptMode } : {}),
+        ...(typeof request.promptOrigin === 'string' ? { promptOrigin: request.promptOrigin } : {}),
+    };
+}
+const MAX_ACTION_REPAIR_ATTEMPTS = 1;
+function collectRawContractDrift(parsed) {
+    const issues = [];
+    if (parsed.crudActions?.length) {
+        issues.push('Raw response used legacy top-level "crudActions" key; use actions[{ "name": "crud", ... }] instead.');
+    }
+    return issues;
+}
+/**
+ * Stateless chat — build prompt, call LLM, parse response.
+ * This is the Layer 1 core: no persistence, no side effects.
+ */
+export async function chat(config, input) {
+    const { effectiveConfig, request } = buildChatLLMRequest(config, input);
+    const trace = createTrace({ personaId: input.personaId, correlationId: input.correlationId });
+    trace.llmRequest = traceLLMRequest(request);
+    const response = await effectiveConfig.provider.chat(request);
+    trace.provider = {
+        name: effectiveConfig.provider.name,
+        ...(response.requestedModel ? { requestedModel: response.requestedModel } : {}),
+        ...(response.model ? { model: response.model } : {}),
+        ...(response.requestFingerprint ? { requestFingerprint: response.requestFingerprint } : {}),
+        ...(response.attempts ? { attempts: response.attempts } : {}),
+    };
+    // 4. Parse response
+    const initial = parseRawResponse(response.text);
+    if (!initial) {
+        trace.parseOk = false;
+        trace.errors.push('Failed to parse LLM response as JSON');
+        console.warn('[archetype] Failed to parse LLM response as JSON, using as plain message');
+        return {
+            message: normalizePlainTextResponse(response.text),
+            actions: [],
+            raw: response.text,
+            trace,
+        };
+    }
+    trace.parseOk = true;
+    let finalPayload = initial;
+    let validation = validateActions(initial.parsed, effectiveConfig);
+    trace.actions = validation.traced;
+    if (validation.invalid.length > 0 && MAX_ACTION_REPAIR_ATTEMPTS > 0) {
+        trace.repairAttempted = true;
+        const repaired = await retryInvalidActions({
+            config: effectiveConfig,
+            input,
+            history: request.history,
+            systemPrompt: request.systemPrompt,
+            responseSchema: request.responseSchema ?? {},
+            initialText: response.text,
+            invalid: validation.invalid,
+        });
+        if (repaired) {
+            finalPayload = repaired;
+            validation = validateActions(repaired.parsed, effectiveConfig);
+            trace.actions = validation.traced.map(a => a.status === 'valid' && validation.invalid.every(inv => inv.name !== a.name) ? a
+                : a.status === 'valid' ? { ...a, status: 'repaired' } : a);
+            trace.repairSucceeded = validation.invalid.length === 0;
+            // If repair still produced invalid actions, surface them on trace.errors
+            // so auditTraceIntegrity can see the failure — not just console.warn.
+            if (!trace.repairSucceeded) {
+                for (const inv of validation.invalid) {
+                    trace.errors.push(`Repair attempt did not fix action "${inv.name}": ${inv.error}`);
+                }
+            }
+        }
+        else {
+            trace.repairSucceeded = false;
+            trace.errors.push('Repair attempt failed to produce a parsable response');
+        }
+    }
+    trace.errors.push(...collectRawContractDrift(finalPayload.parsed));
+    // Normalize message — LLM occasionally returns an array instead of a string
+    const rawMsg = finalPayload.parsed.message;
+    const message = Array.isArray(rawMsg) ? rawMsg.join('\n') : (rawMsg ?? '');
+    // Extract diagnostics (only when enabled)
+    const diagnostics = config.diagnostics?.enabled
+        ? normalizeStringArray(finalPayload.parsed.diagnostics)
+        : undefined;
+    const outcomeNotes = normalizeStringArray(finalPayload.parsed.outcomeNotes);
+    const { crudActions: rawCrud, nonCrudActions } = separateCrudActions(validation.actions, finalPayload.parsed.crudActions);
+    const crudActions = effectiveConfig.entities ? validateAndTraceCrud(rawCrud, effectiveConfig.entities, trace) : undefined;
+    // Only include outcome notes on the public ChatResult when at least one
+    // action or CRUD passed validation — callers filtering on "executed
+    // actions happened" shouldn't see phantom outcomes.
+    // BUT: the raw AI-written outcome notes still go on the trace so
+    // debugging and auditTraceIntegrity can see what the model claimed.
+    const hasValidActions = nonCrudActions.length > 0 || (crudActions && crudActions.length > 0);
+    const effectiveOutcomeNotes = hasValidActions ? outcomeNotes : undefined;
+    if (outcomeNotes)
+        trace.outcomeNotes = outcomeNotes;
+    // CRUD validation gate: if provided, validate proposals and retry on failure
+    if (input.crudValidation && crudActions && crudActions.length > 0) {
+        const validationErrors = input.crudValidation(crudActions);
+        if (validationErrors && validationErrors.length > 0) {
+            trace.errors.push(...validationErrors.map(e => `CRUD validation rejected: ${e}`));
+            const maxRetries = input.crudValidationRetries ?? 1;
+            if (maxRetries > 0) {
+                const retryMessage = `Your response had CRUD validation errors:\n${validationErrors.map(e => `- ${e}`).join('\n')}\n\nPlease correct and resubmit.`;
+                const retryResult = await chat(config, {
+                    ...input,
+                    message: retryMessage,
+                    history: [
+                        ...(input.history ?? []),
+                        { role: 'user', content: input.message },
+                        { role: 'assistant', content: message },
+                    ],
+                    crudValidationRetries: maxRetries - 1,
+                });
+                return retryResult;
+            }
+        }
+    }
+    return {
+        message,
+        actions: nonCrudActions,
+        crudActions,
+        attachmentNotes: normalizeStringArray(finalPayload.parsed.attachmentNotes),
+        followUps: finalPayload.parsed.followUps,
+        ...(usesWorkingSet(effectiveConfig)
+            ? (() => {
+                const workingSet = applyActionsToWorkingSet(input.workingSet, validation.actions, effectiveConfig.actions);
+                return {
+                    workingSet,
+                    workingSetSummary: summarizeWorkingSet(workingSet),
+                };
+            })()
+            : {}),
+        diagnostics,
+        outcomeNotes: effectiveOutcomeNotes,
+        raw: finalPayload.text,
+        trace,
+    };
+}
+function normalizeStringArray(values) {
+    if (!values)
+        return undefined;
+    const normalized = [...new Set(values.map(value => value.trim()).filter(Boolean))];
+    return normalized.length > 0 ? normalized : undefined;
+}
+export function normalizePlainTextResponse(text) {
+    const trimmed = text.trim();
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed === 'string')
+            return parsed;
+        if (Array.isArray(parsed))
+            return parsed.map(item => String(item)).join('\n');
+        if (parsed && typeof parsed === 'object') {
+            if ('greeting' in parsed)
+                return normalizePlainTextResponse(String(parsed.greeting ?? ''));
+            if ('message' in parsed)
+                return normalizePlainTextResponse(String(parsed.message ?? ''));
+            if ('text' in parsed)
+                return normalizePlainTextResponse(String(parsed.text ?? ''));
+        }
+    }
+    catch {
+        // Plain text is the happy path.
+    }
+    return trimmed;
+}
+/**
+ * Parse LLM response text into a ChatResult.
+ */
+export function parseRawResponse(text) {
+    try {
+        return {
+            parsed: JSON.parse(text),
+            text,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function validateActions(parsed, config) {
+    const definedActions = config.actions ?? {};
+    const rawActions = parsed.actions ?? [];
+    const actions = [];
+    const invalid = [];
+    const traced = [];
+    for (const action of rawActions) {
+        // Pass through crud actions — they're extracted and validated separately
+        if (action.name === 'crud') {
+            let params = action.params ?? {};
+            if (typeof params === 'string') {
+                try {
+                    params = JSON.parse(params);
+                }
+                catch { /* leave as-is */ }
+            }
+            actions.push({
+                name: 'crud',
+                params: params,
+                confidence: 'low',
+            });
+            continue;
+        }
+        if (!(action.name in definedActions)) {
+            traced.push({ name: action.name, params: action.params, status: 'unknown_action' });
+            continue;
+        }
+        // Gemini sometimes returns params as a JSON string instead of an object
+        let params = action.params ?? {};
+        if (typeof params === 'string') {
+            try {
+                params = JSON.parse(params);
+            }
+            catch { /* leave as-is — Zod will reject */ }
+        }
+        const parseResult = definedActions[action.name].schema.safeParse(params);
+        if (!parseResult.success) {
+            invalid.push({
+                name: action.name,
+                error: parseResult.error.message,
+            });
+            traced.push({ name: action.name, params: action.params, status: 'invalid', error: parseResult.error.message });
+            continue;
+        }
+        actions.push({
+            name: action.name,
+            params: parseResult.data,
+            confidence: definedActions[action.name].confidence,
+        });
+        traced.push({ name: action.name, params: parseResult.data, status: 'valid' });
+    }
+    return { actions, invalid, traced };
+}
+async function retryInvalidActions(args) {
+    const { config, input, history, systemPrompt, responseSchema, initialText, invalid } = args;
+    console.warn(`[archetype] Retrying response because ${invalid.length} action(s) had invalid params: ${invalid.map(item => item.name).join(', ')}`);
+    const repairMessage = [
+        'Your previous response included invalid action params.',
+        'Return the FULL response again as valid JSON.',
+        'Keep the same user intent and overall meaning.',
+        'If an action is not actually warranted, remove it instead of guessing missing fields.',
+        '',
+        `Original user message: ${input.message}`,
+        '',
+        'Previous response JSON:',
+        initialText,
+        '',
+        'Invalid actions:',
+        ...invalid.map(item => `- ${item.name}: ${item.error}`),
+    ].join('\n');
+    const retry = await config.provider.chat({
+        systemPrompt,
+        history,
+        message: repairMessage,
+        responseSchema,
+        attachments: input.attachments,
+    });
+    const repaired = parseRawResponse(retry.text);
+    if (!repaired) {
+        console.warn('[archetype] Failed to parse repair response as JSON; keeping original valid subset');
+        return null;
+    }
+    const repairedValidation = validateActions(repaired.parsed, config);
+    if (repairedValidation.invalid.length > 0) {
+        console.warn(`[archetype] Repair response still had invalid action params: ${repairedValidation.invalid.map(item => item.name).join(', ')}`);
+    }
+    return repaired;
+}
+//# sourceMappingURL=chat.js.map