@dobby.ai/dobby 0.1.0 → 0.1.2

package/plugins/connector-feishu/src/mapper.ts

@@ -1,401 +0,0 @@
-import { mkdir, readFile, rename } from "node:fs/promises";
-import { join } from "node:path";
-import type { Client } from "@larksuiteoapi/node-sdk";
-import type { GatewayLogger, InboundAttachment, InboundEnvelope } from "@dobby.ai/plugin-sdk";
-
-interface FeishuMention {
-  key: string;
-  id?: {
-    union_id?: string;
-    user_id?: string;
-    open_id?: string;
-  };
-  name: string;
-  tenant_key?: string;
-}
-
-export interface FeishuMessageEvent {
-  app_id?: string;
-  sender: {
-    sender_id?: {
-      union_id?: string;
-      user_id?: string;
-      open_id?: string;
-    };
-    sender_type: string;
-    tenant_key?: string;
-  };
-  message: {
-    message_id: string;
-    root_id?: string;
-    parent_id?: string;
-    create_time: string;
-    update_time?: string;
-    chat_id: string;
-    thread_id?: string;
-    chat_type: string;
-    message_type: string;
-    content: string;
-    mentions?: FeishuMention[];
-    user_agent?: string;
-  };
-}
-
-interface MapFeishuMessageOptions {
-  event: FeishuMessageEvent;
-  connectorId: string;
-  attachmentsRoot: string;
-  client: Client;
-  logger: GatewayLogger;
-  downloadAttachments: boolean;
-  botOpenId?: string;
-  botName?: string;
-}
-
-interface AttachmentDescriptor {
-  fileKey: string;
-  fileName: string;
-  mimeType?: string;
-  resourceType: string;
-}
-
-function safeParseJson(value: string): unknown {
-  try {
-    return JSON.parse(value) as unknown;
-  } catch {
-    return null;
-  }
-}
-
-function sanitizeFileName(value: string): string {
-  return value.replaceAll(/[^a-zA-Z0-9._-]/g, "_");
-}
-
-function headerValue(headers: unknown, name: string): string | undefined {
-  if (!headers || typeof headers !== "object") {
-    return undefined;
-  }
-
-  const record = headers as Record<string, unknown>;
-  const target = record[name] ?? record[name.toLowerCase()] ?? record[name.toUpperCase()];
-  if (typeof target === "string" && target.trim().length > 0) {
-    return target.trim();
-  }
-  if (Array.isArray(target)) {
-    const first = target.find((value) => typeof value === "string" && value.trim().length > 0);
-    return typeof first === "string" ? first.trim() : undefined;
-  }
-  return undefined;
-}
-
-function normalizeMimeType(value?: string): string | undefined {
-  if (!value) {
-    return undefined;
-  }
-
-  const [mimeType] = value.split(";", 1);
-  return mimeType?.trim().toLowerCase() || undefined;
-}
-
-function sniffImageMimeType(buffer: Buffer): string | undefined {
-  if (buffer.length >= 8 && buffer.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]))) {
-    return "image/png";
-  }
-
-  if (buffer.length >= 3 && buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {
-    return "image/jpeg";
-  }
-
-  if (buffer.length >= 6) {
-    const header = buffer.subarray(0, 6).toString("ascii");
-    if (header === "GIF87a" || header === "GIF89a") {
-      return "image/gif";
-    }
-  }
-
-  if (
-    buffer.length >= 12
-    && buffer.subarray(0, 4).toString("ascii") === "RIFF"
-    && buffer.subarray(8, 12).toString("ascii") === "WEBP"
-  ) {
-    return "image/webp";
-  }
-
-  if (buffer.length >= 2 && buffer[0] === 0x42 && buffer[1] === 0x4d) {
-    return "image/bmp";
-  }
-
-  return undefined;
-}
-
-function extensionForMimeType(mimeType?: string): string | undefined {
-  switch (mimeType) {
-    case "image/png":
-      return "png";
-    case "image/jpeg":
-      return "jpg";
-    case "image/gif":
-      return "gif";
-    case "image/webp":
-      return "webp";
-    case "image/bmp":
-      return "bmp";
-    default:
-      return undefined;
-  }
-}
-
-function normalizeWhitespace(value: string): string {
-  return value.replaceAll(/\s+/g, " ").trim();
-}
-
-function normalizeComparableName(value: string): string {
-  return normalizeWhitespace(value).replace(/^@+/, "").toLowerCase();
-}
-
-function collectPostText(node: unknown, output: string[]): void {
-  if (typeof node === "string") {
-    const trimmed = node.trim();
-    if (trimmed.length > 0) {
-      output.push(trimmed);
-    }
-    return;
-  }
-
-  if (Array.isArray(node)) {
-    for (const item of node) {
-      collectPostText(item, output);
-    }
-    return;
-  }
-
-  if (!node || typeof node !== "object") {
-    return;
-  }
-
-  const record = node as Record<string, unknown>;
-  if (record.tag === "text" && typeof record.text === "string") {
-    const trimmed = record.text.trim();
-    if (trimmed.length > 0) {
-      output.push(trimmed);
-    }
-  }
-
-  for (const value of Object.values(record)) {
-    collectPostText(value, output);
-  }
-}
-
-function isBotMention(mention: FeishuMention, botOpenId?: string, botName?: string): boolean {
-  if (botOpenId) {
-    return mention.id?.open_id === botOpenId || mention.id?.user_id === botOpenId || mention.id?.union_id === botOpenId;
-  }
-
-  if (botName) {
-    return normalizeComparableName(mention.name) === normalizeComparableName(botName);
-  }
-
-  return false;
-}
-
-function replaceMentionKeys(text: string, mentions: FeishuMention[]): string {
-  let next = text;
-  for (const mention of mentions) {
-    const replacement = mention.name.length > 0 ? `@${mention.name}` : "@user";
-    next = next.split(mention.key).join(replacement);
-  }
-  return next;
-}
-
-function stripBotMentions(text: string, mentions: FeishuMention[], botOpenId?: string, botName?: string): string {
-  let next = text;
-  for (const mention of mentions) {
-    if (!isBotMention(mention, botOpenId, botName)) {
-      continue;
-    }
-    next = next.split(mention.key).join("");
-    if (mention.name.length > 0) {
-      next = next.split(`@${mention.name}`).join("");
-    }
-  }
-  return normalizeWhitespace(next);
-}
-
-function extractMessageText(event: FeishuMessageEvent, botOpenId?: string, botName?: string): string {
-  const { message } = event;
-  const mentions = message.mentions ?? [];
-  const parsed = safeParseJson(message.content);
-  let text = "";
-
-  switch (message.message_type) {
-    case "text":
-      text = typeof (parsed as { text?: unknown } | null)?.text === "string"
-        ? (parsed as { text: string }).text
-        : message.content;
-      break;
-    case "post": {
-      const parts: string[] = [];
-      collectPostText(parsed, parts);
-      text = parts.join("\n");
-      break;
-    }
-    case "file":
-      text = typeof (parsed as { file_name?: unknown } | null)?.file_name === "string"
-        ? `[file] ${(parsed as { file_name: string }).file_name}`
-        : "(file)";
-      break;
-    case "image":
-      text = "(image)";
-      break;
-    case "audio":
-      text = "(audio)";
-      break;
-    case "media":
-      text = typeof (parsed as { file_name?: unknown } | null)?.file_name === "string"
-        ? `[media] ${(parsed as { file_name: string }).file_name}`
-        : "(media)";
-      break;
-    default:
-      text = `(${message.message_type})`;
-      break;
-  }
-
-  const withReadableMentions = replaceMentionKeys(text, mentions);
-  return stripBotMentions(withReadableMentions, mentions, botOpenId, botName);
-}
-
-function attachmentDescriptor(event: FeishuMessageEvent): AttachmentDescriptor | null {
-  const parsed = safeParseJson(event.message.content) as Record<string, unknown> | null;
-  if (!parsed) {
-    return null;
-  }
-
-  if (event.message.message_type === "image" && typeof parsed.image_key === "string") {
-    return {
-      fileKey: parsed.image_key,
-      fileName: `image-${parsed.image_key}`,
-      resourceType: "image",
-    };
-  }
-
-  if (event.message.message_type === "file" && typeof parsed.file_key === "string") {
-    return {
-      fileKey: parsed.file_key,
-      fileName: typeof parsed.file_name === "string" ? parsed.file_name : `file-${parsed.file_key}`,
-      resourceType: "file",
-    };
-  }
-
-  return null;
-}
-
-async function downloadAttachment(
-  client: Client,
-  event: FeishuMessageEvent,
-  descriptor: AttachmentDescriptor,
-  attachmentDir: string,
-): Promise<InboundAttachment> {
-  await mkdir(attachmentDir, { recursive: true });
-
-  let targetPath = join(attachmentDir, sanitizeFileName(descriptor.fileName));
-  const resource = await client.im.v1.messageResource.get({
-    params: {
-      type: descriptor.resourceType,
-    },
-    path: {
-      message_id: event.message.message_id,
-      file_key: descriptor.fileKey,
-    },
-  });
-
-  await resource.writeFile(targetPath);
-  let resolvedMimeType = normalizeMimeType(descriptor.mimeType) ?? normalizeMimeType(headerValue(resource.headers, "content-type"));
-  let resolvedFileName = descriptor.fileName;
-
-  if (descriptor.resourceType === "image") {
-    const fileBuffer = await readFile(targetPath);
-    resolvedMimeType = sniffImageMimeType(fileBuffer) ?? resolvedMimeType;
-
-    const extension = extensionForMimeType(resolvedMimeType);
-    if (extension) {
-      resolvedFileName = `${descriptor.fileName}.${extension}`;
-      const finalPath = join(attachmentDir, sanitizeFileName(resolvedFileName));
-      if (finalPath !== targetPath) {
-        await rename(targetPath, finalPath);
-        targetPath = finalPath;
-      }
-    }
-  }
-
-  return {
-    id: descriptor.fileKey,
-    fileName: resolvedFileName,
-    ...(resolvedMimeType ? { mimeType: resolvedMimeType } : {}),
-    localPath: targetPath,
-  };
-}
-
-export async function mapFeishuMessageEvent(options: MapFeishuMessageOptions): Promise<InboundEnvelope | null> {
-  const { event, connectorId, attachmentsRoot, client, logger, downloadAttachments, botOpenId, botName } = options;
-  if (event.sender.sender_type !== "user") {
-    return null;
-  }
-
-  const sourceId = event.message.chat_id;
-  const attachments: InboundAttachment[] = [];
-  if (downloadAttachments) {
-    const descriptor = attachmentDescriptor(event);
-    if (descriptor) {
-      try {
-        const attachmentDir = join(attachmentsRoot, sourceId, event.message.message_id);
-        attachments.push(await downloadAttachment(client, event, descriptor, attachmentDir));
-      } catch (error) {
-        logger.warn(
-          {
-            err: error,
-            connectorId,
-            messageId: event.message.message_id,
-            fileKey: descriptor.fileKey,
-            resourceType: descriptor.resourceType,
-          },
-          "Failed to download Feishu attachment; keeping metadata only",
-        );
-        attachments.push({
-          id: descriptor.fileKey,
-          fileName: descriptor.fileName,
-          ...(descriptor.mimeType ? { mimeType: descriptor.mimeType } : {}),
-        });
-      }
-    }
-  }
-
-  const senderId = event.sender.sender_id?.open_id
-    ?? event.sender.sender_id?.user_id
-    ?? event.sender.sender_id?.union_id
-    ?? "unknown";
-
-  const mentionedBot = event.message.chat_type === "p2p"
-    || (event.message.mentions ?? []).some((mention) => isBotMention(mention, botOpenId, botName))
-    || (!botOpenId && !botName && (event.message.mentions?.length ?? 0) > 0);
-
-  const timestampMs = Number.parseInt(event.message.create_time, 10);
-
-  return {
-    connectorId,
-    platform: "feishu",
-    accountId: event.app_id ?? connectorId,
-    source: {
-      type: "chat",
-      id: sourceId,
-    },
-    chatId: event.message.chat_id,
-    messageId: event.message.message_id,
-    userId: senderId,
-    text: extractMessageText(event, botOpenId, botName),
-    attachments,
-    timestampMs: Number.isFinite(timestampMs) ? timestampMs : Date.now(),
-    raw: event,
-    isDirectMessage: event.message.chat_type === "p2p",
-    mentionedBot,
-  };
-}

package/plugins/connector-feishu/tsconfig.json

@@ -1,19 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "types": ["node"],
-    "strict": true,
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "skipLibCheck": true,
-    "noUncheckedIndexedAccess": true,
-    "exactOptionalPropertyTypes": true,
-    "resolveJsonModule": true
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["dist", "node_modules"]
-}

package/plugins/plugin-sdk/index.d.ts

@@ -1,261 +0,0 @@
-import type { ImageContent } from "@mariozechner/pi-ai";
-import type { Logger } from "pino";
-
-export type Platform = string;
-export type ToolProfile = "full" | "readonly";
-export type MentionPolicy = "required" | "optional";
-export type BindingSourceType = "channel" | "chat";
-
-export interface InboundAttachment {
-  id: string;
-  fileName?: string;
-  mimeType?: string;
-  size?: number;
-  localPath?: string;
-  remoteUrl?: string;
-}
-
-export interface BindingSource {
-  type: BindingSourceType;
-  id: string;
-}
-
-export interface InboundEnvelope {
-  connectorId: string;
-  platform: Platform;
-  accountId: string;
-  guildId?: string;
-  source: BindingSource;
-  chatId: string;
-  threadId?: string;
-  messageId: string;
-  userId: string;
-  userName?: string;
-  text: string;
-  attachments: InboundAttachment[];
-  timestampMs: number;
-  raw: unknown;
-  isDirectMessage: boolean;
-  mentionedBot: boolean;
-}
-
-export interface OutboundAttachment {
-  localPath: string;
-  title?: string;
-}
-
-export interface OutboundEnvelope {
-  platform: Platform;
-  accountId: string;
-  chatId: string;
-  threadId?: string;
-  replyToMessageId?: string;
-  mode: "create" | "update";
-  targetMessageId?: string;
-  text: string;
-  attachments?: OutboundAttachment[];
-  metadata?: Record<string, string>;
-}
-
-export interface ConnectorSendResult {
-  messageId?: string;
-}
-
-export interface ConnectorTypingEnvelope {
-  platform: Platform;
-  accountId: string;
-  chatId: string;
-  threadId?: string;
-}
-
-export interface ConnectorContext {
-  emitInbound: (msg: InboundEnvelope) => Promise<void>;
-  emitControl: (event: {
-    type: "stop";
-    connectorId: string;
-    platform: Platform;
-    accountId: string;
-    chatId: string;
-    threadId?: string;
-  }) => Promise<void>;
-}
-
-export type ConnectorUpdateStrategy = "edit" | "final_only" | "append";
-
-export interface ConnectorCapabilities {
-  updateStrategy: ConnectorUpdateStrategy;
-  supportedSources: BindingSourceType[];
-  supportsThread: boolean;
-  supportsTyping: boolean;
-  supportsFileUpload: boolean;
-  maxTextLength?: number;
-}
-
-export interface ConnectorPlugin {
-  readonly id: string;
-  readonly platform: Platform;
-  readonly name: string;
-  readonly capabilities: ConnectorCapabilities;
-  start(ctx: ConnectorContext): Promise<void>;
-  send(message: OutboundEnvelope): Promise<ConnectorSendResult>;
-  sendTyping?(message: ConnectorTypingEnvelope): Promise<void>;
-  stop(): Promise<void>;
-}
-
-export interface RouteProfile {
-  projectRoot: string;
-  tools: ToolProfile;
-  mentions: MentionPolicy;
-  provider: string;
-  sandbox: string;
-  systemPromptFile?: string;
-}
-
-export interface RouteResolution {
-  routeId: string;
-  profile: RouteProfile;
-}
-
-export type GatewayAgentEvent =
-  | { type: "message_delta"; delta: string }
-  | { type: "message_complete"; text: string }
-  | { type: "tool_start"; toolName: string }
-  | { type: "tool_end"; toolName: string; isError: boolean; output: string }
-  | { type: "status"; message: string };
-
-export interface GatewayAgentRuntime {
-  prompt(text: string, options?: { images?: ImageContent[] }): Promise<void>;
-  subscribe(listener: (event: GatewayAgentEvent) => void): () => void;
-  abort(): Promise<void>;
-  dispose(): void;
-}
-
-export interface ExecOptions {
-  timeoutSeconds?: number;
-  signal?: AbortSignal;
-  env?: NodeJS.ProcessEnv;
-}
-
-export interface ExecResult {
-  stdout: string;
-  stderr: string;
-  code: number;
-  killed: boolean;
-}
-
-export interface SpawnOptions {
-  command: string;
-  args: string[];
-  cwd?: string;
-  env?: NodeJS.ProcessEnv;
-  signal?: AbortSignal;
-  tty?: boolean;
-}
-
-export interface SpawnedProcess {
-  stdin: NodeJS.WritableStream;
-  stdout: NodeJS.ReadableStream;
-  stderr: NodeJS.ReadableStream;
-  readonly killed: boolean;
-  readonly exitCode: number | null;
-  kill(signal?: NodeJS.Signals): boolean;
-  on(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): void;
-  on(event: "error", listener: (error: Error) => void): void;
-  once(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): void;
-  once(event: "error", listener: (error: Error) => void): void;
-  off(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): void;
-  off(event: "error", listener: (error: Error) => void): void;
-}
-
-export interface Executor {
-  exec(command: string, cwd: string, options?: ExecOptions): Promise<ExecResult>;
-  spawn(options: SpawnOptions): SpawnedProcess;
-  close(): Promise<void>;
-}
-
-export interface DataConfig {
-  rootDir: string;
-  sessionsDir: string;
-  attachmentsDir: string;
-  logsDir: string;
-  stateDir: string;
-  dedupTtlMs: number;
-}
-
-export type GatewayLogger = Logger;
-
-export interface ExtensionHostContext {
-  logger: GatewayLogger;
-  configBaseDir: string;
-}
-
-export interface ProviderRuntimeCreateOptions {
-  conversationKey: string;
-  route: RouteResolution;
-  inbound: InboundEnvelope;
-  executor: Executor;
-  sessionPolicy?: "shared-session" | "ephemeral";
-}
-
-export interface ProviderSessionArchiveOptions {
-  conversationKey: string;
-  inbound: InboundEnvelope;
-  sessionPolicy?: "shared-session" | "ephemeral";
-  archivedAtMs?: number;
-}
-
-export interface ProviderSessionArchiveResult {
-  archived: boolean;
-  archivePath?: string;
-}
-
-export interface ProviderInstance {
-  id: string;
-  createRuntime(options: ProviderRuntimeCreateOptions): Promise<GatewayAgentRuntime>;
-  archiveSession?(options: ProviderSessionArchiveOptions): Promise<ProviderSessionArchiveResult>;
-  close?: () => Promise<void>;
-}
-
-export interface ProviderInstanceCreateOptions {
-  instanceId: string;
-  config: Record<string, unknown>;
-  host: ExtensionHostContext;
-  data: DataConfig;
-}
-
-export interface ProviderContributionModule {
-  kind: "provider";
-  configSchema?: Record<string, unknown>;
-  createInstance(options: ProviderInstanceCreateOptions): Promise<ProviderInstance> | ProviderInstance;
-}
-
-export interface ConnectorInstanceCreateOptions {
-  instanceId: string;
-  config: Record<string, unknown>;
-  host: ExtensionHostContext;
-  attachmentsRoot: string;
-}
-
-export interface ConnectorContributionModule {
-  kind: "connector";
-  configSchema?: Record<string, unknown>;
-  createInstance(options: ConnectorInstanceCreateOptions): Promise<ConnectorPlugin> | ConnectorPlugin;
-}
-
-export interface SandboxInstance {
-  id: string;
-  executor: Executor;
-  close?: () => Promise<void>;
-}
-
-export interface SandboxInstanceCreateOptions {
-  instanceId: string;
-  config: Record<string, unknown>;
-  host: ExtensionHostContext;
-}
-
-export interface SandboxContributionModule {
-  kind: "sandbox";
-  configSchema?: Record<string, unknown>;
-  createInstance(options: SandboxInstanceCreateOptions): Promise<SandboxInstance> | SandboxInstance;
-}

package/plugins/plugin-sdk/index.js

@@ -1 +0,0 @@
-export {};

package/plugins/plugin-sdk/package-lock.json

@@ -1,12 +0,0 @@
-{
-  "name": "@dobby.ai/plugin-sdk",
-  "version": "0.1.2",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "": {
-      "name": "@dobby.ai/plugin-sdk",
-      "version": "0.1.2"
-    }
-  }
-}