@botharness/core 1.4.0 → 1.4.1

package/dist/index.d.mts

@@ -1321,6 +1321,98 @@ interface ModelCatalog {
   defaultRoute?(): ModelRoute | undefined;
 }
 //#endregion
+//#region packages/core/src/sessions/source.d.ts
+interface DshSessionEvent {
+  type: string;
+  seq?: number;
+  surfaceOp?: unknown;
+  time: number;
+  data: unknown;
+}
+interface DshSessionHeader {
+  cwd?: string;
+  createdAt: number;
+  parentSession?: string;
+  origin?: 'subagent';
+}
+interface DshSession {
+  id: string;
+  header: DshSessionHeader;
+  snapshotEvents(): readonly DshSessionEvent[];
+}
+interface DshSessionStore {
+  get(sessionId: string): DshSession | undefined;
+  list(): readonly DshSession[];
+}
+//#endregion
+//#region packages/core/src/runtime/idle-compaction-settings.d.ts
+interface IdleCompactionRoute {
+  provider: string;
+  model: string;
+}
+interface IdleCompactionSettingsValue {
+  enabled: boolean;
+  cacheLifetimes: Record<string, number>;
+}
+interface RouteCacheObservation {
+  warmGapMs?: number;
+  coldGapMs?: number;
+  samples: number;
+}
+interface IdleCompactionSettings {
+  read(): IdleCompactionSettingsValue | 'invalid';
+  setEnabled(enabled: boolean): IdleCompactionSettingsValue;
+  setCacheLifetime(route: IdleCompactionRoute, seconds: number | null): IdleCompactionSettingsValue;
+  observations(): Record<string, RouteCacheObservation>;
+  saveObservation(key: string, observation: RouteCacheObservation): void;
+}
+//#endregion
+//#region packages/core/src/runtime/idle-compaction.d.ts
+type CacheLifetimeSource = 'setting' | 'catalog' | 'observed' | 'default' | 'unknown';
+type IdleCompactionOutcome = 'compacted' | 'nothing' | 'failed';
+interface IdleCompactionRecord {
+  botSlug: string;
+  at: string;
+  provider: string;
+  model: string;
+  idleGapMs: number;
+  cacheLifetimeMs: number;
+  cacheLifetimeSource: CacheLifetimeSource;
+  tokensBefore: number;
+  tokensAfter: number | null;
+  outcome: IdleCompactionOutcome;
+  error?: string;
+  inputTokens: number | null;
+  cacheReadTokens: number | null;
+  outputTokens: number | null;
+}
+interface IdleCompactionRouteView {
+  provider: string;
+  model: string;
+  cacheLifetimeSeconds: number | null;
+  source: CacheLifetimeSource;
+  compactAfterSeconds: number | null;
+  overrideSeconds: number | null;
+  observedWarmGapSeconds: number | null;
+  observedColdGapSeconds: number | null;
+}
+type ManualCompactionOutcome = 'compacted' | 'nothing' | 'busy' | 'not-loaded';
+interface ManualCompactionResult {
+  outcome: ManualCompactionOutcome;
+  tokensBefore: number | null;
+  tokensAfter: number | null;
+}
+interface IdleCompaction {
+  compactNow(sessionId: string): Promise<ManualCompactionResult>;
+  observeEvent(sessionId: string, event: DshSessionEvent): void;
+  agentStatus(sessionId: string, status: string): void;
+  rescan(sessionIds: readonly string[]): void;
+  forget(sessionId: string): void;
+  describe(routes: readonly IdleCompactionRoute[]): IdleCompactionRouteView[];
+  scheduled(): number;
+  close(): void;
+}
+//#endregion
 //#region packages/core/src/messaging/im-commands.d.ts
 interface ImCommandServices {
   botDisplayName(botSlug: string): string | undefined;
@@ -1333,6 +1425,7 @@ interface ImCommandServices {
   } | undefined>;
   startFreshOrchestrator(botSlug: string, assertCurrent?: () => void): Promise<'started' | 'busy'>;
   turnRunning(botSlug: string): boolean;
+  compact(botSlug: string): Promise<ManualCompactionResult>;
 }
 //#endregion
 //#region node_modules/.pnpm/@deepseek-ai+dsh-brand@0.2.1-rc.2_@deepseek-ai+cordis@4.0.5/node_modules/@deepseek-ai/dsh-brand/lib/types/index.d.ts
@@ -4564,6 +4657,7 @@ interface ChannelStore {
   }): ChannelMessage | undefined;
   rename(id: string, name: string): ChannelRecord | undefined;
   previewAllBotMention(id: string): AllBotPreview;
+  grantRequestResolution?(channelId: string, requestMessageId: string): ChannelMessage | undefined;
   appendMessageOnce(id: string, message: ChannelMessage, preview?: AllBotPreview, origin?: ChannelMessageOrigin, canCommit?: (database?: DatabaseSync) => boolean): Promise<ChannelAppendOnceResult>;
   readPosition(id: string): ChannelReadPosition | undefined;
   markRead(id: string, messageId: string): Promise<ChannelReadPosition | undefined>;
@@ -4664,7 +4758,7 @@ interface SessionOwnership {
 export declare function createSessionOwnership(database: OperationalDatabaseModulePort): SessionOwnership;
 //#endregion
 //#region packages/core/src/workspaces/tool-approval-rules.d.ts
-type ToolRuleKind = 'exact' | 'all-opaque' | 'secret-cli';
+type ToolRuleKind = 'exact' | 'tool' | 'all-opaque' | 'secret-cli';
 interface ToolApprovalRule {
   id: string;
   botSlug: string;
@@ -4764,6 +4858,7 @@ interface ToolApprovalRequestCard {
   input: string;
   externalDecision?: 'operation' | 'web-only' | 'each-use';
   botCreatePreview?: BotCreatePreview;
+  allowAlways?: boolean;
 }
 interface ToolApprovalNotice extends ToolApprovalRequestCard {
   botSlug: string;
@@ -4775,7 +4870,7 @@ interface ToolApprovalNotice extends ToolApprovalRequestCard {
 interface ToolApprovalDecision {
   requestMessageId: string;
   actor?: ToolApprovalActor;
-  outcome: 'allowed-once' | 'allowed-always-exact' | 'allowed-always-all' | 'rejected';
+  outcome: 'allowed-once' | 'allowed-always-tool' | 'allowed-always-exact' | 'allowed-always-all' | 'rejected';
 }
 interface ToolAutoApproval {
   template(botSlug: string): {
@@ -4808,7 +4903,7 @@ declare class ChannelToolApproval {
   constructor(channels: ChannelStore, ownership: SessionOwnership, rules?: ToolApprovalRuleStore, scope?: (agent: Agent, owner: SessionOwnershipRecord) => string | undefined, attention?: {
     changed(slug: string, count: number): void;
     warn(message: string): void;
-  }, beginWait?: (sessionId: string, callId: string, signal: AbortSignal) => AssignmentApprovalWaitLease | undefined, askChannel?: (sessionId: string) => string | undefined, autoApproval?: ToolAutoApproval);
+  }, beginWait?: (sessionId: string, callId: string, signal: AbortSignal) => AssignmentApprovalWaitLease | undefined, askChannel?: (sessionId: string) => string | undefined, autoApproval?: ToolAutoApproval, fullAccess?: (sessionId: string) => boolean);
   track(execution: ToolExecution, externalDecision?: 'operation' | 'web-only' | 'each-use', rememberable?: boolean, device?: 'computer' | 'browser', botCreatePreview?: BotCreatePreview, options?: {
     requireHumanReview?: boolean;
   }): (() => void) | undefined;
@@ -9171,6 +9266,7 @@ interface ChannelMessage {
   toolAutoApprovalOverride?: ChannelToolAutoApprovalOverride;
   botCausation?: BotMessageCausation;
   grantRequest?: true;
+  grantRequestOwner?: string;
   grantRequestResolved?: boolean;
   assignmentReply?: {
     sessionId: string;
@@ -10765,6 +10861,10 @@ interface WorkspaceGrantStore {
   revoke(botSlug: string, grantId: string): WorkspaceGrant;
   requireActive(botSlug: string, grantId: string): WorkspaceGrant;
   setOrchestratorWrite(botSlug: string, grantId: string, enabled: boolean): WorkspaceGrant;
+  prepareWrite?(botSlug: string, workspaceId: string, validate: () => void): Promise<{
+    grant: WorkspaceGrant;
+    commit(database?: DatabaseSync): boolean;
+  }>;
   availableWorkspaces(): {
     id: string;
     path: string;
@@ -11416,6 +11516,36 @@ declare function createMemoryFiles(registry: PersonaBotRegistry): {
   };
 };
 //#endregion
+//#region packages/core/src/media/image-format.d.ts
+type ImageMime = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' | 'image/svg+xml';
+//#endregion
+//#region packages/core/src/memory/image.d.ts
+interface MemoryImage {
+  mime?: ImageMime;
+  source: string;
+  status: 'ready' | 'missing' | 'unsupported' | 'too-large' | 'stale';
+  revision?: string;
+  size?: number;
+  width?: number;
+  height?: number;
+}
+interface MemoryImageComparison {
+  before?: MemoryImage;
+  after?: MemoryImage;
+}
+//#endregion
+//#region packages/core/src/memory/markdown.d.ts
+interface MemoryMarkdown {
+  source: string;
+  status: 'ready' | 'missing' | 'unsupported' | 'too-large' | 'stale';
+  revision?: string;
+  body: string;
+}
+interface MemoryMarkdownComparison {
+  before?: MemoryMarkdown;
+  after?: MemoryMarkdown;
+}
+//#endregion
 //#region packages/core/src/memory/recovery.d.ts
 type MemoryCheckpointOrigin = 'host-observation' | 'agent-session' | 'human-command';
 interface MemoryRecoveryCheckpoint {
@@ -11513,6 +11643,8 @@ interface MemoryGitCommitDiff {
   files: {
     path: string;
     status: string;
+    images?: MemoryImageComparison;
+    markdown?: MemoryMarkdownComparison;
   }[];
   diff: string;
 }
@@ -11523,6 +11655,8 @@ interface MemoryWorkingChange {
   status: string;
 }
 interface MemoryWorkingDiff extends MemoryWorkingChange {
+  images?: MemoryImageComparison;
+  markdown?: MemoryMarkdownComparison;
   diff: string;
   binary: boolean;
 }
@@ -11573,7 +11707,11 @@ interface MemoryAcceptance {
     body: string;
     head: string;
     binary?: boolean;
+    image?: MemoryImage;
+    markdown?: MemoryMarkdown;
   } | undefined;
+  markdownImageFile(botSlug: string, path: string, source: string, revision: string, reference: string): Buffer;
+  imageFile(botSlug: string, path: string, source: string, revision: string): Buffer;
   history(botSlug: string, limit?: number): MemoryAcceptedCommit[];
   diff(botSlug: string, sha: string): {
     sha: string;
@@ -11756,30 +11894,6 @@ interface MemoryService extends MemoryAcceptance, ReturnType<typeof createMemory
 }
 export declare function createMemoryService(options: MemoryServiceOptions): MemoryService;
 //#endregion
-//#region packages/core/src/sessions/source.d.ts
-interface DshSessionEvent {
-  type: string;
-  seq?: number;
-  surfaceOp?: unknown;
-  time: number;
-  data: unknown;
-}
-interface DshSessionHeader {
-  cwd?: string;
-  createdAt: number;
-  parentSession?: string;
-  origin?: 'subagent';
-}
-interface DshSession {
-  id: string;
-  header: DshSessionHeader;
-  snapshotEvents(): readonly DshSessionEvent[];
-}
-interface DshSessionStore {
-  get(sessionId: string): DshSession | undefined;
-  list(): readonly DshSession[];
-}
-//#endregion
 //#region packages/core/src/usage/message-perf.d.ts
 interface MessagePerfTracker {
   observeSessionEvent(sessionId: string, event: DshSessionEvent): void;
@@ -12274,7 +12388,7 @@ interface OrchestratorChannelAccess {
     ref: ChannelAttachmentRef;
     data: Uint8Array;
   }>;
-  requestGrant(reason: string): Promise<ChannelMessage>;
+  requestGrant(reason: string, channelId?: string): Promise<ChannelMessage>;
   contacts(input?: BotContactQuery): BotContactPage;
   createGroup(name: string): ChannelRecord;
   inviteGroup(input: {
@@ -12443,6 +12557,7 @@ interface BotRuntime {
   replaceOrchestrator?<T>(botSlug: string, body: () => T): Promise<OrchestratorReplacement<T>>;
   startFreshOrchestrator?(botSlug: string, assertCurrent?: () => void): Promise<'started' | 'busy'>;
   turnRunning?(botSlug: string): boolean;
+  hasPendingInbox?(botSlug: string): boolean;
   directBotTools?(): DirectBotToolSpec[];
   directBotToolCalls?(botSlug: string): readonly DirectBotToolCall[];
   runDirectBotTool?(botSlug: string, tool: string, args: Record<string, unknown>, signal: AbortSignal): Promise<{
@@ -12626,6 +12741,8 @@ type RosterLiveFrame = {
   placements: PurgedPlacement[];
 } | {
   type: 'changed';
+} | {
+  type: 'attention';
 } | {
   type: 'latest';
   channelId: string;
@@ -13426,6 +13543,14 @@ interface HumanAttentionPage {
   items: HumanAttentionItem[];
   nextCursor?: string;
 }
+interface HumanAttentionStatus {
+  unreadCount: number;
+  hasAction: boolean;
+  messageCounts?: {
+    replies: number;
+    other: number;
+  };
+}
 interface HumanAttentionQuery {
   item(id: string, sourceKey?: string): HumanAttentionItem | undefined;
   assignmentContext(botSlug: string, sessionId: string, sourceEventId: string): HumanAssignmentContext | undefined;
@@ -13443,14 +13568,12 @@ interface HumanAttentionQuery {
     cursor?: string;
     limit?: number;
   }): HumanAttentionPage;
-  status(): {
-    unreadCount: number;
-    hasAction: boolean;
-  };
+  status(messageCounts?: boolean): HumanAttentionStatus;
   unreadByChannel(): Array<{
     channelId: string;
     unreadCount: number;
   }>;
+  dmReplies(limit: number): HumanAttentionItem[];
   durableAttention(): Array<{
     botSlug: string;
     waitingHumanCount: number;
@@ -13593,6 +13716,8 @@ interface UsageProjection {
   sessionSummary(botSlug: string, sessionId: string, sinceIso: string, readLog: DshUsageSessionLogReader): Promise<SessionUsageSummary>;
   overview(period: UsageOverviewPeriod, after?: string): UsageOverviewResult;
   purgeBot(botSlug: string, removeFiles?: () => void): void;
+  recordIdleCompaction(record: IdleCompactionRecord): void;
+  idleCompactions(botSlug: string, sinceIso: string): IdleCompactionRecord[];
 }
 //#endregion
 //#region packages/core/src/plugin.d.ts
@@ -13967,6 +14092,12 @@ export declare class ProfileBackupError extends Error {
 //#region packages/core/src/portability/cli.d.ts
 export declare function runProfileRestoreCli(argv: readonly string[]): Promise<void>;
 //#endregion
+//#region packages/core/src/workspaces/grant-requests.d.ts
+interface GrantRequestApprovalResult {
+  grant: WorkspaceGrant;
+  message: ChannelMessage;
+}
+//#endregion
 //#region packages/core/src/cloud/management.d.ts
 type CloudManagementInput = {
   operation: 'list';
@@ -14511,12 +14642,14 @@ interface BridgeMethods {
   onboardingModel(payload: unknown): Promise<BridgeResult<{
     revision: number;
   }>>;
+  introEvent(payload: unknown): BridgeResult<null>;
   channelRetry(payload: unknown): Promise<BridgeResult<{
     accepted: true;
   }>>;
   botNewSession(payload: unknown): Promise<BridgeResult<{
     started: true;
   }>>;
+  botCompact(payload: unknown): Promise<BridgeResult<ManualCompactionResult>>;
   channelBotStop(payload: unknown): Promise<BridgeResult<{
     stopped: {
       botSlug: string;
@@ -14780,10 +14913,7 @@ interface BridgeMethods {
   humanAssignmentContext(payload: unknown): BridgeResult<{
     context: HumanAssignmentContext;
   }>;
-  humanAttentionStatus(payload: unknown): BridgeResult<{
-    unreadCount: number;
-    hasAction: boolean;
-  }>;
+  humanAttentionStatus(payload: unknown): BridgeResult<HumanAttentionStatus>;
   channelUnreadCounts(payload: unknown): BridgeResult<{
     channels: Array<{
       channelId: string;
@@ -14832,6 +14962,7 @@ interface BridgeMethods {
   grantRevoke(payload: unknown): BridgeResult<{
     grant: WorkspaceGrant;
   }>;
+  grantRequestApprove(payload: unknown): Promise<BridgeResult<GrantRequestApprovalResult>>;
   grantWriteSet(payload: unknown): BridgeResult<{
     grant: WorkspaceGrant;
   }>;
@@ -14920,6 +15051,9 @@ interface BridgeMethods {
       path: string;
       body: string;
       head: string;
+      binary?: boolean;
+      image?: MemoryImage;
+      markdown?: MemoryMarkdown;
     };
   }>;
   memoryHistory(payload: unknown): BridgeResult<{
@@ -15029,6 +15163,9 @@ interface BridgeMethods {
   }>;
   approvalReviewerModel(payload?: unknown): Promise<BridgeResult<ApprovalReviewerModelView>>;
   approvalReviewerModelSet(payload: unknown): Promise<BridgeResult<ApprovalReviewerModelView>>;
+  idleCompaction(payload?: unknown): BridgeResult<IdleCompactionView>;
+  idleCompactionSet(payload: unknown): BridgeResult<IdleCompactionView>;
+  idleCompactionCacheLifetimeSet(payload: unknown): BridgeResult<IdleCompactionView>;
   standingLimitsSet(payload: unknown): BridgeResult<{
     bot: PersonaBotDetail;
   }>;
@@ -15116,7 +15253,22 @@ interface ApprovalReviewerModelView {
   available?: boolean;
   unavailableReason?: string;
 }
+interface IdleCompactionView {
+  enabled: boolean;
+  settingReadable: boolean;
+  minimumIdleSeconds: number;
+  scheduled: number;
+  routes: IdleCompactionRouteView[];
+}
+interface IdleCompactionDeps {
+  settings: IdleCompactionSettings;
+  scheduler: Pick<IdleCompaction, 'describe' | 'scheduled'>;
+  routes(): IdleCompactionRoute[];
+  rescan(): void;
+  compactBot?(slug: string): Promise<ManualCompactionResult>;
+}
 interface BridgeMethodsDeps {
+  idleCompaction?: IdleCompactionDeps;
   cloudConnections?: CloudConnections;
   cloudWork?: CloudWork;
   approvalReviewer?: ApprovalReviewerSettings;
@@ -15447,6 +15599,7 @@ export declare class BotharnessBridgeService extends TypertRemoteService {
   onboardingModel(slug: string | undefined, expectedRevision: number, route: ModelRoute, globalDefault: boolean, expectedDefaultRevision?: number): Promise<{
     revision: number;
   }>;
+  introEvent(event: string, properties?: Record<string, string | boolean>): null;
   modelPlanInherit(slug: string, expectedRevision: number): {
     revision: number;
   };
@@ -15456,6 +15609,7 @@ export declare class BotharnessBridgeService extends TypertRemoteService {
   botNewSession(slug: string): Promise<{
     started: true;
   }>;
+  botCompact(slug: string): Promise<ManualCompactionResult>;
   channelBotStop(channelId: string, botSlug: string): Promise<{
     stopped: {
       botSlug: string;
@@ -15562,6 +15716,9 @@ export declare class BotharnessBridgeService extends TypertRemoteService {
   };
   approvalReviewerModel(): Promise<ApprovalReviewerModelView>;
   approvalReviewerModelSet(model: ModelRoute | null): Promise<ApprovalReviewerModelView>;
+  idleCompaction(): IdleCompactionView;
+  idleCompactionSet(enabled: boolean): IdleCompactionView;
+  idleCompactionCacheLifetimeSet(provider: string, model: string, seconds: number | null): IdleCompactionView;
   standingLimitsSet(slug: string, soul: number, coreMemory: number): {
     bot: PersonaBotDetail;
   };
@@ -15701,10 +15858,7 @@ export declare class BotharnessBridgeService extends TypertRemoteService {
   channelActivityToday(): ChannelActivityToday;
   activityOverview(): ActivityOverview;
   humanAttention(category?: HumanAttentionCategory, botSlug?: string, channelId?: string, limit?: number, cursor?: string, sort?: 'newest' | 'oldest' | 'mentions-first', snoozed?: boolean, kind?: 'auto-rejection', search?: string, unreadOnly?: boolean, queryVersion?: number): HumanAttentionPage;
-  humanAttentionStatus(): {
-    unreadCount: number;
-    hasAction: boolean;
-  };
+  humanAttentionStatus(messageCounts?: boolean): HumanAttentionStatus;
   channelUnreadCounts(): {
     channels: Array<{
       channelId: string;
@@ -15768,6 +15922,7 @@ export declare class BotharnessBridgeService extends TypertRemoteService {
   grantRevoke(slug: string, grantId: string): {
     grant: WorkspaceGrant;
   };
+  grantRequestApprove(slug: string, channelId: string, requestMessageId: string, workspaceId: string, acknowledgeReadWrite: boolean): Promise<GrantRequestApprovalResult>;
   grantWriteSet(slug: string, grantId: string, enabled: boolean): {
     grant: WorkspaceGrant;
   };
@@ -15787,7 +15942,7 @@ export declare class BotharnessBridgeService extends TypertRemoteService {
     status: 'pending' | 'expired';
     execution?: 'waiting-human' | 'waiting-capacity' | 'running' | 'settled' | 'needs-repair';
   };
-  toolApprovalDecide(channelId: string, messageId: string, outcome: 'allowed-once' | 'allowed-always-exact' | 'allowed-always-all' | 'rejected'): Promise<{
+  toolApprovalDecide(channelId: string, messageId: string, outcome: 'allowed-once' | 'allowed-always-tool' | 'allowed-always-exact' | 'allowed-always-all' | 'rejected'): Promise<{
     accepted: boolean;
   }>;
   toolAutoRejectionOverride(itemId: string): Promise<{
@@ -15855,6 +16010,9 @@ export declare class BotharnessBridgeService extends TypertRemoteService {
       path: string;
       body: string;
       head: string;
+      binary?: boolean;
+      image?: MemoryImage;
+      markdown?: MemoryMarkdown;
     };
   };
   memoryHistory(channelId: string): {