@botharness/core 1.0.1 → 1.1.0

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import { DatabaseSync } from "node:sqlite";
 import { ToolCallKind, ToolCallView, ToolExecution } from "@deepseek-ai/dsh-tools";
 import { BlockAssembler, ContextFormed, ToolCallId } from "@deepseek-ai/dsh-llm";
-import { Agent, AgentHandle, AssistantStreamFrame, CreateAgentOptions, ModelSelection, ResumeAgentOptions } from "@deepseek-ai/dsh-agent";
 import { Session, SessionId } from "@deepseek-ai/dsh-session";
+import { Agent, AgentHandle, AssistantStreamFrame, CreateAgentOptions, ModelSelection, ResumeAgentOptions } from "@deepseek-ai/dsh-agent";
 //#region node_modules/.pnpm/@deepseek-ai+cosmokit@1.8.5/node_modules/@deepseek-ai/cosmokit/lib/types/types.d.ts
 declare function isArrayBufferLike(value: any): value is ArrayBufferLike;
 declare function isArrayBufferSource(value: any): value is Binary.Source;
@@ -8021,6 +8021,11 @@ interface MessagingAttachment {
   sizeBytes?: number;
   mediaType?: string;
 }
+interface MessagingVoice {
+  transcript: 'platform' | 'unavailable';
+  itemId?: string;
+  durationMs?: number;
+}
 interface MessagingInboundEvent {
   version: 1;
   channel: 'feishu' | 'slack' | 'discord' | 'weixin';
@@ -8046,6 +8051,7 @@ interface MessagingInboundEvent {
   at: string;
   text: string;
   attachments?: MessagingAttachment[];
+  voice?: MessagingVoice;
   reply: MessagingReplyRoute;
   replay: {
     kind: 'provider-redelivery';
@@ -8157,6 +8163,7 @@ interface MessagingProvider {
       id: string;
       name: string;
       bytes: Uint8Array;
+      mediaType?: string;
     };
     signal: AbortSignal;
     beforeSend?: () => boolean;
@@ -8297,6 +8304,16 @@ interface InboundMessaging {
   close(): void;
 }
 //#endregion
+//#region packages/core/src/telemetry/service.d.ts
+type TelemetryValue = string | number | boolean;
+type TelemetryCapture = (event: string, properties?: Record<string, TelemetryValue>) => void;
+type TelemetryLock = 'config' | 'DO_NOT_TRACK' | 'BOTHARNESS_TELEMETRY';
+interface TelemetryStatus {
+  enabled: boolean;
+  preference: boolean;
+  lockedBy?: TelemetryLock;
+}
+//#endregion
 //#region packages/core/src/messaging/outbound.d.ts
 interface MessagingGrant {
   id: string;
@@ -8432,8 +8449,21 @@ export declare function createOutboundMessaging(options: {
   recover?: boolean;
   now?: () => Date;
   warn?: (message: string) => void;
+  capture?: TelemetryCapture;
 }): OutboundMessaging;
 //#endregion
+//#region packages/core/src/memory/soul.d.ts
+interface StandingLimits {
+  soul: number;
+  coreMemory: number;
+}
+interface StandingUsage {
+  path: string;
+  role: 'soul' | 'coreMemory';
+  chars: number;
+  limit: number;
+}
+//#endregion
 //#region packages/core/src/models/presets.d.ts
 interface ModelRoute {
   provider: string;
@@ -8698,6 +8728,7 @@ interface PersonaBotRecord {
   computerAccess?: boolean;
   browserAccess?: boolean;
   browserProfile?: string;
+  standingLimits?: StandingLimits;
 }
 interface CreatePersonaBotInput {
   slug: string;
@@ -8886,6 +8917,10 @@ interface PersonaBotRegistryOptions {
   initializeMemory?: (memoryDir: string) => MemoryRepositoryInitialization;
   cloneMemory?: (destination: string, url: string) => Promise<MemoryCloneResult>;
   onPurge?: (slug: string, removeFiles: () => void) => void;
+  capture?: TelemetryCapture;
+  syncDescriptor?: (memoryDir: string, record: PersonaBotRecord, options: {
+    onlyIfMissing: boolean;
+  }) => void;
 }
 interface PersonaBotRegistry {
   rootDir: string;
@@ -8904,6 +8939,7 @@ interface PersonaBotRegistry {
   setComputerAccess(slug: string, enabled: boolean): UpdatePersonaBotResult;
   setBrowserAccess(slug: string, enabled: boolean): UpdatePersonaBotResult;
   setBrowserProfile(slug: string, profile: string): UpdatePersonaBotResult;
+  setStandingLimits(slug: string, limits: StandingLimits): UpdatePersonaBotResult;
   applyModelPreset(slug: string, preset: ModelPreset): UpdatePersonaBotResult;
   migrateLegacyModel(slug: string, expectedModel: string, route: ModelRoute): UpdatePersonaBotResult;
   customizeModelPlan(slug: string, orchestrator: PersonaBotModelPlan['orchestrator'], expectedRevision: number): UpdatePersonaBotResult;
@@ -8995,6 +9031,7 @@ interface MemoryAcceptedSnapshot {
   head: string | null;
   files: string[];
   provisional: boolean;
+  standing: StandingUsage[];
 }
 interface MemoryChangeDelta {
   summary: string;
@@ -9193,7 +9230,7 @@ interface MemoryStore {
   read(path: string): MemoryEntry | undefined;
   write(input: MemoryWriteInput): Promise<MemoryWriteResult>;
   search(query: string): Promise<MemorySearchHit[]>;
-  persona(): string | undefined;
+  standingPrompt(limits?: StandingLimits): string;
   history(limit?: number): MemoryCommit[];
 }
 export declare function createMemoryStore(options: MemoryStoreOptions): MemoryStore;
@@ -9260,6 +9297,81 @@ interface AssignmentReportPage {
   estimatedTokens: number;
 }
 //#endregion
+//#region packages/core/src/schedules/bot-schedules.d.ts
+type BotScheduleTrigger = {
+  kind: 'every';
+  everySeconds: number;
+} | {
+  kind: 'daily';
+  time: string;
+  timeZone: string;
+} | {
+  kind: 'weekly';
+  time: string;
+  timeZone: string;
+  weekdays: number[];
+} | {
+  kind: 'once';
+  date: string;
+  time: string;
+  timeZone: string;
+} | {
+  kind: 'cron';
+  expression: string;
+  timeZone: string;
+};
+type BotScheduleCreator = 'human' | 'personabot';
+type BotScheduleFiringState = 'pending' | 'observed' | 'handled' | 'coalesced' | 'skipped';
+interface BotScheduleFiring {
+  id: string;
+  scheduleId: string;
+  trigger: 'planned' | 'manual';
+  occurrenceAt: string;
+  firedAt: string;
+  state: BotScheduleFiringState;
+  sourceEventId?: string;
+  sessionId?: string;
+}
+interface BotSchedule {
+  id: string;
+  botSlug: string;
+  title: string;
+  prompt: string;
+  trigger: BotScheduleTrigger;
+  enabled: boolean;
+  creator: BotScheduleCreator;
+  locked: boolean;
+  nextRunAt?: string;
+  lastFiring?: BotScheduleFiring;
+  createdAt: string;
+  updatedAt: string;
+}
+interface BotScheduleInput {
+  title: string;
+  prompt: string;
+  trigger: BotScheduleTrigger;
+  enabled?: boolean;
+  locked?: boolean;
+}
+interface BotScheduleChange {
+  title?: string;
+  prompt?: string;
+  trigger?: BotScheduleTrigger;
+  enabled?: boolean;
+  locked?: boolean;
+}
+interface BotScheduleStore {
+  list(botSlug: string): BotSchedule[];
+  create(botSlug: string, input: BotScheduleInput, creator: BotScheduleCreator): BotSchedule;
+  update(botSlug: string, id: string, change: BotScheduleChange, actor: BotScheduleCreator): BotSchedule;
+  remove(botSlug: string, id: string, actor: BotScheduleCreator): boolean;
+  history(botSlug: string, id: string): BotScheduleFiring[];
+  runNow(botSlug: string, id: string): BotScheduleFiring;
+  tick(): void;
+  start(): void;
+  close(): void;
+}
+//#endregion
 //#region packages/core/src/runtime/bot-runtime.d.ts
 type AssignmentActivity = 'working' | 'idle' | 'error' | 'stopping' | 'stopped';
 type AssignmentReportState = 'progress' | 'completed' | 'blocked' | 'waiting-human' | 'failed';
@@ -9408,6 +9520,12 @@ interface OrchestratorAgentRun {
     resetImmediateDelivery(sourceClass: 'human-dm' | 'bot-dm' | 'group-mention'): BotSourcePolicy;
   };
   assignments: OrchestratorAssignmentAccess;
+  schedules?: {
+    list(): BotSchedule[];
+    create(input: BotScheduleInput): BotSchedule;
+    update(id: string, change: BotScheduleChange): BotSchedule;
+    remove(id: string): boolean;
+  };
   memory?: {
     switchBranch(branch: string): {
       from: string;
@@ -9645,6 +9763,7 @@ interface BotRuntime {
   listAssignments(botSlug: string): AssignmentSummary[];
   getAssignment(botSlug: string, sessionId: string): AssignmentDetail | undefined;
   admitExternalSource?(botSlug: string, sourceEventId: string): void;
+  admitScheduleFiring?(botSlug: string): void;
   resumePendingDigests?(botSlug: string): void;
   whenIdle(): Promise<void>;
   close(): Promise<void>;
@@ -9654,6 +9773,7 @@ interface BotRuntimeOptions {
   externalMessaging?: OutboundMessaging;
   database: OperationalDatabaseOwner;
   sourcePolicy?: BotSourcePolicyStore;
+  schedules?: Pick<BotScheduleStore, 'list' | 'create' | 'update' | 'remove'>;
   registry: PersonaBotRegistry;
   channels: ChannelStore;
   agents: BotAgentAdapter;
@@ -10440,6 +10560,7 @@ interface BotAttentionItem {
   assignmentReportState?: 'progress' | 'completed' | 'blocked' | 'waiting-human' | 'failed';
   assignmentTurn?: number;
   relatedReportSourceEventId?: string;
+  scheduleId?: string;
   sourceAvailable: boolean;
   authorKind: 'human' | 'bot' | 'bridged' | 'system';
   authorBotSlug?: string;
@@ -10450,6 +10571,7 @@ interface BotAttentionItem {
     conversationId: string;
     senderId: string;
     senderName?: string;
+    voice?: NonNullable<ExternalSource['event']['voice']>;
   };
   summary: string;
 }
@@ -10690,6 +10812,7 @@ interface BotHarnessConfig {
   agentPreset?: string;
   activityDetailConsumers?: string[];
   marketplaceUrl?: string;
+  telemetry?: boolean;
 }
 export declare const DEFAULT_CONFIG: BotHarnessConfig;
 declare const Config$1: Schema<Schemastery.ObjectS<NoInfer<{
@@ -10697,11 +10820,13 @@ declare const Config$1: Schema<Schemastery.ObjectS<NoInfer<{
   activityDetailConsumers: Schema<string[], string[], "defined">;
   agentPreset: Schema<string, string, "defined">;
   marketplaceUrl: Schema<string, string, "defined">;
+  telemetry: Schema<boolean, boolean, "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
   enabled: Schema<boolean, boolean, "defined">;
   activityDetailConsumers: Schema<string[], string[], "defined">;
   agentPreset: Schema<string, string, "defined">;
   marketplaceUrl: Schema<string, string, "defined">;
+  telemetry: Schema<boolean, boolean, "defined">;
 }>>, "plain">;
 interface BotHarnessCore {
   rootDir: string;
@@ -10724,6 +10849,7 @@ interface BotHarnessCore {
   runtime: BotRuntime;
   attention: BotAttentionQuery;
   sourcePolicy: BotSourcePolicyStore;
+  schedules: BotScheduleStore;
   humanAttention: HumanAttentionQuery;
   humanAttentionDecisions: HumanAttentionDecisions;
   grants: WorkspaceGrantStore;
@@ -10751,6 +10877,7 @@ export declare function createCore(options?: {
   onOutputCommitted?: (event: PersonaBotOutputCommitted) => void;
   activeQuestionMessageIds?: () => readonly string[];
   activeToolApprovalMessageIds?: () => readonly string[];
+  capture?: TelemetryCapture;
 }): BotHarnessCore;
 export declare function apply(ctx: Context, config: BotHarnessConfig): void;
 declare module '@deepseek-ai/cordis' {
@@ -10832,6 +10959,74 @@ interface MarketplaceClient {
   }>>;
 }
 //#endregion
+//#region packages/core/src/release/notes.d.ts
+interface LocalizedText {
+  en: string;
+  zh: string;
+}
+interface ReleaseNoteSection {
+  name: string;
+  entries: LocalizedText[];
+}
+interface ReleaseNote {
+  version: string;
+  date: string;
+  summary: LocalizedText;
+  sections: ReleaseNoteSection[];
+}
+//#endregion
+//#region packages/core/src/release/service.d.ts
+interface ReleaseInfo {
+  version: string;
+  releases: ReleaseNote[];
+}
+type ReleaseUpdate = {
+  status: 'development';
+  current: string;
+} | {
+  status: 'unavailable';
+  current: string;
+} | {
+  status: 'current';
+  current: string;
+  latest: string;
+} | {
+  status: 'available';
+  current: string;
+  latest: string;
+  releases: ReleaseNote[];
+  installable: boolean;
+} | {
+  status: 'restart-required';
+  current: string;
+  installed: string;
+  restartable: boolean;
+};
+type ReleaseInstallFailure = 'unavailable' | 'invalid-version' | 'network' | 'incompatible' | 'build-blocked' | 'failed';
+type ReleaseInstall = {
+  status: 'installed';
+  current: string;
+  installed: string;
+  restartable: boolean;
+} | {
+  status: 'failed';
+  reason: ReleaseInstallFailure;
+  diagnostic?: string;
+  logPath?: string;
+};
+type ReleaseRestart = {
+  status: 'restarting';
+} | {
+  status: 'failed';
+  reason: 'unavailable' | 'not-pending';
+};
+interface ReleaseService {
+  info(since?: string): ReleaseInfo;
+  update(): Promise<ReleaseUpdate>;
+  install(version: string): Promise<ReleaseInstall>;
+  restart(): Promise<ReleaseRestart>;
+}
+//#endregion
 //#region packages/core/src/channels/profile-activity.d.ts
 interface GroupProfileActivityDay {
   day: string;
@@ -10937,6 +11132,7 @@ interface PersonaBotSummary {
   avatar?: string;
   appearance?: AvatarAppearance | RetainedAvatarAppearance;
   paused?: boolean;
+  standingLimits: StandingLimits;
   aggregateState: AggregatedState;
   workspaces: string[];
   createdAt: string;
@@ -11347,6 +11543,9 @@ interface BridgeMethods {
   browserProfileSet(payload: unknown): BridgeResult<{
     bot: PersonaBotDetail;
   }>;
+  standingLimitsSet(payload: unknown): BridgeResult<{
+    bot: PersonaBotDetail;
+  }>;
   botAvatarSet(payload: unknown): BridgeResult<{
     bot: PersonaBotDetail;
   }>;
@@ -11363,6 +11562,33 @@ interface BridgeMethods {
   marketplaceReport(payload: unknown): Promise<BridgeResult<{
     received: true;
   }>>;
+  releaseInfo(payload: unknown): BridgeResult<ReleaseInfo>;
+  releaseUpdate(): Promise<BridgeResult<ReleaseUpdate>>;
+  releaseInstall(payload: unknown): Promise<BridgeResult<ReleaseInstall>>;
+  releaseRestart(payload: unknown): Promise<BridgeResult<ReleaseRestart>>;
+  telemetryStatus(): BridgeResult<TelemetryStatus>;
+  telemetrySet(payload: unknown): BridgeResult<TelemetryStatus>;
+  scheduleList(payload: unknown): BridgeResult<{
+    schedules: BotSchedule[];
+  }>;
+  scheduleCreate(payload: unknown): BridgeResult<{
+    schedule: BotSchedule;
+  }>;
+  scheduleUpdate(payload: unknown): BridgeResult<{
+    schedule: BotSchedule;
+  }>;
+  scheduleDelete(payload: unknown): BridgeResult<{
+    removed: boolean;
+  }>;
+  scheduleHistory(payload: unknown): BridgeResult<{
+    firings: BotScheduleFiring[];
+  }>;
+  scheduleRunNow(payload: unknown): BridgeResult<{
+    firing: BotScheduleFiring;
+  }>;
+  schedulePreview(payload: unknown): BridgeResult<{
+    occurrences: string[];
+  }>;
 }
 interface BridgeMethodsDeps {
   warn?: (message: string) => void;
@@ -11381,6 +11607,7 @@ interface BridgeMethodsDeps {
   runtime?: BotRuntime;
   attention?: BotAttentionQuery;
   sourcePolicy?: BotSourcePolicyStore;
+  schedules?: BotScheduleStore;
   humanAttention?: HumanAttentionQuery;
   humanAttentionDecisions?: HumanAttentionDecisions;
   grants?: WorkspaceGrantStore;
@@ -11403,6 +11630,12 @@ interface BridgeMethodsDeps {
   };
   createBotId?: () => string;
   marketplace?: MarketplaceClient;
+  release?: ReleaseService;
+  telemetry?: {
+    status(): TelemetryStatus;
+    setPreference(enabled: boolean): TelemetryStatus;
+    capture?: TelemetryCapture;
+  };
 }
 export declare function createBridgeMethods(deps: BridgeMethodsDeps): BridgeMethods;
 //#endregion
@@ -11521,6 +11754,9 @@ export declare class BotharnessBridgeService extends TypertRemoteService {
   browserProfileSet(slug: string, profile: string): {
     bot: PersonaBotDetail;
   };
+  standingLimitsSet(slug: string, soul: number, coreMemory: number): {
+    bot: PersonaBotDetail;
+  };
   botAvatarSet(channelId: string, avatar: string | null): {
     bot: PersonaBotDetail;
   };
@@ -11768,6 +12004,33 @@ export declare class BotharnessBridgeService extends TypertRemoteService {
   }>;
   marketplaceTopics(): Promise<MarketplaceTopic[]>;
   marketplaceDetail(id: string): Promise<MarketplaceDetail>;
+  releaseInfo(since?: string): Promise<ReleaseInfo>;
+  releaseUpdate(): Promise<ReleaseUpdate>;
+  releaseInstall(version: string): Promise<ReleaseInstall>;
+  releaseRestart(): Promise<ReleaseRestart>;
+  telemetryStatus(): TelemetryStatus;
+  telemetrySet(enabled: boolean): TelemetryStatus;
+  scheduleList(slug: string): {
+    schedules: BotSchedule[];
+  };
+  scheduleCreate(slug: string, input: BotScheduleInput): {
+    schedule: BotSchedule;
+  };
+  scheduleUpdate(slug: string, id: string, change: BotScheduleChange): {
+    schedule: BotSchedule;
+  };
+  scheduleDelete(slug: string, id: string): {
+    removed: boolean;
+  };
+  scheduleHistory(slug: string, id: string): {
+    firings: BotScheduleFiring[];
+  };
+  scheduleRunNow(slug: string, id: string): {
+    firing: BotScheduleFiring;
+  };
+  schedulePreview(trigger: BotScheduleTrigger): {
+    occurrences: string[];
+  };
 }
 export declare function registerBridge(ctx: Context, methods: BridgeMethods): BotharnessBridgeService;
 //#endregion
@@ -11943,6 +12206,7 @@ interface DshImOutboundService {
     id: string;
     name: string;
     bytes: Uint8Array;
+    mediaType?: string;
   }, options: {
     expectedFingerprint: string;
     signal: AbortSignal;
@@ -11970,6 +12234,8 @@ interface DshImOutboundService {
     expectedFingerprint: string;
     signal: AbortSignal;
     sourceFiles?: boolean;
+    sourceImages?: boolean;
+    sourceVoiceTranscripts?: boolean;
     ordinaryText?: boolean;
     onEcho?(event: unknown, context: {
       signal: AbortSignal;