@controlflow-ai/daemon 0.1.1 → 0.1.3

package/src/types.ts

@@ -1,8 +1,13 @@
 export type ChatKind = 'group' | 'dm';
+export type ChatStatus = 'active' | 'archived';
+export type RoomMode = 'standard' | 'idea_development';
+export type ProjectStatus = 'active' | 'archived';
 export type MessageType = 'message' | 'system';
 export type RoomProvider = 'web' | 'lark' | 'wechat';
 export type RoomTopicCapability = 'native' | 'unsupported';
 export type AgentRoomSubscriptionMode = 'all' | 'periodic' | 'mentions' | 'muted' | 'off';
+export type RoomSystemEventType = 'agent_invited' | 'agent_removed' | 'agent_receive_mode_changed';
+export type RoomSystemEventActorKind = 'user' | 'agent' | 'system';
 export type PalIdentityKind = 'user' | 'bot' | 'agent' | 'room';
 export type ProviderExternalType = 'user' | 'bot' | 'room';
 
@@ -16,11 +21,92 @@ export interface Chat {
   dm_type: 'agent_agent' | 'user_agent' | 'user_user' | null;
   capabilities_json: string;
   audit_visibility: 'members' | 'admins';
+  status: ChatStatus;
+  mode: RoomMode;
+  project_id: string | null;
+  project_name: string | null;
+  project_root_path: string | null;
+  project_computer_id: string | null;
+  project_computer_name: string | null;
   created_at: string;
   message_count: number;
   last_message_at: string | null;
 }
 
+export type SkillStatus = 'active' | 'disabled';
+export type SkillSource = 'system' | 'user' | 'project';
+export type SkillBindingScope = 'project' | 'room' | 'agent';
+
+export interface SkillDefinition {
+  key: string;
+  name: string;
+  description: string;
+  instruction_content: string;
+  status: SkillStatus;
+  version: string;
+  source: SkillSource;
+  owner_user_id: string | null;
+  project_id: string | null;
+  repository_path: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface SkillBinding {
+  id: string;
+  scope: SkillBindingScope;
+  scope_id: string;
+  skill_key: string;
+  enabled: boolean;
+  priority: number;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface EnabledSkill extends SkillDefinition {
+  binding_scope: SkillBindingScope;
+  binding_scope_id: string;
+  binding_priority: number;
+}
+
+export interface Project {
+  id: string;
+  name: string;
+  computer_id: string;
+  computer_name: string | null;
+  root_path: string;
+  status: ProjectStatus;
+  room_count: number;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface ProjectAgentDefault {
+  id: string;
+  project_id: string;
+  agent: string;
+  display_name: string | null;
+  mode: AgentRoomSubscriptionMode;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface RemoteFileEntry {
+  name: string;
+  path: string;
+  type: 'directory' | 'file' | 'other';
+  hidden: boolean;
+  readable: boolean;
+  selectable: boolean;
+}
+
+export interface RemoteFileList {
+  path: string;
+  parent: string | null;
+  home: string;
+  entries: RemoteFileEntry[];
+}
+
 export type RoomParticipantKind = 'user' | 'bot' | 'agent';
 export type RoomParticipantSource = 'lark_member_api' | 'known_bot' | 'event' | 'local_agent';
 
@@ -54,11 +140,166 @@ export interface Message {
   channel_id?: string | null;
   provider?: RoomProvider;
   mentions?: string[];
+  attachments?: MessageAttachmentMetadata[];
+}
+
+export interface RoomSystemEvent {
+  id: string;
+  room_id: string;
+  message_id: number;
+  event_type: RoomSystemEventType;
+  actor_kind: RoomSystemEventActorKind;
+  actor_id: string | null;
+  subject_agent: string | null;
+  metadata: Record<string, unknown>;
+  created_at: string;
+}
+
+export interface DeliveryContext {
+  startMessageId: number;
+  totalCount: number;
+  omittedCount: number;
+  messages: Message[];
+  savedMessages?: RoomSavedMessage[];
+}
+
+export type MessageAttachmentKind = 'image' | 'file';
+
+export interface MessageAttachmentMetadata {
+  id: string;
+  message_id: number;
+  kind: MessageAttachmentKind;
+  mime_type: string;
+  filename: string;
+  size_bytes: number;
+  path: string;
+  source_provider: RoomProvider | null;
+  created_at: string;
+}
+
+export interface MessageAttachment extends MessageAttachmentMetadata {
+  source_ref: string | null;
 }
 
 export type RunStatus = 'running' | 'completed' | 'failed' | 'killed' | 'restarted';
 export type RunAction = 'kill' | 'restart';
 export type DeliveryStatus = 'pending' | 'claimed' | 'processing_completed' | 'acked' | 'failed' | 'canceled';
+export type HeldDraftStatus = 'held' | 'abandoned' | 'sent_anyway';
+export type RoomTaskStatus = 'todo' | 'in_progress' | 'in_review' | 'done' | 'closed';
+export type RoomReminderStatus = 'scheduled' | 'fired' | 'canceled';
+export type WorkflowRunStatus = 'running' | 'completed' | 'failed';
+export type WorkflowNodeKind = 'phase' | 'agent' | 'task' | 'message' | 'final';
+export type WorkflowNodeStatus = 'pending' | 'running' | 'done' | 'failed';
+
+export interface HeldMessageDraft {
+  id: string;
+  chat_id: string;
+  chat_name: string;
+  chat_display_name: string | null;
+  agent: string;
+  sender: string;
+  content: string;
+  mentions: string[];
+  base_message_id: number;
+  latest_message_id_at_hold: number;
+  status: HeldDraftStatus;
+  hold_reason: string;
+  hold_count: number;
+  intervening_message_count: number;
+  resolved_message_id: number | null;
+  created_at: string;
+  updated_at: string;
+  resolved_at: string | null;
+}
+
+export interface RoomTask {
+  id: string;
+  room_id: string;
+  room_name: string;
+  task_number: number;
+  title: string;
+  status: RoomTaskStatus;
+  assignee: string | null;
+  created_by: string | null;
+  source_message_id: number | null;
+  created_at: string;
+  updated_at: string;
+  completed_at: string | null;
+}
+
+export interface RoomReminder {
+  id: string;
+  room_id: string;
+  room_name: string;
+  source_message_id: number;
+  title: string;
+  status: RoomReminderStatus;
+  created_by: string | null;
+  fire_at: string;
+  repeat: string | null;
+  fired_at: string | null;
+  canceled_at: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface RoomSavedMessage {
+  id: string;
+  room_id: string;
+  room_name: string;
+  message_id: number;
+  message_sender: string;
+  message_content: string;
+  message_created_at: string;
+  saved_by: string;
+  note: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface WorkflowRun {
+  id: string;
+  file_path: string;
+  goal: string | null;
+  status: WorkflowRunStatus;
+  created_by: string | null;
+  final_output: Record<string, unknown> | null;
+  error: string | null;
+  created_at: string;
+  updated_at: string;
+  completed_at: string | null;
+}
+
+export interface WorkflowNode {
+  id: string;
+  run_id: string;
+  parent_id: string | null;
+  kind: WorkflowNodeKind;
+  title: string;
+  role: string | null;
+  status: WorkflowNodeStatus;
+  context: Record<string, unknown> | null;
+  instruction: string | null;
+  capabilities: string[];
+  output_contract: Record<string, unknown> | null;
+  output: Record<string, unknown> | null;
+  evidence: Record<string, unknown> | null;
+  task_id: string | null;
+  message_id: number | null;
+  created_at: string;
+  updated_at: string;
+  completed_at: string | null;
+}
+
+export interface WorkflowRunRecord {
+  run: WorkflowRun;
+  nodes: WorkflowNode[];
+}
+
+export interface MessageFreshnessInput {
+  base_message_id: number;
+  on_stale: 'hold' | 'send_anyway';
+}
 
 export interface AgentDefinition {
   id: string;
@@ -66,6 +307,51 @@ export interface AgentDefinition {
   display_name: string;
   description: string | null;
   runtime: string | null;
+  model: string | null;
+  avatar: string;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface AgentDeletionResult {
+  agent: AgentDefinition;
+  rooms_left: number;
+  subscriptions_removed: number;
+  assignments_removed: number;
+  daemon_registrations_removed: number;
+  provider_accounts_disabled: number;
+  channel_accounts_disabled: number;
+  active_deliveries_canceled: number;
+  running_runs_marked_kill: number;
+}
+
+export interface AgentDeletionRoomImpact {
+  id: string;
+  name: string;
+  display_name: string | null;
+  kind: ChatKind;
+  provider: RoomProvider;
+  status: ChatStatus;
+}
+
+export interface AgentDeletionLarkBindingImpact {
+  source: 'provider_account' | 'channel_account' | 'credential';
+  app_id: string;
+  label: string | null;
+}
+
+export interface AgentDeletionImpact {
+  agent: AgentDefinition;
+  rooms: AgentDeletionRoomImpact[];
+  lark_bindings: AgentDeletionLarkBindingImpact[];
+}
+
+export type FilesystemPermissionMode = 'project-write' | 'scoped-write' | 'full-access';
+
+export interface AgentPermissionProfile {
+  agent_key: string;
+  filesystem_mode: FilesystemPermissionMode;
+  extra_writable_roots: string[];
   created_at: string;
   updated_at: string;
 }
@@ -74,6 +360,7 @@ export interface ComputerAgentAssignment {
   agent: string;
   display_name: string;
   runtime: string | null;
+  model: string | null;
   computer_id: string;
   cwd: string;
   status: 'active' | 'disabled';
@@ -87,6 +374,19 @@ export interface ProvisionedComputer {
   command: string;
 }
 
+export interface ComputerDeletionImpact {
+  computer: Computer;
+  projects: Project[];
+  assignments: ComputerAgentAssignment[];
+}
+
+export interface ComputerDeletionResult {
+  computer: Computer;
+  projects_removed: number;
+  assignments_removed: number;
+  connections_removed: number;
+}
+
 export interface AgentValidationResult {
   ok: boolean;
   diagnostics: Array<{ level: 'error'; code: string; message: string }>;
@@ -116,6 +416,30 @@ export interface AgentRun {
   delivery_id: string | null;
 }
 
+export type AgentActivityKind = 'lifecycle' | 'working' | 'thinking' | 'output' | 'tool' | 'error';
+
+export interface AgentActivityEvent {
+  id: string;
+  run_id: string;
+  session_id: string | null;
+  agent: string;
+  room_id: string;
+  kind: AgentActivityKind;
+  title: string;
+  detail: string;
+  metadata: Record<string, unknown>;
+  created_at: string;
+}
+
+export interface RoomAgentActivityStatus {
+  agent: string;
+  run_id: string;
+  status: 'working';
+  kind: AgentActivityKind | 'running';
+  title: string;
+  updated_at: string;
+}
+
 export interface AgentSession {
   id: string;
   chat_id: string;
@@ -131,6 +455,73 @@ export interface AgentSession {
   runtime_session_id: string | null;
 }
 
+export interface AgentWorkbenchRoom extends Chat {
+  participant: RoomParticipant | null;
+  subscription: AgentRoomSubscription | null;
+  held_draft_count: number;
+  latest_message_id: number;
+  last_read_message_id: number;
+  last_read_at: string | null;
+  unread_count: number;
+  is_followed: boolean;
+  task_count: number;
+  open_task_count: number;
+  scheduled_reminder_count: number;
+  saved_message_count: number;
+}
+
+export interface AgentWorkbenchLarkBinding {
+  source: 'provider_account' | 'channel_account';
+  app_id: string;
+  label: string | null;
+  bot_open_id: string | null;
+  status: 'active' | 'disabled';
+}
+
+export interface AgentWorkbenchCollaboration {
+  tasks: RoomTask[];
+  reminders: RoomReminder[];
+  saved_messages: RoomSavedMessage[];
+}
+
+export type AgentWorkspaceFileKind = 'memory' | 'soul' | 'state' | 'knowledge';
+
+export interface AgentWorkspaceFile {
+  path: string;
+  label: string;
+  kind: AgentWorkspaceFileKind;
+  size_bytes: number;
+  updated_at: string;
+  content: string;
+  truncated: boolean;
+}
+
+export interface AgentWorkbench {
+  agent: AgentDefinition;
+  permissions: AgentPermissionProfile;
+  assignment: ComputerAgentAssignment | null;
+  machine: Computer | null;
+  project: Project | null;
+  rooms: AgentWorkbenchRoom[];
+  inbox: Message[];
+  deliveries: MessageDelivery[];
+  runs: AgentRun[];
+  activity: AgentActivityEvent[];
+  sessions: AgentSession[];
+  held_drafts: HeldMessageDraft[];
+  collaboration: AgentWorkbenchCollaboration;
+  lark_bindings: AgentWorkbenchLarkBinding[];
+}
+
+export interface ComputerWorkload {
+  computer: Computer;
+  connection: ComputerConnection | null;
+  daemon: DaemonInstance | null;
+  assignments: ComputerAgentAssignment[];
+  runs: AgentRun[];
+  deliveries: MessageDelivery[];
+}
+
 export interface DaemonInstance {
   id: string;
   name: string;
@@ -166,6 +557,7 @@ export interface MessageDelivery {
   id: string;
   message_id: number;
   chat_id: string;
+  chat_name?: string | null;
   agent: string;
   status: DeliveryStatus;
   daemon_id: string | null;
@@ -377,6 +769,8 @@ export interface AgentRoomSubscription {
   room_id: string;
   channel_id: string | null;
   mode: AgentRoomSubscriptionMode;
+  last_read_message_id: number;
+  last_read_at: string | null;
   created_at: string;
   updated_at: string;
 }