weifuwu 0.25.2 → 0.27.0

package/dist/kb/index.d.ts

@@ -1,3 +0,0 @@
-import type { KBOptions, KBModule, KBIngestOptions, KBSearchOptions, KBSearchResult, KBListEntry } from './types.ts';
-export type { KBOptions, KBIngestOptions, KBSearchResult, KBSearchOptions, KBListEntry, KBModule };
-export declare function knowledgeBase(options: KBOptions): KBModule;

package/dist/kb/types.d.ts

@@ -1,72 +0,0 @@
-import type { Middleware } from '../types.ts';
-import type { AIProvider } from '../ai/provider.ts';
-import type { PostgresClient } from '../postgres/types.ts';
-export interface KBOptions {
-    /** Postgres client instance. */
-    pg: PostgresClient;
-    /** AI provider for embedding. */
-    provider: AIProvider;
-    /** Table name (default: '_kb_docs'). */
-    table?: string;
-    /** Default chunk size in characters (default: 512). */
-    chunkSize?: number;
-    /** Default chunk overlap in characters (default: 64). */
-    chunkOverlap?: number;
-    /** Default search limit (default: 5). */
-    searchLimit?: number;
-    /** Minimum similarity score threshold (0–1, default: 0). Set higher for stricter matches. */
-    searchThreshold?: number;
-}
-export interface KBIngestOptions {
-    title?: string;
-    metadata?: Record<string, unknown>;
-    chunkSize?: number;
-    chunkOverlap?: number;
-}
-export interface KBSearchResult {
-    id: number;
-    key: string;
-    title: string;
-    content: string;
-    score: number;
-    metadata: Record<string, unknown>;
-}
-export interface KBSearchOptions {
-    limit?: number;
-    /** Minimum cosine similarity score (0–1). Results below this are excluded. */
-    threshold?: number;
-}
-export interface KBListEntry {
-    key: string;
-    title: string;
-    chunks: number;
-}
-export interface KBInjected {
-    search(query: string, searchOptions?: KBSearchOptions): Promise<KBSearchResult[]>;
-}
-declare module '../types.ts' {
-    interface Context {
-        kb?: KBInjected;
-    }
-}
-export interface KBModule {
-    /**
-     * Ingest a document: chunk → embed → store.
-     * If a document with the same key exists, it is replaced (delete + re-insert).
-     * Returns the number of chunks created.
-     */
-    ingest(key: string, content: string, options?: KBIngestOptions): Promise<number>;
-    /**
-     * Search the knowledge base by semantic similarity.
-     * Query is embedded, then vector similarity search returns top results.
-     */
-    search(query: string, searchOptions?: KBSearchOptions): Promise<KBSearchResult[]>;
-    /** Delete all chunks for a document key. */
-    delete(key: string): Promise<void>;
-    /** List all document keys with title and chunk count. */
-    list(): Promise<KBListEntry[]>;
-    /** Create the table and HNSW index. Safe to call multiple times. */
-    migrate(): Promise<void>;
-    /** Middleware that injects `ctx.kb` with `.search()` method. */
-    middleware(): Middleware;
-}

package/dist/layout.d.ts

@@ -1,2 +0,0 @@
-import type { Middleware } from './types.ts';
-export declare function layout(path: string): Middleware;

package/dist/live.d.ts

@@ -1,7 +0,0 @@
-import { Router, type WebSocketHandler } from './router.ts';
-export declare function broadcastReload(): void;
-export declare function liveWs(): WebSocketHandler;
-export declare function liveRouter(_dir: string): Router;
-export declare function liveWatcher(dir: string): {
-    close: () => void;
-};

package/dist/logdb/client.d.ts

@@ -1,2 +0,0 @@
-import type { LogdbOptions, LogdbModule } from './types.ts';
-export declare function logdb(options: LogdbOptions): LogdbModule;

package/dist/logdb/index.d.ts

@@ -1,2 +0,0 @@
-export { logdb } from './client.ts';
-export type { LogdbOptions, LogdbModule, LogEntry, LogEntryInput } from './types.ts';

package/dist/logdb/rest.d.ts

@@ -1,5 +0,0 @@
-import { type BoundTable } from '../postgres/schema/index.ts';
-import type { Context } from '../types.ts';
-export declare function createHandler(entries: BoundTable<any>): (req: Request, ctx: Context) => Promise<Response>;
-export declare function listHandler(entries: BoundTable<any>): (req: Request) => Promise<Response>;
-export declare function getHandler(entries: BoundTable<any>): (_req: Request, ctx: any) => Promise<Response>;

package/dist/logdb/types.d.ts

@@ -1,27 +0,0 @@
-import type { PostgresClient } from '../postgres/types.ts';
-import type { Router } from '../router.ts';
-import type { Closeable } from '../types.ts';
-export interface LogdbOptions {
-    pg: PostgresClient;
-    table?: string;
-}
-export interface LogEntry {
-    id: number;
-    level: string;
-    source: string;
-    message: string;
-    metadata: Record<string, unknown>;
-    created_at: string;
-}
-export interface LogEntryInput {
-    level: string;
-    source: string;
-    message: string;
-    metadata?: Record<string, unknown>;
-}
-export interface LogdbModule extends Router, Closeable {
-    log(input: LogEntryInput): Promise<LogEntry>;
-    migrate(): Promise<void>;
-    clean(retentionMonths: number): Promise<number>;
-    close(): Promise<void>;
-}

package/dist/logger.d.ts

@@ -1,16 +0,0 @@
-import type { Middleware, Context } from './types.ts';
-export interface LoggerOptions {
-    /** 'short' = method + path + status + ms, 'combined' = short + query string, 'json' = structured stderr JSON */
-    format?: 'short' | 'combined' | 'json';
-}
-export interface LogEvent {
-    level: 'info' | 'warn' | 'error';
-    message: string;
-    method?: string;
-    path?: string;
-    status?: number;
-    elapsed_ms?: number;
-    traceId?: string;
-    timestamp?: string;
-}
-export declare function logger(options?: LoggerOptions): Middleware<Context, Context>;

package/dist/mailer.d.ts

@@ -1,51 +0,0 @@
-import { type Transporter } from 'nodemailer';
-import type { Closeable } from './types.ts';
-/** Options for sending an email. */
-export interface MailOptions {
-    /** Recipient address(es). */
-    to: string | string[];
-    /** Email subject. */
-    subject: string;
-    /** Plain text body. */
-    text?: string;
-    /** HTML body. */
-    html?: string;
-    /** Sender address (overrides `MailerOptions.from`). */
-    from?: string;
-    /** CC recipient(s). */
-    cc?: string | string[];
-    /** BCC recipient(s). */
-    bcc?: string | string[];
-}
-/** Options for {@link mailer}. */
-export interface MailerOptions {
-    /** Nodemailer transport string or pre-built transporter object. */
-    transport?: string | Transporter;
-    /** Default sender address. */
-    from?: string;
-    /** Custom send function (bypasses nodemailer). */
-    send?: (opts: MailOptions) => Promise<void>;
-}
-/** Mailer instance returned by {@link mailer}. */
-export interface Mailer extends Closeable {
-    /** Send an email. */
-    send: (opts: MailOptions) => Promise<void>;
-    /** Close the nodemailer transport. */
-    close: () => Promise<void>;
-}
-/**
- * Create a mailer instance.
- *
- * ```ts
- * import { mailer } from 'weifuwu'
- *
- * const email = mailer({ transport: 'smtp://user:pass@smtp.example.com' })
- * await email.send({
- *   to: 'user@example.com',
- *   subject: 'Hello',
- *   text: 'Hello from weifuwu!',
- * })
- * await email.close()
- * ```
- */
-export declare function mailer(options: MailerOptions): Mailer;

package/dist/mcp.d.ts

@@ -1,34 +0,0 @@
-export interface MCPClientOptions {
-    /** Command to spawn (e.g. 'npx', 'node', 'uvx'). */
-    command: string;
-    /** Arguments passed to the command. */
-    args?: string[];
-    /** Environment variables (merged with process.env). */
-    env?: Record<string, string>;
-    /** How long to wait for handshake/response (ms). Default: 15_000. */
-    timeout?: number;
-    /** Max tool response body size in bytes. Default: 10MB. */
-    maxResponseSize?: number;
-}
-/** A tool definition from an MCP server. */
-export interface MCPToolDef {
-    name: string;
-    description?: string;
-    inputSchema?: {
-        type: 'object';
-        properties?: Record<string, unknown>;
-        required?: string[];
-    };
-}
-/** MCP client — spawns and manages a single MCP server subprocess. */
-export interface MCPClient {
-    /** Fetch tool definitions from the server and return AI SDK Tool objects. */
-    getTools(): Promise<Record<string, unknown>>;
-    /** Refresh tool definitions (re-call tools/list). */
-    refresh(): Promise<void>;
-    /** Call a tool by name. Returns the raw result from the MCP server. */
-    callTool(name: string, args: unknown): Promise<unknown>;
-    /** Shutdown the MCP server and release resources. */
-    close(): Promise<void>;
-}
-export declare function mcpClient(options: MCPClientOptions): MCPClient;

package/dist/messager/agent.d.ts

@@ -1,11 +0,0 @@
-import type { SqlClient } from '../vendor.ts';
-import type { AgentModule } from '../agent/types.ts';
-import type { Hub } from '../hub.ts';
-/**
- * Route a user message to all agent members in a channel.
- * - Streaming: broadcasts SSE text tokens in real-time
- * - Multi-round: passes recent channel history as conversation context
- */
-export declare function runAgentRouting(sql: SqlClient, messages: {
-    insert: (data: any) => Promise<any>;
-}, agents: AgentModule | undefined, hub: Hub, channelId: number, content: string, stream?: boolean, contextMessages?: number): Promise<void>;

package/dist/messager/client.d.ts

@@ -1,2 +0,0 @@
-import type { MessagerOptions, MessagerModule } from './types.ts';
-export declare function messager(options: MessagerOptions): MessagerModule;

package/dist/messager/index.d.ts

@@ -1,2 +0,0 @@
-export { messager } from './client.ts';
-export type { MessagerOptions, MessagerModule, Channel, ChannelMember, Message } from './types.ts';

package/dist/messager/rest.d.ts

@@ -1,15 +0,0 @@
-import type { SqlClient } from '../vendor.ts';
-import { Router } from '../router.ts';
-import type { AgentModule } from '../agent/types.ts';
-import type { Hub } from '../hub.ts';
-import { type BoundTable } from '../postgres/schema/index.ts';
-interface RestDeps {
-    sql: SqlClient;
-    channels: BoundTable<any>;
-    members: BoundTable<any>;
-    messages: BoundTable<any>;
-    agents?: AgentModule;
-    hub: Hub;
-}
-export declare function buildRouter(deps: RestDeps): Router;
-export {};

package/dist/messager/types.d.ts

@@ -1,57 +0,0 @@
-import type { Router } from '../router.ts';
-import type { AgentModule } from '../agent/types.ts';
-import type { PostgresClient } from '../postgres/types.ts';
-import type { Redis } from '../vendor.ts';
-import type { Closeable } from '../types.ts';
-export interface MessagerOptions {
-    pg: PostgresClient;
-    agents?: AgentModule;
-    webhookTimeout?: number;
-    redis?: Redis;
-}
-export interface Channel {
-    id: number;
-    tenant_id: string | null;
-    name: string;
-    type: 'channel' | 'dm';
-    created_by: number;
-    created_at: string;
-}
-export interface ChannelMember {
-    id: number;
-    channel_id: number;
-    member_id: number;
-    member_type: 'user' | 'agent' | 'webhook';
-    role: 'admin' | 'member';
-    last_read_id: number | null;
-}
-export interface Message {
-    id: number;
-    channel_id: number;
-    sender_id: number;
-    sender_type: 'user' | 'agent' | 'webhook';
-    type: 'text' | 'image' | 'file' | 'system';
-    content: string;
-    file_url: string | null;
-    file_name: string | null;
-    file_size: number | null;
-    mime_type: string | null;
-    created_at: string;
-}
-export interface MessagerModule extends Router, Closeable {
-    migrate: () => Promise<void>;
-    wsHandler: () => any;
-    send: (channelId: number, content: string, opts?: {
-        sender_type?: string;
-        sender_id?: number;
-        type?: string;
-    }) => Promise<Message>;
-    close: () => Promise<void>;
-}
-export interface WSMessage {
-    type: 'message' | 'typing' | 'read';
-    channel_id: number;
-    content?: string;
-    is_typing?: boolean;
-    last_message_id?: number;
-}

package/dist/messager/ws.d.ts

@@ -1,14 +0,0 @@
-import type { SqlClient } from '../vendor.ts';
-import type { AgentModule } from '../agent/types.ts';
-import { type Hub } from '../hub.ts';
-interface WSDeps {
-    sql: SqlClient;
-    agents?: AgentModule;
-    redis?: import('../vendor.ts').Redis;
-}
-export declare function broadcastToChannel(hub: Hub | undefined, channelId: number, data: any): void;
-export declare function createWSHandler(deps: WSDeps): {
-    handler: any;
-    hub: Hub;
-};
-export {};

package/dist/module-server.d.ts

@@ -1,9 +0,0 @@
-import { Router } from './router.ts';
-export declare function clearModuleCache(filePath?: string): void;
-export declare function transformModule(absPath: string, root: string, mountPath?: string): Promise<{
-    url: string;
-    code: string;
-}>;
-export declare function moduleServer(opts: {
-    root: string | string[];
-}): Router;

package/dist/not-found.d.ts

@@ -1,2 +0,0 @@
-import type { Handler } from './types.ts';
-export declare function notFound(path?: string): Handler;

package/dist/notifier/client.d.ts

@@ -1,2 +0,0 @@
-import type { Notifier, NotifierOptions } from './types.ts';
-export declare function notifier(opts: NotifierOptions): Notifier;

package/dist/notifier/index.d.ts

@@ -1,2 +0,0 @@
-export { notifier } from './client.ts';
-export type { NotifierOptions, Notifier, NotifierInjected, NotifyMessage, Notification, NotifyChannel, NotifyPreferences, } from './types.ts';

package/dist/notifier/types.d.ts

@@ -1,105 +0,0 @@
-import type { Context, Middleware, Closeable } from '../types.ts';
-import type { Mailer } from '../mailer.ts';
-import type { Hub } from '../hub.ts';
-import type { SqlClient } from '../vendor.ts';
-declare module '../types.ts' {
-    interface Context {
-        notifier: Notifier;
-    }
-}
-/** Shape injected into ctx when notifier middleware is active. */
-export interface NotifierInjected {
-    notifier: Notifier;
-}
-/** Configuration for the notifier module. */
-export interface NotifierOptions {
-    /** SQL client (PostgreSQL) for persistent notifications. */
-    sql: SqlClient;
-    /** Optional mailer for email channel. */
-    mailer?: Mailer;
-    /** Optional hub for WebSocket push channel. */
-    hub?: Hub;
-    /** Default sender name for email (default: system name). */
-    fromName?: string;
-    /** Table name for notifications (default: '_notifications'). */
-    table?: string;
-    /** Max notification list page size (default: 50). */
-    pageSize?: number;
-}
-/** A notification message. */
-export interface NotifyMessage {
-    /** Notification title. */
-    title: string;
-    /** Notification body text. */
-    body?: string;
-    /** Optional action URL. */
-    actionUrl?: string;
-    /** Optional action button text. */
-    actionText?: string;
-    /** Notification type for categorization (default: 'default'). */
-    type?: string;
-    /** Arbitrary metadata (JSON object). */
-    metadata?: Record<string, unknown>;
-}
-/** A notification record from the database. */
-export interface Notification {
-    id: number;
-    user_id: number;
-    title: string;
-    body: string;
-    action_url: string | null;
-    action_text: string | null;
-    type: string;
-    metadata: Record<string, unknown>;
-    read_at: string | null;
-    created_at: string;
-}
-/** Supported notification channels. */
-export type NotifyChannel = 'inbox' | 'email' | 'ws';
-/** User's channel preferences for a notification type. */
-export interface NotifyPreferences {
-    /** Which channels are enabled. Default: ['inbox']. */
-    channels: NotifyChannel[];
-}
-/** The notifier API injected into ctx. */
-export interface Notifier extends Closeable {
-    /**
-     * Send a notification to a specific user.
-     * Routes through the user's channel preferences automatically.
-     */
-    send(to: {
-        userId: number;
-        email?: string;
-    }, message: NotifyMessage): Promise<void>;
-    /**
-     * Send a system-wide notification to all users.
-     * Useful for announcements.
-     */
-    broadcast(message: NotifyMessage): Promise<void>;
-    /** Get user's unread notification count. */
-    unreadCount(userId: number): Promise<number>;
-    /** Mark specific notifications as read. If no ids given, mark all as read. */
-    markRead(userId: number, notificationIds?: number[]): Promise<void>;
-    /** List notifications for a user, newest first. */
-    list(userId: number, opts?: {
-        limit?: number;
-        offset?: number;
-        unreadOnly?: boolean;
-    }): Promise<Notification[]>;
-    /** Get or set user's notification channel preferences. */
-    getPreferences(userId: number): Promise<NotifyPreferences>;
-    setPreferences(userId: number, prefs: NotifyPreferences): Promise<void>;
-    /** Count total notifications for a user. */
-    count(userId: number, unreadOnly?: boolean): Promise<number>;
-    /** Clean up old notifications (older than days). */
-    clean(days: number): Promise<number>;
-    /** Create the notifications and preferences tables. Safe to call multiple times. */
-    migrate(): Promise<void>;
-    /** Release resources. */
-    close(): Promise<void>;
-}
-/** Notifier middleware type. */
-export interface NotifierMiddleware extends Middleware<Context, Context & NotifierInjected>, Notifier {
-    /** Alias for backward compatibility. */
-    middleware: () => Middleware<Context, Context & NotifierInjected>;
-}

package/dist/opencode/client.d.ts

@@ -1,2 +0,0 @@
-import type { OpencodeOptions, OpencodeModule } from './types.ts';
-export declare function opencode(options: OpencodeOptions): Promise<OpencodeModule>;

package/dist/opencode/index.d.ts

@@ -1,2 +0,0 @@
-export { opencode } from './client.ts';
-export type { OpencodeOptions, OpencodeModule, SkillDef, SkillRegistry, OpencodePermissions, Session, } from './types.ts';

package/dist/opencode/permissions.d.ts

@@ -1,5 +0,0 @@
-import type { OpencodePermissions } from './types.ts';
-export declare function isCommandAllowed(command: string): boolean;
-export declare function isPathAllowed(resolvedPath: string, workspace: string, _perms?: OpencodePermissions): boolean;
-export declare function isToolEnabled(name: string, perms?: OpencodePermissions): boolean;
-export declare function isSkillAllowed(name: string, perms?: OpencodePermissions): boolean;

package/dist/opencode/prompt.d.ts

@@ -1,8 +0,0 @@
-import type { SkillDef } from './types.ts';
-export interface PromptOptions {
-    workspace: string;
-    model: string;
-    skills: SkillDef[];
-    systemPrompt?: string;
-}
-export declare function buildSystemPrompt(opts: PromptOptions): string;

package/dist/opencode/rest.d.ts

@@ -1,16 +0,0 @@
-import { Router } from '../router.ts';
-import type { LanguageModel } from 'ai';
-import type { SqlClient } from '../vendor.ts';
-import type { SkillDef, SkillRegistry, OpencodePermissions, PendingQuestion } from './types.ts';
-interface RestDeps {
-    sql: SqlClient;
-    model: LanguageModel;
-    workspace: string;
-    systemPrompt?: string;
-    skills: SkillDef[];
-    skillsRegistry: SkillRegistry;
-    permissions?: OpencodePermissions;
-    pendingQuestions: Map<string, PendingQuestion>;
-}
-export declare function buildRouter(deps: RestDeps): Promise<Router>;
-export {};

package/dist/opencode/run.d.ts

@@ -1,13 +0,0 @@
-import { type LanguageModel, type Tool } from 'ai';
-import { type SessionMessage } from './session.ts';
-export interface ExecuteOptions {
-    sessionId: string;
-    input: string;
-    model: LanguageModel;
-    tools: Record<string, Tool>;
-    systemPrompt: string;
-    messages: SessionMessage[];
-    sql: any;
-    abortSignal?: AbortSignal;
-}
-export declare function executeGenerator(opts: ExecuteOptions): AsyncGenerator<any, void, unknown>;

package/dist/opencode/session.d.ts

@@ -1,26 +0,0 @@
-import type { SqlClient } from '../vendor.ts';
-import type { Session, Message } from './types.ts';
-export declare function createSession(sql: SqlClient, opts: {
-    userId?: number;
-    title?: string;
-    model?: string;
-    systemPrompt?: string;
-}, cwd: string, mountPath: string): Promise<Session>;
-export declare function getSession(sql: SqlClient, id: string): Promise<Session | null>;
-export declare function listSessions(sql: SqlClient, userId?: number): Promise<Session[]>;
-export declare function deleteSession(sql: SqlClient, id: string): Promise<void>;
-export declare function getHistory(sql: SqlClient, sessionId: string, limit?: number): Promise<SessionMessage[]>;
-export interface SessionMessage {
-    id: number;
-    session_id: string;
-    role: 'user' | 'assistant' | 'tool';
-    content: string | null;
-    tool_calls: unknown[] | null;
-    tool_results: unknown[] | null;
-    tokens_in: number;
-    tokens_out: number;
-    created_at: string;
-}
-export declare function addTextMessage(sql: SqlClient, sessionId: string, role: 'user' | 'assistant', content: string, tokensIn?: number, tokensOut?: number): Promise<Message>;
-export declare function addToolMessages(sql: SqlClient, sessionId: string, toolCalls: unknown[], toolResults: unknown[]): Promise<Message>;
-export declare function updateSessionTitle(sql: SqlClient, id: string, title: string): Promise<void>;

package/dist/opencode/skills.d.ts

@@ -1,4 +0,0 @@
-import type { SkillDef, SkillRegistry } from './types.ts';
-export declare function parseSkillFile(filePath: string): Promise<SkillDef | null>;
-export declare function discoverSkills(workspace: string): Promise<SkillDef[]>;
-export declare function buildSkillRegistry(discovered: SkillDef[], manual: SkillDef[]): SkillRegistry;

package/dist/opencode/tools/bash.d.ts

@@ -1,6 +0,0 @@
-import type { ToolContext } from './index.ts';
-export declare function createBashTool(ctx: ToolContext): import("ai").Tool<{
-    command: string;
-    timeout: number;
-    workdir?: string | undefined;
-}, unknown>;

package/dist/opencode/tools/edit.d.ts

@@ -1,19 +0,0 @@
-import type { ToolContext } from './index.ts';
-export declare function createEditTool(ctx: ToolContext): import("ai").Tool<{
-    path: string;
-    oldString: string;
-    newString: string;
-    replaceAll: boolean;
-}, {
-    error: string;
-    replaced?: undefined;
-    path?: undefined;
-} | {
-    error: string;
-    replaced: number;
-    path?: undefined;
-} | {
-    path: string;
-    replaced: number;
-    error?: undefined;
-}>;

package/dist/opencode/tools/glob.d.ts

@@ -1,9 +0,0 @@
-import type { ToolContext } from './index.ts';
-export declare function createGlobTool(ctx: ToolContext): import("ai").Tool<{
-    pattern: string;
-    path?: string | undefined;
-}, {
-    files: string[];
-    total: number;
-    truncated: boolean;
-}>;

package/dist/opencode/tools/grep.d.ts

@@ -1,17 +0,0 @@
-import type { ToolContext } from './index.ts';
-export declare function createGrepTool(ctx: ToolContext): import("ai").Tool<{
-    pattern: string;
-    context: number;
-    include?: string | undefined;
-    path?: string | undefined;
-}, {
-    matches: number;
-    results: string[];
-    truncated: boolean;
-    error?: undefined;
-} | {
-    error: any;
-    matches: number;
-    results: never[];
-    truncated?: undefined;
-}>;

package/dist/opencode/tools/index.d.ts

@@ -1,12 +0,0 @@
-import type { Tool } from 'ai';
-import type { OpencodePermissions, SkillRegistry } from '../types.ts';
-export interface ToolContext {
-    workspace: string;
-    permissions?: OpencodePermissions;
-    pendingQuestions: Map<string, {
-        resolve: (answer: string) => void;
-        reject: (err: Error) => void;
-    }>;
-    skillsRegistry: SkillRegistry;
-}
-export declare function createTools(ctx: ToolContext): Record<string, Tool>;

package/dist/opencode/tools/question.d.ts

@@ -1,5 +0,0 @@
-import type { ToolContext } from './index.ts';
-export declare function createQuestionTool(ctx: ToolContext): import("ai").Tool<{
-    question: string;
-    options?: string[] | undefined;
-}, string>;