@questionbase/deskfree 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,389 @@
+/**
+ * Minimal type definitions for the OpenClaw plugin API.
+ * These mirror the actual OpenClaw types but are defined inline
+ * to avoid a hard dependency on the openclaw package at build time.
+ * At runtime, the real types are provided by OpenClaw.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export interface AnyAgentTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (id: string, params: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }>;
+    optional?: boolean;
+}
+export interface OpenClawPluginToolContext {
+    config?: unknown;
+    messageChannel?: unknown;
+    agentAccountId?: string;
+    sandboxed?: boolean;
+}
+export type OpenClawPluginToolFactory = (ctx: OpenClawPluginToolContext) => AnyAgentTool | AnyAgentTool[] | null | undefined;
+export interface OpenClawPluginToolOptions {
+    optional?: boolean;
+}
+export interface OpenClawConfig {
+    channels?: {
+        deskfree?: DeskFreeChannelConfig;
+        [key: string]: unknown;
+    };
+    plugins?: {
+        entries?: {
+            [pluginId: string]: {
+                enabled?: boolean;
+                [key: string]: unknown;
+            };
+        };
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface OpenClawPluginApi {
+    runtime: PluginRuntime;
+    config: OpenClawConfig;
+    pluginConfig: Record<string, unknown>;
+    logger: PluginLogger;
+    registerChannel(registration: {
+        plugin: ChannelPlugin;
+    }): void;
+    registerHttpRoute(params: {
+        path: string;
+        handler: (req: IncomingMessage, res: ServerResponse) => Promise<void> | void;
+    }): void;
+    registerTool(tool: AnyAgentTool | OpenClawPluginToolFactory, opts?: OpenClawPluginToolOptions): void;
+}
+export interface PluginRuntime {
+    version: string;
+    config: {
+        loadConfig(): OpenClawConfig;
+        writeConfigFile(cfg: OpenClawConfig): Promise<void>;
+    };
+    channel: {
+        reply: {
+            finalizeInboundContext<T extends Record<string, unknown>>(ctx: T): T & FinalizedMsgContext;
+            dispatchReplyFromConfig(params: {
+                ctx: FinalizedMsgContext;
+                cfg: OpenClawConfig;
+                dispatcher: ReplyDispatcher;
+                replyOptions?: Record<string, unknown>;
+            }): Promise<{
+                queuedFinal: boolean;
+            }>;
+            createReplyDispatcherWithTyping(params: {
+                channel: string;
+                accountId: string;
+                deliver: (payload: {
+                    text?: string;
+                    body?: string;
+                }) => Promise<void>;
+                [key: string]: unknown;
+            }): {
+                dispatcher: ReplyDispatcher;
+                replyOptions: Record<string, unknown>;
+                markDispatchIdle: () => void;
+            };
+        };
+        text: {
+            chunkMarkdownText(text: string, limit: number): string[];
+        };
+    };
+    logging: {
+        createLogger(name: string): PluginLogger;
+    };
+    state: {
+        resolveStateDir(): string;
+    };
+}
+export interface FinalizedMsgContext {
+    Body: string;
+    RawBody?: string;
+    ChatType: string;
+    Provider: string;
+    Surface: string;
+    From: string;
+    To: string;
+    MessageSid: string;
+    Timestamp?: string;
+    BodyForAgent?: string;
+    [key: string]: unknown;
+}
+export interface ReplyDispatcher {
+    send(reply: unknown): Promise<void>;
+    getQueuedCounts(): unknown;
+}
+export interface PluginLogger {
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    debug(msg: string): void;
+}
+export interface ChannelMessagingTargetResolver {
+    hint?: string;
+    looksLikeId?(raw: string, normalized?: string): boolean;
+}
+export interface ChannelMessagingAdapter {
+    normalizeTarget?(raw: string): string | undefined;
+    targetResolver?: ChannelMessagingTargetResolver;
+}
+export interface ChannelPlugin {
+    id: string;
+    meta: ChannelMeta;
+    capabilities: ChannelCapabilities;
+    config: ChannelConfigAdapter;
+    outbound?: ChannelOutboundAdapter;
+    gateway?: ChannelGatewayAdapter;
+    setup?: ChannelSetupAdapter;
+    security?: ChannelSecurityAdapter;
+    messaging?: ChannelMessagingAdapter;
+    onboarding?: ChannelOnboardingAdapter;
+    status?: ChannelStatusAdapter;
+}
+export interface ChannelMeta {
+    name: string;
+    icon?: string;
+    description?: string;
+}
+export interface ChannelCapabilities {
+    text: boolean;
+    media: boolean;
+    reactions: boolean;
+    threads: boolean;
+    editing: boolean;
+}
+export interface ChannelConfigAdapter {
+    listAccountIds(cfg: OpenClawConfig): string[];
+    resolveAccount(cfg: OpenClawConfig, accountId?: string | null): ResolvedDeskFreeAccount;
+    isConfigured?(account: ResolvedDeskFreeAccount, cfg?: OpenClawConfig): boolean;
+    isEnabled?(account: ResolvedDeskFreeAccount, cfg?: OpenClawConfig): boolean;
+    describeAccount?(account: ResolvedDeskFreeAccount, cfg?: OpenClawConfig): ChannelAccountSnapshot;
+}
+export interface ChannelOutboundAdapter {
+    deliveryMode: 'direct' | 'gateway' | 'hybrid';
+    resolveTarget?(target: string, ctx: {
+        cfg: OpenClawConfig;
+        accountId?: string | null;
+    }): {
+        to: string;
+    } | null;
+    sendText?(ctx: ChannelOutboundContext): Promise<OutboundDeliveryResult>;
+    textChunkLimit?: number;
+    chunkerMode?: 'text' | 'markdown';
+}
+export interface ChannelGatewayAdapter {
+    startAccount?(ctx: ChannelGatewayContext): Promise<unknown>;
+    stopAccount?(ctx: ChannelGatewayContext): Promise<void>;
+    logoutAccount?(ctx: ChannelLogoutContext): Promise<ChannelLogoutResult>;
+}
+export interface ChannelGatewayContext {
+    cfg: OpenClawConfig;
+    accountId: string;
+    account: ResolvedDeskFreeAccount;
+    runtime: PluginRuntime;
+    abortSignal: AbortSignal;
+    log?: PluginLogger;
+    getStatus(): ChannelAccountSnapshot;
+    setStatus(next: Partial<ChannelAccountSnapshot>): void;
+}
+export interface ChannelSetupAdapter {
+    applyAccountConfig(params: {
+        cfg: OpenClawConfig;
+        accountId: string;
+        input: Record<string, string>;
+    }): OpenClawConfig;
+    validateInput?(params: {
+        cfg: OpenClawConfig;
+        accountId: string;
+        input: Record<string, string>;
+    }): string | null;
+}
+export interface ChannelSecurityDmPolicy {
+    policy: string;
+    allowFrom?: Array<string | number> | null;
+    policyPath?: string;
+    allowFromPath: string;
+    approveHint: string;
+    normalizeEntry?: (raw: string) => string;
+}
+export interface ChannelSecurityAdapter {
+    resolveDmPolicy?(ctx: {
+        cfg: OpenClawConfig;
+        accountId?: string | null;
+        account: ResolvedDeskFreeAccount;
+    }): ChannelSecurityDmPolicy | null;
+    collectWarnings?(ctx: {
+        cfg: OpenClawConfig;
+        accountId?: string | null;
+        account: ResolvedDeskFreeAccount;
+    }): Promise<string[]> | string[];
+}
+export interface ChannelOutboundContext {
+    cfg: OpenClawConfig;
+    to: string;
+    text: string;
+    threadId?: string | number | null;
+    replyToId?: string | null;
+    accountId?: string | null;
+}
+export interface OutboundDeliveryResult {
+    channel: string;
+    success: boolean;
+    threadId?: string;
+}
+export interface ChannelAccountSnapshot {
+    accountId?: string;
+    enabled?: boolean;
+    configured?: boolean;
+    running?: boolean;
+    lastStartAt?: number;
+    lastStopAt?: number;
+    lastError?: string;
+    probe?: ChannelProbeResult;
+}
+export interface ResolvedDeskFreeAccount {
+    accountId: string;
+    botToken: string;
+    apiUrl: string;
+    wsUrl: string;
+    userId: string;
+    enabled: boolean;
+}
+export interface DeskFreeChannelConfig {
+    enabled?: boolean;
+    botToken: string;
+    apiUrl: string;
+    wsUrl: string;
+    userId: string;
+    accounts?: Record<string, Omit<DeskFreeChannelConfig, 'accounts'>>;
+}
+export interface ChatMessageAttachment {
+    name: string;
+    contentType: string;
+    size: number;
+    url: string;
+}
+export interface ChatMessage {
+    messageId: string;
+    botId: string;
+    humanId: string;
+    authorType: 'bot' | 'user';
+    content: string;
+    attachments?: ChatMessageAttachment[];
+    taskId?: string | null;
+    createdAt: string;
+    userName?: string | null;
+    botName?: string | null;
+}
+export interface MessagesResponse {
+    items: ChatMessage[];
+    cursor: string | null;
+    hasMore: boolean;
+}
+export interface WsTicketResponse {
+    ticket: string;
+    wsUrl: string;
+    expiresAt: string;
+}
+export interface WizardPrompter {
+    text(params: {
+        message: string;
+        initialValue?: string;
+        placeholder?: string;
+        validate?: (value: string) => string | undefined;
+    }): Promise<string>;
+    confirm(params: {
+        message: string;
+        initialValue?: boolean;
+    }): Promise<boolean>;
+    note(message: string, title?: string): Promise<void>;
+}
+export interface ChannelOnboardingStatus {
+    channel: string;
+    configured: boolean;
+    statusLines: string[];
+    selectionHint?: string;
+    quickstartScore?: number;
+}
+export interface ChannelOnboardingResult {
+    cfg: OpenClawConfig;
+    accountId?: string;
+}
+export interface ChannelOnboardingAdapter {
+    channel: string;
+    getStatus(ctx: {
+        cfg: OpenClawConfig;
+    }): Promise<ChannelOnboardingStatus>;
+    configure(ctx: {
+        cfg: OpenClawConfig;
+        runtime: PluginRuntime;
+        prompter: WizardPrompter;
+        accountOverrides: Record<string, string>;
+        shouldPromptAccountIds: boolean;
+        forceAllowFrom: boolean;
+    }): Promise<ChannelOnboardingResult>;
+    disable?(cfg: OpenClawConfig): OpenClawConfig;
+}
+export interface ChannelProbeResult {
+    ok: boolean;
+    error?: string;
+}
+export interface ChannelStatusIssue {
+    channel: string;
+    accountId: string;
+    kind: 'config' | 'auth' | 'runtime';
+    message: string;
+    fix?: string;
+}
+export interface ChannelStatusAdapter {
+    probeAccount?(params: {
+        account: ResolvedDeskFreeAccount;
+        timeoutMs: number;
+        cfg: OpenClawConfig;
+    }): Promise<ChannelProbeResult>;
+    buildAccountSnapshot?(params: {
+        account: ResolvedDeskFreeAccount;
+        cfg: OpenClawConfig;
+        runtime?: ChannelAccountSnapshot;
+        probe?: ChannelProbeResult;
+    }): ChannelAccountSnapshot;
+    collectStatusIssues?(accounts: ChannelAccountSnapshot[]): ChannelStatusIssue[];
+}
+export interface ChannelLogoutContext {
+    cfg: OpenClawConfig;
+    accountId: string;
+    account: ResolvedDeskFreeAccount;
+    runtime: PluginRuntime;
+    log?: PluginLogger;
+}
+export interface ChannelLogoutResult {
+    cleared: boolean;
+    loggedOut?: boolean;
+    [key: string]: unknown;
+}
+export interface WsNotification {
+    action: 'notify';
+    hint: string;
+}
+export interface Task {
+    taskId: string;
+    title: string;
+    status: 'ready_for_bot' | 'working_on_it' | 'waiting_for_human' | 'done';
+    instructions?: string;
+    createdAt: string;
+    updatedAt: string;
+    botId?: string | null;
+    createdById: string;
+    reason?: string | null;
+    deliverable?: string | null;
+}
+export interface TasksListResponse {
+    tasks: Task[];
+}
+export interface CreateTaskResponse {
+    task: Task;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/workspace.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Recursively read all `.md` files from a workspace directory.
+ *
+ * Skips files larger than 100 KB, hidden directories, node_modules, and .git.
+ * Returns paths relative to `workspacePath`.
+ */
+export declare function readWorkspaceFiles(workspacePath: string): {
+    path: string;
+    content: string;
+}[];
+/**
+ * Resolve the OpenClaw workspace path from config.
+ *
+ * Looks for `agents.defaults.workspace` in the OpenClaw config.
+ * Falls back to `~/.openclaw` if not found.
+ */
+export declare function resolveWorkspacePath(cfg: Record<string, unknown>): string | null;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAyCrC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,GAAG,IAAI,CAcf"}

package/dist/workspace.js

@@ -0,0 +1,83 @@
+/**
+ * Workspace sync utilities.
+ *
+ * Reads .md files from the OpenClaw workspace directory so they can be
+ * uploaded to DeskFree via the workspace.sync API.
+ */
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+const MAX_FILE_SIZE = 100 * 1024; // 100 KB
+const SKIP_DIRS = new Set(['node_modules', '.git']);
+/**
+ * Recursively read all `.md` files from a workspace directory.
+ *
+ * Skips files larger than 100 KB, hidden directories, node_modules, and .git.
+ * Returns paths relative to `workspacePath`.
+ */
+export function readWorkspaceFiles(workspacePath) {
+    const results = [];
+    function walk(dir) {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            // Skip hidden directories and known non-workspace dirs
+            if (entry.startsWith('.') || SKIP_DIRS.has(entry))
+                continue;
+            const fullPath = join(dir, entry);
+            let st;
+            try {
+                st = statSync(fullPath);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (entry.endsWith('.md') && st.size <= MAX_FILE_SIZE) {
+                try {
+                    const content = readFileSync(fullPath, 'utf-8');
+                    results.push({
+                        path: relative(workspacePath, fullPath),
+                        content,
+                    });
+                }
+                catch {
+                    // Skip unreadable files
+                }
+            }
+        }
+    }
+    walk(workspacePath);
+    return results;
+}
+/**
+ * Resolve the OpenClaw workspace path from config.
+ *
+ * Looks for `agents.defaults.workspace` in the OpenClaw config.
+ * Falls back to `~/.openclaw` if not found.
+ */
+export function resolveWorkspacePath(cfg) {
+    try {
+        const agents = cfg.agents;
+        if (!agents)
+            return null;
+        const defaults = agents.defaults;
+        if (!defaults)
+            return null;
+        const workspace = defaults.workspace;
+        if (typeof workspace === 'string' && workspace.length > 0) {
+            return workspace;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,SAAS;AAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,aAAqB;IAErB,MAAM,OAAO,GAAwC,EAAE,CAAC;IAExD,SAAS,IAAI,CAAC,GAAW;QACvB,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,uDAAuD;YACvD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YAE5D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAClC,IAAI,EAAE,CAAC;YACP,IAAI,CAAC;gBACH,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrB,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjB,CAAC;iBAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,aAAa,EAAE,CAAC;gBAC7D,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;oBAChD,OAAO,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;wBACvC,OAAO;qBACR,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,CAAC;IACpB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAA4B;IAE5B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,GAAG,CAAC,MAA6C,CAAC;QACjE,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAA+C,CAAC;QACxE,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;QACrC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/openclaw.plugin.json

@@ -0,0 +1,8 @@
+{
+  "id": "deskfree",
+  "name": "DeskFree",
+  "description": "Channel plugin and agent tools for DeskFree project management",
+  "configSchema": { "type": "object", "additionalProperties": true },
+  "channels": ["deskfree"],
+  "skills": ["./skills"]
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@questionbase/deskfree",
+  "version": "0.1.0",
+  "description": "OpenClaw channel plugin for DeskFree — turns DeskFree into a messaging platform for OpenClaw AI agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "files": [
+    "dist/",
+    "openclaw.plugin.json",
+    "skills/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "tsc": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/questionbase/deskfree.git"
+  },
+  "peerDependencies": {
+    "openclaw": ">=0.1.0"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.9.0",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "openclaw",
+    "deskfree",
+    "channel",
+    "plugin",
+    "ai",
+    "agent"
+  ],
+  "license": "MIT"
+}