larkin 0.2.70

package/dist/platform/root-layout.cjs

@@ -0,0 +1,111 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TargetRootLayout = void 0;
+exports.resolveConfigDir = resolveConfigDir;
+exports.planRootLayout = planRootLayout;
+const path = __importStar(require("node:path"));
+const APP_ID = /^cli_[A-Za-z0-9]+$/;
+function requireConfigDir(configDir) {
+    if (typeof configDir !== "string" || !configDir.trim())
+        throw new Error("config dir must be non-empty");
+    return path.resolve(configDir);
+}
+function validateAgentId(agentId) {
+    if (typeof agentId !== "string" || !APP_ID.test(agentId)) {
+        throw new Error(`invalid App ID agent id: ${JSON.stringify(agentId)}`);
+    }
+}
+function resolveConfigDir(env, home) {
+    const explicit = env?.LARKIN_CONFIG_DIR;
+    if (!explicit && (typeof home !== "string" || !home.trim()))
+        throw new Error("home must be non-empty");
+    return path.resolve(explicit || path.join(home, ".larkin"));
+}
+class TargetRootLayout {
+    root;
+    configDir;
+    larkinHome;
+    configFile;
+    daemonStatusFile;
+    dashboardStatusFile;
+    constructor(configDir) {
+        this.root = requireConfigDir(configDir);
+        this.configDir = this.root;
+        this.larkinHome = this.root;
+        this.configFile = path.join(this.root, "config.json");
+        this.daemonStatusFile = path.join(this.root, "daemon-status.json");
+        this.dashboardStatusFile = path.join(this.root, "dashboard-status.json");
+        Object.freeze(this);
+    }
+    static fromConfigDir(configDir) {
+        return new TargetRootLayout(configDir);
+    }
+    workspaceDir(agentId) {
+        validateAgentId(agentId);
+        return path.join(this.root, "agents", agentId);
+    }
+    agentStateDir(agentId) {
+        validateAgentId(agentId);
+        return path.join(this.root, "state", "agents", agentId);
+    }
+    agentStatePaths(agentId) {
+        const root = this.agentStateDir(agentId);
+        return Object.freeze({
+            root,
+            agentState: path.join(root, "agent-state.json"),
+            status: path.join(root, "status.json"),
+            map: path.join(root, "feishu-map.json"),
+            replyctx: path.join(root, "feishu-replyctx.json"),
+            botIdentity: path.join(root, "bot-identity.json"),
+            senderProfiles: path.join(root, "sender-profiles.json"),
+            readReceipts: path.join(root, "feishu-read.json"),
+            pendingReact: path.join(root, "feishu-pending-react.json"),
+            runtimeDeliveries: path.join(root, "runtime-deliveries.json"),
+            inboxState: path.join(root, "inbox-state.json"),
+            freshnessState: path.join(root, "freshness-state.json"),
+            documentComments: path.join(root, "document-comments.json"),
+            interactions: path.join(root, "interactions.json"),
+            conversation: path.join(root, "conversation.ndjson"),
+            inbox: path.join(root, "feishu-inbox.ndjson"),
+            reminders: path.join(root, "reminders.json"),
+        });
+    }
+}
+exports.TargetRootLayout = TargetRootLayout;
+function planRootLayout({ root, agentId }) {
+    const target = TargetRootLayout.fromConfigDir(root);
+    return { root: target.root, workspaceDir: target.workspaceDir(agentId), stateDir: target.agentStateDir(agentId) };
+}

package/dist/platform/root-layout.mjs

@@ -0,0 +1,72 @@
+import * as path from "node:path";
+const APP_ID = /^cli_[A-Za-z0-9]+$/;
+function requireConfigDir(configDir) {
+    if (typeof configDir !== "string" || !configDir.trim())
+        throw new Error("config dir must be non-empty");
+    return path.resolve(configDir);
+}
+function validateAgentId(agentId) {
+    if (typeof agentId !== "string" || !APP_ID.test(agentId)) {
+        throw new Error(`invalid App ID agent id: ${JSON.stringify(agentId)}`);
+    }
+}
+export function resolveConfigDir(env, home) {
+    const explicit = env?.LARKIN_CONFIG_DIR;
+    if (!explicit && (typeof home !== "string" || !home.trim()))
+        throw new Error("home must be non-empty");
+    return path.resolve(explicit || path.join(home, ".larkin"));
+}
+export class TargetRootLayout {
+    root;
+    configDir;
+    larkinHome;
+    configFile;
+    daemonStatusFile;
+    dashboardStatusFile;
+    constructor(configDir) {
+        this.root = requireConfigDir(configDir);
+        this.configDir = this.root;
+        this.larkinHome = this.root;
+        this.configFile = path.join(this.root, "config.json");
+        this.daemonStatusFile = path.join(this.root, "daemon-status.json");
+        this.dashboardStatusFile = path.join(this.root, "dashboard-status.json");
+        Object.freeze(this);
+    }
+    static fromConfigDir(configDir) {
+        return new TargetRootLayout(configDir);
+    }
+    workspaceDir(agentId) {
+        validateAgentId(agentId);
+        return path.join(this.root, "agents", agentId);
+    }
+    agentStateDir(agentId) {
+        validateAgentId(agentId);
+        return path.join(this.root, "state", "agents", agentId);
+    }
+    agentStatePaths(agentId) {
+        const root = this.agentStateDir(agentId);
+        return Object.freeze({
+            root,
+            agentState: path.join(root, "agent-state.json"),
+            status: path.join(root, "status.json"),
+            map: path.join(root, "feishu-map.json"),
+            replyctx: path.join(root, "feishu-replyctx.json"),
+            botIdentity: path.join(root, "bot-identity.json"),
+            senderProfiles: path.join(root, "sender-profiles.json"),
+            readReceipts: path.join(root, "feishu-read.json"),
+            pendingReact: path.join(root, "feishu-pending-react.json"),
+            runtimeDeliveries: path.join(root, "runtime-deliveries.json"),
+            inboxState: path.join(root, "inbox-state.json"),
+            freshnessState: path.join(root, "freshness-state.json"),
+            documentComments: path.join(root, "document-comments.json"),
+            interactions: path.join(root, "interactions.json"),
+            conversation: path.join(root, "conversation.ndjson"),
+            inbox: path.join(root, "feishu-inbox.ndjson"),
+            reminders: path.join(root, "reminders.json"),
+        });
+    }
+}
+export function planRootLayout({ root, agentId }) {
+    const target = TargetRootLayout.fromConfigDir(root);
+    return { root: target.root, workspaceDir: target.workspaceDir(agentId), stateDir: target.agentStateDir(agentId) };
+}

package/dist/platform/telemetry-config.cjs

@@ -0,0 +1,64 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateOtlpEndpoint = validateOtlpEndpoint;
+exports.loadTelemetryConfig = loadTelemetryConfig;
+exports.safeEndpointLabel = safeEndpointLabel;
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const root_layout_js_1 = require("./root-layout.cjs");
+const positiveInteger = (value, fallback) => {
+    const parsed = Number(value);
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : fallback;
+};
+function validateOtlpEndpoint(value) {
+    const url = new URL(value);
+    if (!['http:', 'https:'].includes(url.protocol))
+        throw new Error("OTLP endpoint must use http or https");
+    if (url.username || url.password)
+        throw new Error("OTLP endpoint must not contain userinfo");
+    if (url.hash)
+        throw new Error("OTLP endpoint must not contain a fragment");
+    if (url.pathname === "/" || url.pathname === "")
+        url.pathname = "/v1/traces";
+    return url.toString();
+}
+function parseHeaders(value) {
+    if (!value)
+        return {};
+    const headers = {};
+    for (const field of value.split(",")) {
+        const separator = field.indexOf("=");
+        if (separator <= 0)
+            throw new Error("OTLP headers must use name=value pairs");
+        const name = field.slice(0, separator).trim();
+        const headerValue = decodeURIComponent(field.slice(separator + 1).trim());
+        if (!/^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/.test(name) || /[\r\n]/.test(headerValue)) {
+            throw new Error("OTLP header is invalid");
+        }
+        headers[name] = headerValue;
+    }
+    return headers;
+}
+function loadTelemetryConfig(env = process.env) {
+    const home = env.LARKIN_HOME || (0, root_layout_js_1.resolveConfigDir)(env, node_os_1.default.homedir());
+    const endpointValue = env.LARKIN_TELEMETRY_OTLP_ENDPOINT || env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT;
+    return {
+        spoolDir: node_path_1.default.resolve(env.LARKIN_TELEMETRY_SPOOL_DIR || node_path_1.default.join(home, "telemetry", "spool")),
+        ...(endpointValue ? { endpoint: validateOtlpEndpoint(endpointValue) } : {}),
+        headers: parseHeaders(env.LARKIN_TELEMETRY_OTLP_HEADERS || env.OTEL_EXPORTER_OTLP_HEADERS),
+        maxBytes: positiveInteger(env.LARKIN_TELEMETRY_MAX_BYTES, 64 * 1024 * 1024),
+        maxFiles: positiveInteger(env.LARKIN_TELEMETRY_MAX_FILES, 10_000),
+        maxAgeMs: positiveInteger(env.LARKIN_TELEMETRY_MAX_AGE_MS, 14 * 24 * 60 * 60 * 1000),
+        uploadIntervalMs: positiveInteger(env.LARKIN_TELEMETRY_UPLOAD_INTERVAL_MS, 10_000),
+        requestTimeoutMs: positiveInteger(env.LARKIN_TELEMETRY_REQUEST_TIMEOUT_MS, 10_000),
+    };
+}
+function safeEndpointLabel(endpoint) {
+    if (!endpoint)
+        return null;
+    const url = new URL(endpoint);
+    return `${url.protocol}//${url.host}`;
+}

package/dist/platform/telemetry-config.mjs

@@ -0,0 +1,56 @@
+import path from "node:path";
+import os from "node:os";
+import { resolveConfigDir } from "./root-layout.mjs";
+const positiveInteger = (value, fallback) => {
+    const parsed = Number(value);
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : fallback;
+};
+export function validateOtlpEndpoint(value) {
+    const url = new URL(value);
+    if (!['http:', 'https:'].includes(url.protocol))
+        throw new Error("OTLP endpoint must use http or https");
+    if (url.username || url.password)
+        throw new Error("OTLP endpoint must not contain userinfo");
+    if (url.hash)
+        throw new Error("OTLP endpoint must not contain a fragment");
+    if (url.pathname === "/" || url.pathname === "")
+        url.pathname = "/v1/traces";
+    return url.toString();
+}
+function parseHeaders(value) {
+    if (!value)
+        return {};
+    const headers = {};
+    for (const field of value.split(",")) {
+        const separator = field.indexOf("=");
+        if (separator <= 0)
+            throw new Error("OTLP headers must use name=value pairs");
+        const name = field.slice(0, separator).trim();
+        const headerValue = decodeURIComponent(field.slice(separator + 1).trim());
+        if (!/^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/.test(name) || /[\r\n]/.test(headerValue)) {
+            throw new Error("OTLP header is invalid");
+        }
+        headers[name] = headerValue;
+    }
+    return headers;
+}
+export function loadTelemetryConfig(env = process.env) {
+    const home = env.LARKIN_HOME || resolveConfigDir(env, os.homedir());
+    const endpointValue = env.LARKIN_TELEMETRY_OTLP_ENDPOINT || env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT;
+    return {
+        spoolDir: path.resolve(env.LARKIN_TELEMETRY_SPOOL_DIR || path.join(home, "telemetry", "spool")),
+        ...(endpointValue ? { endpoint: validateOtlpEndpoint(endpointValue) } : {}),
+        headers: parseHeaders(env.LARKIN_TELEMETRY_OTLP_HEADERS || env.OTEL_EXPORTER_OTLP_HEADERS),
+        maxBytes: positiveInteger(env.LARKIN_TELEMETRY_MAX_BYTES, 64 * 1024 * 1024),
+        maxFiles: positiveInteger(env.LARKIN_TELEMETRY_MAX_FILES, 10_000),
+        maxAgeMs: positiveInteger(env.LARKIN_TELEMETRY_MAX_AGE_MS, 14 * 24 * 60 * 60 * 1000),
+        uploadIntervalMs: positiveInteger(env.LARKIN_TELEMETRY_UPLOAD_INTERVAL_MS, 10_000),
+        requestTimeoutMs: positiveInteger(env.LARKIN_TELEMETRY_REQUEST_TIMEOUT_MS, 10_000),
+    };
+}
+export function safeEndpointLabel(endpoint) {
+    if (!endpoint)
+        return null;
+    const url = new URL(endpoint);
+    return `${url.protocol}//${url.host}`;
+}