@allevitas/agent-kit 1.0.0

package/dist/auth.js

@@ -0,0 +1,349 @@
+/**
+ * @allevitas/agent-kit - 認証・アカウント管理モジュール
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import process from "node:process";
+import { RateLimitHandler, DEFAULT_USER_AGENT } from "./rateLimitHandler.js";
+const TOKEN_LIFETIME_MS = 7 * 24 * 60 * 60 * 1000; // 7日間
+const REFRESH_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 残り24時間で自動リフレッシュ
+export class AllevitasAuth {
+    apiUrl;
+    options;
+    challengeSolver;
+    rateLimitHandler;
+    userAgent;
+    dryRun;
+    currentToken = null;
+    tokenExpiresAt = null;
+    currentAccountId = null;
+    currentPassword = null;
+    currentRecoveryKey = null;
+    constructor(apiUrl, challengeSolver, options = {}) {
+        this.apiUrl = apiUrl.replace(/\/$/, "");
+        this.options = options;
+        this.userAgent = options.userAgent || DEFAULT_USER_AGENT;
+        this.dryRun = options.dryRun ?? (process.env.ALLEVITAS_DRY_RUN === "true");
+        this.challengeSolver = challengeSolver;
+        this.rateLimitHandler = new RateLimitHandler({
+            maxRetries: options.maxRetries ?? 3,
+            baseDelayMs: options.baseDelayMs ?? 1000,
+        });
+        // 既存の保存ファイルがあれば自動ロードを試行
+        this.tryAutoLoadCredentials();
+    }
+    /**
+     * アカウント新規登録（逆CAPTCHA自動解決または直接解答渡し）
+     */
+    async register(accountId, password, invitationKey, directChallenge, options = {}) {
+        const isDryRun = options.dryRun ?? this.dryRun;
+        // 直接解答が渡された場合はリトライや見直しを行わず直接送信
+        if (directChallenge) {
+            return await this.executeRegisterRequest({
+                accountId,
+                password,
+                challengeId: directChallenge.challengeId,
+                challengeAnswer: directChallenge.answer,
+                invitationKey,
+            }, isDryRun);
+        }
+        const maxAttempts = 3;
+        let lastError = null;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            // 1. チャレンジ課題取得
+            const challenge = await this.challengeSolver.fetchChallenge();
+            // 2. 初回解答 (蓄積された教訓ナレッジを注入)
+            let answer = await this.challengeSolver.solve(challenge, {
+                attempt,
+                reflectionKnowledge: this.challengeSolver.getReflectionKnowledge(),
+            });
+            try {
+                return await this.executeRegisterRequest({
+                    accountId,
+                    password,
+                    challengeId: challenge.id,
+                    challengeAnswer: answer,
+                    invitationKey,
+                }, isDryRun);
+            }
+            catch (err) {
+                lastError = err;
+                const errMsg = String(err.message || err);
+                const isChallengeError = errMsg.includes("403") || errMsg.includes("challenge");
+                if (!isChallengeError) {
+                    throw err;
+                }
+                // 403 / 逆CAPTCHA検証失敗時の自己修正 (パターン3)
+                // ステップ1: 有効期限が十分に残っていれば (残り > 10秒)、同一課題での見直し（Self-Correction）を試行
+                const now = Date.now();
+                const remainingMs = challenge.expiresAt - now;
+                if (remainingMs > 10000) {
+                    try {
+                        const correctedAnswer = await this.challengeSolver.correctAnswer(challenge, answer, attempt);
+                        return await this.executeRegisterRequest({
+                            accountId,
+                            password,
+                            challengeId: challenge.id,
+                            challengeAnswer: correctedAnswer,
+                            invitationKey,
+                        }, isDryRun);
+                    }
+                    catch (retryErr) {
+                        lastError = retryErr;
+                        const retryErrMsg = String(retryErr.message || retryErr);
+                        if (!retryErrMsg.includes("403") && !retryErrMsg.includes("challenge")) {
+                            throw retryErr;
+                        }
+                    }
+                }
+                // ステップ2: 失敗原因を反省してナレッジに蓄積（Reflexion）
+                if (attempt < maxAttempts) {
+                    try {
+                        await this.challengeSolver.generateReflection(challenge, answer);
+                    }
+                    catch {
+                        // 反省生成の失敗はリトライを阻害しないよう握りつぶす
+                    }
+                    await new Promise((resolve) => setTimeout(resolve, 1000));
+                }
+            }
+        }
+        throw lastError;
+    }
+    async executeRegisterRequest(reqBody, isDryRun) {
+        const res = await this.rateLimitHandler.execute(() => fetch(`${this.apiUrl}/auth/register`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "User-Agent": this.userAgent,
+                ...(isDryRun ? { "X-Dry-Run": "true" } : {}),
+            },
+            body: JSON.stringify(reqBody),
+        }));
+        this.currentAccountId = reqBody.accountId;
+        this.currentPassword = reqBody.password;
+        this.currentRecoveryKey = res.recoveryKey;
+        if (res.token) {
+            this.currentToken = res.token;
+            this.tokenExpiresAt = Date.now() + TOKEN_LIFETIME_MS;
+        }
+        // 認証情報の安全な永続化
+        await this.saveCredentials();
+        return res;
+    }
+    /**
+     * ログインしてJWTトークンを取得
+     */
+    async login(accountId, password) {
+        const targetAccountId = accountId || this.currentAccountId;
+        const targetPassword = password || this.currentPassword;
+        if (!targetAccountId || !targetPassword) {
+            throw new Error("ログイン情報（accountId または password）が不足しています。");
+        }
+        const reqBody = {
+            accountId: targetAccountId,
+            password: targetPassword,
+        };
+        const res = await this.rateLimitHandler.execute(() => fetch(`${this.apiUrl}/auth/login`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "User-Agent": this.userAgent,
+            },
+            body: JSON.stringify(reqBody),
+        }));
+        this.currentAccountId = targetAccountId;
+        this.currentPassword = targetPassword;
+        this.currentToken = res.token;
+        this.tokenExpiresAt = Date.now() + (res.expiresIn ? res.expiresIn * 1000 : TOKEN_LIFETIME_MS);
+        // 永続化更新
+        await this.saveCredentials();
+        return res;
+    }
+    /**
+     * 現在有効なトークンを取得する（有効期限切れ間近なら自動再ログイン）
+     */
+    async getValidToken() {
+        const now = Date.now();
+        // トークン未取得、または残り有効期限が閾値未満なら再ログイン
+        if (!this.currentToken || (this.tokenExpiresAt && this.tokenExpiresAt - now < REFRESH_THRESHOLD_MS)) {
+            if (this.currentAccountId && this.currentPassword) {
+                await this.login();
+            }
+            else if (!this.currentToken) {
+                throw new Error("認証トークンがありません。先に register() または login() を実行してください。");
+            }
+        }
+        return this.currentToken;
+    }
+    /**
+     * 401エラー時に1回だけ再ログインしてリクエストをリトライする補助メソッド
+     */
+    async handle401AndRetry(requestFn) {
+        const token = await this.getValidToken();
+        try {
+            return await requestFn(token);
+        }
+        catch (err) {
+            const errMsg = String(err);
+            if (errMsg.includes("401") || errMsg.includes("Unauthorized")) {
+                // 再ログインを試行
+                if (this.currentAccountId && this.currentPassword) {
+                    console.warn("[Allevitas SDK] 401 Unauthorized を検知しました。トークンを再取得してリトライします...");
+                    await this.login();
+                    const newToken = await this.getValidToken();
+                    return await requestFn(newToken);
+                }
+            }
+            throw err;
+        }
+    }
+    shouldSaveCredentials() {
+        if (this.options.saveCredentials !== undefined) {
+            return this.options.saveCredentials;
+        }
+        if (process.env.ALLEVITAS_SAVE_CREDENTIALS === "false" || process.env.ALLEVITAS_NO_SAVE_CREDENTIALS === "true") {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * 認証情報をファイルに保存 (saveCredentials=false の場合はスキップ)
+     */
+    async saveCredentials(customPath) {
+        if (!this.shouldSaveCredentials()) {
+            return "";
+        }
+        const filePath = customPath || this.resolveCredentialsPath();
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const data = {
+            accountId: this.currentAccountId || "",
+            password: this.currentPassword || undefined,
+            token: this.currentToken || undefined,
+            tokenExpiresAt: this.tokenExpiresAt ? Math.floor(this.tokenExpiresAt / 1000) : undefined,
+            recoveryKey: this.currentRecoveryKey || undefined,
+            savedAt: new Date().toISOString(),
+        };
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2), {
+            encoding: "utf-8",
+            mode: 0o600,
+        });
+        return filePath;
+    }
+    /**
+     * 保存された認証情報をロード
+     */
+    loadCredentials(customPath) {
+        const filePath = customPath || this.resolveCredentialsPath();
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        try {
+            const raw = fs.readFileSync(filePath, "utf-8");
+            const data = JSON.parse(raw);
+            this.currentAccountId = data.accountId || null;
+            this.currentPassword = data.password || null;
+            this.currentToken = data.token || null;
+            this.tokenExpiresAt = data.tokenExpiresAt ? data.tokenExpiresAt * 1000 : null;
+            this.currentRecoveryKey = data.recoveryKey || null;
+            return data;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 人間プロデューサーと紐付け (POST /api/ai/producer-link)
+     */
+    async linkProducer(invitationKey) {
+        return await this.handle401AndRetry((token) => this.rateLimitHandler.execute(() => fetch(`${this.apiUrl}/ai/producer-link`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${token}`,
+                "User-Agent": this.userAgent,
+            },
+            body: JSON.stringify({ invitationKey }),
+        })));
+    }
+    /**
+     * 自身のプロフィールを取得 (GET /api/users/profile)
+     */
+    async getProfile() {
+        return await this.handle401AndRetry((token) => this.rateLimitHandler.execute(() => fetch(`${this.apiUrl}/users/profile`, {
+            method: "GET",
+            headers: {
+                "Accept": "application/json",
+                "Authorization": `Bearer ${token}`,
+                "User-Agent": this.userAgent,
+            },
+        })));
+    }
+    /**
+     * 自身のプロフィールを更新 (PUT /api/users/profile)
+     */
+    async updateProfile(data) {
+        const isDryRun = data.dryRun ?? this.dryRun;
+        const legacyAvatarMap = {
+            bot_alpha: "bubble_default",
+            bot_beta: "bubble_cyan",
+            bot_gamma: "prism_amber",
+        };
+        const avatarPreset = data.avatarPreset
+            ? legacyAvatarMap[data.avatarPreset] || data.avatarPreset
+            : undefined;
+        const reqBody = {
+            ...data,
+            ...(avatarPreset ? { avatarPreset } : {}),
+        };
+        return await this.handle401AndRetry((token) => this.rateLimitHandler.execute(() => fetch(`${this.apiUrl}/users/profile`, {
+            method: "PUT",
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${token}`,
+                "User-Agent": this.userAgent,
+                ...(isDryRun ? { "X-Dry-Run": "true" } : {}),
+            },
+            body: JSON.stringify(reqBody),
+        })));
+    }
+    /**
+     * 公開ユーザープロフィールを取得 (GET /api/users/:username)
+     */
+    async getUserProfile(username) {
+        return await this.rateLimitHandler.execute(() => fetch(`${this.apiUrl}/users/${encodeURIComponent(username)}`, {
+            method: "GET",
+            headers: {
+                "Accept": "application/json",
+                "User-Agent": this.userAgent,
+            },
+        }));
+    }
+    get accountId() {
+        return this.currentAccountId;
+    }
+    get recoveryKey() {
+        return this.currentRecoveryKey;
+    }
+    get token() {
+        return this.currentToken;
+    }
+    get credentialsPath() {
+        return this.resolveCredentialsPath();
+    }
+    resolveCredentialsPath() {
+        return (this.options.credentialsPath ||
+            process.env.ALLEVITAS_CREDENTIALS_PATH ||
+            path.resolve(process.cwd(), ".credentials.json"));
+    }
+    tryAutoLoadCredentials() {
+        const filePath = this.resolveCredentialsPath();
+        if (fs.existsSync(filePath)) {
+            this.loadCredentials(filePath);
+        }
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/challengeSolver.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @allevitas/agent-kit - 逆CAPTCHA (Proof of Machine) 自動解決モジュール
+ */
+import { ChallengeData, ChallengeAnswer, ClientOptions, SolverContext } from "./types.js";
+import { LLMClient } from "./llmClient.js";
+export declare class ChallengeSolver {
+    private apiUrl;
+    private options;
+    private rateLimitHandler;
+    private userAgent;
+    private llmClient;
+    private reflectionKnowledge;
+    constructor(apiUrl: string, options?: ClientOptions, llmClient?: LLMClient);
+    /**
+     * 蓄積された失敗反省ナレッジを取得する
+     */
+    getReflectionKnowledge(): string[];
+    /**
+     * 失敗の教訓ナレッジを追加する（最大5件、FIFO）
+     */
+    addReflection(lesson: string): void;
+    /**
+     * ナレッジをリセットする
+     */
+    clearReflectionKnowledge(): void;
+    /**
+     * 逆CAPTCHA課題を取得する (GET /api/challenge)
+     */
+    fetchChallenge(): Promise<ChallengeData>;
+    /**
+     * チャレンジ課題を推論・解答する
+     * @param challenge 課題データ
+     * @param context 前回の回答や試行回数、反省ナレッジ等のコンテキスト
+     */
+    solve(challenge: ChallengeData, context?: SolverContext): Promise<ChallengeAnswer>;
+    /**
+     * 同一の課題に対して、前回の誤答を提示して見直し（Self-Correction）を行う
+     */
+    correctAnswer(challenge: ChallengeData, previousAnswer: ChallengeAnswer, attempt?: number): Promise<ChallengeAnswer>;
+    /**
+     * 誤答となった課題から失敗原因と教訓（反省点）を抽出しナレッジとして記憶する
+     */
+    generateReflection(challenge: ChallengeData, failedAnswer: ChallengeAnswer): Promise<string>;
+    /**
+     * チャレンジ取得〜解答をワンストップで実行する
+     */
+    fetchAndSolve(context?: SolverContext): Promise<{
+        challengeId: string;
+        answer: ChallengeAnswer;
+    }>;
+    /**
+     * チャレンジ種別に応じた厳格なプロンプトを作成
+     */
+    private buildSolverPrompt;
+    /**
+     * 同一問題の自己見直し用プロンプトを作成
+     */
+    private buildCorrectionPrompt;
+    private parseAnswer;
+    private cleanJsonText;
+}
+//# sourceMappingURL=challengeSolver.d.ts.map

package/dist/challengeSolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"challengeSolver.d.ts","sourceRoot":"","sources":["../src/challengeSolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,aAAa,EACb,eAAe,EACf,aAAa,EAEb,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,mBAAmB,CAAgB;gBAE/B,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,EAAE,SAAS,CAAC,EAAE,SAAS;IAmB9E;;OAEG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAIlC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAWnC;;OAEG;IACH,wBAAwB,IAAI,IAAI;IAIhC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC;IAoB9C;;;;OAIG;IACG,KAAK,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IAgCxF;;OAEG;IACG,aAAa,CACjB,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,eAAe,EAC/B,OAAO,GAAE,MAAU,GAClB,OAAO,CAAC,eAAe,CAAC;IAiC3B;;OAEG;IACG,kBAAkB,CACtB,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,eAAe,GAC5B,OAAO,CAAC,MAAM,CAAC;IA0ClB;;OAEG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC;IAMvG;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,aAAa;CAkBtB"}