ns-kiro-core 0.1.0

package/dist/event-parser.d.ts

@@ -0,0 +1,49 @@
+export type KiroWireEvent = {
+    type: "content";
+    data: string;
+} | {
+    type: "thinkingText";
+    data: string;
+} | {
+    type: "thinkingSignature";
+    data: string;
+} | {
+    type: "toolUse";
+    data: {
+        name: string;
+        toolUseId: string;
+        input: string;
+        stop?: boolean;
+    };
+} | {
+    type: "toolUseInput";
+    data: {
+        input: string;
+    };
+} | {
+    type: "toolUseStop";
+    data: {
+        stop: boolean;
+    };
+} | {
+    type: "contextUsage";
+    data: {
+        contextUsagePercentage: number;
+    };
+} | {
+    type: "followupPrompt";
+    data: string;
+} | {
+    type: "usage";
+    data: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+} | {
+    type: "error";
+    data: {
+        error: string;
+        message?: string;
+    };
+};
+export declare function parseKiroEvent(parsed: Record<string, unknown>): KiroWireEvent | null;

package/dist/event-parser.js

@@ -0,0 +1,56 @@
+// ABOUTME: Kiro stream event type definitions and JSON-to-typed-event mapping.
+// ABOUTME: Binary framing is handled by @smithy/core EventStreamMarshaller in stream.ts.
+// Named `KiroWireEvent` to keep it distinct from `KiroStreamEvent`, which is what
+// this package emits outward after parsing.
+export function parseKiroEvent(parsed) {
+    if (parsed.content !== undefined)
+        return { type: "content", data: parsed.content };
+    if (typeof parsed.text === "string")
+        return { type: "thinkingText", data: parsed.text };
+    if (typeof parsed.signature === "string")
+        return { type: "thinkingSignature", data: parsed.signature };
+    if (parsed.name && parsed.toolUseId) {
+        const input = typeof parsed.input === "string"
+            ? parsed.input
+            : parsed.input &&
+                typeof parsed.input === "object" &&
+                Object.keys(parsed.input).length > 0
+                ? JSON.stringify(parsed.input)
+                : "";
+        return {
+            type: "toolUse",
+            data: {
+                name: parsed.name,
+                toolUseId: parsed.toolUseId,
+                input,
+                stop: parsed.stop,
+            },
+        };
+    }
+    if (parsed.input !== undefined && !parsed.name) {
+        return {
+            type: "toolUseInput",
+            data: { input: typeof parsed.input === "string" ? parsed.input : JSON.stringify(parsed.input) },
+        };
+    }
+    if (parsed.stop !== undefined && parsed.contextUsagePercentage === undefined)
+        return { type: "toolUseStop", data: { stop: parsed.stop } };
+    if (parsed.contextUsagePercentage !== undefined)
+        return { type: "contextUsage", data: { contextUsagePercentage: parsed.contextUsagePercentage } };
+    if (parsed.followupPrompt !== undefined)
+        return { type: "followupPrompt", data: parsed.followupPrompt };
+    if (parsed.error !== undefined || parsed.Error !== undefined) {
+        const error = (parsed.error || parsed.Error || "unknown");
+        const message = (parsed.message || parsed.Message || parsed.reason);
+        return { type: "error", data: { error: typeof error === "string" ? error : JSON.stringify(error), message } };
+    }
+    if (parsed.usage !== undefined) {
+        const u = parsed.usage;
+        return {
+            type: "usage",
+            data: { inputTokens: u.inputTokens, outputTokens: u.outputTokens },
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=event-parser.js.map

package/dist/event-parser.js.map

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

package/dist/history-validator.d.ts

@@ -0,0 +1,91 @@
+import { type KiroHistoryEntry } from "./transform.js";
+/** Identifiers for the seven invariants. Names match kiro-agent's
+ *  `ValidationRule` enum so diagnostics are greppable across both codebases. */
+export declare enum KiroValidationRule {
+    STARTS_WITH_USER_MESSAGE = "STARTS_WITH_USER_MESSAGE",
+    ENDS_WITH_USER_MESSAGE = "ENDS_WITH_USER_MESSAGE",
+    ALTERNATING_MESSAGES = "ALTERNATING_MESSAGES",
+    TOOL_USES_AND_RESULTS = "TOOL_USES_AND_RESULTS",
+    TOOL_RESULTS_AND_NO_USES = "TOOL_RESULTS_AND_NO_USES",
+    TOOL_RESULTS_ORPHAN_IDS = "TOOL_RESULTS_ORPHAN_IDS",
+    NON_EMPTY_USER_MESSAGE = "NON_EMPTY_USER_MESSAGE"
+}
+export declare const KIRO_VALIDATION_MESSAGES: Record<KiroValidationRule, string>;
+export interface KiroValidationError {
+    /** The invariant that was violated. */
+    rule: KiroValidationRule;
+    /** Human-readable description. */
+    message: string;
+    /** Index into the validated conversation where the violation was found. */
+    index: number;
+}
+export interface KiroValidationResult {
+    valid: boolean;
+    errors: KiroValidationError[];
+}
+/** The subset describing an unbalanced toolUse/toolResult turn — the shape the
+ *  backend rejects as `TOOL_USE_RESULT_MISMATCH`. Probed 2026-08-11: a history
+ *  whose final assistant `toolUse` has no matching `toolResult` returns
+ *  `400 {"reason":"TOOL_USE_RESULT_MISMATCH"}`. */
+export declare const KIRO_TOOL_STRUCTURE_RULES: readonly [KiroValidationRule.TOOL_USES_AND_RESULTS, KiroValidationRule.TOOL_RESULTS_AND_NO_USES, KiroValidationRule.TOOL_RESULTS_ORPHAN_IDS];
+export type KiroToolStructureRule = (typeof KIRO_TOOL_STRUCTURE_RULES)[number];
+export declare function isKiroToolStructureRule(rule: string): boolean;
+/** Text of the synthetic result substituted for a tool result the caller never
+ *  supplied. A pure function of nothing — same bytes every time, so a repaired
+ *  conversation is byte-stable across retries. */
+export declare const SYNTHETIC_FAILED_TOOL_RESULT_TEXT = "Tool use was interrupted and did not produce a result.";
+export declare function validateStartsWithUserMessage(entries: KiroHistoryEntry[]): KiroValidationError | null;
+export declare function validateEndsWithUserMessage(entries: KiroHistoryEntry[]): KiroValidationError | null;
+export declare function validateAlternatingMessages(entries: KiroHistoryEntry[]): KiroValidationError | null;
+export declare function validateToolUsesAndResults(entries: KiroHistoryEntry[]): KiroValidationError | null;
+export declare function validateToolResultOrphanIds(entries: KiroHistoryEntry[]): KiroValidationError | null;
+/** Content **or** tool results — not content unconditionally. This is the rule
+ *  that makes an empty `content` on a tool turn correct rather than malformed. */
+export declare function validateNonEmptyUserMessages(entries: KiroHistoryEntry[]): KiroValidationError | null;
+/** Only the three tool-structure rules, in the order `validateKiroConversation`
+ *  reports them. Cheaper than a full pass when only pairing matters. */
+export declare function validateKiroToolStructure(entries: KiroHistoryEntry[]): KiroValidationResult;
+/**
+ * Validates a whole conversation against all seven invariants.
+ *
+ * `entries` is the full conversation: the outbound `history` followed by the
+ * entry for `currentMessage`. Validating history alone would report a spurious
+ * `ENDS_WITH_USER_MESSAGE` — this provider's history deliberately ends on the
+ * assistant turn whose tool uses the current message answers. Use
+ * {@link kiroConversationEntries} to build the array.
+ */
+export declare function validateKiroConversation(entries: KiroHistoryEntry[]): KiroValidationResult;
+/** Assembles the conversation this provider actually sends: history plus the
+ *  current user message. */
+export declare function kiroConversationEntries(history: KiroHistoryEntry[], currentUserMessage: KiroHistoryEntry["userInputMessage"]): KiroHistoryEntry[];
+export interface KiroRepairResult {
+    /** The repaired conversation. */
+    entries: KiroHistoryEntry[];
+    /** Violations found in the input, before repair. Empty when it was valid. */
+    diagnostics: KiroValidationError[];
+    /** Violations still present after repair. Non-empty means a shape this
+     *  repair pass cannot express — report it rather than silently sending. */
+    remaining: KiroValidationError[];
+}
+/**
+ * Validates and repairs, rather than throwing. Mirrors what kiro-agent's
+ * sanitizer does, in this provider's terms:
+ *
+ * 1. Drop leading entries until the conversation starts with a user message
+ *    that is not a bare tool-result carrier.
+ * 2. Consolidate runs of adjacent tool-result-only user messages into one.
+ *    This runs **before** orphan-stripping on purpose: a run's later carriers
+ *    are preceded by a user entry, not the assistant that issued the tool uses,
+ *    so stripping first would judge their results orphaned and discard real
+ *    tool output.
+ * 3. Strip orphaned and duplicate `toolResults`.
+ * 4. Synthesize an ERROR tool result for every assistant `toolUse` still
+ *    unanswered.
+ * 5. Give a user message that has neither text nor tool results the neutral
+ *    {@link EMPTY_CONTENT_PLACEHOLDER}.
+ *
+ * A repaired conversation is not guaranteed valid: an input that alternates
+ * incorrectly for reasons outside these five shapes is reported in
+ * `remaining`. Callers log it; nothing here throws.
+ */
+export declare function repairKiroConversation(entries: KiroHistoryEntry[]): KiroRepairResult;

package/dist/history-validator.js

@@ -0,0 +1,370 @@
+// Feature 11: Conversation History Validation
+//
+// The seven invariants first-party Kiro Agent enforces on a conversation before
+// sending it, ported to this provider's request shape.
+//
+// Reference: `packages/kiro-agent/src/utils/message-history-sanitizer/`
+// (`errors.ts` for the rule set, `validator.ts` for the checks, `sanitizer.ts`
+// for the repairs). Only the validation is ported — kiro-agent's sanitizer is
+// coupled to LangChain message types this provider does not use.
+//
+// This provider previously enforced none of these, relying instead on
+// structural merging in `buildHistory` plus the salvage passes in `history.ts`.
+// Repair, not rejection, is the default: failing closed on a history a caller
+// has already built would be a behavior change for existing consumers, so
+// `repairKiroConversation` returns a corrected conversation plus diagnostics
+// and callers decide whether to care.
+import { EMPTY_CONTENT_PLACEHOLDER } from "./transform.js";
+/** Identifiers for the seven invariants. Names match kiro-agent's
+ *  `ValidationRule` enum so diagnostics are greppable across both codebases. */
+export var KiroValidationRule;
+(function (KiroValidationRule) {
+    KiroValidationRule["STARTS_WITH_USER_MESSAGE"] = "STARTS_WITH_USER_MESSAGE";
+    KiroValidationRule["ENDS_WITH_USER_MESSAGE"] = "ENDS_WITH_USER_MESSAGE";
+    KiroValidationRule["ALTERNATING_MESSAGES"] = "ALTERNATING_MESSAGES";
+    KiroValidationRule["TOOL_USES_AND_RESULTS"] = "TOOL_USES_AND_RESULTS";
+    KiroValidationRule["TOOL_RESULTS_AND_NO_USES"] = "TOOL_RESULTS_AND_NO_USES";
+    KiroValidationRule["TOOL_RESULTS_ORPHAN_IDS"] = "TOOL_RESULTS_ORPHAN_IDS";
+    KiroValidationRule["NON_EMPTY_USER_MESSAGE"] = "NON_EMPTY_USER_MESSAGE";
+})(KiroValidationRule || (KiroValidationRule = {}));
+export const KIRO_VALIDATION_MESSAGES = {
+    [KiroValidationRule.STARTS_WITH_USER_MESSAGE]: "Conversation must start with a user message",
+    [KiroValidationRule.ENDS_WITH_USER_MESSAGE]: "Conversation must end with a user message",
+    [KiroValidationRule.ALTERNATING_MESSAGES]: "Between every two user messages there must be an assistant message",
+    [KiroValidationRule.TOOL_USES_AND_RESULTS]: "If an assistant message has tool uses, the next message must be a user message with corresponding tool results",
+    [KiroValidationRule.TOOL_RESULTS_AND_NO_USES]: "If there is a message with tool result, there has to be a corresponding message with tool use.",
+    [KiroValidationRule.NON_EMPTY_USER_MESSAGE]: "User messages must have either content or tool results",
+    [KiroValidationRule.TOOL_RESULTS_ORPHAN_IDS]: "User message has toolResults whose toolUseIds do not match any toolUse in the preceding assistant message.",
+};
+/** The subset describing an unbalanced toolUse/toolResult turn — the shape the
+ *  backend rejects as `TOOL_USE_RESULT_MISMATCH`. Probed 2026-08-11: a history
+ *  whose final assistant `toolUse` has no matching `toolResult` returns
+ *  `400 {"reason":"TOOL_USE_RESULT_MISMATCH"}`. */
+export const KIRO_TOOL_STRUCTURE_RULES = [
+    KiroValidationRule.TOOL_USES_AND_RESULTS,
+    KiroValidationRule.TOOL_RESULTS_AND_NO_USES,
+    KiroValidationRule.TOOL_RESULTS_ORPHAN_IDS,
+];
+export function isKiroToolStructureRule(rule) {
+    return KIRO_TOOL_STRUCTURE_RULES.includes(rule);
+}
+/** Text of the synthetic result substituted for a tool result the caller never
+ *  supplied. A pure function of nothing — same bytes every time, so a repaired
+ *  conversation is byte-stable across retries. */
+export const SYNTHETIC_FAILED_TOOL_RESULT_TEXT = "Tool use was interrupted and did not produce a result.";
+function error(rule, index, message) {
+    return { rule, message: message ?? KIRO_VALIDATION_MESSAGES[rule], index };
+}
+function isUserEntry(entry) {
+    return !!entry?.userInputMessage;
+}
+function isAssistantEntry(entry) {
+    return !!entry?.assistantResponseMessage;
+}
+function toolResultsOf(entry) {
+    return entry?.userInputMessage?.userInputMessageContext?.toolResults ?? [];
+}
+function hasToolResults(entry) {
+    return toolResultsOf(entry).length > 0;
+}
+function toolUseIdsOf(entry) {
+    return (entry?.assistantResponseMessage?.toolUses ?? []).map((tu) => tu.toolUseId).filter(Boolean);
+}
+function hasToolUses(entry) {
+    return toolUseIdsOf(entry).length > 0;
+}
+function hasText(entry) {
+    return (entry?.userInputMessage?.content ?? "").trim() !== "";
+}
+/** True when every toolUse has a result and every result has a toolUse. */
+function toolResultsMatch(toolUseIds, toolResults) {
+    if (toolUseIds.length === 0)
+        return true;
+    if (toolResults.length === 0)
+        return false;
+    const resultIds = new Set(toolResults.map((tr) => tr.toolUseId));
+    const useIds = new Set(toolUseIds);
+    return toolUseIds.every((id) => resultIds.has(id)) && toolResults.every((tr) => useIds.has(tr.toolUseId));
+}
+// ---------------------------------------------------------------------------
+// Individual rule checks. Each returns the first violation it finds, or null.
+// ---------------------------------------------------------------------------
+export function validateStartsWithUserMessage(entries) {
+    if (entries.length === 0 || !isUserEntry(entries[0])) {
+        return error(KiroValidationRule.STARTS_WITH_USER_MESSAGE, 0);
+    }
+    return null;
+}
+export function validateEndsWithUserMessage(entries) {
+    if (entries.length === 0 || !isUserEntry(entries[entries.length - 1])) {
+        return error(KiroValidationRule.ENDS_WITH_USER_MESSAGE, entries.length - 1);
+    }
+    return null;
+}
+export function validateAlternatingMessages(entries) {
+    for (let i = 1; i < entries.length; i++) {
+        if (isUserEntry(entries[i - 1]) && isUserEntry(entries[i])) {
+            return error(KiroValidationRule.ALTERNATING_MESSAGES, i, "Between every two user messages there must be an assistant message");
+        }
+        if (isAssistantEntry(entries[i - 1]) && isAssistantEntry(entries[i])) {
+            return error(KiroValidationRule.ALTERNATING_MESSAGES, i, "Between every two assistant messages there must be a user message");
+        }
+    }
+    return null;
+}
+export function validateToolUsesAndResults(entries) {
+    for (let i = 0; i < entries.length - 1; i++) {
+        const current = entries[i];
+        const next = entries[i + 1];
+        if (isAssistantEntry(current) &&
+            hasToolUses(current) &&
+            (!isUserEntry(next) || !toolResultsMatch(toolUseIdsOf(current), toolResultsOf(next)))) {
+            return error(KiroValidationRule.TOOL_USES_AND_RESULTS, i + 1);
+        }
+        if (isAssistantEntry(current) && !hasToolUses(current) && isUserEntry(next) && hasToolResults(next)) {
+            return error(KiroValidationRule.TOOL_RESULTS_AND_NO_USES, i);
+        }
+    }
+    // A carrier with no assistant predecessor at all — first entry, or preceded by
+    // another user entry. The pairwise walk above cannot see it: it only inspects
+    // a carrier that follows an assistant entry. kiro-agent never reaches this
+    // shape because its sanitizer drops leading carriers before validating, but
+    // this provider can send one as the *current* message: `prepareHistory`
+    // guarantees every carrier inside `history` has an assistant-with-toolUses
+    // predecessor (`sanitizeHistory` drops the rest, `injectSyntheticToolCalls`
+    // synthesizes uses for orphans), and the current message is assembled after
+    // that pass. Probed 2026-08-11: a lone current-turn carrier reached the wire
+    // with `toolResults` and no `toolUse` anywhere while this check stayed silent.
+    for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        if (!isUserEntry(entry) || !hasToolResults(entry))
+            continue;
+        const prev = i > 0 ? entries[i - 1] : undefined;
+        if (!isAssistantEntry(prev))
+            return error(KiroValidationRule.TOOL_RESULTS_AND_NO_USES, i);
+    }
+    return null;
+}
+export function validateToolResultOrphanIds(entries) {
+    for (let i = 1; i < entries.length; i++) {
+        const prev = entries[i - 1];
+        const current = entries[i];
+        if (!isAssistantEntry(prev) || !hasToolUses(prev) || !isUserEntry(current) || !hasToolResults(current))
+            continue;
+        const validIds = new Set(toolUseIdsOf(prev));
+        const toolResults = toolResultsOf(current);
+        const hasOrphan = toolResults.some((tr) => !tr.toolUseId || !validIds.has(tr.toolUseId));
+        const seen = new Set();
+        const hasDuplicate = toolResults.some((tr) => {
+            if (!tr.toolUseId)
+                return false;
+            if (seen.has(tr.toolUseId))
+                return true;
+            seen.add(tr.toolUseId);
+            return false;
+        });
+        if (hasOrphan || hasDuplicate)
+            return error(KiroValidationRule.TOOL_RESULTS_ORPHAN_IDS, i);
+    }
+    return null;
+}
+/** Content **or** tool results — not content unconditionally. This is the rule
+ *  that makes an empty `content` on a tool turn correct rather than malformed. */
+export function validateNonEmptyUserMessages(entries) {
+    for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        if (!isUserEntry(entry))
+            continue;
+        if (!hasText(entry) && !hasToolResults(entry)) {
+            return error(KiroValidationRule.NON_EMPTY_USER_MESSAGE, i);
+        }
+    }
+    return null;
+}
+/** Only the three tool-structure rules, in the order `validateKiroConversation`
+ *  reports them. Cheaper than a full pass when only pairing matters. */
+export function validateKiroToolStructure(entries) {
+    const errors = [validateToolUsesAndResults(entries), validateToolResultOrphanIds(entries)].filter((e) => e !== null);
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validates a whole conversation against all seven invariants.
+ *
+ * `entries` is the full conversation: the outbound `history` followed by the
+ * entry for `currentMessage`. Validating history alone would report a spurious
+ * `ENDS_WITH_USER_MESSAGE` — this provider's history deliberately ends on the
+ * assistant turn whose tool uses the current message answers. Use
+ * {@link kiroConversationEntries} to build the array.
+ */
+export function validateKiroConversation(entries) {
+    const errors = [
+        validateStartsWithUserMessage(entries),
+        validateEndsWithUserMessage(entries),
+        validateAlternatingMessages(entries),
+        ...validateKiroToolStructure(entries).errors,
+        validateNonEmptyUserMessages(entries),
+    ].filter((e) => e !== null);
+    return { valid: errors.length === 0, errors };
+}
+/** Assembles the conversation this provider actually sends: history plus the
+ *  current user message. */
+export function kiroConversationEntries(history, currentUserMessage) {
+    return currentUserMessage ? [...history, { userInputMessage: currentUserMessage }] : [...history];
+}
+/**
+ * Validates and repairs, rather than throwing. Mirrors what kiro-agent's
+ * sanitizer does, in this provider's terms:
+ *
+ * 1. Drop leading entries until the conversation starts with a user message
+ *    that is not a bare tool-result carrier.
+ * 2. Consolidate runs of adjacent tool-result-only user messages into one.
+ *    This runs **before** orphan-stripping on purpose: a run's later carriers
+ *    are preceded by a user entry, not the assistant that issued the tool uses,
+ *    so stripping first would judge their results orphaned and discard real
+ *    tool output.
+ * 3. Strip orphaned and duplicate `toolResults`.
+ * 4. Synthesize an ERROR tool result for every assistant `toolUse` still
+ *    unanswered.
+ * 5. Give a user message that has neither text nor tool results the neutral
+ *    {@link EMPTY_CONTENT_PLACEHOLDER}.
+ *
+ * A repaired conversation is not guaranteed valid: an input that alternates
+ * incorrectly for reasons outside these five shapes is reported in
+ * `remaining`. Callers log it; nothing here throws.
+ */
+export function repairKiroConversation(entries) {
+    const diagnostics = validateKiroConversation(entries).errors;
+    if (diagnostics.length === 0)
+        return { entries, diagnostics, remaining: [] };
+    // A synthesized user turn must declare the same model as its neighbours.
+    const modelId = entries.find((e) => e.userInputMessage?.modelId)?.userInputMessage?.modelId ?? "";
+    // 1. Leading entries that cannot start a conversation.
+    let working = [...entries];
+    while (working.length > 0 && (!isUserEntry(working[0]) || hasToolResults(working[0])))
+        working = working.slice(1);
+    // 2. Consolidate adjacent tool-result-only user messages. Must precede the
+    //    orphan pass: a later carrier in such a run is preceded by a user entry,
+    //    whose toolUse id set is empty, so orphan-stripping would delete its real
+    //    results and leave synthesis to substitute failure text for output the
+    //    caller actually had.
+    const consolidated = [];
+    for (let i = 0; i < working.length; i++) {
+        const entry = working[i];
+        const isToolOnly = isUserEntry(entry) && hasToolResults(entry) && !hasText(entry);
+        if (!isToolOnly) {
+            consolidated.push(entry);
+            continue;
+        }
+        let j = i;
+        const merged = [];
+        const seen = new Set();
+        while (j < working.length) {
+            const candidate = working[j];
+            if (!(isUserEntry(candidate) && hasToolResults(candidate) && !hasText(candidate)))
+                break;
+            for (const tr of toolResultsOf(candidate)) {
+                if (tr.toolUseId && seen.has(tr.toolUseId))
+                    continue;
+                if (tr.toolUseId)
+                    seen.add(tr.toolUseId);
+                merged.push(tr);
+            }
+            j++;
+        }
+        if (j - i === 1) {
+            consolidated.push(entry);
+        }
+        else {
+            const uim = entry.userInputMessage;
+            consolidated.push({
+                userInputMessage: {
+                    ...uim,
+                    userInputMessageContext: { ...uim.userInputMessageContext, toolResults: merged },
+                },
+            });
+        }
+        i = j - 1;
+    }
+    working = consolidated;
+    // 3 + 4. Walk pairs, fixing tool structure in both directions.
+    const repaired = [];
+    for (let i = 0; i < working.length; i++) {
+        const entry = working[i];
+        if (isUserEntry(entry) && hasToolResults(entry)) {
+            const prev = repaired[repaired.length - 1];
+            const validIds = new Set(toolUseIdsOf(prev));
+            const seen = new Set();
+            const kept = toolResultsOf(entry).filter((tr) => {
+                if (!tr.toolUseId || !validIds.has(tr.toolUseId) || seen.has(tr.toolUseId))
+                    return false;
+                seen.add(tr.toolUseId);
+                return true;
+            });
+            const uim = { ...entry.userInputMessage };
+            if (kept.length === 0) {
+                const { userInputMessageContext, ...rest } = uim;
+                const tools = userInputMessageContext?.tools;
+                repaired.push({
+                    userInputMessage: { ...rest, ...(tools ? { userInputMessageContext: { tools } } : {}) },
+                });
+            }
+            else {
+                repaired.push({
+                    userInputMessage: {
+                        ...uim,
+                        userInputMessageContext: { ...uim.userInputMessageContext, toolResults: kept },
+                    },
+                });
+            }
+            continue;
+        }
+        repaired.push(entry);
+        // 4. Assistant toolUses the next entry does not answer.
+        if (isAssistantEntry(entry) && hasToolUses(entry)) {
+            const next = working[i + 1];
+            const answered = new Set(isUserEntry(next) ? toolResultsOf(next).map((tr) => tr.toolUseId) : /* c8 ignore next */ []);
+            const unanswered = toolUseIdsOf(entry).filter((id) => !answered.has(id));
+            if (unanswered.length > 0 && !isUserEntry(next)) {
+                // No user turn follows at all: insert one carrying every result.
+                repaired.push(syntheticToolResultEntry(unanswered, modelId));
+            }
+            else if (unanswered.length > 0 && isUserEntry(next)) {
+                // A user turn follows but under-answers: top it up in place.
+                const uim = { ...next.userInputMessage };
+                working[i + 1] = {
+                    userInputMessage: {
+                        ...uim,
+                        userInputMessageContext: {
+                            ...uim.userInputMessageContext,
+                            toolResults: [...toolResultsOf(next), ...unanswered.map(syntheticFailedToolResult)],
+                        },
+                    },
+                };
+            }
+        }
+    }
+    // 5. Neither text nor tool results — give it the neutral prompt.
+    const final = repaired.map((entry) => {
+        if (!isUserEntry(entry) || hasText(entry) || hasToolResults(entry))
+            return entry;
+        const uim = entry.userInputMessage;
+        return { userInputMessage: { ...uim, content: EMPTY_CONTENT_PLACEHOLDER } };
+    });
+    return { entries: final, diagnostics, remaining: validateKiroConversation(final).errors };
+}
+function syntheticFailedToolResult(toolUseId) {
+    return { toolUseId, content: [{ text: SYNTHETIC_FAILED_TOOL_RESULT_TEXT }], status: "error" };
+}
+function syntheticToolResultEntry(toolUseIds, modelId) {
+    return {
+        userInputMessage: {
+            // Empty by design: `toolResults` is the payload. Matches kiro-agent's
+            // `FAILED_TOOL_USE_MESSAGE`, which also ships `content: ''`.
+            content: "",
+            modelId,
+            origin: "KIRO_CLI",
+            userInputMessageContext: { toolResults: toolUseIds.map(syntheticFailedToolResult) },
+        },
+    };
+}
+//# sourceMappingURL=history-validator.js.map

package/dist/history-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-validator.js","sourceRoot":"","sources":["../src/history-validator.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,EAAE;AACF,gFAAgF;AAChF,uDAAuD;AACvD,EAAE;AACF,wEAAwE;AACxE,+EAA+E;AAC/E,8EAA8E;AAC9E,iEAAiE;AACjE,EAAE;AACF,sEAAsE;AACtE,gFAAgF;AAChF,8EAA8E;AAC9E,0EAA0E;AAC1E,6EAA6E;AAC7E,sCAAsC;AAEtC,OAAO,EAAE,yBAAyB,EAA8C,MAAM,gBAAgB,CAAC;AAEvG;gFACgF;AAChF,MAAM,CAAN,IAAY,kBAQX;AARD,WAAY,kBAAkB;IAC5B,2EAAqD,CAAA;IACrD,uEAAiD,CAAA;IACjD,mEAA6C,CAAA;IAC7C,qEAA+C,CAAA;IAC/C,2EAAqD,CAAA;IACrD,yEAAmD,CAAA;IACnD,uEAAiD,CAAA;AACnD,CAAC,EARW,kBAAkB,KAAlB,kBAAkB,QAQ7B;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAuC;IAC1E,CAAC,kBAAkB,CAAC,wBAAwB,CAAC,EAAE,6CAA6C;IAC5F,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,EAAE,2CAA2C;IACxF,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,EAAE,oEAAoE;IAC/G,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,EACxC,gHAAgH;IAClH,CAAC,kBAAkB,CAAC,wBAAwB,CAAC,EAC3C,gGAAgG;IAClG,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,EAAE,wDAAwD;IACrG,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,EAC1C,4GAA4G;CAC/G,CAAC;AAgBF;;;mDAGmD;AACnD,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,kBAAkB,CAAC,qBAAqB;IACxC,kBAAkB,CAAC,wBAAwB;IAC3C,kBAAkB,CAAC,uBAAuB;CAClC,CAAC;AAIX,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAQ,yBAA+C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC;AAED;;kDAEkD;AAClD,MAAM,CAAC,MAAM,iCAAiC,GAAG,wDAAwD,CAAC;AAE1G,SAAS,KAAK,CAAC,IAAwB,EAAE,KAAa,EAAE,OAAgB;IACtE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,WAAW,CAAC,KAAmC;IACtD,OAAO,CAAC,CAAC,KAAK,EAAE,gBAAgB,CAAC;AACnC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAmC;IAC3D,OAAO,CAAC,CAAC,KAAK,EAAE,wBAAwB,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa,CAAC,KAAmC;IACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,WAAW,IAAI,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,cAAc,CAAC,KAAmC;IACzD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,KAAmC;IACvD,OAAO,CAAC,KAAK,EAAE,wBAAwB,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACrG,CAAC;AAED,SAAS,WAAW,CAAC,KAAmC;IACtD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,OAAO,CAAC,KAAmC;IAClD,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAChE,CAAC;AAED,2EAA2E;AAC3E,SAAS,gBAAgB,CAAC,UAAoB,EAAE,WAA6B;IAC3E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5G,CAAC;AAED,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAE9E,MAAM,UAAU,6BAA6B,CAAC,OAA2B;IACvE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC,kBAAkB,CAAC,wBAAwB,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAA2B;IACrE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC,kBAAkB,CAAC,sBAAsB,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAA2B;IACrE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,OAAO,KAAK,CACV,kBAAkB,CAAC,oBAAoB,EACvC,CAAC,EACD,oEAAoE,CACrE,CAAC;QACJ,CAAC;QACD,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,OAAO,KAAK,CACV,kBAAkB,CAAC,oBAAoB,EACvC,CAAC,EACD,mEAAmE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAA2B;IACpE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,IACE,gBAAgB,CAAC,OAAO,CAAC;YACzB,WAAW,CAAC,OAAO,CAAC;YACpB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EACrF,CAAC;YACD,OAAO,KAAK,CAAC,kBAAkB,CAAC,qBAAqB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YACpG,OAAO,KAAK,CAAC,kBAAkB,CAAC,wBAAwB,EAAE,CAAC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IACD,+EAA+E;IAC/E,8EAA8E;IAC9E,2EAA2E;IAC3E,4EAA4E;IAC5E,wEAAwE;IACxE,2EAA2E;IAC3E,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,+EAA+E;IAC/E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;YAAE,SAAS;QAC5D,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC,kBAAkB,CAAC,wBAAwB,EAAE,CAAC,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAA2B;IACrE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;YAAE,SAAS;QACjH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QACzF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;YAC3C,IAAI,CAAC,EAAE,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAC;YAChC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC;gBAAE,OAAO,IAAI,CAAC;YACxC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QACH,IAAI,SAAS,IAAI,YAAY;YAAE,OAAO,KAAK,CAAC,kBAAkB,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;kFACkF;AAClF,MAAM,UAAU,4BAA4B,CAAC,OAA2B;IACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,KAAK,CAAC,kBAAkB,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;wEACwE;AACxE,MAAM,UAAU,yBAAyB,CAAC,OAA2B;IACnE,MAAM,MAAM,GAAG,CAAC,0BAA0B,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAC/F,CAAC,CAAC,EAA4B,EAAE,CAAC,CAAC,KAAK,IAAI,CAC5C,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAA2B;IAClE,MAAM,MAAM,GAAG;QACb,6BAA6B,CAAC,OAAO,CAAC;QACtC,2BAA2B,CAAC,OAAO,CAAC;QACpC,2BAA2B,CAAC,OAAO,CAAC;QACpC,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC,MAAM;QAC5C,4BAA4B,CAAC,OAAO,CAAC;KACtC,CAAC,MAAM,CAAC,CAAC,CAAC,EAA4B,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IACtD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED;4BAC4B;AAC5B,MAAM,UAAU,uBAAuB,CACrC,OAA2B,EAC3B,kBAAwD;IAExD,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;AACpG,CAAC;AAYD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA2B;IAChE,MAAM,WAAW,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAC7D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAE7E,yEAAyE;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE,gBAAgB,EAAE,OAAO,IAAI,EAAE,CAAC;IAElG,uDAAuD;IACvD,IAAI,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAElH,2EAA2E;IAC3E,6EAA6E;IAC7E,8EAA8E;IAC9E,2EAA2E;IAC3E,0BAA0B;IAC1B,MAAM,YAAY,GAAuB,EAAE,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAClF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC7B,IAAI,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAAE,MAAM;YACzF,KAAK,MAAM,EAAE,IAAI,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1C,IAAI,EAAE,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC;oBAAE,SAAS;gBACrD,IAAI,EAAE,CAAC,SAAS;oBAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;gBACzC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;YACD,CAAC,EAAE,CAAC;QACN,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAChB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,KAAK,CAAC,gBAAqE,CAAC;YACxF,YAAY,CAAC,IAAI,CAAC;gBAChB,gBAAgB,EAAE;oBAChB,GAAG,GAAG;oBACN,uBAAuB,EAAE,EAAE,GAAG,GAAG,CAAC,uBAAuB,EAAE,WAAW,EAAE,MAAM,EAAE;iBACjF;aACF,CAAC,CAAC;QACL,CAAC;QACD,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,YAAY,CAAC;IAEvB,+DAA+D;IAC/D,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;gBAC9C,IAAI,CAAC,EAAE,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC;oBAAE,OAAO,KAAK,CAAC;gBACzF,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;gBACvB,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,GAAG,KAAK,CAAC,gBAAgB,EAAuD,CAAC;YAC/F,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,EAAE,uBAAuB,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;gBACjD,MAAM,KAAK,GAAG,uBAAuB,EAAE,KAAK,CAAC;gBAC7C,QAAQ,CAAC,IAAI,CAAC;oBACZ,gBAAgB,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,uBAAuB,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;iBACxF,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC;oBACZ,gBAAgB,EAAE;wBAChB,GAAG,GAAG;wBACN,uBAAuB,EAAE,EAAE,GAAG,GAAG,CAAC,uBAAuB,EAAE,WAAW,EAAE,IAAI,EAAE;qBAC/E;iBACF,CAAC,CAAC;YACL,CAAC;YACD,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,wDAAwD;QACxD,IAAI,gBAAgB,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAC5F,CAAC;YACF,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACzE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,iEAAiE;gBACjE,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YAC/D,CAAC;iBAAM,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtD,6DAA6D;gBAC7D,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,gBAAgB,EAAuD,CAAC;gBAC9F,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG;oBACf,gBAAgB,EAAE;wBAChB,GAAG,GAAG;wBACN,uBAAuB,EAAE;4BACvB,GAAG,GAAG,CAAC,uBAAuB;4BAC9B,WAAW,EAAE,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;yBACpF;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACnC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACjF,MAAM,GAAG,GAAG,KAAK,CAAC,gBAAqE,CAAC;QACxF,OAAO,EAAE,gBAAgB,EAAE,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,yBAAyB,EAAE,EAAE,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;AAC5F,CAAC;AAED,SAAS,yBAAyB,CAAC,SAAiB;IAClD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAChG,CAAC;AAED,SAAS,wBAAwB,CAAC,UAAoB,EAAE,OAAe;IACrE,OAAO;QACL,gBAAgB,EAAE;YAChB,sEAAsE;YACtE,6DAA6D;YAC7D,OAAO,EAAE,EAAE;YACX,OAAO;YACP,MAAM,EAAE,UAAU;YAClB,uBAAuB,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE;SACpF;KACF,CAAC;AACJ,CAAC"}

package/dist/history.d.ts

@@ -0,0 +1,21 @@
+import type { KiroHistoryEntry, KiroToolSpec } from "./transform.js";
+export declare const HISTORY_LIMIT = 850000;
+/** The context window size (in tokens) that HISTORY_LIMIT was calibrated for. */
+export declare const HISTORY_LIMIT_CONTEXT_WINDOW = 200000;
+/** Maximum combined base64 characters retained for one historical image-bearing turn. */
+export declare const HISTORY_IMAGE_BASE64_LIMIT: number;
+/**
+ * Keep at most the newest bounded image-bearing history entry.
+ *
+ * Older images are removed to bound request growth. If the newest image set is
+ * itself too large, remove it as well rather than substituting an older image
+ * that no longer matches a follow-up such as "look at that image again".
+ */
+export declare function stripHistoryImages(history: KiroHistoryEntry[], keepNewestBounded?: boolean): KiroHistoryEntry[];
+export declare function sanitizeHistory(history: KiroHistoryEntry[]): KiroHistoryEntry[];
+export declare function injectSyntheticToolCalls(history: KiroHistoryEntry[]): KiroHistoryEntry[];
+export declare function prepareHistory(history: KiroHistoryEntry[], keepNewestBoundedImage?: boolean): KiroHistoryEntry[];
+/** Fail before sending rather than silently discarding conversation context. */
+export declare function assertHistoryWithinLimit(history: KiroHistoryEntry[], limit: number): void;
+export declare function extractToolNamesFromHistory(history: KiroHistoryEntry[]): Set<string>;
+export declare function addPlaceholderTools(tools: KiroToolSpec[], history: KiroHistoryEntry[]): KiroToolSpec[];