ns-kiro-core 0.1.0

package/dist/history.js

@@ -0,0 +1,130 @@
+// Feature 6: History Management
+export const HISTORY_LIMIT = 850000;
+/** The context window size (in tokens) that HISTORY_LIMIT was calibrated for. */
+export const HISTORY_LIMIT_CONTEXT_WINDOW = 200000;
+/** Maximum combined base64 characters retained for one historical image-bearing turn. */
+export const HISTORY_IMAGE_BASE64_LIMIT = 512 * 1024;
+/**
+ * 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 function stripHistoryImages(history, keepNewestBounded = true) {
+    let newestImageIndex = -1;
+    for (let index = history.length - 1; index >= 0; index--) {
+        if ((history[index]?.userInputMessage?.images?.length ?? 0) > 0) {
+            newestImageIndex = index;
+            break;
+        }
+    }
+    const newestImages = newestImageIndex >= 0 ? history[newestImageIndex]?.userInputMessage?.images : undefined;
+    const keepNewest = keepNewestBounded &&
+        newestImages !== undefined &&
+        newestImages.reduce((size, image) => size + image.source.bytes.length, 0) <= HISTORY_IMAGE_BASE64_LIMIT;
+    return history.map((entry, index) => {
+        if (!entry.userInputMessage?.images || (index === newestImageIndex && keepNewest))
+            return entry;
+        const { images: _images, ...rest } = entry.userInputMessage;
+        return { ...entry, userInputMessage: { ...rest } };
+    });
+}
+export function sanitizeHistory(history) {
+    // Strip leading entries that would make the history invalid
+    while (history.length > 0 &&
+        (!history[0]?.userInputMessage || history[0].userInputMessage.userInputMessageContext?.toolResults))
+        history = history.slice(1);
+    const result = [];
+    for (let i = 0; i < history.length; i++) {
+        const m = history[i];
+        if (!m)
+            continue;
+        // Skip assistant messages with no content and no tool uses (e.g. from API errors)
+        if (m.assistantResponseMessage && !m.assistantResponseMessage.toolUses && !m.assistantResponseMessage.content)
+            continue;
+        if (m.assistantResponseMessage?.toolUses) {
+            const next = history[i + 1];
+            if (next?.userInputMessage?.userInputMessageContext?.toolResults)
+                result.push(m);
+        }
+        else if (m.userInputMessage?.userInputMessageContext?.toolResults) {
+            const prev = result[result.length - 1];
+            if (prev?.assistantResponseMessage?.toolUses)
+                result.push(m);
+        }
+        else {
+            result.push(m);
+        }
+    }
+    // Leading invalid entries already stripped above
+    return result;
+}
+export function injectSyntheticToolCalls(history) {
+    const validIds = new Set();
+    for (const entry of history) {
+        for (const tu of entry.assistantResponseMessage?.toolUses ?? []) {
+            if (tu.toolUseId)
+                validIds.add(tu.toolUseId);
+        }
+    }
+    const result = [];
+    for (const entry of history) {
+        const toolResults = entry.userInputMessage?.userInputMessageContext?.toolResults;
+        if (toolResults) {
+            const orphaned = toolResults.filter((tr) => !validIds.has(tr.toolUseId));
+            if (orphaned.length > 0) {
+                result.push({
+                    assistantResponseMessage: {
+                        content: "Tool calls were made.",
+                        toolUses: orphaned.map((tr) => ({ name: "unknown_tool", toolUseId: tr.toolUseId, input: {} })),
+                    },
+                });
+                for (const tr of orphaned)
+                    validIds.add(tr.toolUseId);
+            }
+        }
+        result.push(entry);
+    }
+    return result;
+}
+export function prepareHistory(history, keepNewestBoundedImage = true) {
+    return injectSyntheticToolCalls(sanitizeHistory(stripHistoryImages(history, keepNewestBoundedImage)));
+}
+/** Fail before sending rather than silently discarding conversation context. */
+export function assertHistoryWithinLimit(history, limit) {
+    const size = JSON.stringify(history).length;
+    if (size > limit) {
+        throw new Error(`Kiro API error: context_length_exceeded (local history ${size} chars / ${history.length} entries exceeds ${limit}-char limit)`);
+    }
+}
+export function extractToolNamesFromHistory(history) {
+    const names = new Set();
+    for (const entry of history) {
+        for (const tu of entry.assistantResponseMessage?.toolUses ?? []) {
+            if (tu.name)
+                names.add(tu.name);
+        }
+    }
+    return names;
+}
+export function addPlaceholderTools(tools, history) {
+    const historyNames = extractToolNamesFromHistory(history);
+    if (historyNames.size === 0)
+        return tools;
+    const existing = new Set(tools.map((t) => t.toolSpecification?.name).filter(Boolean));
+    const missing = Array.from(historyNames).filter((n) => !existing.has(n));
+    if (missing.length === 0)
+        return tools;
+    return [
+        ...tools,
+        ...missing.map((name) => ({
+            toolSpecification: {
+                name,
+                description: "Tool",
+                inputSchema: { json: { type: "object", properties: {} } },
+            },
+        })),
+    ];
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { KiroBlockBuffer } from "./blocks.js";
+export { parseBracketToolCalls } from "./bracket-tool-parser.js";
+export { calculateKiroCost } from "./cost.js";
+export { debugEnabled, debugLog, formatSafeError, redactSensitiveText } from "./debug.js";
+export { buildKiroAdditionalModelRequestFields, clampKiroEffort, deriveKiroEffort, fallbackKiroEffort, getKiroEffortConfig, type KiroAdditionalModelRequestFields, type KiroEffortConfig, type KiroEffortField, mapEffortToKiroValue, } from "./effort.js";
+export { getKiroEndpoints, getKiroRegionFromEndpoint, type KiroEndpoints, resolveApiRegion, } from "./endpoints.js";
+export { type KiroWireEvent, parseKiroEvent } from "./event-parser.js";
+export { isKiroToolStructureRule, KIRO_TOOL_STRUCTURE_RULES, KIRO_VALIDATION_MESSAGES, type KiroRepairResult, type KiroToolStructureRule, type KiroValidationError, type KiroValidationResult, KiroValidationRule, kiroConversationEntries, repairKiroConversation, SYNTHETIC_FAILED_TOOL_RESULT_TEXT, validateKiroConversation, validateKiroToolStructure, } from "./history-validator.js";
+export { parseInvokeToolCalls } from "./invoke-tool-parser.js";
+export { getKiroCliCredentials, getKiroCliCredentialsAllowExpired, getKiroCliDbPath, getKiroCliSocialToken, getKiroCliSocialTokenAllowExpired, refreshViaKiroCli, saveKiroCliCredentials, } from "./kiro-cli.js";
+export { getKiroIdeCredentials, getKiroIdeCredentialsAllowExpired } from "./kiro-ide.js";
+export { fetchKiroModelCatalog, type KiroCatalogModel, type KiroManagementAuth, KiroManagementHttpError, resolveKiroProfileArn, } from "./management.js";
+export { applyEffortLadder, getCachedModels, isCacheStale, KIRO_MANAGEMENT_CACHE_PATH, KIRO_MODEL_IDS, type KiroModel, kiroModels, loadCachedModelIds, mapKiroCatalogModels, resolveKiroModel, updateKiroModelsCache, } from "./models.js";
+export { isApiKey, isExpired, type KiroAuthMethod, type KiroCredentials, kiroAuthHeaders, loginKiroWithApiKey, refreshKiroToken, resolveKiroCredentials, } from "./oauth.js";
+export { CAPACITY_PATTERN, isCapacityError, isNonRetryableBodyError, isTooBigError, KIRO_REASON_CODES, type KiroReasonCode, NON_RETRYABLE_BODY_PATTERNS, TOO_BIG_PATTERNS, } from "./retry.js";
+export { type KiroStreamRequest, resetProfileArnCache, streamKiro } from "./stream.js";
+export { ThinkingTagParser } from "./thinking-parser.js";
+export { countTokens } from "./tokenizer.js";
+export { buildHistory, EMPTY_CONTENT_PLACEHOLDER, type KiroHistoryEntry, type KiroImage, type KiroToolResult, type KiroToolSpec, type KiroToolUse, type KiroUserInputMessage, normalizeMessages, relocateDisplacedToolResults, sanitizeSurrogates, toKiroToolUseId, } from "./transform.js";
+export { TRUNCATION_NOTICE, wasPreviousResponseTruncated } from "./truncation.js";
+export * from "./types.js";
+export { fetchKiroUsage, type KiroProviderUsage, type KiroProviderUsageBucket } from "./usage.js";

package/dist/index.js

@@ -0,0 +1,28 @@
+// Public surface of the host-neutral Kiro core.
+export { KiroBlockBuffer } from "./blocks.js";
+export { parseBracketToolCalls } from "./bracket-tool-parser.js";
+export { calculateKiroCost } from "./cost.js";
+export { debugEnabled, debugLog, formatSafeError, redactSensitiveText } from "./debug.js";
+export { buildKiroAdditionalModelRequestFields, clampKiroEffort, deriveKiroEffort, fallbackKiroEffort, getKiroEffortConfig, mapEffortToKiroValue, } from "./effort.js";
+export { getKiroEndpoints, getKiroRegionFromEndpoint, resolveApiRegion, } from "./endpoints.js";
+export { parseKiroEvent } from "./event-parser.js";
+export { isKiroToolStructureRule, KIRO_TOOL_STRUCTURE_RULES, KIRO_VALIDATION_MESSAGES, KiroValidationRule, kiroConversationEntries, repairKiroConversation, SYNTHETIC_FAILED_TOOL_RESULT_TEXT, validateKiroConversation, validateKiroToolStructure, } from "./history-validator.js";
+export { parseInvokeToolCalls } from "./invoke-tool-parser.js";
+export { getKiroCliCredentials, getKiroCliCredentialsAllowExpired, getKiroCliDbPath, getKiroCliSocialToken, getKiroCliSocialTokenAllowExpired, refreshViaKiroCli, saveKiroCliCredentials, } from "./kiro-cli.js";
+export { getKiroIdeCredentials, getKiroIdeCredentialsAllowExpired } from "./kiro-ide.js";
+export { fetchKiroModelCatalog, KiroManagementHttpError, resolveKiroProfileArn, } from "./management.js";
+export { applyEffortLadder, getCachedModels, isCacheStale, KIRO_MANAGEMENT_CACHE_PATH, KIRO_MODEL_IDS, kiroModels, loadCachedModelIds, mapKiroCatalogModels, resolveKiroModel, updateKiroModelsCache, } from "./models.js";
+export { isApiKey, isExpired, kiroAuthHeaders, loginKiroWithApiKey, refreshKiroToken, resolveKiroCredentials, } from "./oauth.js";
+// Kiro's own error vocabulary and the predicates this core classifies it with.
+// Published so consumers can interpret a reason code without an error instance
+// in hand (a persisted log line, say) instead of hardcoding copies of the
+// literals, which drift when the service adds a code.
+export { CAPACITY_PATTERN, isCapacityError, isNonRetryableBodyError, isTooBigError, KIRO_REASON_CODES, NON_RETRYABLE_BODY_PATTERNS, TOO_BIG_PATTERNS, } from "./retry.js";
+export { resetProfileArnCache, streamKiro } from "./stream.js";
+export { ThinkingTagParser } from "./thinking-parser.js";
+export { countTokens } from "./tokenizer.js";
+export { buildHistory, EMPTY_CONTENT_PLACEHOLDER, normalizeMessages, relocateDisplacedToolResults, sanitizeSurrogates, toKiroToolUseId, } from "./transform.js";
+export { TRUNCATION_NOTICE, wasPreviousResponseTruncated } from "./truncation.js";
+export * from "./types.js";
+export { fetchKiroUsage } from "./usage.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EACL,qCAAqC,EACrC,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EAInB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EAEzB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAsB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EAKxB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,iCAAiC,EACjC,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,qBAAqB,EACrB,iCAAiC,EACjC,gBAAgB,EAChB,qBAAqB,EACrB,iCAAiC,EACjC,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,iCAAiC,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EACL,qBAAqB,EAGrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,0BAA0B,EAC1B,cAAc,EAEd,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,EACR,SAAS,EAGT,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,+EAA+E;AAC/E,+EAA+E;AAC/E,0EAA0E;AAC1E,sDAAsD;AACtD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EAEjB,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAA0B,oBAAoB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,yBAAyB,EAOzB,iBAAiB,EACjB,4BAA4B,EAC5B,kBAAkB,EAClB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAClF,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAwD,MAAM,YAAY,CAAC"}

package/dist/invoke-tool-parser.d.ts

@@ -0,0 +1,16 @@
+export interface InvokeToolCall {
+    toolUseId: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface InvokeParseResult {
+    toolCalls: InvokeToolCall[];
+    cleanedText: string;
+}
+/**
+ * Recovers tool calls that a model emitted as XML text instead of as structured
+ * tool-use frames. Mirrors {@link parseBracketToolCalls}: returns the recovered
+ * calls plus the text with each consumed `<invoke>` span spliced out. A block
+ * that cannot be parsed in full is left in the text untouched.
+ */
+export declare function parseInvokeToolCalls(text: string): InvokeParseResult;

package/dist/invoke-tool-parser.js

@@ -0,0 +1,152 @@
+// ABOUTME: Extracts XML-dialect tool calls from content text as a fallback.
+// ABOUTME: Parses <invoke name="..."><parameter name="...">value</parameter></invoke> blocks.
+const INVOKE_OPEN_ANCHORED = /^<invoke name="([\w-]+)">/;
+const INVOKE_OPEN_SEARCH = "<invoke name=";
+const INVOKE_OPEN_ANYWHERE = /<invoke name="[\w-]+">/;
+const PARAM_OPEN_ANCHORED = /^<parameter name="([^"]*)">/;
+const INVOKE_CLOSE = "</invoke>";
+const PARAM_CLOSE = "</parameter>";
+const FENCE = "```";
+/**
+ * Byte ranges covered by an *opened* fenced code block. Fences are counted
+ * pairwise; a trailing unclosed fence extends to end of text. Used to reject
+ * `<invoke>` blocks that appear inside documentation rather than as a real
+ * (misrouted) tool call — model output that discusses this very bug quotes the
+ * dialect verbatim, and executing a command out of a code sample would be
+ * strictly worse than not recovering it.
+ */
+function fencedRanges(text) {
+    const ranges = [];
+    let searchFrom = 0;
+    while (true) {
+        const open = text.indexOf(FENCE, searchFrom);
+        if (open < 0)
+            break;
+        const close = text.indexOf(FENCE, open + FENCE.length);
+        if (close < 0) {
+            ranges.push({ start: open, end: text.length });
+            break;
+        }
+        ranges.push({ start: open, end: close + FENCE.length });
+        searchFrom = close + FENCE.length;
+    }
+    return ranges;
+}
+/** Thrown when a block's markup cannot be attributed unambiguously. */
+class AmbiguousDialectError extends Error {
+}
+/**
+ * Parses one `<invoke>` block starting at `start`, or returns null if the
+ * markup there is not a complete, well-formed block.
+ *
+ * The block end is found structurally — by walking parameters — never by
+ * searching for `</invoke>`. A naive search would stop at a `</invoke>` that
+ * happens to sit inside a parameter value, truncating the value and then
+ * accepting the truncation as if it were the whole argument.
+ *
+ * Strict by design: the body must consist of nothing but whitespace and
+ * well-formed `<parameter name="...">...</parameter>` elements. Any other
+ * content (prose, an ellipsis placeholder, a stray tag) rejects the block,
+ * because a partial parse would either fabricate arguments or half-strip the
+ * text.
+ */
+function parseBlockAt(text, start) {
+    const openMatch = INVOKE_OPEN_ANCHORED.exec(text.substring(start));
+    if (!openMatch)
+        return null;
+    const args = {};
+    let cursor = start + openMatch[0].length;
+    while (true) {
+        const remainder = text.substring(cursor);
+        const leadingWhitespace = remainder.length - remainder.trimStart().length;
+        if (leadingWhitespace > 0)
+            cursor += leadingWhitespace;
+        if (text.startsWith(INVOKE_CLOSE, cursor)) {
+            const end = cursor + INVOKE_CLOSE.length;
+            // A consumed block must end cleanly. This rejects a literal
+            // `</parameter></invoke>` inside a value: accepting that prefix would
+            // execute a silently truncated command and leave quote/tag debris behind.
+            if (end < text.length && !/\s/.test(text[end]))
+                return null;
+            return { name: openMatch[1], arguments: args, end };
+        }
+        const paramMatch = PARAM_OPEN_ANCHORED.exec(text.substring(cursor));
+        if (!paramMatch)
+            return null;
+        const valueStart = cursor + paramMatch[0].length;
+        const valueEnd = text.indexOf(PARAM_CLOSE, valueStart);
+        if (valueEnd < 0)
+            return null;
+        const value = text.substring(valueStart, valueEnd);
+        // A parameter value that itself contains an `<invoke>` open tag makes the
+        // block unattributable: nested markup could otherwise be harvested as a
+        // call the model never made.
+        if (INVOKE_OPEN_ANYWHERE.test(value))
+            throw new AmbiguousDialectError();
+        // Values in this dialect are raw text, not JSON. Preserve every byte:
+        // parsing or trimming can silently change a command that will be executed.
+        args[paramMatch[1]] = value;
+        cursor = valueEnd + PARAM_CLOSE.length;
+    }
+}
+/**
+ * Recovers tool calls that a model emitted as XML text instead of as structured
+ * tool-use frames. Mirrors {@link parseBracketToolCalls}: returns the recovered
+ * calls plus the text with each consumed `<invoke>` span spliced out. A block
+ * that cannot be parsed in full is left in the text untouched.
+ */
+export function parseInvokeToolCalls(text) {
+    const toolCalls = [];
+    const removals = [];
+    const fences = fencedRanges(text);
+    const untouched = { toolCalls: [], cleanedText: text };
+    let cursor = 0;
+    while (cursor < text.length) {
+        const openStart = text.indexOf(INVOKE_OPEN_SEARCH, cursor);
+        if (openStart < 0)
+            break;
+        const containingFence = fences.find((range) => openStart >= range.start && openStart < range.end);
+        if (containingFence) {
+            cursor = containingFence.end;
+            continue;
+        }
+        let block;
+        try {
+            block = parseBlockAt(text, openStart);
+        }
+        catch (e) {
+            if (e instanceof AmbiguousDialectError)
+                return untouched;
+            throw e;
+        }
+        // A malformed opener can enclose later valid-looking markup as argument
+        // data. Without a structural end, independence cannot be proven; abandon
+        // all recovery rather than execute an embedded call.
+        if (block === null)
+            return untouched;
+        // If apparent block end truncated a raw value containing closing-tag text,
+        // real outer closers remain later in prose. Never execute that prefix.
+        const nextOpen = text.indexOf(INVOKE_OPEN_SEARCH, block.end);
+        const interstitialEnd = nextOpen < 0 ? text.length : nextOpen;
+        const interstitial = text.substring(block.end, interstitialEnd);
+        if (interstitial.includes(PARAM_CLOSE) || interstitial.includes(INVOKE_CLOSE))
+            return untouched;
+        toolCalls.push({ toolUseId: crypto.randomUUID(), name: block.name, arguments: block.arguments });
+        removals.push({ start: openStart, end: block.end });
+        // Resume past the whole block: its parameter values are data, not markup.
+        // With the nesting bail above this is belt-and-braces — any value holding a
+        // full open tag has already abandoned the parse — so no test can currently
+        // distinguish it from resuming at the search hit. Kept because it is the
+        // structurally correct resume point, and the bail is the only thing making
+        // the weaker one safe.
+        cursor = block.end;
+    }
+    // Splice out consumed spans in reverse order so earlier indices stay valid.
+    let cleanedText = text;
+    for (let i = removals.length - 1; i >= 0; i--) {
+        const { start, end } = removals[i];
+        cleanedText = cleanedText.substring(0, start) + cleanedText.substring(end);
+    }
+    return { toolCalls, cleanedText };
+}
+//# sourceMappingURL=invoke-tool-parser.js.map

package/dist/invoke-tool-parser.js.map

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

package/dist/kiro-cli.d.ts

@@ -0,0 +1,31 @@
+import type { KiroAuthMethod, KiroCredentials } from "./oauth.js";
+export declare function getKiroCliDbPath(): string | undefined;
+export declare function getKiroCliCredentials(): KiroCredentials | undefined;
+/**
+ * Like getKiroCliCredentials but returns credentials even when the access token
+ * is expired, as long as a refresh token exists. Used to attempt a token refresh
+ * before falling back to the full device code login flow.
+ */
+export declare function getKiroCliCredentialsAllowExpired(): KiroCredentials | undefined;
+declare function tryKiroCliToken(dbPath: string, tokenKey: string, authMethod: KiroAuthMethod, allowExpired?: boolean): KiroCredentials | undefined;
+export { tryKiroCliToken };
+/**
+ * Get the social token (Google/GitHub) from kiro-cli if available.
+ * Returns undefined if no valid social token exists.
+ * This is used to prefer social login when the user has logged in that way.
+ */
+export declare function getKiroCliSocialToken(): KiroCredentials | undefined;
+/**
+ * Like getKiroCliSocialToken but returns credentials even when the access token
+ * is expired, as long as a refresh token exists.
+ */
+export declare function getKiroCliSocialTokenAllowExpired(): KiroCredentials | undefined;
+export declare function saveKiroCliCredentials(creds: KiroCredentials): void;
+/**
+ * Ask kiro-cli to refresh its own tokens via `kiro-cli debug refresh-auth-token`,
+ * then re-read the SQLite DB for fresh credentials.
+ *
+ * Returns refreshed credentials on success, or undefined if kiro-cli is not
+ * installed, the command fails, or the DB still has no valid tokens afterward.
+ */
+export declare function refreshViaKiroCli(): KiroCredentials | undefined;