@crewx/sdk 0.9.0-rc.74 → 0.9.0-rc.76

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

@@ -0,0 +1,53 @@
+import type { ConversationHighlight, SemanticContinuityContext, TemplateMessage } from '../conversation/types.js';
+export declare const DEFAULT_PROTECTED_TURN_COUNT = 5;
+export declare const DEFAULT_HIGHLIGHT_BUDGET_PERCENT = 5;
+export interface ConversationTurn {
+    taskId?: string;
+    messages: TemplateMessage[];
+    ordinal: number;
+}
+export interface GroupedConversationTurns {
+    turns: ConversationTurn[];
+    unpairedMessages: 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[];
+    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;
+}
+export declare function getConversationMessageTaskId(message: TemplateMessage): string | undefined;
+export declare function groupConversationTurns(messages: readonly TemplateMessage[]): GroupedConversationTurns;
+export declare function materializeConversationTurn(turn: ConversationTurn, includeActivityLog?: boolean): string;
+export declare function selectConversationTurns(options: SelectConversationTurnsOptions): ConversationTurnSelection;
+export declare function selectConversationHighlights(options: SelectConversationHighlightsOptions): ConversationHighlightSelection;
+export interface BuildSemanticContinuityContextOptions {
+    highlights: readonly ConversationHighlight[];
+    omittedTaskIds: readonly string[];
+    representedTaskIds: readonly string[];
+}
+export declare function buildSemanticContinuityContext(options: BuildSemanticContinuityContextOptions): SemanticContinuityContext;

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

@@ -45,6 +45,25 @@ export interface UnresolvedInputBudget {
 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 {
     phase: ContextBudgetPhase;
     initialInputFraming: ProviderInitialInputFraming;
@@ -68,6 +87,20 @@ export interface ContextBudgetManifest {
     historyOriginalMessages: number;
     historyIncludedMessages: number;
     historyOmittedMessages: number;
+    turnOriginal: number;
+    turnIncluded: number;
+    turnOmitted: number;
+    highlightOriginal: number;
+    highlightIncluded: number;
+    highlightOmitted: number;
+    representedOmittedTurns: number;
+    unrepresentedOmittedTurns: number;
+    activityDegraded: boolean;
+    activityIncludedTasks: number;
+    activityOmittedTasks: number;
+    activityDegradation: ContextBudgetActivityDegradation[];
+    highlightLookupFailed: boolean;
+    layoutCapability: ContextBudgetLayoutCapability;
     overBudget: boolean;
 }
 export interface TokenCountResult {
@@ -102,4 +135,5 @@ export declare function countFreshProviderInitialInput(input: FreshProviderIniti
 export declare function createTokenCounter(options?: TokenizerOptions): TokenCounter;
 export declare function __createTokenCounterForTest(options?: TokenizerOptions, internalOptions?: TokenCounterInternalOptions): TokenCounter;
 export declare function resolveInputBudget(options: ResolveInputBudgetOptions): ResolveInputBudgetResult;
-export {};
+export { DEFAULT_HIGHLIGHT_BUDGET_PERCENT, DEFAULT_PROTECTED_TURN_COUNT, buildSemanticContinuityContext, getConversationMessageTaskId, groupConversationTurns, materializeConversationTurn, selectConversationHighlights, selectConversationTurns, } from './continuity.js';
+export type { BuildSemanticContinuityContextOptions, ConversationHighlightSelection, ConversationTurn, ConversationTurnSelection, GroupedConversationTurns, SelectConversationHighlightsOptions, SelectConversationTurnsOptions, } from './continuity.js';

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

@@ -1,8 +1,9 @@
-import type { ConversationThread, FetchHistoryOptions, IConversationHistoryProvider, Platform } from './types';
+import type { ConversationHighlight, ConversationThread, FetchHistoryOptions, IConversationHistoryProvider, Platform } 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;
@@ -10,6 +11,7 @@ export declare class SqliteConversationProvider implements IConversationHistoryP
         created: boolean;
     }>;
     fetchHistory(threadId: string, options?: FetchHistoryOptions): Promise<ConversationThread>;
+    fetchHighlights(threadId: string): Promise<ConversationHighlight[] | undefined>;
     saveUserMessage(threadId: string, text: string, _userId?: string, _metadata?: Record<string, unknown>): Promise<{
         id: string;
         firstMessage: boolean;
@@ -19,5 +21,6 @@ export declare class SqliteConversationProvider implements IConversationHistoryP
     }>;
     close(): void;
     private normalizeStatus;
+    private readActiveHighlights;
     private rowsToMessages;
 }

package/dist/conversation/types.d.ts

@@ -4,13 +4,38 @@ export interface ConversationMessage {
     text: string;
     isAssistant: boolean;
     timestamp: number;
+    taskId?: string;
     metadata?: Record<string, unknown>;
 }
 export type Platform = 'cli' | 'web' | 'api' | 'mcp' | `channel/${string}`;
+export interface ConversationHighlight {
+    id: string;
+    text: string;
+    kind?: string;
+    source?: string;
+    coversFromTaskId?: string;
+    coversToTaskId?: string;
+    covers_from_task_id?: string;
+    covers_to_task_id?: string;
+    createdAt?: number | string;
+    created_at?: number | string;
+}
+export interface SemanticContinuityContext {
+    highlights: ConversationHighlight[];
+    omittedTurns: {
+        count: number;
+        represented: number;
+        unrepresented: number;
+        taskIds: string[];
+    };
+    rendered?: string;
+}
+export type ConversationSemanticContinuityContext = SemanticContinuityContext;
 export interface ConversationThread {
     threadId: string;
     platform: Platform;
     messages: ConversationMessage[];
+    highlights?: ConversationHighlight[];
     metadata?: {
         title?: string;
         firstMessage?: string;
@@ -20,8 +45,10 @@ export interface ConversationThread {
     };
 }
 export interface TemplateMessage {
+    id?: string;
     text: string;
     isAssistant: boolean;
+    taskId?: string;
     timestamp?: number;
     metadata?: Record<string, unknown>;
     activity_log?: string;
@@ -41,6 +68,7 @@ export interface IConversationHistoryProvider {
         created: boolean;
     }>;
     fetchHistory(threadId: string, options?: FetchHistoryOptions): Promise<ConversationThread>;
+    fetchHighlights?(threadId: string): Promise<ConversationHighlight[] | undefined>;
     saveUserMessage(threadId: string, text: string, userId?: string, metadata?: Record<string, unknown>): Promise<{
         id: string;
         firstMessage: boolean;