twinny 0.0.0-dev.260525150705

package/dist/lark/browser-auth.js

@@ -0,0 +1,258 @@
+import { Buffer } from "node:buffer";
+import { setTimeout as sleep } from "node:timers/promises";
+import { TwinnyError } from "../errors.js";
+import { resolveLarkEndpoints } from "./auth.js";
+export const LARK_APP_REGISTRATION_PATH = "/oauth/v1/app/registration";
+export const LARK_DEVICE_AUTHORIZATION_PATH = "/oauth/v1/device_authorization";
+export const LARK_OAUTH_TOKEN_PATH = "/authen/v2/oauth/token";
+export const LARK_USER_INFO_PATH = "/authen/v1/user_info";
+const deviceCodeGrantType = "urn:ietf:params:oauth:grant-type:device_code";
+const maxPollIntervalSeconds = 60;
+const maxAppRegistrationPollAttempts = 200;
+const maxDeviceTokenPollAttempts = 600;
+export async function requestLarkAppRegistration(brand, options = {}) {
+    const fetch = options.fetch ?? globalFetch;
+    const displayEndpoints = resolveLarkEndpoints(brand);
+    const registrationEndpoints = resolveLarkEndpoints("feishu");
+    const body = new URLSearchParams({
+        action: "begin",
+        archetype: "PersonalAgent",
+        auth_method: "client_secret",
+        request_user_info: "open_id tenant_brand"
+    });
+    const response = await fetch(`${registrationEndpoints.accounts}${LARK_APP_REGISTRATION_PATH}`, {
+        method: "POST",
+        headers: { "content-type": "application/x-www-form-urlencoded" },
+        body: body.toString(),
+        signal: options.signal
+    });
+    const payload = await readJsonBody(response);
+    if (!response.ok || stringField(payload, "error")) {
+        throw new TwinnyError(`app registration failed: ${errorDescription(payload, response.statusText)}`, "LARK_APP_REGISTRATION_FAILED");
+    }
+    const userCode = requiredString(payload, "user_code", "app registration response did not include user_code");
+    return {
+        deviceCode: requiredString(payload, "device_code", "app registration response did not include device_code"),
+        userCode,
+        verificationUri: stringField(payload, "verification_uri") ?? "",
+        verificationUriComplete: `${displayEndpoints.open}/page/cli?user_code=${encodeURIComponent(userCode)}`,
+        expiresIn: numberField(payload, "expires_in") ?? 300,
+        interval: numberField(payload, "interval") ?? 5
+    };
+}
+export async function pollLarkAppRegistration(brand, deviceCode, options = {}) {
+    const first = await pollLarkAppRegistrationOnce(brand, deviceCode, options);
+    if (!first.clientSecret && first.tenantBrand === "lark") {
+        const retry = await pollLarkAppRegistrationOnce("lark", deviceCode, options);
+        return normalizeAppRegistrationResult(retry, "lark");
+    }
+    return normalizeAppRegistrationResult(first, first.tenantBrand === "lark" ? "lark" : brand);
+}
+export function buildLarkVerificationUrl(baseUrl, cliVersion) {
+    const separator = baseUrl.includes("?") ? "&" : "?";
+    const version = encodeURIComponent(cliVersion);
+    return `${baseUrl}${separator}lpv=${version}&ocv=${version}&from=cli`;
+}
+export async function requestLarkDeviceAuthorization(input, options = {}) {
+    const fetch = options.fetch ?? globalFetch;
+    const endpoints = resolveLarkEndpoints(input.brand);
+    const scope = ensureOfflineAccessScope(input.scope ?? "");
+    const body = new URLSearchParams({
+        client_id: input.appId,
+        scope
+    });
+    const response = await fetch(`${endpoints.accounts}${LARK_DEVICE_AUTHORIZATION_PATH}`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/x-www-form-urlencoded",
+            authorization: `Basic ${Buffer.from(`${input.appId}:${input.appSecret}`).toString("base64")}`
+        },
+        body: body.toString(),
+        signal: options.signal
+    });
+    const payload = await readJsonBody(response);
+    if (!response.ok || stringField(payload, "error")) {
+        throw new TwinnyError(`device authorization failed: ${errorDescription(payload, response.statusText)}`, "LARK_DEVICE_AUTH_FAILED");
+    }
+    const verificationUri = stringField(payload, "verification_uri") ?? "";
+    return {
+        deviceCode: requiredString(payload, "device_code", "device authorization response did not include device_code"),
+        userCode: requiredString(payload, "user_code", "device authorization response did not include user_code"),
+        verificationUri,
+        verificationUriComplete: stringField(payload, "verification_uri_complete") ?? verificationUri,
+        expiresIn: numberField(payload, "expires_in") ?? 240,
+        interval: numberField(payload, "interval") ?? 5
+    };
+}
+export async function pollLarkDeviceToken(input, options = {}) {
+    const fetch = options.fetch ?? globalFetch;
+    const endpoints = resolveLarkEndpoints(input.brand);
+    const startedAt = options.now?.() ?? Date.now();
+    const deadline = startedAt + Math.max(0, input.expiresIn ?? 240) * 1000;
+    let interval = Math.max(1, input.interval ?? 5);
+    for (let attempt = 0; attempt < maxDeviceTokenPollAttempts && (options.now?.() ?? Date.now()) < deadline; attempt += 1) {
+        await sleep(interval * 1000, undefined, { signal: options.signal });
+        const body = new URLSearchParams({
+            grant_type: deviceCodeGrantType,
+            device_code: input.deviceCode,
+            client_id: input.appId,
+            client_secret: input.appSecret
+        });
+        const response = await fetch(`${endpoints.openApi}${LARK_OAUTH_TOKEN_PATH}`, {
+            method: "POST",
+            headers: { "content-type": "application/x-www-form-urlencoded" },
+            body: body.toString(),
+            signal: options.signal
+        });
+        const payload = await readJsonBody(response);
+        const error = stringField(payload, "error");
+        if (response.ok && !error && stringField(payload, "access_token")) {
+            const accessToken = requiredString(payload, "access_token", "device token response did not include access_token");
+            const refreshToken = stringField(payload, "refresh_token");
+            const expiresIn = numberField(payload, "expires_in") ?? 7200;
+            return {
+                accessToken,
+                refreshToken,
+                expiresIn,
+                refreshExpiresIn: refreshToken ? numberField(payload, "refresh_token_expires_in") ?? 604800 : expiresIn,
+                scope: stringField(payload, "scope")
+            };
+        }
+        if (error === "authorization_pending") {
+            continue;
+        }
+        if (error === "slow_down") {
+            interval = Math.min(interval + 5, maxPollIntervalSeconds);
+            continue;
+        }
+        if (error === "access_denied") {
+            throw new TwinnyError(errorDescription(payload, "Authorization denied by user"), "LARK_DEVICE_AUTH_DENIED");
+        }
+        if (error === "expired_token" || error === "invalid_grant") {
+            throw new TwinnyError(errorDescription(payload, "Device code expired, please try again"), "LARK_DEVICE_AUTH_EXPIRED");
+        }
+        throw new TwinnyError(`device token polling failed: ${errorDescription(payload, response.statusText)}`, "LARK_DEVICE_TOKEN_FAILED");
+    }
+    throw new TwinnyError("device authorization timed out, please try again", "LARK_DEVICE_AUTH_TIMEOUT");
+}
+export async function getLarkBrowserUserInfo(input, options = {}) {
+    const fetch = options.fetch ?? globalFetch;
+    const endpoints = resolveLarkEndpoints(input.brand);
+    const response = await fetch(`${endpoints.openApi}${LARK_USER_INFO_PATH}`, {
+        method: "GET",
+        headers: {
+            authorization: `Bearer ${input.accessToken}`,
+            "content-type": "application/json"
+        },
+        signal: options.signal
+    });
+    const payload = await readJsonBody(response);
+    const data = recordField(payload, "data");
+    const code = numberField(payload, "code") ?? 0;
+    if (!response.ok || code !== 0) {
+        throw new TwinnyError(`failed to get user info: ${errorDescription(payload, response.statusText)}`, "LARK_USER_INFO_FAILED");
+    }
+    return {
+        openId: requiredString(data, "open_id", "user info response did not include open_id"),
+        name: stringField(data, "name") ?? "(unknown)"
+    };
+}
+async function pollLarkAppRegistrationOnce(brand, deviceCode, options) {
+    const fetch = options.fetch ?? globalFetch;
+    const endpoints = resolveLarkEndpoints(brand);
+    const startedAt = options.now?.() ?? Date.now();
+    const deadline = startedAt + Math.max(0, options.expiresIn ?? 300) * 1000;
+    let interval = Math.max(1, options.interval ?? 5);
+    for (let attempt = 0; attempt < maxAppRegistrationPollAttempts && (options.now?.() ?? Date.now()) < deadline; attempt += 1) {
+        await sleep(interval * 1000, undefined, { signal: options.signal });
+        const body = new URLSearchParams({
+            action: "poll",
+            device_code: deviceCode
+        });
+        const response = await fetch(`${endpoints.accounts}${LARK_APP_REGISTRATION_PATH}`, {
+            method: "POST",
+            headers: { "content-type": "application/x-www-form-urlencoded" },
+            body: body.toString(),
+            signal: options.signal
+        });
+        const payload = await readJsonBody(response);
+        const error = stringField(payload, "error");
+        const clientId = stringField(payload, "client_id");
+        if (response.ok && !error && clientId) {
+            const userInfo = recordField(payload, "user_info");
+            return {
+                clientId,
+                clientSecret: stringField(payload, "client_secret") ?? "",
+                tenantBrand: stringField(userInfo, "tenant_brand"),
+                openId: stringField(userInfo, "open_id")
+            };
+        }
+        if (error === "authorization_pending") {
+            continue;
+        }
+        if (error === "slow_down") {
+            interval = Math.min(interval + 5, maxPollIntervalSeconds);
+            continue;
+        }
+        if (error === "access_denied") {
+            throw new TwinnyError("app registration denied by user", "LARK_APP_REGISTRATION_DENIED");
+        }
+        if (error === "expired_token" || error === "invalid_grant") {
+            throw new TwinnyError("device code expired, please try again", "LARK_APP_REGISTRATION_EXPIRED");
+        }
+        throw new TwinnyError(`app registration failed: ${errorDescription(payload, response.statusText)}`, "LARK_APP_REGISTRATION_FAILED");
+    }
+    throw new TwinnyError("app registration timed out, please try again", "LARK_APP_REGISTRATION_TIMEOUT");
+}
+function normalizeAppRegistrationResult(raw, fallbackBrand) {
+    const brand = raw.tenantBrand === "lark" ? "lark" : raw.tenantBrand === "feishu" ? "feishu" : fallbackBrand;
+    if (!raw.clientId || !raw.clientSecret) {
+        throw new TwinnyError("app registration succeeded but missing client_id or client_secret", "LARK_APP_REGISTRATION_INCOMPLETE");
+    }
+    return {
+        appId: raw.clientId,
+        appSecret: raw.clientSecret,
+        brand,
+        ownerOpenId: raw.openId
+    };
+}
+function ensureOfflineAccessScope(scope) {
+    const scopes = scope.split(/\s+/).map((part) => part.trim()).filter(Boolean);
+    if (!scopes.includes("offline_access")) {
+        scopes.push("offline_access");
+    }
+    return scopes.join(" ");
+}
+async function readJsonBody(response) {
+    const value = await response.json();
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function recordField(source, key) {
+    const value = source[key];
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function stringField(source, key) {
+    const value = source[key];
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function requiredString(source, key, message) {
+    const value = stringField(source, key);
+    if (!value) {
+        throw new TwinnyError(message, "LARK_BROWSER_AUTH_RESPONSE_INVALID");
+    }
+    return value;
+}
+function numberField(source, key) {
+    const value = source[key];
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function errorDescription(payload, fallback) {
+    return stringField(payload, "error_description") ?? stringField(payload, "msg") ?? stringField(payload, "error") ?? fallback;
+}
+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=browser-auth.js.map

package/dist/lark/browser-auth.js.map

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

package/dist/lark/cards.d.ts

@@ -0,0 +1,140 @@
+import type { CodexThreadMode, CodexThreadStatus, ConversationResponseMode, ConversationType, ProfileName, UserIdentity } from "../types.js";
+export type LarkCardJson = Record<string, unknown>;
+export type LarkCardElement = Record<string, unknown>;
+export type TwinnyAgentCardStatus = "working" | "finished" | "interrupted" | "paused" | "failed" | "waiting_input" | "waiting_plan" | "interrupted_input" | "interrupted_plan" | "accepted_plan";
+export interface TwinnyAgentCardMessage {
+    id: string;
+    text: string;
+    processOnly?: boolean;
+}
+export interface TwinnyAgentCardActionValue {
+    twinny: true;
+    action: "stop" | "next" | "queue" | "request_input_submit" | "request_input_interrupt" | "plan_implement" | "plan_interrupt";
+    stateKey: string;
+    runId: number;
+}
+export interface TwinnyStatusCardActionValue {
+    twinny: true;
+    action: "status_hide";
+    stateKey: string;
+}
+export interface TwinnyAgentCardInputQuestion {
+    id: string;
+    header: string;
+    question: string;
+    isOther: boolean;
+    isSecret: boolean;
+    options: Array<{
+        label: string;
+        description: string;
+    }> | null;
+}
+export type TwinnyAgentCardWaiting = {
+    kind: "request_user_input";
+    requestId: string;
+    questions: TwinnyAgentCardInputQuestion[];
+} | {
+    kind: "plan";
+    planText: string;
+};
+export interface RenderTwinnyAgentCardOptions {
+    status: TwinnyAgentCardStatus;
+    messages: TwinnyAgentCardMessage[];
+    elapsedMs: number;
+    runtimeStats?: TwinnyAgentCardRuntimeStats;
+    queueDepth: number;
+    queueNextMessage: boolean;
+    stateKey: string;
+    runId: number;
+    iconImageKey?: string;
+    mode?: CodexThreadMode;
+    title?: string;
+    subtitle?: string;
+    hideQueueControls?: boolean;
+    waiting?: TwinnyAgentCardWaiting;
+    finalElements?: LarkCardElement[];
+    mentionOpenIds?: string[];
+    summaryText?: string;
+    error?: string;
+}
+export interface TwinnyAgentCardRuntimeStats {
+    model?: string;
+    effort?: string;
+    inputTokens: number;
+    cachedInputTokens: number;
+    outputTokens: number;
+    contextTokens: number;
+    contextWindow: number;
+}
+export declare const PLAN_IMPLEMENT_INSTRUCTION_FORM_NAME = "plan_implement_instruction";
+export interface RenderTwinnyThreadSummaryCardOptions {
+    name: string;
+    status: CodexThreadStatus;
+    creatorOpenId?: string;
+    createdAt: number;
+    codexThreadId: string;
+    turnCount: number;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    reasoningOutputTokens: number;
+    totalTokens: number;
+    totalWorkDurationMs: number;
+    contextTokens: number;
+    contextWindow: number;
+    iconImageKey?: string;
+}
+export interface RenderTwinnyStatusCardOptions {
+    topic: {
+        id?: string;
+        name?: string;
+        mode: CodexThreadMode;
+        model: string;
+        contextTokens: number;
+        contextWindow: number;
+        userMessageCount: number;
+        inputTokens: number;
+        cachedInputTokens: number;
+        outputTokens: number;
+        reasoningOutputTokens: number;
+        totalWorkDurationMs: number;
+    };
+    workspace: {
+        id: string;
+        type: ConversationType;
+        responseMode: ConversationResponseMode;
+        profile?: ProfileName;
+        path?: string;
+        topicCount: number;
+        userMessageCount: number;
+        inputTokens: number;
+        cachedInputTokens: number;
+        outputTokens: number;
+        reasoningOutputTokens: number;
+        totalWorkDurationMs: number;
+    };
+    user: {
+        openId: string;
+        identity: UserIdentity;
+    };
+    system?: {
+        twinnyHome: string;
+        twinnyVersion: string;
+        codexVersion: string;
+        larkAppId: string;
+        fiveHourRemainingLimit: string;
+        sevenDayRemainingLimit: string;
+    };
+    hideAction?: TwinnyStatusCardActionValue;
+}
+export interface RenderTwinnyBannerCardOptions {
+    bannerImageKey?: string;
+    twinnyVersion?: string;
+}
+export declare function renderTwinnyAgentCard(options: RenderTwinnyAgentCardOptions): LarkCardJson;
+export declare function renderTwinnyStatusCard(options: RenderTwinnyStatusCardOptions): LarkCardJson;
+export declare function renderTwinnyThreadSummaryCard(options: RenderTwinnyThreadSummaryCardOptions): LarkCardJson;
+export declare function renderTwinnyBannerCard(options?: RenderTwinnyBannerCardOptions): LarkCardJson;
+export declare function markdownElement(content: string, extra?: Record<string, unknown>): LarkCardElement;
+export declare function imageElement(imageKey: string): LarkCardElement;
+export declare function mediaElement(fileKey: string): LarkCardElement;