@folio-agent/handler 0.3.1 → 0.4.1

package/dist/chat/graph.d.ts

@@ -11,7 +11,7 @@ export declare function buildChatGraph(deps: ChatGraphDeps): import("@langchain/
     route?: ChatRoute | undefined;
     overLimit?: boolean | undefined;
     answer?: string | undefined;
-}, "__start__" | "input_guard" | "route_message" | "generate" | "log", {
+}, "__start__" | "generate" | "input_guard" | "log" | "route_message", {
     input: import("@langchain/langgraph").LastValue<string>;
     ip: import("@langchain/langgraph").LastValue<string>;
     route: import("@langchain/langgraph").LastValue<ChatRoute | undefined>;
@@ -24,18 +24,18 @@ export declare function buildChatGraph(deps: ChatGraphDeps): import("@langchain/
     overLimit: import("@langchain/langgraph").LastValue<boolean>;
     answer: import("@langchain/langgraph").LastValue<string | undefined>;
 }, import("@langchain/langgraph").StateDefinition, {
+    generate: {
+        answer: string;
+    };
     input_guard: {
         overLimit: true;
         answer: string;
     } | {
-        overLimit: false;
         answer?: undefined;
+        overLimit: false;
     };
+    log: {};
     route_message: {
-        route: "thoughts" | "works" | "inquiry";
+        route: "inquiry" | "thoughts" | "works";
     };
-    generate: {
-        answer: string;
-    };
-    log: {};
 }, unknown, unknown, []>;

package/dist/chat/graph.js

@@ -1,13 +1,13 @@
 import { Annotation, END, START, StateGraph } from "@langchain/langgraph";
 import { classifyRoute } from "./route.js";
 import { DEFAULT_LANGUAGE } from "./types.js";
-const RATE_LIMIT_REASON_TEXT = {
-    ja: { daily: "本日の上限", shortWindow: "直近の質問数の上限" },
-    en: { daily: "today's limit", shortWindow: "the recent question limit" },
-};
 const OVER_LIMIT_MESSAGE = {
-    ja: (reasonText) => `${reasonText}に達しました。お急ぎの場合はContactからお問い合わせください。`,
-    en: (reasonText) => `You've reached ${reasonText}. If it's urgent, please contact us via the Contact page.`,
+    ja: (reason, config) => reason === "short_window"
+        ? `${config.shortWindowMinutes}分間に${config.shortWindowMax}件までのご質問上限に達しました。少し時間を置いてから再度お試しください。お急ぎの場合はContactからお問い合わせください。`
+        : `${config.longWindowHours}時間に${config.longWindowMax}件までのご質問上限に達しました。時間を置いてから再度お試しください。お急ぎの場合はContactからお問い合わせください。`,
+    en: (reason, config) => reason === "short_window"
+        ? `You've reached the limit of ${config.shortWindowMax} questions per ${config.shortWindowMinutes} minutes. Please try again in a little while. If it's urgent, please contact us via the Contact page.`
+        : `You've reached the limit of ${config.longWindowMax} questions per ${config.longWindowHours} hours. Please try again later. If it's urgent, please contact us via the Contact page.`,
 };
 const GENERATION_FAILED_MESSAGE = {
     ja: "本日の受付上限に達したか、一時的な不具合が発生しています。恐れ入りますがContactからお問い合わせください。",
@@ -26,10 +26,9 @@ export function buildChatGraph(deps) {
         .addNode("input_guard", async (state) => {
         const result = await deps.checkRateLimit(state.ip);
         if (!result.allowed) {
-            const reasonText = result.reason === "daily" ? RATE_LIMIT_REASON_TEXT[language].daily : RATE_LIMIT_REASON_TEXT[language].shortWindow;
             return {
                 overLimit: true,
-                answer: OVER_LIMIT_MESSAGE[language](reasonText),
+                answer: OVER_LIMIT_MESSAGE[language](result.reason, deps.rateLimitConfig),
             };
         }
         return { overLimit: false };

package/dist/chat/handler.js

@@ -4,10 +4,12 @@ import { checkRateLimit } from "./rate-limit.js";
 import { DEFAULT_RATE_LIMIT_CONFIG } from "./types.js";
 const MAX_INPUT_LENGTH = 1000;
 export function createChatHandler(config) {
+    const rateLimitConfig = config.rateLimitConfig ?? DEFAULT_RATE_LIMIT_CONFIG;
     const graph = buildChatGraph({
-        checkRateLimit: (ip) => checkRateLimit(config.db, ip, new Date(), config.rateLimitConfig ?? DEFAULT_RATE_LIMIT_CONFIG),
+        checkRateLimit: (ip) => checkRateLimit(config.db, ip, new Date(), rateLimitConfig),
         generateAnswer: config.generateAnswer,
         logChat: (entry) => logChat(config.db, entry),
+        rateLimitConfig,
         language: config.language,
     });
     return async (request) => {

package/dist/chat/rate-limit.js

@@ -1,6 +1,6 @@
 import { DEFAULT_RATE_LIMIT_CONFIG } from "./types.js";
 const MINUTE_MS = 60_000;
-const DAY_MS = 24 * 60 * MINUTE_MS;
+const HOUR_MS = 60 * MINUTE_MS;
 async function countSince(db, ip, sinceIso) {
     const row = await db
         .prepare("SELECT COUNT(*) as count FROM chat_logs WHERE ip = ? AND created_at >= ? AND over_limit = 0")
@@ -14,10 +14,10 @@ export async function checkRateLimit(db, ip, now = new Date(), config = DEFAULT_
     if (shortCount >= config.shortWindowMax) {
         return { allowed: false, reason: "short_window" };
     }
-    const dailyStart = new Date(now.getTime() - DAY_MS).toISOString();
-    const dailyCount = await countSince(db, ip, dailyStart);
-    if (dailyCount >= config.dailyMax) {
-        return { allowed: false, reason: "daily" };
+    const longWindowStart = new Date(now.getTime() - config.longWindowHours * HOUR_MS).toISOString();
+    const longWindowCount = await countSince(db, ip, longWindowStart);
+    if (longWindowCount >= config.longWindowMax) {
+        return { allowed: false, reason: "long_window" };
     }
     return { allowed: true };
 }

package/dist/chat/types.d.ts

@@ -4,10 +4,11 @@ export declare const DEFAULT_LANGUAGE: Language;
 export interface RateLimitConfig {
     shortWindowMinutes: number;
     shortWindowMax: number;
-    dailyMax: number;
+    longWindowHours: number;
+    longWindowMax: number;
 }
 export declare const DEFAULT_RATE_LIMIT_CONFIG: RateLimitConfig;
-export type RateLimitReason = "short_window" | "daily";
+export type RateLimitReason = "short_window" | "long_window";
 export interface RateLimitResult {
     allowed: boolean;
     reason?: RateLimitReason;
@@ -23,5 +24,6 @@ export interface ChatGraphDeps {
     checkRateLimit: (ip: string) => Promise<RateLimitResult>;
     generateAnswer: (input: string, route: ChatRoute) => Promise<string>;
     logChat: (entry: ChatLogEntry) => Promise<void>;
+    rateLimitConfig: RateLimitConfig;
     language?: Language;
 }

package/dist/chat/types.js

@@ -1,6 +1,7 @@
 export const DEFAULT_LANGUAGE = "ja";
 export const DEFAULT_RATE_LIMIT_CONFIG = {
     shortWindowMinutes: 10,
-    shortWindowMax: 3,
-    dailyMax: 10,
+    shortWindowMax: 6,
+    longWindowHours: 12,
+    longWindowMax: 12,
 };

package/dist/ingest/cli.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {};
+export declare function main(): Promise<void>;

package/dist/ingest/cli.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
+import { realpathSync } from "node:fs";
 import { readFile, writeFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
 import { generateKnowledge } from "./generate.js";
-async function main() {
+export async function main() {
     const configPath = process.argv[2];
     const outputPath = process.argv[3];
     if (!configPath || !outputPath) {
@@ -17,7 +19,13 @@ async function main() {
         console.warn(`warning: ${warning}`);
     }
 }
-main().catch((error) => {
-    console.error(error);
-    process.exitCode = 1;
-});
+// Only run when executed directly (e.g. `folio-agent-ingest ...`), not when imported by tests.
+// Compares realpaths, not raw paths: npm's node_modules/.bin/ entries are symlinks, so
+// process.argv[1] stays the symlink path while import.meta.url is already the resolved target
+// (see sync/cli.ts for the fuller rationale).
+if (process.argv[1] && fileURLToPath(import.meta.url) === realpathSync(process.argv[1])) {
+    main().catch((error) => {
+        console.error(error);
+        process.exitCode = 1;
+    });
+}

package/dist/ingest/generate.js

@@ -1,11 +1,24 @@
+import { readFile, stat } from "node:fs/promises";
 import { createUrlMatcher } from "./glob.js";
 import { htmlToText } from "./html-to-text.js";
 import { readTextFile, scanDist, scanKnowledgeDir } from "./scan-dist.js";
 import { DEFAULT_TOKEN_WARNING_THRESHOLD, estimateTokens } from "./token-count.js";
 import { scanZennArticles } from "./zenn.js";
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
 export async function generateKnowledge(config) {
     const matchesUrl = createUrlMatcher(config);
     const pages = [];
+    const warnings = [];
     const distFiles = await scanDist(config.distDir);
     for (const file of distFiles.filter((f) => matchesUrl(f.urlPath))) {
         const html = await readTextFile(file.absolutePath);
@@ -20,12 +33,20 @@ export async function generateKnowledge(config) {
         }
     }
     if (config.zenn) {
-        pages.push(...(await scanZennArticles(config.zenn)));
+        if (await pathExists(config.zenn.articlesDir)) {
+            pages.push(...(await scanZennArticles(config.zenn)));
+        }
+        else if (config.zennSnapshotPath) {
+            const snapshot = JSON.parse(await readFile(config.zennSnapshotPath, "utf-8"));
+            pages.push(...snapshot);
+        }
+        else {
+            warnings.push(`articlesDir not found: ${config.zenn.articlesDir} — skipping zenn ingest`);
+        }
     }
     pages.sort((a, b) => a.url.localeCompare(b.url));
     const estimatedTokens = estimateTokens(pages.map((p) => p.text).join("\n"));
     const threshold = config.tokenWarningThreshold ?? DEFAULT_TOKEN_WARNING_THRESHOLD;
-    const warnings = [];
     if (estimatedTokens > threshold) {
         warnings.push(`estimated knowledge size (${estimatedTokens} tokens) exceeds the warning threshold (${threshold}). ` +
             "Consider narrowing include globs, or switching to a RAG-based approach.");

package/dist/ingest/types.d.ts

@@ -10,6 +10,13 @@ export interface IngestConfig {
     knowledgeDir?: string;
     /** Zenn CLI articles/ ingestion. Omit to skip Zenn articles entirely. */
     zenn?: ZennIngestConfig;
+    /**
+     * Path to a snapshot JSON produced by `folio-agent-sync-zenn`. Used as a
+     * fallback source of Zenn pages in environments where `zenn.articlesDir`
+     * cannot be read (e.g. CI, where the articles directory often comes from a
+     * separate/private repo that isn't checked out).
+     */
+    zennSnapshotPath?: string;
     /** Token threshold above which the CLI warns that CAG may no longer fit. */
     tokenWarningThreshold?: number;
     /** UI language captured by `folio-agent-init`. Ignored by ingest itself. */

package/dist/init/cli.d.ts

@@ -1,2 +1,16 @@
 #!/usr/bin/env node
-export {};
+export interface DevVarsAndGitignorePlan {
+    nextDevVars: string | undefined;
+    gitignoreResult: {
+        content: string;
+        changed: boolean;
+    };
+}
+/**
+ * Computes what to write to `.dev.vars` and `.gitignore`. `.gitignore` protection for
+ * `.dev.vars` is unconditional — independent of whether a Gemini API key was entered this run —
+ * because a skipped key is commonly filled in by hand afterward per the wizard's own guidance
+ * (see `geminiApiKeySkipNote`), and by then the file must already be gitignored.
+ */
+export declare function planDevVarsAndGitignore(geminiApiKey: string | undefined, devVarsContent: string, gitignoreContent: string): DevVarsAndGitignorePlan;
+export declare function main(): Promise<void>;

package/dist/init/cli.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
-import { existsSync, statSync } from "node:fs";
+import { existsSync, realpathSync, statSync } from "node:fs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
 import * as clack from "@clack/prompts";
 import { DEFAULT_WIZARD_ANSWERS, runWizard } from "./questions.js";
 import { appendIngestToBuildScript, buildApiRouteTemplate, buildConfigJson, buildThemeCss, deriveEndpointPath, ensureGitignoreEntry, PUBLIC_DIR_NAME, resolveThemeCssPath, THEME_CSS_FILENAME, upsertDevVar, } from "./writers.js";
@@ -71,6 +72,17 @@ async function readJson(path) {
 async function readTextOrEmpty(path) {
     return existsSync(path) ? readFile(path, "utf-8") : "";
 }
+/**
+ * Computes what to write to `.dev.vars` and `.gitignore`. `.gitignore` protection for
+ * `.dev.vars` is unconditional — independent of whether a Gemini API key was entered this run —
+ * because a skipped key is commonly filled in by hand afterward per the wizard's own guidance
+ * (see `geminiApiKeySkipNote`), and by then the file must already be gitignored.
+ */
+export function planDevVarsAndGitignore(geminiApiKey, devVarsContent, gitignoreContent) {
+    const nextDevVars = geminiApiKey ? upsertDevVar(devVarsContent, "GEMINI_API_KEY", geminiApiKey) : undefined;
+    const gitignoreResult = ensureGitignoreEntry(gitignoreContent, DEV_VARS_PATH);
+    return { nextDevVars, gitignoreResult };
+}
 function seedDefaults(previous) {
     if (!previous)
         return DEFAULT_WIZARD_ANSWERS;
@@ -84,7 +96,7 @@ function seedDefaults(previous) {
         apiRoutePath: undefined,
     };
 }
-async function main() {
+export async function main() {
     const previousConfig = await readJson(CONFIG_PATH);
     const answers = await runWizard(seedDefaults(previousConfig));
     const text = CLI_TEXT[answers.language];
@@ -107,10 +119,7 @@ async function main() {
     const scripts = pkg.scripts ?? {};
     const nextBuildScript = appendIngestToBuildScript(scripts.build, CONFIG_PATH, KNOWLEDGE_OUTPUT_PATH);
     const buildScriptChanged = nextBuildScript !== (scripts.build ?? "");
-    const nextDevVars = answers.geminiApiKey
-        ? upsertDevVar(await readTextOrEmpty(DEV_VARS_PATH), "GEMINI_API_KEY", answers.geminiApiKey)
-        : undefined;
-    const gitignoreResult = nextDevVars !== undefined ? ensureGitignoreEntry(await readTextOrEmpty(GITIGNORE_PATH), DEV_VARS_PATH) : undefined;
+    const { nextDevVars, gitignoreResult } = planDevVarsAndGitignore(answers.geminiApiKey, await readTextOrEmpty(DEV_VARS_PATH), await readTextOrEmpty(GITIGNORE_PATH));
     const summaryLines = [
         text.summaryConfigLine,
         text.summaryThemeLine(themeCssPath),
@@ -123,8 +132,8 @@ async function main() {
     ];
     if (nextDevVars !== undefined) {
         summaryLines.push(text.summaryDevVarsLine);
-        summaryLines.push(gitignoreResult?.changed ? text.summaryGitignoreAppendedLine : text.summaryGitignoreAlreadyPresentLine);
     }
+    summaryLines.push(gitignoreResult.changed ? text.summaryGitignoreAppendedLine : text.summaryGitignoreAlreadyPresentLine);
     clack.note(summaryLines.join("\n"), text.summaryTitle);
     const shouldWrite = await clack.confirm({ message: text.confirmMessage, initialValue: true });
     if (clack.isCancel(shouldWrite) || !shouldWrite) {
@@ -143,9 +152,9 @@ async function main() {
     }
     if (nextDevVars !== undefined) {
         await writeFile(DEV_VARS_PATH, nextDevVars);
-        if (gitignoreResult?.changed) {
-            await writeFile(GITIGNORE_PATH, gitignoreResult.content);
-        }
+    }
+    if (gitignoreResult.changed) {
+        await writeFile(GITIGNORE_PATH, gitignoreResult.content);
     }
     const endpoint = deriveEndpointPath(answers.apiRoutePath ?? DEFAULT_WIZARD_ANSWERS.apiRoutePath ?? "functions/api/chat.ts");
     const snippetLines = [
@@ -169,13 +178,18 @@ async function main() {
     }
     clack.note(introNotes.join("\n\n"));
     console.log(`\n${snippet}\n`);
-    if (nextDevVars !== undefined) {
-        clack.note(gitignoreResult?.changed ? text.gitignoreAppendedNote : text.gitignoreAlreadyPresentNote);
-    }
+    clack.note(gitignoreResult.changed ? text.gitignoreAppendedNote : text.gitignoreAlreadyPresentNote);
     clack.note(text.d1Note);
     clack.outro(text.outroTitle);
 }
-main().catch((error) => {
-    console.error(error);
-    process.exitCode = 1;
-});
+// Only run the wizard when executed directly (the bin entry point); importing this module for
+// unit tests (e.g. `planDevVarsAndGitignore`) must not trigger the interactive CLI as a side effect.
+// Compares realpaths, not raw paths: npm's node_modules/.bin/ entries are symlinks, so
+// process.argv[1] stays the symlink path while import.meta.url is already the resolved target
+// (see sync/cli.ts for the fuller rationale).
+if (process.argv[1] && fileURLToPath(import.meta.url) === realpathSync(process.argv[1])) {
+    main().catch((error) => {
+        console.error(error);
+        process.exitCode = 1;
+    });
+}

package/dist/sync/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import type { KnowledgePage } from "../ingest/types.js";
+/**
+ * Reads `config.zenn` from `configPath`, scans the configured articles/
+ * directory, and writes the resulting `KnowledgePage[]` to `outputPath` as
+ * JSON. Throws if `config.zenn` is not set.
+ */
+export declare function syncZennSnapshot(configPath: string, outputPath: string): Promise<KnowledgePage[]>;

package/dist/sync/cli.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { scanZennArticles } from "../ingest/zenn.js";
+/**
+ * Reads `config.zenn` from `configPath`, scans the configured articles/
+ * directory, and writes the resulting `KnowledgePage[]` to `outputPath` as
+ * JSON. Throws if `config.zenn` is not set.
+ */
+export async function syncZennSnapshot(configPath, outputPath) {
+    const config = JSON.parse(await readFile(configPath, "utf-8"));
+    if (!config.zenn) {
+        throw new Error("config.zenn is not set");
+    }
+    const pages = await scanZennArticles(config.zenn);
+    await writeFile(outputPath, JSON.stringify(pages, null, 2));
+    return pages;
+}
+async function main() {
+    const configPath = process.argv[2];
+    const outputPath = process.argv[3];
+    if (!configPath || !outputPath) {
+        console.error("usage: folio-agent-sync-zenn <config.json> <output.json>");
+        process.exitCode = 1;
+        return;
+    }
+    const pages = await syncZennSnapshot(configPath, outputPath);
+    console.log(`wrote ${pages.length} zenn page(s) -> ${outputPath}`);
+}
+// Only run when executed directly (e.g. `folio-agent-sync-zenn ...`), not
+// when imported by tests. Compares realpaths: npm's node_modules/.bin/
+// entries are symlinks, so process.argv[1] stays the symlink path while
+// import.meta.url is already the resolved target — a plain string/URL
+// comparison of the two (matching ingest/cli.ts as-is) never matches, and
+// main() silently never runs when invoked via the published bin name.
+if (process.argv[1] && fileURLToPath(import.meta.url) === realpathSync(process.argv[1])) {
+    main().catch((error) => {
+        console.error(error);
+        process.exitCode = 1;
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@folio-agent/handler",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Chat handler (LangGraph.js on Cloudflare Workers) + knowledge ingestion CLI",
   "license": "MIT",
   "type": "module",
@@ -12,7 +12,8 @@
   ],
   "bin": {
     "folio-agent-ingest": "dist/ingest/cli.js",
-    "folio-agent-init": "dist/init/cli.js"
+    "folio-agent-init": "dist/init/cli.js",
+    "folio-agent-sync-zenn": "dist/sync/cli.js"
   },
   "repository": {
     "type": "git",
@@ -39,14 +40,14 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.7.0",
-    "@google/genai": "^2.10.0",
-    "@langchain/langgraph": "^1.4.7",
-    "node-html-parser": "^8.0.4",
+    "@google/genai": "^2.15.0",
+    "@langchain/langgraph": "^1.4.8",
+    "node-html-parser": "^9.0.1",
     "picomatch": "^4.0.5"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^5.20260705.1",
+    "@cloudflare/workers-types": "^5.20260801.1",
     "@types/picomatch": "^4.0.2",
-    "wrangler": "^4.107.0"
+    "wrangler": "^4.118.0"
   }
 }