@sayknow-cli/coding-agent 0.3.12 → 0.3.13

package/dist/types/session/agent-storage.d.ts

@@ -1,101 +0,0 @@
-import { type AuthCredential, type AuthCredentialStore, type StoredAuthCredential } from "@sayknow-cli/ai";
-import type { RawSettings as Settings } from "../config/settings";
-/**
- * Unified SQLite storage for agent settings, model usage, and auth credentials.
- * Delegates auth credential operations to AuthCredentialStore from @sayknow-cli/ai.
- * Uses singleton pattern per database path; access via AgentStorage.open().
- */
-export declare class AgentStorage {
-    #private;
-    private constructor();
-    /**
-     * Returns singleton instance for the given database path, creating if needed.
-     * Retries on SQLITE_BUSY with exponential backoff.
-     * @param dbPath - Path to the SQLite database file (defaults to config path)
-     * @returns AgentStorage instance for the given path
-     */
-    static open(dbPath?: string): Promise<AgentStorage>;
-    /**
-     * Retrieves all settings from storage (legacy, for migration only).
-     * Settings are now stored in config.yml. This method is only used
-     * during migration from agent.db to config.yml.
-     * @returns Settings object, or null if no settings are stored
-     * @deprecated Use config.yml instead. This is only for migration.
-     */
-    getSettings(): Settings | null;
-    /**
-     * @deprecated Settings are now stored in config.yml, not agent.db.
-     * This method is kept for backward compatibility but does nothing.
-     */
-    saveSettings(settings: Settings): void;
-    /**
-     * Records model usage, updating the last-used timestamp.
-     * @param modelKey - Model key in "provider/modelId" format
-     */
-    recordModelUsage(modelKey: string): void;
-    /**
-     * Gets model keys ordered by most recently used.
-     * Results are cached until recordModelUsage is called.
-     * @returns Array of model keys ("provider/modelId") in MRU order
-     */
-    getModelUsageOrder(): string[];
-    /**
-     * Checks if any auth credentials exist in storage.
-     * @returns True if at least one credential is stored
-     */
-    hasAuthCredentials(): boolean;
-    /**
-     * Returns the underlying {@link AuthCredentialStore} so callers that need
-     * the lower-level pi-ai abstraction (e.g. `findAnthropicAuth(store)`) can
-     * reuse this storage's open database connection instead of opening their
-     * own.
-     */
-    get authStore(): AuthCredentialStore;
-    /**
-     * Lists auth credentials, optionally filtered by provider.
-     * Only returns active (non-disabled) credentials by default.
-     * @param provider - Optional provider name to filter by
-     * @param includeDisabled - If true, includes disabled credentials
-     * @returns Array of stored credentials with their database IDs
-     */
-    listAuthCredentials(provider?: string, includeDisabled?: boolean): StoredAuthCredential[];
-    /**
-     * Atomically replaces all credentials for a provider.
-     * Useful for OAuth token refresh where old tokens should be discarded.
-     * @param provider - Provider name (e.g., "anthropic", "openai")
-     * @param credentials - New credentials to store
-     * @returns Array of newly stored credentials with their database IDs
-     */
-    replaceAuthCredentialsForProvider(provider: string, credentials: AuthCredential[]): StoredAuthCredential[];
-    /**
-     * Updates an existing auth credential by ID.
-     * @param id - Database row ID of the credential to update
-     * @param credential - New credential data
-     */
-    updateAuthCredential(id: number, credential: AuthCredential): void;
-    /**
-     * Disables an auth credential by ID with a persisted cause.
-     * @param id - Database row ID of the credential to disable
-     * @param disabledCause - Human-readable cause stored with the disabled row
-     */
-    deleteAuthCredential(id: number, disabledCause: string): void;
-    /**
-     * Disables all auth credentials for a provider with a persisted cause.
-     * @param provider - Provider name whose credentials should be disabled
-     * @param disabledCause - Human-readable cause stored with the disabled rows
-     */
-    deleteAuthCredentialsForProvider(provider: string, disabledCause: string): void;
-    /**
-     * Gets a cached value by key. Returns null if not found or expired.
-     */
-    getCache(key: string): string | null;
-    /**
-     * Sets a cached value with expiry time (unix seconds).
-     */
-    setCache(key: string, value: string, expiresAtSec: number): void;
-    deleteCachePrefix(prefix: string): void;
-    /**
-     * Deletes expired cache entries. Call periodically for cleanup.
-     */
-    cleanExpiredCache(): void;
-}

package/dist/types/session/artifacts.d.ts

@@ -1,64 +0,0 @@
-export interface ArtifactSaveOptions {
-    maxBytes?: number;
-}
-/**
- * Manages artifact storage for a session.
- *
- * Artifacts are stored with sequential IDs in the session's artifact directory.
- * The directory is created lazily on first write.
- *
- * Subagents do not own their own `ArtifactManager`. The parent's instance is
- * adopted via `SessionManager.adoptArtifactManager`, so the whole parent +
- * subagent tree shares one ID space and one directory.
- */
-export declare class ArtifactManager {
-    #private;
-    /**
-     * @param dir Directory that will hold artifact files. Created lazily on first save.
-     */
-    constructor(dir: string);
-    /**
-     * Artifact directory path.
-     * Directory may not exist until first artifact is saved.
-     */
-    get dir(): string;
-    /**
-     * Atomically allocate next artifact ID.
-     * IDs are sequential within the session.
-     */
-    allocateId(): number;
-    /**
-     * Allocate a new artifact path and ID without writing content.
-     *
-     * @param toolType Tool name for file extension (e.g., "bash", "read")
-     */
-    allocatePath(toolType: string): Promise<{
-        id: string;
-        path: string;
-    }>;
-    /**
-     * Save content as an artifact and return the artifact ID.
-     *
-     * @param content Full content to save
-     * @param toolType Tool name for file extension (e.g., "bash", "read")
-     * @returns Artifact ID (numeric string)
-     */
-    save(content: string, toolType: string, options?: ArtifactSaveOptions): Promise<string>;
-    /**
-     * Check if an artifact exists.
-     * @param id Artifact ID (numeric string)
-     */
-    exists(id: string): Promise<boolean>;
-    /**
-     * List all artifact files in the directory.
-     * Returns empty array if directory doesn't exist.
-     */
-    listFiles(): Promise<string[]>;
-    /**
-     * Get the full path to an artifact file.
-     * Returns null if artifact doesn't exist.
-     *
-     * @param id Artifact ID (numeric string)
-     */
-    getPath(id: string): Promise<string | null>;
-}

package/dist/types/session/auth-broker-config.d.ts

@@ -1,13 +0,0 @@
-export interface AuthBrokerClientConfig {
-    url: string;
-    token: string;
-}
-/** Path to the local bearer token file. Created on the broker host by `skc auth-broker token`. */
-export declare function getAuthBrokerTokenFilePath(): string;
-/**
- * Read broker configuration. Returns null when the URL is missing
- * (broker disabled — local store is used). Throws when URL is set but no
- * token is available — the caller cannot fall back silently because the
- * user explicitly asked to use the broker.
- */
-export declare function resolveAuthBrokerConfig(): Promise<AuthBrokerClientConfig | null>;

package/dist/types/session/auth-storage.d.ts

@@ -1,6 +0,0 @@
-/**
- * Re-exports from @sayknow-cli/ai.
- * All credential storage types and the AuthStorage class now live in the ai package.
- */
-export type { ApiKeyCredential, AuthCredential, AuthCredentialEntry, AuthCredentialIfAbsentReason, AuthCredentialIfAbsentResult, AuthCredentialIfAbsentSnapshotResult, AuthCredentialStore, AuthStorageData, AuthStorageOptions, OAuthCredential, SerializedAuthStorage, StoredAuthCredential, } from "@sayknow-cli/ai";
-export { AuthBrokerClient, AuthStorage, REMOTE_REFRESH_SENTINEL, RemoteAuthCredentialStore, SqliteAuthCredentialStore, } from "@sayknow-cli/ai";

package/dist/types/session/blob-store.d.ts

@@ -1,160 +0,0 @@
-export interface BlobPutResult {
-    hash: string;
-    path: string;
-    get ref(): string;
-}
-export interface CheckedBlobPutResult extends BlobPutResult {
-    bytes: number;
-}
-export declare class BlobCorruptError extends Error {
-    readonly hash: string;
-    readonly path: string;
-    constructor(hash: string, path: string);
-}
-/**
- * Content-addressed blob store for externalizing large binary data (images) from session JSONL files.
- *
- * Files are stored at `<dir>/<sha256-hex>` with no extension. The SHA-256 hash is computed
- * over the raw binary data (not base64). Content-addressing makes writes idempotent and
- * provides automatic deduplication across sessions.
- */
-export declare class BlobStore {
-    readonly dir: string;
-    constructor(dir: string);
-    /**
-     * Write binary data to the blob store.
-     * @returns SHA-256 hex hash of the data
-     */
-    put(data: Buffer): Promise<BlobPutResult>;
-    /**
-     * Synchronous variant of {@link put}. Use on persistence hot paths where the caller
-     * cannot afford the microtask hops of the async version (e.g. OOM-safe session writes).
-     * Returns once the bytes are in the kernel page cache.
-     */
-    putSync(data: Buffer): BlobPutResult;
-    /**
-     * Durably install binary data as an immutable content-addressed blob.
-     *
-     * Callers that persist references to this blob must mutate canonical session entries only
-     * after this method returns successfully. A corrupt pre-existing target is reported with
-     * {@link BlobCorruptError}; it is never silently overwritten or trusted.
-     */
-    putImmutableSync(data: Buffer): CheckedBlobPutResult;
-    /** Read blob by hash, returns Buffer or null if not found. */
-    get(hash: string): Promise<Buffer | null>;
-    /** Synchronously read blob by hash, returns Buffer or null if not found. */
-    getSync(hash: string): Buffer | null;
-    /** Read blob by hash and verify its content hash; returns null if not found. */
-    getChecked(hash: string): Promise<Buffer | null>;
-    /** Synchronously read blob by hash and verify its content hash; returns null if not found. */
-    getCheckedSync(hash: string): Buffer | null;
-    /** Check if a blob exists. */
-    has(hash: string): Promise<boolean>;
-}
-export declare class EphemeralBlobStore extends BlobStore {
-    #private;
-    constructor(dir: string);
-    putSync(data: Buffer): BlobPutResult;
-    putImmutableSync(data: Buffer): CheckedBlobPutResult;
-    getSync(hash: string): Buffer | null;
-    getCheckedSync(hash: string): Buffer | null;
-    clear(): void;
-    dispose(): void;
-}
-export declare class MemoryBlobStore extends BlobStore {
-    #private;
-    constructor();
-    put(data: Buffer): Promise<BlobPutResult>;
-    putSync(data: Buffer): BlobPutResult;
-    putImmutableSync(data: Buffer): CheckedBlobPutResult;
-    get(hash: string): Promise<Buffer | null>;
-    getSync(hash: string): Buffer | null;
-    getChecked(hash: string): Promise<Buffer | null>;
-    getCheckedSync(hash: string): Buffer | null;
-    has(hash: string): Promise<boolean>;
-}
-export declare class ResidentBlobMissingError extends Error {
-    readonly hash: string;
-    readonly kind: "text" | "imageUrl" | "imageData";
-    readonly sessionId?: string | undefined;
-    readonly sessionFile?: string | undefined;
-    constructor(hash: string, kind: "text" | "imageUrl" | "imageData", sessionId?: string | undefined, sessionFile?: string | undefined);
-}
-/** Check if a data string is a blob reference. */
-export declare function isBlobRef(data: string): boolean;
-/** Extract the SHA-256 hash from a blob reference string. */
-export declare function parseBlobRef(data: string): string | null;
-/** Identify provider transport image data URLs so persistence can externalize and restore them losslessly. */
-export declare function isImageDataUrl(data: string): boolean;
-/**
- * Externalize a provider image data URL to the blob store, returning a blob reference.
- * The full data URL string is preserved so transport-native history can be reconstructed on resume.
- */
-export declare function externalizeImageDataUrl(blobStore: BlobStore, dataUrl: string): Promise<string>;
-/** Synchronous variant of {@link externalizeImageDataUrl}. */
-export declare function externalizeImageDataUrlSync(blobStore: BlobStore, dataUrl: string): string;
-/**
- * Externalize an image's base64 data to the blob store, returning a blob reference.
- * If the data is already a blob reference, returns it unchanged.
- */
-export declare function externalizeImageData(blobStore: BlobStore, base64Data: string): Promise<string>;
-/** Synchronous variant of {@link externalizeImageData}. */
-export declare function externalizeImageDataSync(blobStore: BlobStore, base64Data: string): string;
-/**
- * Resolve an externalized provider image data URL back to its original string.
- * If the data is not a blob reference, returns it unchanged.
- *
- * LEGACY PERSISTED-IMAGE COMPATIBILITY BOUNDARY: when the persisted blob is missing
- * (e.g. resuming an old session whose image blob was pruned), this warns and returns
- * the reference as-is rather than throwing, so legacy resume degrades gracefully.
- * New resident byte-sensitive TEXT uses the fail-closed path instead
- * (`resolveTextBlobSync` -> `ResidentBlobMissingError`). Do NOT route new byte-sensitive
- * resident data through this warn-and-return path.
- */
-export declare function resolveImageDataUrl(blobStore: BlobStore, data: string): Promise<string>;
-/**
- * Resolve a blob reference back to base64 data.
- * If the data is not a blob reference, returns it unchanged.
- *
- * LEGACY PERSISTED-IMAGE COMPATIBILITY BOUNDARY: when the blob is missing this warns
- * and returns the reference as-is (downstream sees an invalid base64 ref but does not
- * crash), preserving legacy-session resume. Byte-sensitive resident TEXT is fail-closed
- * via `resolveTextBlobSync`; do NOT route new byte-sensitive resident data here.
- */
-export declare function resolveImageData(blobStore: BlobStore, data: string): Promise<string>;
-/** Synchronously resolve an externalized provider image data URL back to its original string. */
-export declare function resolveImageDataUrlSync(blobStore: BlobStore, data: string): string;
-/** Synchronously resolve a blob reference back to base64 data. */
-export declare function resolveImageDataSync(blobStore: BlobStore, data: string): string;
-/**
- * Synchronously resolve a blob reference back to utf8 text.
- *
- * FAIL-CLOSED byte-sensitive path: a missing resident blob throws
- * `ResidentBlobMissingError` rather than degrading, so a missing resident text blob can
- * never silently leak a `blob:sha256:` ref into provider payloads, UI, or exports.
- * (Contrast the legacy persisted-image warn-and-return resolvers above.)
- */
-export declare function resolveTextBlobSync(blobStore: BlobStore, data: string, context?: {
-    kind?: "text";
-    sessionId?: string;
-    sessionFile?: string;
-}): string;
-/**
- * FAIL-CLOSED resident variant of {@link resolveImageDataUrlSync}: a missing resident
- * image-data-url blob throws `ResidentBlobMissingError` ("imageUrl") instead of warn-returning,
- * so resident byte-sensitive provider image data can never leak a `blob:sha256:` ref into
- * materialized entries, context, or provider payloads. The warn-and-return `resolveImageDataUrl*`
- * resolvers remain ONLY for legacy persisted-image resume.
- */
-export declare function resolveResidentImageDataUrlSync(blobStore: BlobStore, data: string, context?: {
-    sessionId?: string;
-    sessionFile?: string;
-}): string;
-/**
- * FAIL-CLOSED resident variant of {@link resolveImageDataSync}: a missing resident image blob
- * throws `ResidentBlobMissingError` ("imageData") instead of warn-returning a placeholder.
- */
-export declare function resolveResidentImageDataSync(blobStore: BlobStore, data: string, context?: {
-    sessionId?: string;
-    sessionFile?: string;
-}): string;

package/dist/types/session/client-bridge.d.ts

@@ -1,88 +0,0 @@
-/**
- * ClientBridge — abstraction over capabilities provided by an external client
- * (e.g. ACP editor host) that the agent can route through instead of operating
- * directly on the local filesystem / spawning local subprocesses.
- *
- * When `undefined`, tools fall back to local IO. When populated (currently
- * only by `AcpAgent`), tools route requests through the client so it can
- * surface unsaved buffer state, render terminals in the IDE, or gate
- * destructive operations behind user permission prompts.
- */
-export interface ClientBridgeCapabilities {
-    /** Client implements `fs/read_text_file`. */
-    readTextFile?: boolean;
-    /** Client implements `fs/write_text_file`. */
-    writeTextFile?: boolean;
-    /** Client implements the `terminal/*` family. */
-    terminal?: boolean;
-    /** Client implements `session/request_permission`. */
-    requestPermission?: boolean;
-}
-export interface ClientBridgePermissionToolCall {
-    toolCallId: string;
-    toolName: string;
-    title: string;
-    kind?: string;
-    status?: "pending" | "in_progress" | "completed" | "failed";
-    rawInput?: unknown;
-    content?: unknown[];
-    locations?: {
-        path: string;
-        line?: number;
-    }[];
-}
-export type ClientBridgePermissionOptionKind = "allow_once" | "allow_always" | "reject_once" | "reject_always";
-export interface ClientBridgePermissionOption {
-    optionId: string;
-    name: string;
-    kind: ClientBridgePermissionOptionKind;
-}
-export type ClientBridgePermissionOutcome = {
-    outcome: "cancelled";
-} | {
-    outcome: "selected";
-    optionId: string;
-    kind?: ClientBridgePermissionOptionKind;
-};
-export interface ClientBridgeTerminalExitStatus {
-    exitCode?: number | null;
-    signal?: string | null;
-}
-export interface ClientBridgeTerminalOutput {
-    output: string;
-    truncated: boolean;
-    exitStatus?: ClientBridgeTerminalExitStatus | null;
-}
-export interface ClientBridgeTerminalHandle {
-    terminalId: string;
-    waitForExit(): Promise<ClientBridgeTerminalExitStatus>;
-    currentOutput(): Promise<ClientBridgeTerminalOutput>;
-    kill(): Promise<void>;
-    release(): Promise<void>;
-}
-export interface ClientBridgeCreateTerminalParams {
-    command: string;
-    args?: string[];
-    env?: Array<{
-        name: string;
-        value: string;
-    }>;
-    cwd?: string;
-    outputByteLimit?: number;
-}
-export interface ClientBridge {
-    readonly capabilities: ClientBridgeCapabilities;
-    /** ACP v1 clients cannot show server-initiated turns as busy after prompt response. */
-    readonly deferAgentInitiatedTurns?: boolean;
-    readTextFile?(params: {
-        path: string;
-        line?: number;
-        limit?: number;
-    }): Promise<string>;
-    writeTextFile?(params: {
-        path: string;
-        content: string;
-    }): Promise<void>;
-    createTerminal?(params: ClientBridgeCreateTerminalParams): Promise<ClientBridgeTerminalHandle>;
-    requestPermission?(toolCall: ClientBridgePermissionToolCall, options: ClientBridgePermissionOption[], signal?: AbortSignal): Promise<ClientBridgePermissionOutcome>;
-}

package/dist/types/session/contribution-prep.d.ts

@@ -1,47 +0,0 @@
-import type { AgentMessage } from "@sayknow-cli/agent-core";
-export declare const CONTRIBUTION_PREP_SCHEMA_VERSION = 1;
-export interface ContributionPrepArtifact {
-    path: string;
-    description: string;
-}
-export interface ContributionPrepManifest {
-    schema_version: number;
-    source_session_id: string;
-    created_at: string;
-    cwd: string;
-    git_head: string | null;
-    changed_files: string[];
-    artifacts: ContributionPrepArtifact[];
-    redactions: string[];
-    recommended_output: string[];
-    worker_prompt_path: string;
-}
-export interface ContributionPrepResult {
-    manifestPath: string;
-    workerPromptPath: string;
-    artifactDir: string;
-    changedFiles: string[];
-    spawned: boolean;
-}
-export interface ContributionPrepOptions {
-    customInstructions?: string;
-    spawnWorker?: boolean;
-    artifactRoot?: string;
-    now?: Date;
-    spawn?: (args: string[], cwd: string, shell: boolean) => Promise<void>;
-}
-export interface ContributionPrepContext {
-    sessionId: string;
-    cwd: string;
-    sessionFile?: string;
-    messages: AgentMessage[];
-    customInstructions?: string;
-    now?: Date;
-}
-interface RedactionState {
-    labels: Set<string>;
-}
-export declare function redactContributionPrepText(text: string, cwd: string, state?: RedactionState): string;
-export declare function buildContributionPrepWorkerPrompt(manifestPath: string): string;
-export declare function prepareContributionPrep(context: ContributionPrepContext, options?: ContributionPrepOptions): Promise<ContributionPrepResult>;
-export {};

package/dist/types/session/file-mention-pruning.d.ts

@@ -1,8 +0,0 @@
-import type { SessionEntry, SessionMessageEntry } from "./session-manager";
-export interface FileMentionPruneResult {
-    changed: SessionMessageEntry[];
-    bytesSaved: number;
-}
-/** Notice injected in place of a superseded file-mention body. */
-export declare function stalefileMentionNotice(path: string): string;
-export declare function pruneStaleFileMentions(entries: readonly SessionEntry[], resolveAbs: (path: string) => string): FileMentionPruneResult;

package/dist/types/session/history-storage.d.ts

@@ -1,16 +0,0 @@
-export interface HistoryEntry {
-    id: number;
-    prompt: string;
-    created_at: number;
-    cwd?: string;
-}
-export declare class HistoryStorage {
-    #private;
-    private constructor();
-    static open(dbPath?: string): HistoryStorage;
-    /** @internal Reset the singleton — test-only. */
-    static resetInstance(): void;
-    add(prompt: string, cwd?: string): Promise<void>;
-    getRecent(limit: number, cwd?: string): HistoryEntry[];
-    search(query: string, limit: number, cwd?: string): HistoryEntry[];
-}

package/dist/types/session/messages.d.ts

@@ -1,169 +0,0 @@
-/**
- * Custom message types and transformers for the coding agent.
- *
- * Extends the base AgentMessage type with coding-agent specific message types,
- * and provides a transformer to convert them to LLM-compatible messages.
- */
-import type { AgentMessage } from "@sayknow-cli/agent-core";
-import { type BranchSummaryMessage, type CompactionSummaryMessage } from "@sayknow-cli/agent-core/compaction/messages";
-import type { AssistantMessage, ImageContent, Message, MessageAttribution, TextContent } from "@sayknow-cli/ai";
-export { type BranchSummaryMessage, type CompactionSummaryMessage, createBranchSummaryMessage, createCompactionSummaryMessage, } from "@sayknow-cli/agent-core/compaction/messages";
-import type { LoadedSubskillActivation } from "../extensibility/skc-plugins";
-import type { OutputMeta } from "../tools/output-meta";
-export declare const SKILL_PROMPT_MESSAGE_TYPE = "skill-prompt";
-export interface SkillPromptDetails {
-    name: string;
-    path: string;
-    args?: string;
-    lineCount: number;
-    subskillActivation?: LoadedSubskillActivation;
-    subskillActivationSet?: LoadedSubskillActivation[];
-    /** Internal: tag used by AgentSession to remove the pending-display chip
-     *  from `#steeringMessages` / `#followUpMessages` when the agent consumes
-     *  this message. Not surfaced to renderers; the `__` prefix signals
-     *  "private". Optional — non-streaming skill prompts never set it. Stripped
-     *  from persisted `details` by `SessionManager.appendCustomMessageEntry`
-     *  via the `INTERNAL_DETAILS_FIELDS` allowlist below. */
-    __pendingDisplayTag?: string;
-}
-/** Sentinel value for `AssistantMessage.errorMessage` indicating that the abort
- *  was an *expected internal transition* (plan-mode → execution compaction)
- *  and must NOT surface as a red "Operation aborted" line. Distinct from
- *  `undefined` (default) so user-cancel aborts with no errorMessage still
- *  render normally. Persists through SessionManager so history replay
- *  branches identically.
- *
- *  Consumers: `AgentSession.#handleAgentEvent` (stamper) writes this value;
- *  `EventController.#handleMessageEnd`, `AssistantMessageComponent`,
- *  `ui-helpers.addMessageToChat` (renderers), `SessionObserverOverlay
- *  #buildTranscriptLines`, `runPrintMode`, and `AcpAgent#replayAssistantMessage`
- *  (fallback error emission) read it via `isSilentAbort`. */
-export declare const SILENT_ABORT_MARKER = "__skc.silent_abort__";
-/** Type-guard for `SILENT_ABORT_MARKER`. Renderers MUST branch on this rather
- *  than string-comparing inline so refactors to the marker constant (e.g.,
- *  namespacing changes) propagate through every consumer in lockstep. */
-export declare function isSilentAbort(errorMessage: string | undefined): boolean;
-/** Extract the optional `__pendingDisplayTag` field from a CustomMessage's
- *  `details` blob. Safe over `unknown`; returns undefined when the field is
- *  absent or non-string. */
-export declare function readPendingDisplayTag(details: unknown): string | undefined;
-/** Explicit allowlist of `details` field names that are AgentSession-internal
- *  transient bookkeeping and MUST be removed before SessionManager persists
- *  the CustomMessageEntry to disk. Scoped intentionally narrow: only fields
- *  declared here are stripped. Adding a new entry is a deliberate, reviewed
- *  change — unrelated future payload fields are never silently dropped. */
-export declare const INTERNAL_DETAILS_FIELDS: readonly ["__pendingDisplayTag"];
-/** Return a `details` copy with every key in `INTERNAL_DETAILS_FIELDS`
- *  removed. Returns the input unchanged when there is nothing to strip
- *  (null/non-object, or no listed fields present) so callers don't pay a
- *  clone cost on the common path. */
-export declare function stripInternalDetailsFields<T>(details: T | undefined): T | undefined;
-/**
- * Message type for bash executions via the ! command.
- */
-export interface BashExecutionMessage {
-    role: "bashExecution";
-    command: string;
-    output: string;
-    exitCode: number | undefined;
-    cancelled: boolean;
-    truncated: boolean;
-    meta?: OutputMeta;
-    timestamp: number;
-    /** If true, this message is excluded from LLM context (!! prefix) */
-    excludeFromContext?: boolean;
-}
-/**
- * Message type for user-initiated Python executions via the $ command.
- * Shares the same kernel session as eval's Python backend.
- */
-export interface PythonExecutionMessage {
-    role: "pythonExecution";
-    code: string;
-    output: string;
-    exitCode: number | undefined;
-    cancelled: boolean;
-    truncated: boolean;
-    meta?: OutputMeta;
-    timestamp: number;
-    /** If true, this message is excluded from LLM context ($$ prefix) */
-    excludeFromContext?: boolean;
-}
-/**
- * Message type for extension-injected messages via sendMessage().
- */
-export interface CustomMessage<T = unknown> {
-    role: "custom";
-    customType: string;
-    content: string | (TextContent | ImageContent)[];
-    display: boolean;
-    details?: T;
-    /** Who initiated this message for billing/attribution semantics. */
-    attribution?: MessageAttribution;
-    timestamp: number;
-}
-/**
- * Legacy hook message type (pre-extensions). Kept for session migration.
- */
-export interface HookMessage<T = unknown> {
-    role: "hookMessage";
-    customType: string;
-    content: string | (TextContent | ImageContent)[];
-    display: boolean;
-    details?: T;
-    /** Who initiated this message for billing/attribution semantics. */
-    attribution?: MessageAttribution;
-    timestamp: number;
-}
-/**
- * Message type for auto-read file mentions via @filepath syntax.
- */
-export interface FileMentionMessage {
-    role: "fileMention";
-    files: Array<{
-        path: string;
-        content: string;
-        lineCount?: number;
-        /** File size in bytes, if known. */
-        byteSize?: number;
-        /** Why the file contents were omitted from auto-read. */
-        skippedReason?: "tooLarge";
-        image?: ImageContent;
-        /** Set when this mention duplicated a recently shown path (compact note, no full body). */
-        duplicate?: boolean;
-        /** Set when a stale entry was pruned to a digest notice (never silently deleted). */
-        pruned?: boolean;
-    }>;
-    timestamp: number;
-}
-declare module "@sayknow-cli/agent-core" {
-    interface CustomAgentMessages {
-        bashExecution: BashExecutionMessage;
-        pythonExecution: PythonExecutionMessage;
-        custom: CustomMessage;
-        hookMessage: HookMessage;
-        branchSummary: BranchSummaryMessage;
-        compactionSummary: CompactionSummaryMessage;
-        fileMention: FileMentionMessage;
-    }
-}
-/**
- * Convert a BashExecutionMessage to user message text for LLM context.
- */
-export declare function bashExecutionToText(msg: BashExecutionMessage): string;
-/**
- * Convert a PythonExecutionMessage to user message text for LLM context.
- */
-export declare function pythonExecutionToText(msg: PythonExecutionMessage): string;
-export declare function sanitizeRehydratedOpenAIResponsesAssistantMessage(message: AssistantMessage): AssistantMessage;
-/** Convert CustomMessageEntry to AgentMessage format */
-export declare function createCustomMessage(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details: unknown | undefined, timestamp: string, attribution?: MessageAttribution): CustomMessage;
-/**
- * Transform AgentMessages (including custom types) to LLM-compatible Messages.
- *
- * This is used by:
- * - Agent's transormToLlm option (for prompt calls and queued messages)
- * - Compaction's generateSummary (for summarization)
- * - Custom extensions and tools
- */
-export declare function convertToLlm(messages: AgentMessage[]): Message[];