work-ally 0.2.0-alpha.1

package/bridge/src/types.ts

@@ -0,0 +1,289 @@
+export type ApprovalKind = 'command' | 'file_change';
+export type ApprovalDecision = 'accept' | 'acceptForSession' | 'decline' | 'cancel';
+export type RuntimeProgressKind = 'agent_message' | 'plan' | 'command' | 'context_compaction';
+export interface RuntimeProgressMeta {
+  kind?: RuntimeProgressKind;
+  phase?: 'commentary' | 'final_answer' | 'unknown' | null;
+  turnId?: string | null;
+  itemId?: string | null;
+}
+export type RuntimeThreadActiveFlag = 'waitingOnApproval' | 'waitingOnUserInput';
+export type RuntimeThreadStatusType = 'notLoaded' | 'idle' | 'systemError' | 'active';
+export type PendingUserInputKind = 'questionnaire' | 'mcp_elicitation';
+
+export interface RuntimeThreadStatus {
+  type: RuntimeThreadStatusType;
+  activeFlags: RuntimeThreadActiveFlag[];
+}
+
+export interface RuntimeErrorDetails extends Error {
+  code?: string | number;
+  data?: unknown;
+}
+
+export interface ConversationRef {
+  channel: string;
+  conversationId: string;
+  userId?: string | null;
+  chatType?: string | null;
+}
+
+export interface InboundAttachment {
+  kind: 'image' | 'file' | 'audio' | 'video';
+  path?: string;
+  token?: string;
+  name?: string;
+}
+
+export interface InboundMessage {
+  messageId: string;
+  conversationRef: ConversationRef;
+  senderId: string;
+  senderName?: string | null;
+  text: string;
+  sourceMessageType?: string | null;
+  replyToMessageId?: string | null;
+  rootMessageId?: string | null;
+  replyToText?: string | null;
+  attachments?: InboundAttachment[];
+  receivedAt: string;
+  raw?: unknown;
+}
+
+export interface SessionMeta {
+  conversationRef: ConversationRef;
+  sessionKey: string;
+  createdAt: string;
+  updatedAt: string;
+  threadId: string | null;
+  activeTurnId: string | null;
+  lastTurnId: string | null;
+  lastMessageId: string | null;
+  lastPromptPreview: string | null;
+  lastReplyPreview: string | null;
+  pendingApprovalIds: string[];
+  pendingUserInputRequestId: string | null;
+}
+
+export type WorkSessionOrigin = 'work_ally' | 'codex_cli_attach';
+export type WorkSessionActiveSurface = 'work_ally_channel' | 'official_codex_cli' | 'idle' | 'closed';
+export type WorkSessionOwnershipSource =
+  | 'explicit_channel_takeover'
+  | 'explicit_codex_launch'
+  | 'observed_external_activity'
+  | 'manual_attach'
+  | 'new_session';
+export type WorkSessionResumeCapability = 'ready' | 'not_ready';
+export type WorkSessionCliResumeRefType = 'session_id' | 'thread_name' | 'unknown' | 'null';
+
+export interface WorkSessionMeta {
+  workSessionId: string;
+  threadHandle: string;
+  assistantName: string;
+  assistantCodexHome: string | null;
+  workspaceRoot: string;
+  runtime: 'codex';
+  runtimeThreadId: string;
+  cliResumeRef: string | null;
+  cliResumeRefType: WorkSessionCliResumeRefType;
+  threadName: string | null;
+  origin: WorkSessionOrigin;
+  deliveryChannel: string | null;
+  deliveryConversationKey: string | null;
+  activeSurface: WorkSessionActiveSurface;
+  ownershipSource: WorkSessionOwnershipSource;
+  resumeCapability: WorkSessionResumeCapability;
+  lastRuntimeActivityAt: string | null;
+  lastSurfaceSwitchAt: string;
+  createdAt: string;
+  updatedAt: string;
+  archivedAt: string | null;
+  lastTurnId?: string | null;
+  lastPromptPreview?: string | null;
+  lastReplyPreview?: string | null;
+  lastHandoffExportAt?: string | null;
+  lastAttachAt?: string | null;
+}
+
+export interface WorkSessionAssistantIndex {
+  assistantName: string;
+  activeWorkSessionId: string | null;
+  updatedAt: string;
+}
+
+export interface WorkSessionDeliveryIndex {
+  deliveryChannel: string;
+  deliveryConversationKey: string;
+  activeWorkSessionId: string | null;
+  updatedAt: string;
+}
+
+export interface UserInputOption {
+  label: string;
+  description: string;
+}
+
+export interface UserInputQuestion {
+  id: string;
+  header: string;
+  question: string;
+  isOther?: boolean;
+  isSecret?: boolean;
+  options?: UserInputOption[] | null;
+}
+
+export interface McpElicitationRequest {
+  serverName: string;
+  mode: 'form' | 'url';
+  message: string;
+  requestedSchema?: unknown;
+  url?: string | null;
+  elicitationId?: string | null;
+}
+
+export interface UserInputRequest {
+  requestId: string | number;
+  threadId: string;
+  turnId: string;
+  itemId: string | null;
+  messageId: string;
+  kind?: PendingUserInputKind;
+  questions: UserInputQuestion[];
+  elicitation?: McpElicitationRequest | null;
+}
+
+export interface PendingUserInputRecord extends UserInputRequest {
+  createdAt: string;
+  status: 'pending';
+  visible: boolean;
+}
+
+export interface InboundReceipt {
+  messageId: string;
+  status: 'processing' | 'completed';
+  createdAt: string;
+  updatedAt: string;
+  outcome?: 'success' | 'failed';
+}
+
+export interface ApprovalRecord {
+  approvalId: string;
+  kind: ApprovalKind;
+  requestId: string | number;
+  turnId: string;
+  threadId: string;
+  messageId: string;
+  command?: string | null;
+  reason?: string | null;
+  grantRoot?: string | null;
+  cwd?: string | null;
+  createdAt: string;
+  status: 'pending' | 'accepted' | 'declined' | 'cancelled';
+  visible: boolean;
+}
+
+export type TurnExecutionStatus =
+  | 'running'
+  | 'completed'
+  | 'failed'
+  | 'interrupted';
+
+export type TurnDeliveryStatus = 'not_ready' | 'pending' | 'delivered' | 'suppressed' | 'delivery_unavailable';
+export type InboundAcceptanceStatus = 'received' | TurnExecutionStatus;
+
+export interface InboundAcceptanceRecord {
+  messageId: string;
+  threadId: string | null;
+  turnId: string | null;
+  createdAt: string;
+  updatedAt: string;
+  acceptedAt: string | null;
+  executionStatus: InboundAcceptanceStatus;
+}
+
+export interface TurnRecord {
+  turnId: string;
+  threadId: string;
+  status: string;
+  prompt: string;
+  reply: string;
+  startedAt: string;
+  completedAt: string;
+  error?: string | null;
+}
+
+export interface TurnLedgerRecord {
+  turnId: string;
+  threadId: string;
+  messageId: string | null;
+  promptPreview: string | null;
+  createdAt: string;
+  updatedAt: string;
+  executionStatus: TurnExecutionStatus;
+  replyPreview: string | null;
+  error: string | null;
+  deliveryStatus: TurnDeliveryStatus;
+  deliveredAt: string | null;
+  suppressedByMessageId: string | null;
+  suppressedByTurnId: string | null;
+  suppressionReason: string | null;
+}
+
+export interface RuntimeTurnResult {
+  threadId: string;
+  turnId: string;
+  status: string;
+  reply: string;
+  error?: string | null;
+}
+
+export interface OutboundDeliveryRecord {
+  sourceKey: string;
+  threadId: string;
+  turnId: string;
+  conversationRef: ConversationRef;
+  envelopeType: 'final_reply';
+  payloadText: string;
+  payloadDigest: string;
+  createdAt: string;
+  updatedAt: string;
+  status: 'pending' | 'delivered';
+  deliveredAt: string | null;
+}
+
+export type ConnectionLifecycleState = 'disconnected' | 'reconnecting' | 'reconnected';
+export type ConnectionLifecycleSource = 'runtime' | 'feishu';
+
+export interface ConnectionLifecycleEvent {
+  source: ConnectionLifecycleSource;
+  state: ConnectionLifecycleState;
+  reason?: string | null;
+  attempt?: number | null;
+  nextRetryDelayMs?: number | null;
+  hasActiveTurn?: boolean | null;
+}
+
+export interface ApprovalRequest {
+  approvalId: string;
+  kind: ApprovalKind;
+  requestId: string | number;
+  threadId: string;
+  turnId: string;
+  messageId: string;
+  command?: string | null;
+  reason?: string | null;
+  grantRoot?: string | null;
+  cwd?: string | null;
+  boundaryReason?: string | null;
+  autonomyDecision?: {
+    action: 'auto_approve';
+    reason: string;
+    policy: string;
+  } | null;
+}
+
+export interface ServerRequestResolvedEvent {
+  requestId: string | number;
+  threadId: string | null;
+  turnId: string | null;
+}

package/bridge/src/utils.ts

@@ -0,0 +1,104 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import crypto from 'node:crypto';
+
+export function ensureDir(target: string): string {
+  fs.mkdirSync(target, { recursive: true });
+  return target;
+}
+
+export function readJsonFile(filePath: string, fallback = null) {
+  if (!fs.existsSync(filePath)) {
+    return fallback;
+  }
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch {
+    return fallback;
+  }
+}
+
+export function writeJsonFile(filePath: string, value: unknown): void {
+  ensureDir(path.dirname(filePath));
+  fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+}
+
+export function appendNdjson(filePath: string, value: unknown): void {
+  ensureDir(path.dirname(filePath));
+  fs.appendFileSync(filePath, `${JSON.stringify(value)}\n`, 'utf8');
+}
+
+export function nowIso(): string {
+  return new Date().toISOString();
+}
+
+export function resolveTimeZone(explicit?: string | null): string {
+  const detected = explicit || Intl.DateTimeFormat().resolvedOptions().timeZone;
+  return detected || 'UTC';
+}
+
+export function todayStamp(date = new Date(), timeZone?: string): string {
+  const zone = resolveTimeZone(timeZone);
+  const parts = new Intl.DateTimeFormat('en-CA', {
+    timeZone: zone,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+  }).formatToParts(date);
+  const values = Object.fromEntries(parts.filter((item) => item.type !== 'literal').map((item) => [item.type, item.value]));
+  return `${values.year}-${values.month}-${values.day}`;
+}
+
+export function sanitizeSegment(input: string): string {
+  return input.replace(/[^a-zA-Z0-9._-]+/g, '_').slice(0, 120) || 'default';
+}
+
+export function conversationKey(channel: string, conversationId: string): string {
+  return `${sanitizeSegment(channel)}--${sanitizeSegment(conversationId)}`;
+}
+
+export function loadDotEnv(filePath: string): Record<string, string> {
+  const result: Record<string, string> = {};
+  if (!fs.existsSync(filePath)) {
+    return result;
+  }
+  const lines = fs.readFileSync(filePath, 'utf8').split(/\r?\n/);
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    const eq = trimmed.indexOf('=');
+    if (eq < 0) continue;
+    const key = trimmed.slice(0, eq).trim();
+    let value = trimmed.slice(eq + 1).trim();
+    const commentIndex = value.search(/\s+#/);
+    if (commentIndex >= 0) {
+      value = value.slice(0, commentIndex).trim();
+    }
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1);
+    }
+    result[key] = value;
+  }
+  return result;
+}
+
+export function mergeEnv(values: Record<string, string>): void {
+  for (const [key, value] of Object.entries(values)) {
+    if (!(key in process.env)) {
+      process.env[key] = value;
+    }
+  }
+}
+
+export function randomId(prefix: string): string {
+  return `${prefix}_${crypto.randomUUID()}`;
+}
+
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export function tempDir(prefix: string): string {
+  return fs.mkdtempSync(path.join(os.tmpdir(), `${prefix}-`));
+}