@crewx/sdk 0.9.0-rc.18 → 0.9.0-rc.181

package/dist/app-ui/index.d.ts

@@ -0,0 +1,83 @@
+export interface AppUiToolCall {
+    readonly name: string;
+    readonly arguments?: Readonly<Record<string, unknown>>;
+}
+export interface AppUiCallOptions {
+    readonly timeout?: number;
+    readonly resetTimeoutOnProgress?: boolean;
+    readonly onprogress?: (progress: AppUiProgress) => void;
+}
+export interface AppUiProgress {
+    readonly progress: number;
+    readonly total?: number;
+    readonly message?: string;
+}
+export interface AppUiToolResult {
+    readonly isError?: boolean;
+    readonly structuredContent?: Readonly<Record<string, unknown>>;
+}
+export interface AppUiToolCaller {
+    callServerTool(params: AppUiToolCall, options?: AppUiCallOptions): Promise<AppUiToolResult>;
+}
+export declare class CrewxAppToolError extends Error {
+    readonly code: string;
+    constructor(code: string, message?: string);
+}
+export interface AppUiShareResult {
+    readonly shareId: string;
+    readonly url: string;
+    readonly revision: number;
+    readonly status: 'active';
+    readonly viewer: 'app' | 'markdown';
+}
+export interface AppUiFileItem {
+    readonly ref: string;
+    readonly version: string;
+    readonly bytes: number;
+    readonly modifiedAt: string;
+}
+export interface AppUiFilesListResult {
+    readonly items: readonly AppUiFileItem[];
+    readonly next: string | null;
+}
+export interface AppUiFileReadResult {
+    readonly ref: string;
+    readonly text: string;
+    readonly version: string;
+}
+export interface AppUiFileWriteResult {
+    readonly ref: string;
+    readonly version: string;
+}
+export interface AppUiShareInput {
+    readonly ref: string;
+    readonly onprogress?: (progress: AppUiProgress) => void;
+}
+export interface AppUiListFilesInput {
+    readonly prefix?: string;
+    readonly after?: string;
+}
+export interface AppUiWriteFileInput {
+    readonly ref: string;
+    readonly text: string;
+    readonly expectedVersion: string | null;
+}
+export declare function share(app: AppUiToolCaller, input: AppUiShareInput): Promise<AppUiShareResult>;
+export declare function listFiles(app: AppUiToolCaller, input?: AppUiListFilesInput): Promise<AppUiFilesListResult>;
+export declare function readFile(app: AppUiToolCaller, input: {
+    readonly ref: string;
+}): Promise<AppUiFileReadResult>;
+export declare function writeFile(app: AppUiToolCaller, input: AppUiWriteFileInput): Promise<AppUiFileWriteResult>;
+export declare const CREWX_DOCUMENT_CHANGED: "ui/notifications/crewx-document-changed";
+export interface AppUiDocumentChanged {
+    readonly ref: string;
+    readonly version: string | null;
+}
+export interface AppUiNotification {
+    readonly method: string;
+    readonly params?: unknown;
+}
+export interface AppUiNotificationSource {
+    fallbackNotificationHandler?(notification: AppUiNotification): Promise<void>;
+}
+export declare function onDocumentChanged(app: AppUiNotificationSource, handler: (params: AppUiDocumentChanged) => void): () => void;

package/dist/app-ui/index.js

@@ -0,0 +1 @@
+'use strict';var p=class extends Error{code;constructor(r,n=r){super(n),this.name="CrewxAppToolError",this.code=r;}},g=1200*1e3;function x(e,r){return d(e,{name:"crewx_docs_share",arguments:{ref:r.ref}},{timeout:g,resetTimeoutOnProgress:true,onprogress:r.onprogress??(()=>{})})}function C(e,r={}){return d(e,{name:"crewx_files_list",arguments:{...r}})}function R(e,r){return d(e,{name:"crewx_files_read",arguments:{ref:r.ref}})}function T(e,r){return d(e,{name:"crewx_files_write",arguments:{ref:r.ref,text:r.text,expectedVersion:r.expectedVersion}})}var m="ui/notifications/crewx-document-changed",A=/^sha256:[0-9a-f]{64}$/,l=new WeakMap;function w(e,r){let n=l.get(e)??y(e),t=i=>r(i);return n.listeners.add(t),()=>{n.listeners.delete(t),n.listeners.size===0&&l.get(e)===n&&(l.delete(e),e.fallbackNotificationHandler===n.dispatch&&(e.fallbackNotificationHandler=n.previous));}}function y(e){let r=e.fallbackNotificationHandler,n=new Set,t=async o=>{if(o.method!==m){await r?.call(e,o);return}let s=U(o.params);if(s===void 0)return;let a;for(let u of [...n])try{u(s);}catch(f){a??={error:f};}if(a!==void 0)throw a.error},i={listeners:n,previous:r,dispatch:t};return l.set(e,i),e.fallbackNotificationHandler=t,i}function U(e){if(!c(e))return;let r=e.ref,n=e.version;if(!(typeof r!="string"||r.length===0)&&!(n!==null&&(typeof n!="string"||!A.test(n))))return {ref:r,version:n}}async function d(e,r,n){let t=n===void 0?await e.callServerTool(r):await e.callServerTool(r,n);if(t.isError===true){let i=t.structuredContent?.error,o=c(i)?i:void 0,s=typeof o?.code=="string"?o.code:"TOOL_ERROR",a=typeof o?.message=="string"?o.message:s;throw new p(s,a)}if(!c(t.structuredContent))throw new p("TOOL_RESULT_INVALID",`${r.name} returned no structured result`);return t.structuredContent}function c(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}exports.CREWX_DOCUMENT_CHANGED=m;exports.CrewxAppToolError=p;exports.listFiles=C;exports.onDocumentChanged=w;exports.readFile=R;exports.share=x;exports.writeFile=T;

package/dist/boxing/box.types.d.ts

@@ -43,11 +43,15 @@ export interface ThreadMessage {
     content: string;
     timestamp: string;
     metadata: Record<string, unknown> | null;
+    contentTruncated?: boolean;
+    originalTokens?: number;
+    includedTokens?: number;
 }
 export interface ContextBuildParams {
     maxTokens: number;
     hotzoneRatio: number;
     warmzoneRatio: number;
+    minGuaranteedPairs?: number;
 }
 export interface ContextBuildResponse {
     hot: ThreadMessage[];

package/dist/config/canonicalize-agent-options.d.ts

@@ -0,0 +1,18 @@
+export declare function normalizeClaudeMode(mode: string): string;
+export interface AgentOptionsLike {
+    query?: unknown;
+    execute?: unknown;
+    [key: string]: unknown;
+}
+export interface CanonicalizeAgentOptionsInput {
+    provider?: string;
+    model?: string;
+    options: unknown;
+}
+export interface CanonicalizeAgentOptionsResult {
+    options: unknown;
+    changed: boolean;
+    removed: string[];
+}
+export declare function normalizeProviderMode(providerId: string, mode: string): string;
+export declare function canonicalizeAgentOptions(input: CanonicalizeAgentOptionsInput): CanonicalizeAgentOptionsResult;

package/dist/config/default-agent-models.d.ts

@@ -0,0 +1,11 @@
+import { type ProviderExecutionOptions } from './models.generated.js';
+export type DefaultAgentStage = {
+    model: string;
+    query: Pick<ProviderExecutionOptions, 'mode' | 'effort'>;
+    execute: Pick<ProviderExecutionOptions, 'mode' | 'effort'>;
+};
+export interface DefaultAgentProfile {
+    planner: DefaultAgentStage;
+    worker: DefaultAgentStage;
+}
+export declare function getDefaultAgentProfile(provider: string): DefaultAgentProfile | undefined;

package/dist/config/global-settings.d.ts

@@ -0,0 +1,33 @@
+import { mkdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'fs';
+import type { LocalServerSettings } from '../local-server/types';
+export interface GlobalSettings {
+    cron?: {
+        auto_start?: boolean;
+        [key: string]: unknown;
+    };
+    ai_server?: LocalServerSettings;
+    [key: string]: unknown;
+}
+export type DeepPartial<T> = T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+export interface GlobalSettingsStore {
+    read(): GlobalSettings;
+    update(patch: DeepPartial<GlobalSettings>): GlobalSettings;
+    set(key: string, value: unknown): GlobalSettings;
+    remove(key: string): GlobalSettings;
+    readonly path: string;
+}
+interface GlobalSettingsFileSystem {
+    mkdirSync: typeof mkdirSync;
+    readFileSync: typeof readFileSync;
+    renameSync: typeof renameSync;
+    statSync: typeof statSync;
+    writeFileSync: typeof writeFileSync;
+}
+export interface CreateGlobalSettingsStoreOptions {
+    filePath?: string;
+    fileSystem?: Partial<GlobalSettingsFileSystem>;
+}
+export declare function createGlobalSettingsStore(opts?: CreateGlobalSettingsStoreOptions): GlobalSettingsStore;
+export {};

package/dist/config/migrate-grok-mode.d.ts

@@ -0,0 +1,6 @@
+export type GrokSandbox = 'workspace' | 'read-only' | 'off';
+export interface GrokNativeOptions {
+    alwaysApprove?: boolean;
+    sandbox?: GrokSandbox;
+}
+export declare function migrateGrokLegacyMode<T>(slot: T): T;

package/dist/config/model-compat.d.ts

@@ -0,0 +1,31 @@
+export declare const CLAUDE_OPUS_4_8_BASE_MODEL_ID: "claude-opus-4-8";
+export declare const CLAUDE_OPUS_4_8_LEGACY_MODEL_ID: "claude-opus-4-8[1m]";
+export declare const CLAUDE_MODEL_COMPATIBILITY_PAIRS: readonly [{
+    readonly baseModelId: "claude-opus-4-8";
+    readonly catalogModelId: "claude-opus-4-8[1m]";
+}, {
+    readonly baseModelId: "claude-opus-4-7";
+    readonly catalogModelId: "claude-opus-4-7[1m]";
+}, {
+    readonly baseModelId: "claude-opus-4-6";
+    readonly catalogModelId: "claude-opus-4-6[1m]";
+}, {
+    readonly baseModelId: "claude-sonnet-4-6";
+    readonly catalogModelId: "claude-sonnet-4-6[1m]";
+}];
+export declare function normalizeAntigravityMode(mode: string): string;
+export declare function resolveCatalogModelId(model: string): string;
+export declare const ANTIGRAVITY_MODEL_COMPATIBILITY: ReadonlyArray<{
+    legacyId: string;
+    model: string;
+    effort?: string;
+}>;
+export type AntigravityResolvedModel = {
+    model?: string;
+    effort?: string;
+};
+export declare function resolveAntigravityModel(model?: string): AntigravityResolvedModel;
+export declare function resolveProviderCatalogModel(providerId: string, model?: string): {
+    model?: string;
+    effort?: string;
+};

package/dist/config/models.generated.d.ts

@@ -1,7 +1,20 @@
+import type { ModelApiPricing } from './pricing.types.js';
+export declare const MODEL_TIERS: readonly ["flagship", "balanced", "speed"];
+export type ModelTier = (typeof MODEL_TIERS)[number];
+export declare const EFFORT_LEVELS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra"];
+export type EffortLevel = (typeof EFFORT_LEVELS)[number];
+export type KnownEffortLevel = EffortLevel;
+export declare const PROVIDER_ARGV_EFFORTS: Record<string, readonly string[]>;
+export declare const MODEL_CATALOG_VERSION = 34;
+export declare const MODEL_CATALOG_UPDATED = "2026-10-24T00:00:00Z";
 export interface ModelCatalogEntry {
     id: string;
     name: string;
     description?: string;
+    contextWindowTokens?: number;
+    tier?: ModelTier;
+    recommended?: boolean;
+    apiPricing?: ModelApiPricing;
 }
 export interface ProviderModeEntry {
     id: string;
@@ -12,11 +25,35 @@ export interface ProviderModelOverride {
     effort?: string[];
     defaultEffort?: string;
 }
+export type ProviderOptionSpec = {
+    key: string;
+    type: 'boolean';
+} | {
+    key: string;
+    type: 'enum';
+    values: string[];
+};
+export interface ProviderExecutionOptions {
+    mode: string;
+    effort: string;
+    providerOptions?: Record<string, unknown>;
+}
+export interface ProviderDefaultProfile {
+    model: string;
+    query: ProviderExecutionOptions;
+    execute: ProviderExecutionOptions;
+}
+export interface ProviderDefaults {
+    version: number;
+    providers: Record<string, ProviderDefaultProfile>;
+}
 export interface ProviderCatalogEntry {
     models: ModelCatalogEntry[];
     modes: ProviderModeEntry[];
     effort: string[];
     modelOverrides: Record<string, ProviderModelOverride>;
+    providerOptions?: ProviderOptionSpec[];
 }
 export declare const PROVIDER_CATALOGS: Record<string, ProviderCatalogEntry>;
+export declare const PROVIDER_DEFAULTS: ProviderDefaults;
 export declare const PROVIDER_MODELS: Record<string, ModelCatalogEntry[]>;

package/dist/config/models.remote.d.ts

@@ -1,3 +1,4 @@
+export declare const MIN_REMOTE_CATALOG_VERSION = 20;
 export declare function initModelsRemote(opts?: {
     endpoint?: string;
     ttlMs?: number;

package/dist/config/overdrive.d.ts

@@ -3,6 +3,7 @@ export interface OverdriveProfile {
     model?: string;
     mode?: string;
     effort?: string;
+    providerOptions?: Record<string, unknown>;
 }
 export type OverdriveSignalInput = boolean | {
     mode?: 'count' | 'latch';
@@ -20,5 +21,11 @@ export interface OverdriveResolution {
     mode?: string;
     effort?: string;
     crossProvider: boolean;
+    providerOptions?: Record<string, unknown>;
 }
 export declare function resolveOverdrive(agentOptions: unknown, mode: 'query' | 'execute', baseProvider: string, signal: OverdriveSignal): OverdriveResolution;
+export interface ModeOverrideResolution {
+    provider?: string;
+    model?: string;
+}
+export declare function resolveModeOverride(agentOptions: unknown, mode: 'query' | 'execute'): ModeOverrideResolution;

package/dist/config/pricing.d.ts

@@ -1,9 +1,12 @@
-import type { ModelPricing } from './pricing.types.js';
-export type { ModelPricing } from './pricing.types.js';
-export { MODEL_PRICING } from './pricing.generated.js';
+import type { ModelApiPricing, ModelPricing } from './pricing.types.js';
+export type { ModelApiPricing, ModelPricing } from './pricing.types.js';
+export { MODEL_PRICING, UNPUBLISHED_MODEL_IDS } from './pricing.generated.js';
 export declare function setPricingOverride(models: Record<string, ModelPricing>): void;
 export declare function clearPricingOverride(): void;
+export declare function setApiPricingOverride(models: Record<string, ModelApiPricing>): void;
+export declare function clearApiPricingOverride(): void;
 export declare function normalizeModel(model: string): string;
+export declare function lookupApiPricing(model: string | null | undefined): ModelApiPricing | undefined;
 export declare function getPricing(model: string | null | undefined): ModelPricing;
 export declare function calculateCost(inputTokens: number, outputTokens: number, model: string | null | undefined, cachedInputTokens?: number, _date?: Date): number;
 export declare function resolveCost(costUsd: number | undefined, inputTokens: number | undefined, outputTokens: number | undefined, cachedInputTokens: number | undefined, model: string | null | undefined, date?: Date): number;

package/dist/config/pricing.generated.d.ts

@@ -1,2 +1,6 @@
 import type { ModelPricing } from './pricing.types.js';
 export declare const MODEL_PRICING: Record<string, ModelPricing>;
+export declare const MODEL_PRICING_VERSION = 34;
+export declare const MODEL_PRICING_UPDATED = "2026-10-24T00:00:00Z";
+export declare const UNPUBLISHED_MODEL_IDS: ReadonlySet<string>;
+export declare const CATALOG_MODEL_IDS: ReadonlySet<string>;

package/dist/config/pricing.types.d.ts

@@ -3,3 +3,7 @@ export interface ModelPricing {
     cachedInput: number;
     output: number;
 }
+export interface ModelApiPricing {
+    inputPerMillionTokensUsd: number;
+    outputPerMillionTokensUsd: number;
+}

package/dist/config/timeout.config.d.ts

@@ -1,5 +1,9 @@
 export interface TimeoutConfig {
     queryMs: number;
     executeMs: number;
+    idleMs: number;
 }
+export declare const DEFAULT_IDLE_MS: number;
+export declare const DEFAULT_RESUME_TIMEOUT_MS = 60000;
+export declare function parseIdleEnvOverride(env?: NodeJS.ProcessEnv): number | undefined;
 export declare function getProviderTimeoutConfig(env?: NodeJS.ProcessEnv): TimeoutConfig;

package/dist/config/wi-boards.d.ts

@@ -0,0 +1,19 @@
+import type { CrewxProjectConfig } from '../types';
+export declare const DEFAULT_WI_BOARD_ID = "default";
+export declare const ARCHIVE_WI_BOARD_ID = "archive";
+export declare const DEFAULT_WI_WORKFLOW_ID = "wi-default-flow";
+export declare const WI_PLAN_WORKFLOW_ID = "wi-plan-flow";
+export declare const WI_DEFAULT_FLOW_FILENAME = "wi-default-flow.yaml";
+export declare const WI_PLAN_FLOW_FILENAME = "wi-plan-flow.yaml";
+export declare const WI_BOARD_ID_PATTERN: RegExp;
+export declare function isReservedWiBoardId(id: string): boolean;
+export interface ResolvedWiBoard {
+    id: string;
+    name: string;
+    workflowId: string;
+    description?: string;
+    goalId?: string;
+    system: boolean;
+    readOnly: boolean;
+}
+export declare function resolveWiBoards(config: CrewxProjectConfig | undefined): ResolvedWiBoard[];

package/dist/context-budget/continuity.d.ts

@@ -0,0 +1,63 @@
+import type { ConversationHighlight, ConversationThreadState, SemanticContinuityContext, TemplateMessage } from '../conversation/types.js';
+export declare const DEFAULT_PROTECTED_TURN_COUNT = 5;
+export declare const DEFAULT_HIGHLIGHT_BUDGET_PERCENT = 5;
+export declare const MAX_ACTIVE_HIGHLIGHTS = 12;
+export declare const MAX_ACTIVE_HIGHLIGHT_CHARS = 2000;
+export declare const MAX_THREAD_TITLE_CHARS = 200;
+export declare const MAX_THREAD_STATE_VALUE_CHARS = 64;
+export interface ConversationTurn {
+    taskId?: string;
+    messages: TemplateMessage[];
+    ordinal: number;
+}
+export interface GroupedConversationTurns {
+    turns: ConversationTurn[];
+    unpairedMessages: TemplateMessage[];
+    droppedMessages: TemplateMessage[];
+}
+export interface ConversationTurnSelection {
+    includedTurns: ConversationTurn[];
+    omittedTurns: ConversationTurn[];
+    protectedTurns: ConversationTurn[];
+    tokenCount: number;
+    protectedTokenCount: number;
+    overBudget: boolean;
+}
+export interface SelectConversationTurnsOptions {
+    turns: readonly ConversationTurn[];
+    maxTokenCount: number;
+    countTokens: (text: string) => number;
+    protectedTurnCount?: number;
+    materializeTurn?: (turn: ConversationTurn) => string;
+}
+export interface ConversationHighlightSelection {
+    includedHighlights: ConversationHighlight[];
+    omittedHighlights: ConversationHighlight[];
+    truncatedHighlights: number;
+    representedTaskIds: string[];
+    unrepresentedTaskIds: string[];
+    tokenCount: number;
+    budgetTokens: number;
+}
+export interface SelectConversationHighlightsOptions {
+    highlights: readonly ConversationHighlight[];
+    omittedTaskIds: readonly string[];
+    taskOrder: readonly string[];
+    maxTokenCount: number;
+    countTokens: (text: string) => number;
+    applySafetyCap?: boolean;
+}
+export declare function getConversationMessageTaskId(message: TemplateMessage): string | undefined;
+export declare function groupConversationTurns(messages: readonly TemplateMessage[]): GroupedConversationTurns;
+export declare function withoutDroppedAppCards(messages: readonly TemplateMessage[]): TemplateMessage[];
+export declare function materializeConversationTurn(turn: ConversationTurn, includeActivityLog?: boolean): string;
+export declare function selectConversationTurns(options: SelectConversationTurnsOptions): ConversationTurnSelection;
+export declare function buildThreadStateContext(state: ConversationThreadState | undefined): ConversationThreadState | undefined;
+export declare function selectConversationHighlights(options: SelectConversationHighlightsOptions): ConversationHighlightSelection;
+export interface BuildSemanticContinuityContextOptions {
+    highlights: readonly ConversationHighlight[];
+    omittedTaskIds: readonly string[];
+    representedTaskIds: readonly string[];
+    applySafetyCap?: boolean;
+}
+export declare function buildSemanticContinuityContext(options: BuildSemanticContinuityContextOptions): SemanticContinuityContext;

package/dist/context-budget/index.d.ts

@@ -0,0 +1,142 @@
+export declare const DEFAULT_INPUT_BUDGET_PERCENT = 60;
+export declare const MIN_INPUT_BUDGET_PERCENT = 30;
+export declare const MAX_INPUT_BUDGET_PERCENT = 80;
+export declare const INPUT_BUDGET_TOKENIZER_ENCODING = "o200k_base";
+export declare const FRESH_PROVIDER_INITIAL_INPUT_SEPARATOR = "\n\n---\n\n";
+export declare const FRESH_PROVIDER_INITIAL_INPUT_FRAMING = "system_prompt\\n\\n---\\n\\nmessage";
+export declare const RESUME_PROVIDER_INITIAL_INPUT_FRAMING = "message";
+export type InputBudgetUnresolvedReason = 'invalid_input_budget_percent' | 'provider_catalog_unavailable' | 'model_not_found' | 'context_window_tokens_unavailable';
+export type TokenizerFallbackReason = 'vendor_tokenizer_unavailable';
+export interface ResolveInputBudgetOptions {
+    provider: string;
+    model: string;
+    inputBudgetPercent?: number;
+}
+export interface TokenizerOptions {
+    provider?: string;
+    model?: string;
+}
+export interface TokenizerMetadata {
+    provider: string;
+    model: string;
+    encoding: typeof INPUT_BUDGET_TOKENIZER_ENCODING;
+    exact: boolean;
+    fallbackReason?: TokenizerFallbackReason;
+}
+export interface ResolvedInputBudget {
+    resolved: true;
+    requestedProvider: string;
+    provider: string;
+    model: string;
+    contextWindowTokens: number;
+    inputBudgetPercent: number;
+    inputBudgetTokens: number;
+    tokenizer: TokenizerMetadata;
+}
+export interface UnresolvedInputBudget {
+    resolved: false;
+    requestedProvider: string;
+    provider: string;
+    model: string;
+    reason: InputBudgetUnresolvedReason;
+    inputBudgetPercent?: number;
+    tokenizer: TokenizerMetadata;
+}
+export type ResolveInputBudgetResult = ResolvedInputBudget | UnresolvedInputBudget;
+export type ContextBudgetPhase = 'fresh' | 'resume';
+export type ProviderInitialInputFraming = typeof FRESH_PROVIDER_INITIAL_INPUT_FRAMING | typeof RESUME_PROVIDER_INITIAL_INPUT_FRAMING;
+export interface ContextBudgetLayoutCapability {
+    layoutId: string;
+    supportsSemanticContinuity: boolean;
+    slot: string | null;
+    requiredForOmittedTurns: boolean;
+    warning?: string;
+}
+export interface ContextBudgetActivityDegradation {
+    taskId: string;
+    taskDistance: number;
+    action: 'reduced' | 'omitted';
+}
+export type ContextBudgetAssemblyErrorCode = 'INPUT_BUDGET_EXCEEDED' | 'CONTINUITY_SLOT_REQUIRED';
+export declare class ContextBudgetLayoutError extends Error {
+    readonly layoutId: string;
+    readonly omittedTurnCount: number;
+    readonly code: "CONTINUITY_SLOT_REQUIRED";
+    constructor(message: string, layoutId: string, omittedTurnCount: number);
+}
+export interface ContextBudgetManifest {
+    runningInstructionAppsOmitted?: number;
+    phase: ContextBudgetPhase;
+    initialInputFraming: ProviderInitialInputFraming;
+    resolved: boolean;
+    reason?: InputBudgetUnresolvedReason;
+    requestedProvider: string;
+    requestedModel: string | null;
+    effectiveProvider: string;
+    effectiveModel: string | null;
+    contextWindowTokens: number | null;
+    inputBudgetPercent: number | null;
+    inputBudgetTokens: number | null;
+    tokenizer: TokenizerMetadata;
+    initialTokenCount: number | null;
+    finalTokenCount: number | null;
+    activityLogTokenCount: number | null;
+    activityIncludedEntries: number | null;
+    activityOmittedEntries: number | null;
+    activityRemovedForBudget: boolean;
+    activityNewestTaskTokenCap: number | null;
+    historyOriginalMessages: number;
+    historyIncludedMessages: number;
+    historyOmittedMessages: number;
+    turnOriginal: number;
+    turnIncluded: number;
+    turnOmitted: number;
+    highlightOriginal: number;
+    highlightIncluded: number;
+    highlightOmitted: number;
+    highlightTruncated: number;
+    representedOmittedTurns: number;
+    unrepresentedOmittedTurns: number;
+    activityDegraded: boolean;
+    activityIncludedTasks: number;
+    activityOmittedTasks: number;
+    activityDegradation: ContextBudgetActivityDegradation[];
+    highlightLookupFailed: boolean;
+    layoutCapability: ContextBudgetLayoutCapability;
+    overBudget: boolean;
+    overdriveProviderSuppressed?: boolean;
+}
+export interface TokenCountResult {
+    tokenCount: number;
+    tokenizer: TokenizerMetadata;
+}
+export interface TokenCounter {
+    metadata: TokenizerMetadata;
+    countTokens(text: string): number;
+}
+export interface FreshProviderInitialInput {
+    systemPrompt?: string | null;
+    message: string;
+}
+type PieceCacheEventType = 'hit' | 'miss' | 'evict' | 'full_encode';
+interface PieceCacheEvent {
+    type: PieceCacheEventType;
+    piece?: string;
+    tokenCount?: number;
+    reason?: 'special_token';
+}
+type PieceCacheObserver = (event: PieceCacheEvent) => void;
+interface TokenCounterInternalOptions {
+    pieceCacheMaxEntries?: number;
+    observePieceCache?: PieceCacheObserver;
+}
+export declare function normalizeInputBudgetProvider(provider: string): string;
+export declare function resolveTokenizerMetadata(options?: TokenizerOptions): TokenizerMetadata;
+export declare function countTokens(text: string, options?: TokenizerOptions): TokenCountResult;
+export declare function renderFreshProviderInitialInput(input: FreshProviderInitialInput): string;
+export declare function countFreshProviderInitialInput(input: FreshProviderInitialInput, count: (text: string) => number): number;
+export declare function createTokenCounter(options?: TokenizerOptions): TokenCounter;
+export declare function __createTokenCounterForTest(options?: TokenizerOptions, internalOptions?: TokenCounterInternalOptions): TokenCounter;
+export declare function resolveInputBudget(options: ResolveInputBudgetOptions): ResolveInputBudgetResult;
+export { DEFAULT_HIGHLIGHT_BUDGET_PERCENT, DEFAULT_PROTECTED_TURN_COUNT, MAX_ACTIVE_HIGHLIGHT_CHARS, MAX_ACTIVE_HIGHLIGHTS, MAX_THREAD_STATE_VALUE_CHARS, MAX_THREAD_TITLE_CHARS, buildSemanticContinuityContext, buildThreadStateContext, getConversationMessageTaskId, groupConversationTurns, materializeConversationTurn, selectConversationHighlights, selectConversationTurns, withoutDroppedAppCards, } from './continuity.js';
+export type { BuildSemanticContinuityContextOptions, ConversationHighlightSelection, ConversationTurn, ConversationTurnSelection, GroupedConversationTurns, SelectConversationHighlightsOptions, SelectConversationTurnsOptions, } from './continuity.js';

package/dist/conversation/index.d.ts

@@ -1,3 +1,3 @@
 export * from './types.js';
 export { toTaskReader } from './to-task-reader.js';
-export { toTemplateMessages } from './to-template-messages.js';
+export { LEGACY_UI_CARD_SAFE_SUMMARY, sanitizeLegacyUiCardText, sanitizeTemplateMessages, toTemplateMessages, } from './to-template-messages.js';

package/dist/conversation/sqlite-provider.d.ts

@@ -1,15 +1,18 @@
-import type { ConversationThread, FetchHistoryOptions, IConversationHistoryProvider, Platform } from './types';
+import type { ConversationHighlight, ConversationThread, ConversationThreadState, FetchHistoryOptions, IConversationHistoryProvider, Platform, ThreadCreationOptions } from './types';
 export declare class SqliteConversationProvider implements IConversationHistoryProvider {
     private readonly dbPath;
     constructor(dbPath?: string);
     private getThreadRepo;
+    private getThreadHistoryRepo;
     updateThread(id: string, patch: {
         title?: string;
     }): void;
-    ensureThread(threadId: string, platform: Platform, workspaceId?: string): Promise<{
+    ensureThread(threadId: string, platform: Platform, workspaceId?: string, creator?: ThreadCreationOptions): Promise<{
         created: boolean;
     }>;
     fetchHistory(threadId: string, options?: FetchHistoryOptions): Promise<ConversationThread>;
+    fetchThreadState(threadId: string): Promise<ConversationThreadState | undefined>;
+    fetchHighlights(threadId: string): Promise<ConversationHighlight[] | undefined>;
     saveUserMessage(threadId: string, text: string, _userId?: string, _metadata?: Record<string, unknown>): Promise<{
         id: string;
         firstMessage: boolean;
@@ -18,6 +21,6 @@ export declare class SqliteConversationProvider implements IConversationHistoryP
         id: string;
     }>;
     close(): void;
-    private normalizeStatus;
+    private readActiveHighlights;
     private rowsToMessages;
 }

package/dist/conversation/to-template-messages.d.ts

@@ -1,2 +1,11 @@
 import type { ConversationThread, TemplateMessage } from './types';
+import type { UiAgentContextProjection } from '../ui-instance/types.js';
+import type { McpAppStateDescriptor } from '../mcp-app/types.js';
+export declare const LEGACY_UI_CARD_SAFE_SUMMARY = "[workflow card omitted from AI context]";
+export declare const V2_UI_INSTANCE_SAFE_SUMMARY = "[workflow UI instance omitted from AI context]";
+export declare function sanitizeUiInstanceReferenceText(text: string): string;
+export declare function sanitizeLegacyUiCardText(text: string): string;
+export declare function sanitizeTemplateMessages(messages: readonly TemplateMessage[]): TemplateMessage[];
+export declare function appendUiProjections(messages: readonly TemplateMessage[], projections: readonly UiAgentContextProjection[] | undefined): TemplateMessage[];
+export declare function appendMcpAppProjections(messages: readonly TemplateMessage[], descriptors: readonly McpAppStateDescriptor[] | undefined): TemplateMessage[];
 export declare function toTemplateMessages(thread: ConversationThread): TemplateMessage[];