agent-afk 5.1.0 → 5.3.0

package/dist/cli/render/text-input.d.ts

@@ -0,0 +1,9 @@
+import type { PickerHost } from './picker.js';
+export interface RunTextInputOptions {
+    header: readonly string[];
+    initial?: string;
+    help?: string;
+    validate?: (value: string) => string | null;
+    signal?: AbortSignal;
+}
+export declare function runTextInput(host: PickerHost, opts: RunTextInputOptions): Promise<string | null>;

package/dist/cli/render/usage-limit-box.d.ts

@@ -0,0 +1,7 @@
+export declare function usageLimitBox(opts: {
+    resetsAt?: Date;
+    reason: 'usage-limit' | 'credit-exhausted';
+    accountId?: string;
+    hotSwapped?: boolean;
+    autoResume?: boolean;
+}): string;

package/dist/cli/render/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function maxInnerBoxWidth(): number;
+export declare function truncateDisplay(s: string, maxWidth: number): string;

package/dist/cli/render/welcome-banner.d.ts

@@ -0,0 +1,10 @@
+export interface WelcomeBannerOpts {
+    mode: string;
+    metaLine?: string;
+    hintLine?: string;
+    model?: string;
+    worktree?: string;
+    cwd?: string;
+    version?: string;
+}
+export declare function welcomeBanner(opts: WelcomeBannerOpts): string;

package/dist/cli/render.d.ts

@@ -0,0 +1 @@
+export * from './render/index.js';

package/dist/cli/resume-command.d.ts

@@ -0,0 +1,3 @@
+import type { AgentModelInput } from '../agent/types.js';
+export declare function shellQuoteToken(value: string): string;
+export declare function formatResumeCommand(target: string, model?: AgentModelInput): string;

package/dist/cli/resume-session.d.ts

@@ -0,0 +1,13 @@
+import type { AgentConfig } from '../agent/types.js';
+import { type StoredSession } from './session-store.js';
+export interface ResumeCliOptions {
+    resume?: string;
+    continue?: boolean;
+}
+export interface ResolvedResumeTarget {
+    id: string;
+    resumeId: string;
+    stored?: StoredSession;
+}
+export declare function resolveResumeTarget(options: ResumeCliOptions): ResolvedResumeTarget | undefined;
+export declare function resumeConfigFor(target: ResolvedResumeTarget | undefined): Partial<AgentConfig>;

package/dist/cli/session-name.d.ts

@@ -0,0 +1 @@
+export declare function slugifySessionName(text: string): string;

package/dist/cli/session-store.d.ts

@@ -0,0 +1,51 @@
+import type { SessionStats, TurnRecord } from './slash/types.js';
+import type { AgentModelInput } from '../agent/types.js';
+import type { TraceActor } from '../agent/session/session-identity.js';
+export interface StoredSession {
+    sessionId?: string;
+    name?: string;
+    source?: 'cli' | 'telegram' | 'daemon';
+    telegramChatId?: number;
+    model: AgentModelInput;
+    startedAt: number;
+    savedAt: number;
+    totalTurns: number;
+    totalCostUsd: number;
+    totalTokens: number;
+    totalDurationMs: number;
+    turns: TurnRecord[];
+    forkedFrom?: string;
+    forkedAt?: number;
+    actor?: TraceActor;
+    cwd?: string;
+}
+export interface SessionListEntry {
+    path: string;
+    id: string;
+    sessionId?: string;
+    name?: string;
+    source?: 'cli' | 'telegram' | 'daemon';
+    actor?: TraceActor;
+    model: AgentModelInput;
+    startedAt: number;
+    savedAt: number;
+    totalTurns: number;
+    totalCostUsd: number;
+    cwd?: string;
+}
+export interface FoundSession {
+    path: string;
+    id: string;
+    data: StoredSession;
+}
+export declare function saveSession(stats: SessionStats, overrideId?: string): string;
+export declare function forkStoredSession(stats: SessionStats, opts?: {
+    newId?: string;
+}): {
+    id: string;
+    path: string;
+};
+export declare function loadSession(idOrPath: string): StoredSession | undefined;
+export declare function findSession(idOrName: string): FoundSession | undefined;
+export declare function listSessions(): SessionListEntry[];
+export declare function sdkSessionIdFor(idOrName: string): string | undefined;

package/dist/cli/shared-helpers.d.ts

@@ -0,0 +1,33 @@
+import type { ModelProvider } from '../agent/provider.js';
+import type { AgentModelInput, ThinkingConfig, EffortLevel } from '../agent/types.js';
+export declare function loadSystemPrompt(): string | undefined;
+export declare function loadConfigSystemPrompt(): string | undefined;
+export declare const OPERATOR_CONFIG_HEADER: string;
+export declare function composeSystemPrompt(framework: string | undefined, overlay: string | undefined): string | undefined;
+export declare function resolveBaseSystemPrompt(): {
+    prompt: string | undefined;
+    source: string;
+};
+export declare function getApiKey(): string | undefined;
+export declare function getCodexApiKey(): string | undefined;
+export declare function getApiKeyForModel(model: string | undefined): string | undefined;
+export declare function getModel(): AgentModelInput;
+export declare function getDefaultSubagentModel(parentModel?: AgentModelInput): AgentModelInput;
+export declare function parseThinking(raw: string | undefined): ThinkingConfig | undefined;
+export declare function parseEffort(raw: string | undefined): EffortLevel | undefined;
+export declare function getThinking(): ThinkingConfig | undefined;
+export declare function getEffort(): EffortLevel | undefined;
+export declare function parseBudget(raw: string | undefined): number | undefined;
+export declare function getMaxBudgetUsd(): number | undefined;
+export declare function getTaskBudget(): number | undefined;
+export declare function parseMaxOutputTokens(raw: string | undefined): number | undefined;
+export declare function getMaxOutputTokens(): number | undefined;
+export declare function parseProvider(raw: string | undefined, opts?: {
+    subagentExecutor?: import('../agent/tools/subagent-executor.js').SubagentExecutor;
+    skillExecutor?: import('../agent/tools/skill-executor.js').SkillExecutor;
+    composeExecutor?: import('../agent/tools/compose-executor.js').ComposeExecutor;
+    memoryStore?: import('../agent/memory/index.js').MemoryStore;
+    mcpManager?: import('../agent/mcp/index.js').McpManager;
+    model?: string;
+    openaiBaseUrl?: string;
+}): ModelProvider | undefined;

package/dist/cli/slash/_lib/command-tags.d.ts

@@ -0,0 +1,9 @@
+export declare const COMMAND_NAME_TAG = "command-name";
+export declare const COMMAND_MESSAGE_TAG = "command-message";
+export declare const COMMAND_ARGS_TAG = "command-args";
+export declare function formatCommandBreadcrumb(name: string, args: string): string;
+export declare function stripCommandTags(text: string): string;
+export declare function extractSkillTag(text: string, skillName: string): {
+    text: string;
+    found: boolean;
+};

package/dist/cli/slash/_lib/create-skill-renderer.d.ts

@@ -0,0 +1,9 @@
+import { StreamRenderer } from '../../_lib/stream-renderer.js';
+import type { SlashContext, Writer } from '../types.js';
+export interface SkillRendererOpts {
+    skillName: string;
+    verbose?: boolean;
+    out?: Writer;
+    onCancel?: () => void;
+}
+export declare function createSkillRenderer(ctx: SlashContext, opts: SkillRendererOpts): StreamRenderer;

package/dist/cli/slash/_lib/flag-harvest.d.ts

@@ -0,0 +1,9 @@
+export declare function normalizeFlag(flag: string): string;
+export declare function extractFlagsFromBody(body: string): string[];
+export interface ParsedSkillMd {
+    frontmatter: Record<string, string> | null;
+    frontmatterFlags: string[] | null;
+    body: string;
+}
+export declare function parseSkillMd(content: string): ParsedSkillMd;
+export declare function harvestFlagsFromSkillMd(content: string): string[];

package/dist/cli/slash/_lib/image-blocks.d.ts

@@ -0,0 +1,3 @@
+import type { ContentBlockParam } from '@anthropic-ai/sdk/resources';
+import type { ImageAttachment } from '../../input/attachments.js';
+export declare function appendImageBlocks(blocks: ContentBlockParam[], attachments: readonly ImageAttachment[] | undefined): void;

package/dist/cli/slash/_lib/review-post.d.ts

@@ -0,0 +1,30 @@
+import type { Writer } from '../types.js';
+import { checkGhReady, postPrComment, resolveCurrentBranchPr } from '../../../agent/gh.js';
+import { pushIfConfigured } from '../../../telegram/push.js';
+export type PostTarget = 'github' | 'telegram';
+export declare const REVIEW_MARKER = "<!-- agent-afk-review -->";
+export interface ParsedPostFlag {
+    targets: PostTarget[];
+    cleanedArgs: string;
+    unknown: string[];
+}
+export declare function parsePostFlag(args: string): ParsedPostFlag;
+export declare function parsePostTargets(value: string): {
+    targets: PostTarget[];
+    unknown: string[];
+};
+export declare function chunkText(text: string, limit: number): string[];
+export declare function buildGithubBody(review: string): string;
+export declare function summarizeForTelegram(review: string): string;
+export interface ReviewPostDeps {
+    checkGhReady: typeof checkGhReady;
+    postPrComment: typeof postPrComment;
+    resolveCurrentBranchPr: typeof resolveCurrentBranchPr;
+    pushIfConfigured: typeof pushIfConfigured;
+}
+export interface RunReviewPostParams {
+    targets: PostTarget[];
+    reviewText: string;
+    prRefFromArgs: string | null;
+}
+export declare function runReviewPostPublish(out: Writer, params: RunReviewPostParams, deps?: Partial<ReviewPostDeps>): Promise<void>;

package/dist/cli/slash/_lib/run-skill-dispatch-turn.d.ts

@@ -0,0 +1,11 @@
+import type { SlashContext } from '../types.js';
+import type { SkillMetadata } from '../../../skills/index.js';
+import type { ImageAttachment } from '../../input/attachments.js';
+export interface RunSkillDispatchTurnParams {
+    skillName: string;
+    skillMeta: SkillMetadata;
+    args: string;
+    preflight?: () => Promise<string | undefined>;
+    attachments?: readonly ImageAttachment[] | undefined;
+}
+export declare function runSkillDispatchTurn(ctx: SlashContext, params: RunSkillDispatchTurnParams): Promise<string>;

package/dist/cli/slash/_lib/skill-message-bridge.d.ts

@@ -0,0 +1,4 @@
+import type { ContentBlockParam } from '@anthropic-ai/sdk/resources';
+import type { SkillMetadata } from '../../../skills/index.js';
+import type { ImageAttachment } from '../../input/attachments.js';
+export declare function buildSkillInvocationMessage(skill: SkillMetadata, args: string, manifestBlock?: string, attachments?: readonly ImageAttachment[]): ContentBlockParam[];

package/dist/cli/slash/_lib/skill-sink-channel.d.ts

@@ -0,0 +1 @@
+export { runWithSink, getCurrentSink } from '../../../agent/_lib/skill-sink-channel.js';

package/dist/cli/slash/_lib/user-payload.d.ts

@@ -0,0 +1,3 @@
+import type { ContentBlockParam } from '@anthropic-ai/sdk/resources';
+import type { ImageAttachment } from '../../input/attachments.js';
+export declare function buildUserPayload(text: string, attachments: readonly ImageAttachment[], manifestBlock?: string, fileBlocks?: readonly ContentBlockParam[]): ContentBlockParam[];

package/dist/cli/slash/builtin-skills.d.ts

@@ -0,0 +1,4 @@
+import { type SkillMetadata } from '../../skills/index.js';
+import type { SlashCommand } from './types.js';
+export declare function makeImmediateHandler(skill: SkillMetadata): SlashCommand;
+export declare function registerBuiltinSkillCommands(): void;

package/dist/cli/slash/commands/afk.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const afkCmd: SlashCommand;

package/dist/cli/slash/commands/allow-dir.d.ts

@@ -0,0 +1,14 @@
+import type { SlashCommand } from '../types.js';
+export interface GrantManager {
+    addReadRoot(absPath: string, source: 'slash' | 'tool', sessionId?: string): void;
+    addWriteRoot(absPath: string, source: 'slash' | 'tool', sessionId?: string): void;
+    revokeRoot(absPath: string, source: 'slash' | 'tool', sessionId?: string): void;
+    getGrants(): {
+        resolveBase: string | undefined;
+        readRoots: string[];
+        writeRoots: string[];
+        allowAll?: boolean;
+    };
+}
+export declare function setAllowDirDispatcher(manager: GrantManager): void;
+export declare const allowDirCmd: SlashCommand;

package/dist/cli/slash/commands/bgsub.d.ts

@@ -0,0 +1,11 @@
+import type { SlashCommand } from '../types.js';
+import type { BackgroundAgentRegistry } from '../../../agent/background-registry.js';
+import type { BackgroundSummarizer } from '../../../agent/background-summarizer.js';
+export declare function setBgsubRegistry(registry: BackgroundAgentRegistry): void;
+export declare function setBgsubSummarizer(summarizer: BackgroundSummarizer | undefined): void;
+export declare function resetBgsubRegistry(): void;
+export declare const bgsubCmd: SlashCommand;
+export declare const bgsubStatusCmd: SlashCommand;
+export declare const bgsubJoinCmd: SlashCommand;
+export declare const bgsubCancelCmd: SlashCommand;
+export declare const bgsubCommands: readonly SlashCommand[];

package/dist/cli/slash/commands/changelog.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const changelogCmd: SlashCommand;

package/dist/cli/slash/commands/config-doctor.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const configDoctorCommands: SlashCommand[];

package/dist/cli/slash/commands/core.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const coreCommands: SlashCommand[];

package/dist/cli/slash/commands/font-size.d.ts

@@ -0,0 +1,4 @@
+import type { ToolHandler } from '../../../agent/tools/types.js';
+import type { SlashCommand } from '../types.js';
+export declare function createFontSizeCmd(handler?: ToolHandler): SlashCommand;
+export declare const fontSizeCmd: SlashCommand;

package/dist/cli/slash/commands/fork.d.ts

@@ -0,0 +1,4 @@
+import { type SpawnOutcome } from '../../terminal-spawn/index.js';
+import type { SlashCommand } from '../types.js';
+export declare function forkSpawnLines(spawn: SpawnOutcome, command: string, copied: boolean): string[];
+export declare const forkCmd: SlashCommand;

package/dist/cli/slash/commands/info.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const infoCommands: SlashCommand[];

package/dist/cli/slash/commands/init.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const initCmd: SlashCommand;

package/dist/cli/slash/commands/keys.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const keysCmd: SlashCommand;

package/dist/cli/slash/commands/name.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const nameCmd: SlashCommand;

package/dist/cli/slash/commands/plan.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const planCmd: SlashCommand;

package/dist/cli/slash/commands/reauth.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const reauthCmd: SlashCommand;

package/dist/cli/slash/commands/resume.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const resumeCmd: SlashCommand;

package/dist/cli/slash/commands/save.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const saveCmd: SlashCommand;

package/dist/cli/slash/commands/sh.d.ts

@@ -0,0 +1,4 @@
+import type { SlashCommand } from '../types.js';
+import type { ShellPassthrough } from '../../commands/interactive/shell-passthrough.js';
+export declare function setShellPassthrough(pt: ShellPassthrough): void;
+export declare const shCmd: SlashCommand;

package/dist/cli/slash/commands/stats.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const statsCmd: SlashCommand;

package/dist/cli/slash/commands/todo.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const todoCmd: SlashCommand;

package/dist/cli/slash/commands/transcript.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const transcriptCmd: SlashCommand;

package/dist/cli/slash/commands/worktree.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../types.js';
+export declare const worktreeCmd: SlashCommand;

package/dist/cli/slash/index.d.ts

@@ -0,0 +1,3 @@
+import '../trusted-skills-registered.js';
+export declare function registerAll(): void;
+export { registry } from './registry-exports.js';

package/dist/cli/slash/marketplace-browse.d.ts

@@ -0,0 +1 @@
+export declare function registerMarketplaceCommands(): void;

package/dist/cli/slash/plugin-agents.d.ts

@@ -0,0 +1,5 @@
+import type { AgentSession } from '../../agent/session.js';
+import type { SlashCommand } from './types.js';
+export declare const initialAgentsCmd: SlashCommand;
+export declare function registerPluginAgents(session: AgentSession): Promise<number | null>;
+export declare function registerStaticPluginAgentCommands(): void;

package/dist/cli/slash/plugin-skills.d.ts

@@ -0,0 +1,32 @@
+import type { AgentSession } from '../../agent/session.js';
+import { type SkillManifestEntry } from '../../agent/tools/skill-bridge.js';
+import { type InstalledPlugin } from '../../agent/plugins/inventory.js';
+import type { SlashCommand } from './types.js';
+interface DiscoveredSkill {
+    name: string;
+    description: string;
+    argumentHint?: string;
+}
+export declare function harvestPluginSkillFlags(cacheRoot?: string): Map<string, string[]>;
+export declare function extractHintFromDescription(description: string): string | undefined;
+export declare function makeForwardHandler(skill: DiscoveredSkill, flags?: readonly string[]): SlashCommand;
+export declare const initialSkillsCmd: SlashCommand;
+export declare function registerPluginSkills(session: AgentSession): Promise<number | null>;
+export declare function getPluginShadowingNoticeLines(): string[];
+export declare function autoRegisterPluginPassthroughs(session: AgentSession): Promise<{
+    skillCount: number | null;
+    agentCount: number | null;
+}>;
+export declare function buildSourceBreakdown(entries: SkillManifestEntry[]): string;
+export declare function computeSkillDelta(prev: ReadonlySet<string>, next: ReadonlySet<string>): {
+    added: string[];
+    removed: string[];
+} | null;
+export declare function formatSkillDelta(delta: {
+    added: string[];
+    removed: string[];
+}): string;
+export declare function buildPluginRows(plugins: InstalledPlugin[]): string[];
+export declare const reloadPluginsCmd: SlashCommand;
+export declare function registerStaticPluginSkillCommands(): void;
+export {};

package/dist/cli/slash/preflight/artifact-dir.d.ts

@@ -0,0 +1,3 @@
+export declare function _resetPruneStateForTests(): void;
+export declare function pruneStaleDirs(root: string, ttlMs: number): void;
+export declare function getSkillPreflightDir(sessionId: string | undefined): string;

package/dist/cli/slash/preflight/index.d.ts

@@ -0,0 +1,6 @@
+export { runPreflight, getPreflight, registerPreflight } from './registry.js';
+export { getSkillPreflightDir } from './artifact-dir.js';
+export { stitchForwardManifest } from './stitch-forward.js';
+export type { SkillInvocation, PreflightContext, PreflightResult, SkillPreflight, } from './types.js';
+export declare function initBuiltinPreflights(): void;
+export declare function _resetBuiltinsInitializedForTests(): void;

package/dist/cli/slash/preflight/registry.d.ts

@@ -0,0 +1,8 @@
+import type { PreflightContext, PreflightResult, SkillInvocation, SkillPreflight } from './types.js';
+export declare function _sealBuiltinKeys(): void;
+export declare function registerPreflight(skillName: string, preflight: SkillPreflight, opts?: {
+    force?: boolean;
+}): void;
+export declare function getPreflight(skillName: string): SkillPreflight | undefined;
+export declare function _clearPreflightsForTests(): void;
+export declare function runPreflight(inv: SkillInvocation, ctx: PreflightContext, onError?: (err: unknown) => void): Promise<PreflightResult | null>;

package/dist/cli/slash/preflight/review-pr.d.ts

@@ -0,0 +1,34 @@
+import type { PreflightContext, SkillPreflight } from './types.js';
+export declare function parsePrRef(rawArgs: string): string | null;
+interface PrMetadata {
+    title?: string;
+    baseRefName?: string;
+    headRefName?: string;
+    additions?: number;
+    deletions?: number;
+    changedFiles?: number;
+    files?: Array<{
+        path?: string;
+        additions?: number;
+        deletions?: number;
+    }>;
+}
+interface GatheredState {
+    pr: string;
+    metadata: PrMetadata | null;
+    diffPath: string | null;
+    diffLineCount: number | null;
+    dirty: boolean;
+    dirtyFiles: number;
+}
+export declare function gatherPrState(pr: string, ctx: PreflightContext, deps?: {
+    exec?: (cmd: string, args: string[], opts?: {
+        cwd?: string;
+    }) => Promise<string | null>;
+    writeFile?: (path: string, content: string) => void | string;
+}): Promise<GatheredState>;
+export declare function renderManifest(state: GatheredState): string;
+export declare const reviewPrPreflight: SkillPreflight;
+export declare function _resetConcurrencyGuardForTests(): void;
+export declare function _setConcurrencyGuardForTests(value: boolean): void;
+export {};

package/dist/cli/slash/preflight/stitch-forward.d.ts

@@ -0,0 +1 @@
+export declare function stitchForwardManifest(manifestBlock: string | undefined, slashLine: string): string;

package/dist/cli/slash/preflight/types.d.ts

@@ -0,0 +1,18 @@
+export interface SkillInvocation {
+    skillName: string;
+    rawArgs: string;
+    source: 'builtin' | 'user' | 'project' | 'plugin' | 'imported';
+    capabilities: {
+        compose: boolean;
+        subagents: boolean;
+    };
+}
+export interface PreflightContext {
+    cwd: string;
+    artifactDir: string;
+}
+export interface PreflightResult {
+    manifestBlock: string;
+    artifacts: Record<string, string>;
+}
+export type SkillPreflight = (inv: SkillInvocation, ctx: PreflightContext) => Promise<PreflightResult | null>;

package/dist/cli/slash/registry-exports.d.ts

@@ -0,0 +1,2 @@
+import * as registryImpl from './registry.js';
+export declare const registry: typeof registryImpl;

package/dist/cli/slash/registry.d.ts

@@ -0,0 +1,23 @@
+import type { SlashCommand, SlashContext, SlashResult } from './types.js';
+import type { ImageAttachment } from '../input/attachments.js';
+export declare function register(cmd: SlashCommand): void;
+export declare function registerOrReplace(cmd: SlashCommand): void;
+export declare function registerIfAbsent(cmd: SlashCommand): void;
+export declare function has(nameOrAlias: string): boolean;
+export declare function resetRegistry(): void;
+export declare function list(): SlashCommand[];
+export declare function aliasEntries(): {
+    alias: string;
+    canonical: string;
+    summary: string;
+}[];
+export declare function lookup(nameOrAlias: string): SlashCommand | undefined;
+export declare function suggest(input: string, maxDistance?: number): string | undefined;
+export declare function parse(input: string): {
+    name: string;
+    args: string;
+} | null;
+export declare function dispatch(input: string, ctx: SlashContext, attachments?: readonly ImageAttachment[]): Promise<{
+    handled: boolean;
+    result?: SlashResult;
+}>;

package/dist/cli/slash/session-stats.d.ts

@@ -0,0 +1,6 @@
+import type { ResponseMetadata } from '../../agent/types/message-types.js';
+import type { AgentModelInput } from '../../agent/types.js';
+import type { SessionStats, ToolEvent, TurnRecord } from './types.js';
+export declare function createSessionStats(model: AgentModelInput): SessionStats;
+export declare function resetStats(stats: SessionStats): void;
+export declare function recordTurn(stats: SessionStats, userInput: string, assistantText: string, metadata: ResponseMetadata | undefined, toolEvents?: ToolEvent[]): TurnRecord;

package/dist/cli/slash/types.d.ts

@@ -0,0 +1,103 @@
+import type { SessionRef } from '../../agent/session-ref.js';
+import type { ElicitationHandler } from '../../agent/elicitation-router.js';
+import type { AgentModelInput } from '../../agent/types.js';
+import type { TraceActor } from '../../agent/session/session-identity.js';
+import type { PermissionMode } from '../../agent/types/sdk-types.js';
+import type { TrustedSkillLedger } from '../trusted-skill-ledger.js';
+import type { ImageAttachment } from '../input/attachments.js';
+import type { ResolvedResumeTarget } from '../resume-session.js';
+export type ResumeSwapResult = {
+    ok: true;
+    sessionId: string;
+} | {
+    ok: false;
+    reason: string;
+};
+export interface ToolEvent {
+    toolName: string;
+    toolUseId: string;
+    input: string;
+    inputRaw?: string;
+    result?: string;
+    isError?: boolean;
+}
+export interface TurnRecord {
+    user: string;
+    assistant: string;
+    timestamp: number;
+    costUsd?: number;
+    durationMs?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    toolEvents?: ToolEvent[];
+}
+export interface SessionStats {
+    totalTurns: number;
+    totalCostUsd: number;
+    totalTokens: number;
+    totalDurationMs: number;
+    sessionStartTime: number;
+    turnCosts: number[];
+    turnTokens: Array<{
+        input: number;
+        output: number;
+        cache: number;
+        footprint?: number;
+    }>;
+    turns: TurnRecord[];
+    model: AgentModelInput;
+    permissionMode: PermissionMode;
+    sessionId?: string;
+    name?: string;
+    cwd?: string;
+    source?: 'cli' | 'telegram' | 'daemon';
+    telegramChatId?: number;
+    actor?: TraceActor;
+}
+export interface Writer {
+    line(text?: string): void;
+    raw(text: string): void;
+    success(text: string): void;
+    info(text: string): void;
+    warn(text: string): void;
+    error(text: string): void;
+}
+export interface UiSurface {
+    clearScreen(): void;
+    repaintStatusLine(): void;
+}
+export interface SlashContext {
+    session: SessionRef;
+    stats: SessionStats;
+    out: Writer;
+    ui: UiSurface;
+    ledger?: TrustedSkillLedger;
+    requestResume?: (target: ResolvedResumeTarget) => Promise<ResumeSwapResult>;
+    mcpManager?: import('../../agent/mcp/index.js').McpManager;
+    getCompositor?: () => import('../terminal-compositor.js').TerminalCompositor | null;
+    setSoftStopHandler?: (handler: (() => void) | null) => void;
+    onStageChange?: (stage: import('../commands/interactive/loop-stage.js').LoopStage) => void;
+    onContextProgress?: () => void | Promise<void>;
+    transcript?: {
+        appendTurn(userInput: string, assistantText: string): Promise<void>;
+        appendUser?(userInput: string): Promise<void>;
+    };
+    swapElicitationHandler?: (handler: ElicitationHandler | null) => void;
+    stdinElicitationHandler?: ElicitationHandler;
+}
+export type SlashResult = 'continue' | 'exit' | 'forward' | {
+    rerun: string;
+} | {
+    kind: 'submit';
+    message: string;
+};
+export interface SlashCommand {
+    name: string;
+    aliases?: string[];
+    summary: string;
+    usage?: string;
+    hint?: string;
+    flags?: readonly string[];
+    acceptsAttachments?: boolean;
+    handler(ctx: SlashContext, args: string, _attachments?: readonly ImageAttachment[]): Promise<SlashResult>;
+}