twinny 0.0.0-dev.260525150705

package/dist/lark/openapi.d.ts

@@ -0,0 +1,58 @@
+import { TwinnyError } from "../errors.js";
+import { TenantAccessTokenManager } from "./auth.js";
+import type { FetchLike } from "./types.js";
+export interface LarkOpenApiClientOptions {
+    tokenManager: TenantAccessTokenManager;
+    baseUrl?: string;
+    fetch?: FetchLike;
+    maxRetries?: number;
+    retryBaseDelayMs?: number;
+    now?: () => number;
+}
+export interface LarkOpenApiRequestOptions {
+    method?: "GET" | "POST" | "DELETE" | "PATCH" | "PUT";
+    query?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+    signal?: AbortSignal;
+    retry?: boolean;
+}
+export interface LarkOpenApiBinaryResponse {
+    body: Buffer;
+    contentType?: string;
+    contentDisposition?: string;
+}
+export interface LarkOpenApiMultipartFile {
+    fieldName: string;
+    fileName: string;
+    body: Buffer;
+    contentType?: string;
+}
+export declare class LarkOpenApiError extends TwinnyError {
+    readonly detail: {
+        status?: number;
+        code?: number;
+        responseBody?: unknown;
+        retryable?: boolean;
+    };
+    constructor(message: string, detail: {
+        status?: number;
+        code?: number;
+        responseBody?: unknown;
+        retryable?: boolean;
+    }, cause?: unknown);
+}
+export declare class LarkOpenApiClient {
+    private readonly tokenManager;
+    private readonly baseUrl;
+    private readonly fetch;
+    private readonly maxRetries;
+    private readonly retryBaseDelayMs;
+    constructor(options: LarkOpenApiClientOptions);
+    request(pathname: string, options?: LarkOpenApiRequestOptions): Promise<unknown>;
+    download(pathname: string, options?: LarkOpenApiRequestOptions): Promise<LarkOpenApiBinaryResponse>;
+    uploadMultipart(pathname: string, fields: Record<string, string | number | boolean | undefined>, files: LarkOpenApiMultipartFile[], options?: Pick<LarkOpenApiRequestOptions, "query" | "signal" | "retry">): Promise<unknown>;
+    private requestOnce;
+    private downloadOnce;
+    private uploadMultipartOnce;
+    private buildUrl;
+}

package/dist/lark/openapi.js

@@ -0,0 +1,206 @@
+import { TwinnyError, toErrorMessage } from "../errors.js";
+import { DEFAULT_LARK_OPENAPI_BASE_URL, normalizeBaseUrl } from "./auth.js";
+export class LarkOpenApiError extends TwinnyError {
+    detail;
+    constructor(message, detail, cause) {
+        super(message, "LARK_OPENAPI_ERROR", cause);
+        this.detail = detail;
+        this.name = "LarkOpenApiError";
+    }
+}
+export class LarkOpenApiClient {
+    tokenManager;
+    baseUrl;
+    fetch;
+    maxRetries;
+    retryBaseDelayMs;
+    constructor(options) {
+        this.tokenManager = options.tokenManager;
+        this.baseUrl = normalizeBaseUrl(options.baseUrl ?? DEFAULT_LARK_OPENAPI_BASE_URL);
+        this.fetch = options.fetch ?? globalFetch;
+        this.maxRetries = options.maxRetries ?? 2;
+        this.retryBaseDelayMs = options.retryBaseDelayMs ?? 100;
+    }
+    async request(pathname, options = {}) {
+        const retry = options.retry ?? true;
+        const attempts = retry ? this.maxRetries + 1 : 1;
+        let lastError;
+        for (let attempt = 0; attempt < attempts; attempt += 1) {
+            try {
+                return await this.requestOnce(pathname, options);
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt >= attempts - 1 || !isRetryableError(error)) {
+                    break;
+                }
+                await sleep(this.retryBaseDelayMs * 2 ** attempt);
+            }
+        }
+        throw lastError;
+    }
+    async download(pathname, options = {}) {
+        const retry = options.retry ?? true;
+        const attempts = retry ? this.maxRetries + 1 : 1;
+        let lastError;
+        for (let attempt = 0; attempt < attempts; attempt += 1) {
+            try {
+                return await this.downloadOnce(pathname, options);
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt >= attempts - 1 || !isRetryableError(error)) {
+                    break;
+                }
+                await sleep(this.retryBaseDelayMs * 2 ** attempt);
+            }
+        }
+        throw lastError;
+    }
+    async uploadMultipart(pathname, fields, files, options = {}) {
+        const retry = options.retry ?? true;
+        const attempts = retry ? this.maxRetries + 1 : 1;
+        let lastError;
+        for (let attempt = 0; attempt < attempts; attempt += 1) {
+            try {
+                return await this.uploadMultipartOnce(pathname, fields, files, options);
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt >= attempts - 1 || !isRetryableError(error)) {
+                    break;
+                }
+                await sleep(this.retryBaseDelayMs * 2 ** attempt);
+            }
+        }
+        throw lastError;
+    }
+    async requestOnce(pathname, options) {
+        const token = await this.tokenManager.getTenantAccessToken();
+        const response = await this.fetch(this.buildUrl(pathname, options.query), {
+            method: options.method ?? "GET",
+            headers: {
+                authorization: `Bearer ${token}`,
+                "content-type": "application/json"
+            },
+            body: options.body === undefined ? undefined : JSON.stringify(options.body),
+            signal: options.signal
+        });
+        const body = await readJsonBody(response);
+        const record = toRecord(body);
+        const code = typeof record.code === "number" ? record.code : undefined;
+        if (!response.ok || (code !== undefined && code !== 0)) {
+            const retryable = response.status === 429 || response.status >= 500;
+            throw new LarkOpenApiError(`Lark OpenAPI request failed: ${formatOpenApiFailure(response, record)}`, { status: response.status, code, responseBody: body, retryable });
+        }
+        return body;
+    }
+    async downloadOnce(pathname, options) {
+        const token = await this.tokenManager.getTenantAccessToken();
+        const response = await this.fetch(this.buildUrl(pathname, options.query), {
+            method: options.method ?? "GET",
+            headers: {
+                authorization: `Bearer ${token}`,
+                "content-type": "application/json"
+            },
+            body: options.body === undefined ? undefined : JSON.stringify(options.body),
+            signal: options.signal
+        });
+        if (!response.ok) {
+            throw new LarkOpenApiError(`Lark OpenAPI download failed: ${await formatDownloadFailure(response)}`, { status: response.status, retryable: response.status === 429 || response.status >= 500 });
+        }
+        if (!response.arrayBuffer) {
+            throw new LarkOpenApiError("Lark OpenAPI binary response cannot be read in this runtime", {
+                status: response.status
+            });
+        }
+        return {
+            body: Buffer.from(await response.arrayBuffer()),
+            contentType: response.headers?.get("content-type") ?? undefined,
+            contentDisposition: response.headers?.get("content-disposition") ?? undefined
+        };
+    }
+    async uploadMultipartOnce(pathname, fields, files, options) {
+        const token = await this.tokenManager.getTenantAccessToken();
+        const form = new FormData();
+        for (const [key, value] of Object.entries(fields)) {
+            if (value !== undefined) {
+                form.append(key, String(value));
+            }
+        }
+        for (const file of files) {
+            form.append(file.fieldName, new Blob([file.body], { type: file.contentType ?? "application/octet-stream" }), file.fileName);
+        }
+        const response = await this.fetch(this.buildUrl(pathname, options.query), {
+            method: "POST",
+            headers: {
+                authorization: `Bearer ${token}`
+            },
+            body: form,
+            signal: options.signal
+        });
+        const body = await readJsonBody(response);
+        const record = toRecord(body);
+        const code = typeof record.code === "number" ? record.code : undefined;
+        if (!response.ok || (code !== undefined && code !== 0)) {
+            const retryable = response.status === 429 || response.status >= 500;
+            throw new LarkOpenApiError(`Lark OpenAPI request failed: ${formatOpenApiFailure(response, record)}`, { status: response.status, code, responseBody: body, retryable });
+        }
+        return body;
+    }
+    buildUrl(pathname, query) {
+        const path = pathname.startsWith("/") ? pathname : `/${pathname}`;
+        const url = new URL(`${this.baseUrl}${path}`);
+        for (const [key, value] of Object.entries(query ?? {})) {
+            if (value !== undefined) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        return url.toString();
+    }
+}
+function isRetryableError(error) {
+    if (error instanceof LarkOpenApiError) {
+        return error.detail.retryable === true;
+    }
+    return true;
+}
+function formatOpenApiFailure(response, body) {
+    const msg = typeof body.msg === "string" && body.msg.length > 0 ? body.msg : response.statusText;
+    return `status=${response.status} code=${String(body.code ?? "unknown")} msg=${msg}`;
+}
+async function formatDownloadFailure(response) {
+    const text = response.text ? await response.text().catch(() => "") : "";
+    return `status=${response.status} msg=${text || response.statusText}`;
+}
+async function readJsonBody(response) {
+    try {
+        return await response.json();
+    }
+    catch (error) {
+        if (response.text) {
+            try {
+                return { raw: await response.text() };
+            }
+            catch {
+                throw error;
+            }
+        }
+        throw new LarkOpenApiError(`Lark OpenAPI returned invalid JSON: ${toErrorMessage(error)}`, {}, error);
+    }
+}
+function toRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+const globalFetch = async (input, init) => {
+    if (typeof fetch !== "function") {
+        throw new TwinnyError("global fetch is not available in this Node.js runtime", "LARK_FETCH_UNAVAILABLE");
+    }
+    return fetch(input, init);
+};
+//# sourceMappingURL=openapi.js.map

package/dist/lark/openapi.js.map

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

package/dist/lark/redactor.d.ts

@@ -0,0 +1,5 @@
+import { type LarkMessageRedactionConfig } from "../types.js";
+export declare const DEFAULT_LARK_MESSAGE_REDACTION: LarkMessageRedactionConfig;
+export declare function normalizeLarkMessageRedactionConfig(config: Partial<LarkMessageRedactionConfig> | undefined): LarkMessageRedactionConfig;
+export declare function redactSensitiveText(text: string, config?: Partial<LarkMessageRedactionConfig> | undefined): string;
+export declare function redactLarkMessageContent<T>(content: T, config?: Partial<LarkMessageRedactionConfig>): T;

package/dist/lark/redactor.js

@@ -0,0 +1,68 @@
+import { DEFAULT_LARK_MESSAGE_REDACTION_STRATEGY } from "../types.js";
+export const DEFAULT_LARK_MESSAGE_REDACTION = {
+    email: DEFAULT_LARK_MESSAGE_REDACTION_STRATEGY,
+    chinesePhoneNumber: DEFAULT_LARK_MESSAGE_REDACTION_STRATEGY
+};
+const EMAIL_PATTERN = /(^|[^\w.!#$%&'*+/=?^`{|}~-])([A-Za-z0-9.!#$%&'*+/=?^_`{|}~-]+)@([A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?)+)(?![\w-])/g;
+const CHINESE_PHONE_PATTERN = /(^|[^\dA-Za-z])(1[3-9]\d)(\d{4})(\d{4})(?=$|[^\dA-Za-z])/g;
+export function normalizeLarkMessageRedactionConfig(config) {
+    return {
+        email: normalizeStrategy(config?.email),
+        chinesePhoneNumber: normalizeStrategy(config?.chinesePhoneNumber)
+    };
+}
+export function redactSensitiveText(text, config = DEFAULT_LARK_MESSAGE_REDACTION) {
+    const normalized = normalizeLarkMessageRedactionConfig(config);
+    return redactChinesePhoneNumbers(redactEmails(text, normalized.email), normalized.chinesePhoneNumber);
+}
+export function redactLarkMessageContent(content, config) {
+    return redactStringValues(content, normalizeLarkMessageRedactionConfig(config));
+}
+function normalizeStrategy(strategy) {
+    return strategy ?? DEFAULT_LARK_MESSAGE_REDACTION_STRATEGY;
+}
+function redactEmails(text, strategy) {
+    if (strategy === "none") {
+        return text;
+    }
+    return text.replace(EMAIL_PATTERN, (_match, prefix, local, domain) => {
+        if (strategy === "whitespace") {
+            return `${prefix}${local} @ ${domain}`;
+        }
+        return `${prefix}${maskEmailLocalPart(local)}@${domain}`;
+    });
+}
+function redactChinesePhoneNumbers(text, strategy) {
+    if (strategy === "none") {
+        return text;
+    }
+    return text.replace(CHINESE_PHONE_PATTERN, (_match, prefix, first, middle, last) => {
+        if (strategy === "whitespace") {
+            return `${prefix}${first} ${middle} ${last}`;
+        }
+        return `${prefix}${first}****${last}`;
+    });
+}
+function maskEmailLocalPart(local) {
+    if (local.length <= 2) {
+        return local;
+    }
+    return `${local[0]}${"*".repeat(local.length - 2)}${local[local.length - 1]}`;
+}
+function redactStringValues(value, config) {
+    if (typeof value === "string") {
+        return redactSensitiveText(value, config);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => redactStringValues(item, config));
+    }
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+    const result = {};
+    for (const [childKey, childValue] of Object.entries(value)) {
+        result[childKey] = redactStringValues(childValue, config);
+    }
+    return result;
+}
+//# sourceMappingURL=redactor.js.map

package/dist/lark/redactor.js.map

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

package/dist/lark/types.d.ts

@@ -0,0 +1,49 @@
+import type { IncomingLarkBotMenuAction, IncomingLarkCardAction, IncomingLarkMessage, IncomingLarkMessageRecall, LarkReactionHandle } from "../types.js";
+export declare const LARK_BOT_MENU_EVENT: "application.bot.menu_v6";
+export declare const LARK_MESSAGE_RECEIVE_EVENT: "im.message.receive_v1";
+export declare const LARK_MESSAGE_RECALLED_EVENT: "im.message.recalled_v1";
+export declare const LARK_CARD_ACTION_TRIGGER_EVENT: "card.action.trigger";
+export declare const LARK_REQUIRED_SCOPES: readonly ["im:message.p2p_msg:readonly", "im:message.group_msg", "im:message:readonly", "im:message:send_as_bot", "im:message:update", "im:message:recall", "im:message.reactions:write_only", "im:chat:read", "im:chat:create", "im:chat:update", "im:resource"];
+export interface FetchResponseLike {
+    readonly ok: boolean;
+    readonly status: number;
+    readonly statusText: string;
+    readonly headers?: {
+        get(name: string): string | null;
+    };
+    json(): Promise<unknown>;
+    text?(): Promise<string>;
+    arrayBuffer?(): Promise<ArrayBuffer>;
+}
+export interface FetchRequestInitLike {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string | FormData;
+    signal?: AbortSignal;
+}
+export type FetchLike = (input: string, init?: FetchRequestInitLike) => Promise<FetchResponseLike>;
+export interface LarkCredentialOptions {
+    appId: string;
+    appSecret: string;
+    baseUrl?: string;
+    fetch?: FetchLike;
+    now?: () => number;
+}
+export interface LarkLogger {
+    debug?: (metadata: Record<string, unknown>, message?: string) => void;
+    info?: (metadata: Record<string, unknown>, message?: string) => void;
+    warn?: (metadata: Record<string, unknown>, message?: string) => void;
+    error?: (metadata: Record<string, unknown>, message?: string) => void;
+}
+export interface LarkSdkLogger {
+    trace: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+export interface LarkSendMessageResult {
+    messageId?: string;
+    raw: unknown;
+}
+export type { IncomingLarkBotMenuAction, IncomingLarkCardAction, IncomingLarkMessage, IncomingLarkMessageRecall, LarkReactionHandle };

package/dist/lark/types.js

@@ -0,0 +1,18 @@
+export const LARK_BOT_MENU_EVENT = "application.bot.menu_v6";
+export const LARK_MESSAGE_RECEIVE_EVENT = "im.message.receive_v1";
+export const LARK_MESSAGE_RECALLED_EVENT = "im.message.recalled_v1";
+export const LARK_CARD_ACTION_TRIGGER_EVENT = "card.action.trigger";
+export const LARK_REQUIRED_SCOPES = [
+    "im:message.p2p_msg:readonly",
+    "im:message.group_msg",
+    "im:message:readonly",
+    "im:message:send_as_bot",
+    "im:message:update",
+    "im:message:recall",
+    "im:message.reactions:write_only",
+    "im:chat:read",
+    "im:chat:create",
+    "im:chat:update",
+    "im:resource"
+];
+//# sourceMappingURL=types.js.map

package/dist/lark/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lark/types.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAkC,CAAC;AACtE,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAgC,CAAC;AAC3E,MAAM,CAAC,MAAM,2BAA2B,GAAG,wBAAiC,CAAC;AAC7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,qBAA8B,CAAC;AAE7E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,6BAA6B;IAC7B,sBAAsB;IACtB,qBAAqB;IACrB,wBAAwB;IACxB,mBAAmB;IACnB,mBAAmB;IACnB,iCAAiC;IACjC,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;CACL,CAAC"}

package/dist/launchd/install.d.ts

@@ -0,0 +1,22 @@
+import type { TwinnyConfig } from "../types.js";
+export interface WaitForRuntimeLockReleaseOptions {
+    home?: string;
+    timeoutMs?: number;
+    pollMs?: number;
+}
+export interface LaunchAgentCommandOptions {
+    home?: string;
+}
+export interface InstallLaunchAgentOptions extends LaunchAgentCommandOptions {
+    config?: TwinnyConfig;
+    entrypoint?: string;
+    environment?: Record<string, string | undefined>;
+}
+export declare function installLaunchAgent(options?: InstallLaunchAgentOptions): Promise<void>;
+export declare function uninstallLaunchAgent(options?: LaunchAgentCommandOptions): Promise<void>;
+export declare function startLaunchAgent(options?: LaunchAgentCommandOptions): Promise<void>;
+export declare function stopLaunchAgent(options?: LaunchAgentCommandOptions): Promise<void>;
+export declare function restartLaunchAgent(options?: LaunchAgentCommandOptions): Promise<void>;
+export declare function waitForRuntimeLockRelease(options?: WaitForRuntimeLockReleaseOptions): Promise<void>;
+export declare function statusLaunchAgent(options?: LaunchAgentCommandOptions): Promise<void>;
+export declare function tailLogs(options?: LaunchAgentCommandOptions): Promise<void>;

package/dist/launchd/install.js

@@ -0,0 +1,114 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { execa } from "execa";
+import { createRuntimePaths, readConfigStatus, resolveTwinnyHome } from "../config/index.js";
+import { isTwinnyLockHeld, readTwinnyLockPid } from "../lock/index.js";
+import { createLaunchAgentPlist, launchAgentLabelForHomeRandom } from "./plist.js";
+const defaultStopWaitTimeoutMs = 35_000;
+const defaultStopWaitPollMs = 250;
+const runtimeLockStaleMs = 30_000;
+export async function installLaunchAgent(options = {}) {
+    const runtime = await resolveLaunchAgentRuntime(options);
+    const plistPath = runtime.plistPath;
+    fs.mkdirSync(path.dirname(plistPath), { recursive: true });
+    fs.writeFileSync(plistPath, createLaunchAgentPlist({
+        label: runtime.label,
+        twinnyHome: runtime.home,
+        entrypoint: options.entrypoint,
+        environment: options.environment
+    }), "utf8");
+    console.log(`Installed ${runtime.label} at ${plistPath}`);
+}
+export async function uninstallLaunchAgent(options = {}) {
+    const runtime = await resolveLaunchAgentRuntime(options);
+    const plistPath = runtime.plistPath;
+    await execa("launchctl", ["bootout", `gui/${process.getuid?.() ?? os.userInfo().uid}`, plistPath], {
+        reject: false
+    });
+    if (fs.existsSync(plistPath)) {
+        fs.rmSync(plistPath);
+    }
+    console.log(`Uninstalled ${runtime.label}`);
+}
+export async function startLaunchAgent(options = {}) {
+    const runtime = await resolveLaunchAgentRuntime(options);
+    const plistPath = runtime.plistPath;
+    if (!fs.existsSync(plistPath)) {
+        await installLaunchAgent(options);
+        return;
+    }
+    await execa("launchctl", ["bootstrap", `gui/${process.getuid?.() ?? os.userInfo().uid}`, plistPath], {
+        reject: false
+    });
+    await execa("launchctl", ["kickstart", "-k", `gui/${process.getuid?.() ?? os.userInfo().uid}/${runtime.label}`]);
+    console.log(`Started ${runtime.label}`);
+}
+export async function stopLaunchAgent(options = {}) {
+    const runtime = await resolveLaunchAgentRuntime(options);
+    await execa("launchctl", ["bootout", `gui/${process.getuid?.() ?? os.userInfo().uid}`, runtime.plistPath], {
+        reject: false
+    });
+    await waitForRuntimeLockRelease({ home: runtime.home });
+    console.log(`Stopped ${runtime.label}`);
+}
+export async function restartLaunchAgent(options = {}) {
+    await stopLaunchAgent(options);
+    await startLaunchAgent(options);
+}
+export async function waitForRuntimeLockRelease(options = {}) {
+    const paths = createRuntimePaths(options.home ?? resolveTwinnyHome());
+    const timeoutMs = options.timeoutMs ?? defaultStopWaitTimeoutMs;
+    const pollMs = options.pollMs ?? defaultStopWaitPollMs;
+    const deadline = Date.now() + timeoutMs;
+    while (await isTwinnyLockHeld(paths, { stale: runtimeLockStaleMs })) {
+        if (Date.now() >= deadline) {
+            const pid = await readTwinnyLockPid(paths, { stale: runtimeLockStaleMs });
+            const detail = pid ? `pid ${pid}` : "unknown pid";
+            throw new Error(`Timed out waiting for Twinny runtime lock to release (${detail})`);
+        }
+        await sleep(pollMs);
+    }
+}
+export async function statusLaunchAgent(options = {}) {
+    const runtime = await resolveLaunchAgentRuntime(options);
+    const result = await execa("launchctl", ["print", `gui/${process.getuid?.() ?? os.userInfo().uid}/${runtime.label}`], {
+        reject: false
+    });
+    if (result.exitCode === 0) {
+        console.log(result.stdout);
+        return;
+    }
+    console.log(`${runtime.label} is not loaded`);
+}
+export async function tailLogs(options = {}) {
+    const runtime = await resolveLaunchAgentRuntime(options);
+    const logPath = path.join(os.homedir(), "Library", "Logs", "twinny", `${runtime.label}.log`);
+    fs.mkdirSync(path.dirname(logPath), { recursive: true });
+    if (!fs.existsSync(logPath)) {
+        fs.writeFileSync(logPath, "", "utf8");
+    }
+    await execa("tail", ["-f", logPath], { stdio: "inherit" });
+}
+function getLaunchAgentPath(label) {
+    return path.join(os.homedir(), "Library", "LaunchAgents", `${label}.plist`);
+}
+async function resolveLaunchAgentRuntime(options = {}) {
+    const status = options.config
+        ? { complete: true, issues: [], config: options.config, paths: createRuntimePaths(options.config.home) }
+        : await readConfigStatus({ home: options.home });
+    if (!status.complete || !status.config) {
+        throw new Error(`Twinny home is not configured. Issues: ${status.issues.join("; ")}`);
+    }
+    const label = launchAgentLabelForHomeRandom(status.config.homeIdentity.random);
+    return {
+        home: status.paths.home,
+        label,
+        plistPath: getLaunchAgentPath(label),
+        config: status.config
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=install.js.map

package/dist/launchd/install.js.map

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

package/dist/launchd/plist.d.ts

@@ -0,0 +1,10 @@
+export declare const legacyLaunchAgentLabel = "com.twinny.daemon";
+export declare const launchAgentLabelPrefix = "com.twinny.daemon";
+export interface CreateLaunchAgentPlistOptions {
+    label?: string;
+    entrypoint?: string;
+    twinnyHome?: string;
+    environment?: Record<string, string | undefined>;
+}
+export declare function createLaunchAgentPlist(options?: CreateLaunchAgentPlistOptions): string;
+export declare function launchAgentLabelForHomeRandom(homeRandom: string): string;

package/dist/launchd/plist.js

@@ -0,0 +1,61 @@
+import { createHash } from "node:crypto";
+import os from "node:os";
+import path from "node:path";
+export const legacyLaunchAgentLabel = "com.twinny.daemon";
+export const launchAgentLabelPrefix = "com.twinny.daemon";
+export function createLaunchAgentPlist(options = {}) {
+    const label = options.label ?? legacyLaunchAgentLabel;
+    const entrypoint = options.entrypoint ? path.resolve(options.entrypoint) : process.argv[1] ? path.resolve(process.argv[1]) : process.execPath;
+    const logsDir = path.join(os.homedir(), "Library", "Logs", "twinny");
+    const stdout = path.join(logsDir, `${label}.log`);
+    const twinnyHome = options.twinnyHome ?? process.env.TWINNY_HOME ?? path.join(os.homedir(), ".twinny");
+    const args = entrypoint === process.execPath ? [process.execPath, "run"] : [process.execPath, entrypoint, "run"];
+    const environment = normalizeEnvironment({
+        ...(options.environment ?? {}),
+        TWINNY_HOME: twinnyHome
+    });
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${escapeXml(label)}</string>
+  <key>ProgramArguments</key>
+  <array>
+${args.map((arg) => `    <string>${escapeXml(arg)}</string>`).join("\n")}
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+${Object.entries(environment).map(([key, value]) => `    <key>${escapeXml(key)}</key>\n    <string>${escapeXml(value)}</string>`).join("\n")}
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${escapeXml(stdout)}</string>
+  <key>StandardErrorPath</key>
+  <string>${escapeXml(stdout)}</string>
+</dict>
+</plist>
+`;
+}
+export function launchAgentLabelForHomeRandom(homeRandom) {
+    const homeId = createHash("sha256").update(homeRandom.trim().toLowerCase()).digest("hex").slice(0, 16);
+    return `${launchAgentLabelPrefix}.${homeId}`;
+}
+function escapeXml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+function normalizeEnvironment(environment) {
+    return Object.fromEntries(Object.entries(environment)
+        .filter(([key, value]) => key.trim() && value !== undefined)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, value]) => [key, String(value)]));
+}
+//# sourceMappingURL=plist.js.map