@co-engram/viewer 0.1.0

package/dist/runtime/tabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.js","sourceRoot":"","sources":["../../src/runtime/tabs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+uD3B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Co-Engram Viewer HTTP Server
+ *
+ * 绑定 127.0.0.1 的轻量 HTTP server,提供只读为主的数据访问 + 极少写操作。
+ *
+ * 设计目标:
+ *   - 只绑定 loopback,不对外网暴露
+ *   - 可选 bearer token 认证
+ *   - EADDRINUSE 自动重试 5 次,每次 port+1
+ *   - 默认关闭,需 CO_ENGRAM_VIEWER_ENABLED=1 显式开启
+ *
+ * 端点清单(11 个):
+ *   GET    /                    SPA HTML(htmx)
+ *   GET    /api/stats           总览统计
+ *   GET    /api/engrams         列表
+ *   GET    /api/engrams/:id     详情
+ *   PATCH  /api/engrams/:id     更新(标题/importance/visibility 等)
+ *   DELETE /api/engrams/:id     删除
+ *   GET    /api/search?q=       搜索
+ *   GET    /api/graph           图视图(节点 + 边)
+ *   GET    /api/proposals       候选提案
+ *   GET    /api/audit           审计日志
+ *   GET    /api/effectiveness   有效性统计
+ *   GET    /api/trash           回收站
+ *   GET    /api/trash/:id       回收站单条预览(完整内容)
+ *   DELETE /api/trash           清空回收站(永久删除,支持 ?partition= 过滤)
+ *   POST   /api/trash/:id/restore  从回收站恢复
+ *
+ * @module @co-engram/claude-code/viewer
+ */
+import { type Server as HttpServer } from "node:http";
+import { type ToolContext, type Language } from "@co-engram/core";
+/** Viewer 配置 */
+export interface ViewerServerConfig {
+    /** 端口(默认 18799) */
+    readonly port?: number;
+    /** 绑定 host(强制 127.0.0.1,不开放外网) */
+    readonly host?: "127.0.0.1";
+    /** Bearer token(可选,设置后所有 /api 请求需 Authorization: Bearer <token>) */
+    readonly token?: string;
+    /** EADDRINUSE 重试次数(默认 5) */
+    readonly maxRetries?: number;
+    /** UI 语言(默认 en) */
+    readonly language?: Language;
+    /**
+     * team-memory 数据根目录。用于 GET/PUT /api/config 读写持久化配置。
+     * 若未传,尝试从 env CO_ENGRAM_DATA_ROOT 读取。
+     */
+    readonly dataRoot?: string;
+    /**
+     * 宿主类型(用于 UI 文字适配,默认自动探测)
+     *
+     * - 'mcp-server':通过 @co-engram/claude-code MCP server 启动,父进程通常是 Claude Code
+     * - 'openclaw-plugin':作为 openclaw plugin 运行,viewer 是 gateway 进程的一部分
+     *
+     * 不传时通过 process.argv 自动探测:启动脚本含 'mcp-server' → mcp-server;
+     * 含 'gateway' → openclaw-plugin;否则默认 'mcp-server'(向后兼容)。
+     */
+    readonly hostType?: "mcp-server" | "openclaw-plugin";
+}
+/** Viewer 运行时句柄 */
+export interface ViewerRuntime {
+    readonly server: HttpServer;
+    readonly port: number;
+    readonly stop: () => Promise<void>;
+}
+/**
+ * 启动 Viewer HTTP server
+ *
+ * 不抛——端口冲突时自动重试 maxRetries 次。
+ */
+export declare function startViewerServer(ctx: ToolContext, config?: ViewerServerConfig): Promise<ViewerRuntime>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAEL,KAAK,MAAM,IAAI,UAAU,EAG1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAEL,KAAK,WAAW,EAGhB,KAAK,QAAQ,EAed,MAAM,iBAAiB,CAAC;AAGzB,gBAAgB;AAChB,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,iBAAiB,CAAC;CACtD;AAED,mBAAmB;AACnB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAKD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAiBxB"}