codelark 0.1.0

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "codelark",
+  "version": "0.1.0",
+  "description": "Installable CodeLark bridge with local setup UI and background service",
+  "license": "MIT",
+  "homepage": "https://github.com/huiyeruzhou/codelark#readme",
+  "bugs": {
+    "url": "https://github.com/huiyeruzhou/codelark/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/huiyeruzhou/codelark.git"
+  },
+  "type": "module",
+  "files": [
+    "dist/",
+    "agents/",
+    "schemas/",
+    "skills/",
+    "scripts/",
+    "SKILL.md",
+    "LICENSE",
+    "README.md",
+    "SECURITY.md"
+  ],
+  "bin": {
+    "codelark": "dist/cli.mjs"
+  },
+  "scripts": {
+    "postinstall": "node scripts/patch-codex-sdk-windows-hide.js",
+    "build": "node scripts/build.js",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsx src/entrypoints/daemon.ts",
+    "dev:ui": "tsx src/operator-ui/server.ts",
+    "docs:dev": "vitepress dev docs --host 127.0.0.1",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs --host 127.0.0.1",
+    "logs:analyze": "node scripts/analyze-bridge-log.js",
+    "real:setup-wizard:e2e": "tsx scripts/setup-wizard-real-e2e.ts",
+    "real:feishu:e2e": "tsx scripts/real-feishu-e2e.ts",
+    "run": "node dist/cli.mjs run",
+    "test": "node scripts/run-tests.js",
+    "pack:check": "node scripts/check-npm-pack.js",
+    "prepublishOnly": "npm run typecheck && npm test && npm run docs:build && npm run build && npm run pack:check"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.160",
+    "@clack/prompts": "^1.5.1",
+    "@homebridge/node-pty-prebuilt-multiarch": "^0.13.1",
+    "@larksuite/cli": "^1.0.45",
+    "@larksuiteoapi/node-sdk": "^1.66.1",
+    "@openai/codex-sdk": "^0.130.0",
+    "https-proxy-agent": "^9.0.0",
+    "markdown-it": "^14.1.1",
+    "pino": "^10.3.1",
+    "qrcode": "^1.5.4",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^24.12.4",
+    "@types/ws": "^8.5.0",
+    "esbuild": "^0.25.0",
+    "mermaid": "^11.15.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5",
+    "vite": "^5.4.21",
+    "vitepress": "^1.6.4"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}

package/schemas/config.v1.schema.json

@@ -0,0 +1,259 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codelark.local/schemas/config.v1.schema.json",
+  "title": "CodeLark config.json",
+  "description": "Structured runtime and channel configuration stored at ~/.codelark/config.json.",
+  "type": "object",
+  "required": ["schemaVersion", "runtime", "channels"],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "runtime": {
+      "$ref": "#/$defs/runtime"
+    },
+    "channels": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/channelInstance"
+      }
+    }
+  },
+  "allOf": [
+    {
+      "$ref": "#/$defs/noRetiredThreadIdentityFields"
+    }
+  ],
+  "additionalProperties": true,
+  "$defs": {
+    "runtime": {
+      "type": "object",
+      "required": ["provider"],
+      "properties": {
+        "provider": {
+          "const": "codex"
+        },
+        "codex": {
+          "$ref": "#/$defs/codexRuntimeDefaults"
+        },
+        "claude": {
+          "$ref": "#/$defs/claudeRuntimeDefaults"
+        },
+        "bridgeControl": {
+          "$ref": "#/$defs/bridgeControlConfig"
+        },
+        "bridge": {
+          "$ref": "#/$defs/globalBridgeConfig"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/noRetiredThreadIdentityFields"
+        }
+      ],
+      "additionalProperties": true
+    },
+    "codexRuntimeDefaults": {
+      "type": "object",
+      "properties": {
+        "defaultModel": {
+          "type": "string"
+        },
+        "defaultMode": {
+          "enum": ["normal", "yolo"]
+        },
+        "skipGitRepoCheck": {
+          "type": "boolean"
+        },
+        "sandboxMode": {
+          "enum": ["read-only", "workspace-write", "danger-full-access"]
+        },
+        "networkAccess": {
+          "type": "boolean"
+        },
+        "reasoningEffort": {
+          "enum": ["minimal", "low", "medium", "high", "xhigh"]
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/noRetiredThreadIdentityFields"
+        }
+      ],
+      "additionalProperties": true
+    },
+    "claudeRuntimeDefaults": {
+      "type": "object",
+      "properties": {
+        "provider": {
+          "enum": ["pty", "sdk"]
+        },
+        "executable": {
+          "enum": ["claude", "ccr"]
+        },
+        "defaultModel": {
+          "type": "string"
+        },
+        "permissionMode": {
+          "enum": ["default", "acceptEdits", "bypassPermissions", "plan"]
+        },
+        "idleTimeoutMinutes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/noRetiredThreadIdentityFields"
+        }
+      ],
+      "additionalProperties": true
+    },
+    "bridgeControlConfig": {
+      "type": "object",
+      "properties": {
+        "defaultCodexProvider": {
+          "enum": ["sdk", "pty", "tmux"]
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/noRetiredThreadIdentityFields"
+        }
+      ],
+      "additionalProperties": true
+    },
+    "globalBridgeConfig": {
+      "type": "object",
+      "properties": {
+        "defaultWorkspaceRoot": {
+          "type": "string"
+        },
+        "historyMessageLimit": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "streamStatusIdleStartSeconds": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "streamStatusCheckIntervalSeconds": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "uiAllowLan": {
+          "type": "boolean"
+        },
+        "uiAccessToken": {
+          "type": "string"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/noRetiredThreadIdentityFields"
+        }
+      ],
+      "additionalProperties": true
+    },
+    "channelInstance": {
+      "type": "object",
+      "required": ["id", "alias", "provider", "enabled", "createdAt", "updatedAt", "config"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "alias": {
+          "type": "string",
+          "minLength": 1
+        },
+        "provider": {
+          "enum": ["feishu"]
+        },
+        "enabled": {
+          "type": "boolean"
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": "string"
+        },
+        "config": {
+          "$ref": "#/$defs/feishuChannelConfig"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/noRetiredThreadIdentityFields"
+        }
+      ],
+      "additionalProperties": true
+    },
+    "feishuChannelConfig": {
+      "type": "object",
+      "properties": {
+        "appId": {
+          "type": "string"
+        },
+        "appSecret": {
+          "type": "string"
+        },
+        "site": {
+          "enum": ["feishu", "lark"]
+        },
+        "allowedUsers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "streamingEnabled": {
+          "type": "boolean"
+        },
+        "feedbackMarkdownEnabled": {
+          "type": "boolean"
+        },
+        "requireMention": {
+          "type": "boolean"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/noRetiredThreadIdentityFields"
+        }
+      ],
+      "additionalProperties": true
+    },
+    "noRetiredThreadIdentityFields": {
+      "not": {
+        "anyOf": [
+          {
+            "required": ["sdk_session_id"]
+          },
+          {
+            "required": ["sdkSessionId"]
+          },
+          {
+            "required": ["desktop_thread_id"]
+          },
+          {
+            "required": ["desktopThreadId"]
+          },
+          {
+            "required": ["thread_origin"]
+          },
+          {
+            "required": ["threadOrigin"]
+          },
+          {
+            "required": ["thread_id"]
+          },
+          {
+            "required": ["threadId"]
+          }
+        ]
+      }
+    }
+  }
+}

package/schemas/data/audit.v1.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codelark.local/schemas/data/audit.v1.schema.json",
+  "title": "CodeLark audit log entry array",
+  "description": "Audit log entry shape. Current runtime appends entries to data/audit.jsonl and still reads legacy data/audit.json arrays.",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "required": ["id", "createdAt", "channelType", "chatId", "direction", "messageId", "summary"],
+    "properties": {
+      "id": {
+        "type": "string",
+        "minLength": 1
+      },
+      "createdAt": {
+        "type": "string"
+      },
+      "channelType": {
+        "type": "string",
+        "minLength": 1
+      },
+      "channelProvider": {
+        "type": "string"
+      },
+      "channelAlias": {
+        "type": "string"
+      },
+      "chatId": {
+        "type": "string",
+        "minLength": 1
+      },
+      "direction": {
+        "enum": ["inbound", "outbound"]
+      },
+      "messageId": {
+        "type": "string"
+      },
+      "summary": {
+        "type": "string"
+      }
+    },
+    "additionalProperties": true
+  }
+}

package/schemas/data/auto-tasks.v1.schema.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codelark.local/schemas/data/auto-tasks.v1.schema.json",
+  "title": "CodeLark data/auto-tasks.json",
+  "description": "Map of auto task id to /auto automation task records.",
+  "type": "object",
+  "additionalProperties": {
+    "$ref": "#/$defs/autoTask"
+  },
+  "$defs": {
+    "autoTask": {
+      "type": "object",
+      "required": [
+        "id",
+        "bridgeSessionId",
+        "channelType",
+        "chatId",
+        "createdAt",
+        "updatedAt",
+        "triggeredCount",
+        "times",
+        "status"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "kind": {
+          "enum": ["script", "interval"]
+        },
+        "bridgeSessionId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "channelType": {
+          "type": "string",
+          "minLength": 1
+        },
+        "channelProvider": {
+          "type": "string"
+        },
+        "channelAlias": {
+          "type": "string"
+        },
+        "chatId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "chatUserId": {
+          "type": "string"
+        },
+        "chatDisplayName": {
+          "type": "string"
+        },
+        "scriptPath": {
+          "type": "string",
+          "minLength": 0
+        },
+        "prompt": {
+          "type": "string"
+        },
+        "intervalSeconds": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": "string"
+        },
+        "triggeredCount": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "lastTriggeredAt": {
+          "type": "string"
+        },
+        "times": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "status": {
+          "enum": ["running", "completed", "failed"]
+        },
+        "lastError": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    }
+  }
+}

package/schemas/data/channel-chats.v1.schema.json

@@ -0,0 +1,159 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codelark.local/schemas/data/channel-chats.v1.schema.json",
+  "title": "CodeLark data/channel-chats.json",
+  "description": "Map of channel chat binding id to one ChannelChat record. Each channel/chat pair has at most one record.",
+  "type": "object",
+  "additionalProperties": {
+    "$ref": "#/$defs/channelChat"
+  },
+  "$defs": {
+    "channelChat": {
+      "type": "object",
+      "required": [
+        "id",
+        "channelType",
+        "chatId",
+        "bridgeSessionId",
+        "createdAt",
+        "updatedAt"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "channelType": {
+          "type": "string",
+          "minLength": 1
+        },
+        "channelProvider": {
+          "type": "string"
+        },
+        "channelAlias": {
+          "type": "string"
+        },
+        "chatId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "chatKind": {
+          "enum": ["p2p", "group"]
+        },
+        "chatUserId": {
+          "type": "string"
+        },
+        "bridgeSessionId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "runtimeBridgeSessionIds": {
+          "type": "object",
+          "properties": {
+            "codex": {
+              "type": "string",
+              "minLength": 1
+            },
+            "claude": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "additionalProperties": false
+        },
+        "cloudDocumentChat": {
+          "type": "object",
+          "required": ["provider", "fileToken", "fileType"],
+          "properties": {
+            "provider": {
+              "const": "feishu"
+            },
+            "fileToken": {
+              "type": "string",
+              "minLength": 1
+            },
+            "fileType": {
+              "enum": ["doc", "docx", "sheet", "file"]
+            }
+          },
+          "additionalProperties": false
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": "string"
+        },
+        "lastActivityAt": {
+          "type": "string"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/noLegacyBindingRuntimeFields"
+        }
+      ],
+      "additionalProperties": false
+    },
+    "noLegacyBindingRuntimeFields": {
+      "not": {
+        "anyOf": [
+          {
+            "required": ["active"]
+          },
+          {
+            "required": ["chatDisplayName"]
+          },
+          {
+            "required": ["workingDirectory"]
+          },
+          {
+            "required": ["model"]
+          },
+          {
+            "required": ["mode"]
+          },
+          {
+            "required": ["codex_thread_id"]
+          },
+          {
+            "required": ["codexThreadId"]
+          },
+          {
+            "required": ["sdk_session_id"]
+          },
+          {
+            "required": ["sdkSessionId"]
+          },
+          {
+            "required": ["desktop_thread_id"]
+          },
+          {
+            "required": ["desktopThreadId"]
+          },
+          {
+            "required": ["thread_origin"]
+          },
+          {
+            "required": ["threadOrigin"]
+          },
+          {
+            "required": ["thread_id"]
+          },
+          {
+            "required": ["threadId"]
+          },
+          {
+            "required": ["codepilotSessionId"]
+          },
+          {
+            "required": ["codepilot_session_id"]
+          },
+          {
+            "required": ["bridge_session_id"]
+          }
+        ]
+      }
+    }
+  }
+}

package/schemas/data/channel-default-targets.v1.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codelark.local/schemas/data/channel-default-targets.v1.schema.json",
+  "title": "CodeLark data/channel-default-targets.json",
+  "description": "Map of channel instance id to one-shot default bridge session records.",
+  "type": "object",
+  "additionalProperties": {
+    "$ref": "#/$defs/channelDefaultTarget"
+  },
+  "$defs": {
+    "channelDefaultTarget": {
+      "type": "object",
+      "required": ["id", "channelType", "bridgeSessionId", "createdAt", "updatedAt"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "channelType": {
+          "type": "string",
+          "minLength": 1
+        },
+        "channelProvider": {
+          "type": "string"
+        },
+        "channelAlias": {
+          "type": "string"
+        },
+        "bridgeSessionId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/data/messages.v1.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codelark.local/schemas/data/messages.v1.schema.json",
+  "title": "CodeLark data/messages/*.json",
+  "description": "Per-session bridge message history arrays.",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "required": ["role", "content"],
+    "properties": {
+      "role": {
+        "type": "string"
+      },
+      "content": {
+        "type": "string"
+      },
+      "timestamp": {
+        "type": "string"
+      }
+    },
+    "additionalProperties": true
+  }
+}