@squadbase/vite-server 0.1.17-dev.24af54e → 0.1.17-dev.423ee34

package/dist/connectors/jira-api-key.js

@@ -16,6 +16,7 @@ var init_parameter_definition = __esm({
       type;
       secret;
       required;
+      isDeprecated;
       constructor(config) {
         this.slug = config.slug;
         this.name = config.name;
@@ -24,6 +25,7 @@ var init_parameter_definition = __esm({
         this.type = config.type;
         this.secret = config.secret;
         this.required = config.required;
+        this.isDeprecated = config.isDeprecated ?? false;
       }
       /**
        * Get the parameter value from a ConnectorConnectionObject.
@@ -222,7 +224,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
   /**
    * Create tools for connections that belong to this connector.
    * Filters connections by connectorKey internally.
-   * Returns tools keyed as `${connectorKey}_${toolName}`.
+   * Returns tools keyed as `connector_${connectorKey}_${toolName}`.
    */
   createTools(connections, config, opts) {
     const myConnections = connections.filter(
@@ -232,7 +234,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
     for (const t of Object.values(this.tools)) {
       const tool = t.createTool(myConnections, config);
       const originalToModelOutput = tool.toModelOutput;
-      result[`${this.connectorKey}_${t.name}`] = {
+      result[`connector_${this.connectorKey}_${t.name}`] = {
         ...tool,
         toModelOutput: async (options) => {
           if (!originalToModelOutput) {
@@ -288,19 +290,34 @@ async function runSetupFlow(flow, params, ctx, config) {
   };
   let state = flow.initialState();
   let answerIdx = 0;
+  const pendingParameterUpdates = [];
   for (const step of flow.steps) {
     const ans = ctx.answers[answerIdx];
     if (ans && ans.questionSlug === step.slug) {
       state = step.applyAnswer(state, ans.answer);
+      if (step.toParameterUpdates) {
+        pendingParameterUpdates.push(...step.toParameterUpdates(state));
+      }
       answerIdx += 1;
       continue;
     }
+    const resolvedAllowFreeText = step.allowFreeText !== void 0 ? step.allowFreeText : true;
     if (step.type === "text") {
+      if (step.fetchOptions) {
+        const options2 = await step.fetchOptions(state, runtime);
+        if (options2.length === 0) {
+          continue;
+        }
+      }
       return {
         type: "nextQuestion",
         questionSlug: step.slug,
         question: step.question[ctx.language],
-        questionType: "text"
+        questionType: "text",
+        allowFreeText: resolvedAllowFreeText,
+        ...pendingParameterUpdates.length > 0 && {
+          parameterUpdates: pendingParameterUpdates
+        }
       };
     }
     const options = step.fetchOptions ? await step.fetchOptions(state, runtime) : [];
@@ -312,11 +329,21 @@ async function runSetupFlow(flow, params, ctx, config) {
       questionSlug: step.slug,
       question: step.question[ctx.language],
       questionType: step.type,
-      options
+      options,
+      allowFreeText: resolvedAllowFreeText,
+      ...pendingParameterUpdates.length > 0 && {
+        parameterUpdates: pendingParameterUpdates
+      }
     };
   }
   const dataInvestigationResult = await flow.finalize(state, runtime);
-  return { type: "fulfilled", dataInvestigationResult };
+  return {
+    type: "fulfilled",
+    dataInvestigationResult,
+    ...pendingParameterUpdates.length > 0 && {
+      parameterUpdates: pendingParameterUpdates
+    }
+  };
 }
 async function resolveSetupSelection(params) {
   const { selected, allSentinel, fetchAll, limit } = params;
@@ -337,12 +364,12 @@ var AUTH_TYPES = {
 // ../connectors/src/connectors/jira/setup.ts
 var jiraOnboarding = new ConnectorOnboarding({
   dataOverviewInstructions: {
-    en: `1. Call jira-api-key_request with GET project to list all accessible projects
-2. For key projects, call jira-api-key_request with POST search to search issues using JQL (e.g., body: { "jql": "project = PROJ order by created DESC", "maxResults": 5, "fields": ["summary", "status", "assignee", "priority", "created"] })
-3. Call jira-api-key_request with GET issue/{issueKey} to inspect a sample issue's full details`,
-    ja: `1. jira-api-key_request \u3067 GET project \u3092\u547C\u3073\u51FA\u3057\u3001\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
-2. \u4E3B\u8981\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306B\u3064\u3044\u3066 jira-api-key_request \u3067 POST search \u3092\u4F7F\u7528\u3057\u3066JQL\u3067\u30A4\u30B7\u30E5\u30FC\u3092\u691C\u7D22\uFF08\u4F8B: body: { "jql": "project = PROJ order by created DESC", "maxResults": 5, "fields": ["summary", "status", "assignee", "priority", "created"] }\uFF09
-3. jira-api-key_request \u3067 GET issue/{issueKey} \u3092\u547C\u3073\u51FA\u3057\u3001\u30B5\u30F3\u30D7\u30EB\u30A4\u30B7\u30E5\u30FC\u306E\u8A73\u7D30\u3092\u78BA\u8A8D`
+    en: `1. Call connector_jira-api-key_request with GET project to list all accessible projects
+2. For key projects, call connector_jira-api-key_request with POST search to search issues using JQL (e.g., body: { "jql": "project = PROJ order by created DESC", "maxResults": 5, "fields": ["summary", "status", "assignee", "priority", "created"] })
+3. Call connector_jira-api-key_request with GET issue/{issueKey} to inspect a sample issue's full details`,
+    ja: `1. connector_jira-api-key_request \u3067 GET project \u3092\u547C\u3073\u51FA\u3057\u3001\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
+2. \u4E3B\u8981\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306B\u3064\u3044\u3066 connector_jira-api-key_request \u3067 POST search \u3092\u4F7F\u7528\u3057\u3066JQL\u3067\u30A4\u30B7\u30E5\u30FC\u3092\u691C\u7D22\uFF08\u4F8B: body: { "jql": "project = PROJ order by created DESC", "maxResults": 5, "fields": ["summary", "status", "assignee", "priority", "created"] }\uFF09
+3. connector_jira-api-key_request \u3067 GET issue/{issueKey} \u3092\u547C\u3073\u51FA\u3057\u3001\u30B5\u30F3\u30D7\u30EB\u30A4\u30B7\u30E5\u30FC\u306E\u8A73\u7D30\u3092\u78BA\u8A8D`
   }
 });
 
@@ -404,6 +431,43 @@ async function getProject(params, keyOrId) {
   }
   return await res.json();
 }
+async function fetchProjectIssueCount(params, projectKey) {
+  try {
+    const jql = encodeURIComponent(`project = ${projectKey}`);
+    const res = await apiFetch(
+      params,
+      `search?jql=${jql}&maxResults=0`
+    );
+    if (!res.ok) return null;
+    const data = await res.json();
+    return typeof data.total === "number" ? data.total : null;
+  } catch {
+    return null;
+  }
+}
+async function fetchStatusBreakdown(params, projectKey) {
+  try {
+    const jql = encodeURIComponent(
+      `project = ${projectKey} ORDER BY created DESC`
+    );
+    const res = await apiFetch(
+      params,
+      `search?jql=${jql}&maxResults=100&fields=status`
+    );
+    if (!res.ok) return null;
+    const data = await res.json();
+    const issues = data.issues ?? [];
+    if (issues.length === 0) return null;
+    const breakdown = {};
+    for (const issue of issues) {
+      const category = issue.fields?.status?.statusCategory?.name ?? "Unknown";
+      breakdown[category] = (breakdown[category] ?? 0) + 1;
+    }
+    return breakdown;
+  } catch {
+    return null;
+  }
+}
 var jiraSetupFlow = {
   initialState: () => ({}),
   steps: [
@@ -444,17 +508,37 @@ var jiraSetupFlow = {
     const sections = ["## Jira", ""];
     for (const key of targetKeys) {
       const project = await getProject(rt.params, key);
-      sections.push(`### Project: ${project.name} (${project.key})`, "");
+      const issueCount = await fetchProjectIssueCount(rt.params, key);
+      const countLabel = issueCount == null ? "" : ` - ${issueCount.toLocaleString()} issues`;
+      sections.push(
+        `### Project: ${project.name} (${project.key})${countLabel}`,
+        ""
+      );
       const lead = project.lead?.displayName ?? "-";
       const typeKey = project.projectTypeKey ?? "-";
       sections.push(`- Lead: ${lead}`);
       sections.push(`- Project type: ${typeKey}`);
+      if (issueCount != null) {
+        sections.push(`- Total issues: ${issueCount.toLocaleString()}`);
+      }
       const issueTypes = project.issueTypes ?? [];
       sections.push(`- Issue types (${issueTypes.length}):`);
       for (const it of issueTypes) {
         const suffix = it.subtask ? " (sub-task)" : "";
         sections.push(`  - ${it.name}${suffix}`);
       }
+      const breakdown = await fetchStatusBreakdown(rt.params, key);
+      if (breakdown && Object.keys(breakdown).length > 0) {
+        sections.push("");
+        sections.push("**Status category breakdown (from recent 100 issues):**", "");
+        sections.push("| Status category | Count |");
+        sections.push("|-----------------|-------|");
+        for (const [category, count] of Object.entries(breakdown).sort(
+          (a, b) => b[1] - a[1]
+        )) {
+          sections.push(`| ${category} | ${count} |`);
+        }
+      }
       sections.push("");
     }
     return sections.join("\n");
@@ -553,7 +637,7 @@ var jiraConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`jira-api-key_request\`: The only way to call the Jira Cloud REST API (v3). Use it to list projects, search issues with JQL, get issue details, create/update issues, manage transitions, and add comments. Authentication (Basic Auth with email + API token) and instance URL are configured automatically.
+- \`connector_jira-api-key_request\`: The only way to call the Jira Cloud REST API (v3). Use it to list projects, search issues with JQL, get issue details, create/update issues, manage transitions, and add comments. Authentication (Basic Auth with email + API token) and instance URL are configured automatically.
 
 ### Business Logic
 
@@ -623,7 +707,7 @@ await jira.request("/rest/api/3/issue", {
 - Text search: summary ~ "keyword"`,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`jira-api-key_request\`: Jira Cloud REST API\uFF08v3\uFF09\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u306E\u53D6\u5F97\u3001JQL\u306B\u3088\u308B\u30A4\u30B7\u30E5\u30FC\u691C\u7D22\u3001\u30A4\u30B7\u30E5\u30FC\u8A73\u7D30\u306E\u53D6\u5F97\u3001\u30A4\u30B7\u30E5\u30FC\u306E\u4F5C\u6210\u30FB\u66F4\u65B0\u3001\u30C8\u30E9\u30F3\u30B8\u30B7\u30E7\u30F3\u7BA1\u7406\u3001\u30B3\u30E1\u30F3\u30C8\u8FFD\u52A0\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08Basic Auth: \u30E1\u30FC\u30EB + API\u30C8\u30FC\u30AF\u30F3\uFF09\u3068\u30A4\u30F3\u30B9\u30BF\u30F3\u30B9URL\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
+- \`connector_jira-api-key_request\`: Jira Cloud REST API\uFF08v3\uFF09\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u306E\u53D6\u5F97\u3001JQL\u306B\u3088\u308B\u30A4\u30B7\u30E5\u30FC\u691C\u7D22\u3001\u30A4\u30B7\u30E5\u30FC\u8A73\u7D30\u306E\u53D6\u5F97\u3001\u30A4\u30B7\u30E5\u30FC\u306E\u4F5C\u6210\u30FB\u66F4\u65B0\u3001\u30C8\u30E9\u30F3\u30B8\u30B7\u30E7\u30F3\u7BA1\u7406\u3001\u30B3\u30E1\u30F3\u30C8\u8FFD\u52A0\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08Basic Auth: \u30E1\u30FC\u30EB + API\u30C8\u30FC\u30AF\u30F3\uFF09\u3068\u30A4\u30F3\u30B9\u30BF\u30F3\u30B9URL\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
 
 ### Business Logic
 

package/dist/connectors/kintone-api-token.js

@@ -16,6 +16,7 @@ var init_parameter_definition = __esm({
       type;
       secret;
       required;
+      isDeprecated;
       constructor(config) {
         this.slug = config.slug;
         this.name = config.name;
@@ -24,6 +25,7 @@ var init_parameter_definition = __esm({
         this.type = config.type;
         this.secret = config.secret;
         this.required = config.required;
+        this.isDeprecated = config.isDeprecated ?? false;
       }
       /**
        * Get the parameter value from a ConnectorConnectionObject.
@@ -251,7 +253,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
   /**
    * Create tools for connections that belong to this connector.
    * Filters connections by connectorKey internally.
-   * Returns tools keyed as `${connectorKey}_${toolName}`.
+   * Returns tools keyed as `connector_${connectorKey}_${toolName}`.
    */
   createTools(connections, config, opts) {
     const myConnections = connections.filter(
@@ -261,7 +263,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
     for (const t of Object.values(this.tools)) {
       const tool = t.createTool(myConnections, config);
       const originalToModelOutput = tool.toModelOutput;
-      result[`${this.connectorKey}_${t.name}`] = {
+      result[`connector_${this.connectorKey}_${t.name}`] = {
         ...tool,
         toModelOutput: async (options) => {
           if (!originalToModelOutput) {
@@ -317,19 +319,34 @@ async function runSetupFlow(flow, params, ctx, config) {
   };
   let state = flow.initialState();
   let answerIdx = 0;
+  const pendingParameterUpdates = [];
   for (const step of flow.steps) {
     const ans = ctx.answers[answerIdx];
     if (ans && ans.questionSlug === step.slug) {
       state = step.applyAnswer(state, ans.answer);
+      if (step.toParameterUpdates) {
+        pendingParameterUpdates.push(...step.toParameterUpdates(state));
+      }
       answerIdx += 1;
       continue;
     }
+    const resolvedAllowFreeText = step.allowFreeText !== void 0 ? step.allowFreeText : true;
     if (step.type === "text") {
+      if (step.fetchOptions) {
+        const options2 = await step.fetchOptions(state, runtime);
+        if (options2.length === 0) {
+          continue;
+        }
+      }
       return {
         type: "nextQuestion",
         questionSlug: step.slug,
         question: step.question[ctx.language],
-        questionType: "text"
+        questionType: "text",
+        allowFreeText: resolvedAllowFreeText,
+        ...pendingParameterUpdates.length > 0 && {
+          parameterUpdates: pendingParameterUpdates
+        }
       };
     }
     const options = step.fetchOptions ? await step.fetchOptions(state, runtime) : [];
@@ -341,11 +358,21 @@ async function runSetupFlow(flow, params, ctx, config) {
       questionSlug: step.slug,
       question: step.question[ctx.language],
       questionType: step.type,
-      options
+      options,
+      allowFreeText: resolvedAllowFreeText,
+      ...pendingParameterUpdates.length > 0 && {
+        parameterUpdates: pendingParameterUpdates
+      }
     };
   }
   const dataInvestigationResult = await flow.finalize(state, runtime);
-  return { type: "fulfilled", dataInvestigationResult };
+  return {
+    type: "fulfilled",
+    dataInvestigationResult,
+    ...pendingParameterUpdates.length > 0 && {
+      parameterUpdates: pendingParameterUpdates
+    }
+  };
 }
 
 // ../connectors/src/auth-types.ts
@@ -363,14 +390,14 @@ var kintoneApiTokenOnboarding = new ConnectorOnboarding({
   dataOverviewInstructions: {
     en: `Each connection is scoped to a single kintone app (configured via the "app-id" parameter). The request tool auto-injects the configured app id, so you do NOT need to specify "app=" in paths or "app" in bodies. apps.json is NOT available with API Token auth.
 
-1. Call kintone-api-key_request with GET app.json to fetch the scoped app's metadata (name, description, creator)
-2. Call kintone-api-key_request with GET app/form/fields.json to get field definitions
-3. Call kintone-api-key_request with GET records.json with query=limit 5 to sample records`,
+1. Call connector_kintone-api-key_request with GET app.json to fetch the scoped app's metadata (name, description, creator)
+2. Call connector_kintone-api-key_request with GET app/form/fields.json to get field definitions
+3. Call connector_kintone-api-key_request with GET records.json with query=limit 5 to sample records`,
     ja: `\u5404\u63A5\u7D9A\u306F1\u3064\u306Ekintone\u30A2\u30D7\u30EA\u306B\u30B9\u30B3\u30FC\u30D7\u3055\u308C\u3066\u3044\u307E\u3059\uFF08"app-id" \u30D1\u30E9\u30E1\u30FC\u30BF\u3067\u8A2D\u5B9A\uFF09\u3002request \u30C4\u30FC\u30EB\u306F\u8A2D\u5B9A\u3055\u308C\u305F\u30A2\u30D7\u30EAID\u3092\u81EA\u52D5\u6CE8\u5165\u3059\u308B\u305F\u3081\u3001\u30D1\u30B9\u306B "app=" \u3084 body \u306B "app" \u3092\u6307\u5B9A\u3059\u308B\u5FC5\u8981\u306F\u3042\u308A\u307E\u305B\u3093\u3002API Token \u8A8D\u8A3C\u3067\u306F apps.json \u306F\u5229\u7528\u3067\u304D\u307E\u305B\u3093\u3002
 
-1. kintone-api-key_request \u3067 GET app.json \u3092\u547C\u3073\u51FA\u3057\u3001\u30B9\u30B3\u30FC\u30D7\u5BFE\u8C61\u30A2\u30D7\u30EA\u306E\u30E1\u30BF\u60C5\u5831\uFF08\u30A2\u30D7\u30EA\u540D\u3001\u8AAC\u660E\u3001\u4F5C\u6210\u8005\uFF09\u3092\u53D6\u5F97
-2. kintone-api-key_request \u3067 GET app/form/fields.json \u3092\u547C\u3073\u51FA\u3057\u3001\u30D5\u30A3\u30FC\u30EB\u30C9\u5B9A\u7FA9\u3092\u53D6\u5F97
-3. kintone-api-key_request \u3067 GET records.json \u3092 query=limit 5 \u3067\u547C\u3073\u51FA\u3057\u3001\u30EC\u30B3\u30FC\u30C9\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0`
+1. connector_kintone-api-key_request \u3067 GET app.json \u3092\u547C\u3073\u51FA\u3057\u3001\u30B9\u30B3\u30FC\u30D7\u5BFE\u8C61\u30A2\u30D7\u30EA\u306E\u30E1\u30BF\u60C5\u5831\uFF08\u30A2\u30D7\u30EA\u540D\u3001\u8AAC\u660E\u3001\u4F5C\u6210\u8005\uFF09\u3092\u53D6\u5F97
+2. connector_kintone-api-key_request \u3067 GET app/form/fields.json \u3092\u547C\u3073\u51FA\u3057\u3001\u30D5\u30A3\u30FC\u30EB\u30C9\u5B9A\u7FA9\u3092\u53D6\u5F97
+3. connector_kintone-api-key_request \u3067 GET records.json \u3092 query=limit 5 \u3067\u547C\u3073\u51FA\u3057\u3001\u30EC\u30B3\u30FC\u30C9\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0`
   }
 });
 
@@ -394,6 +421,7 @@ async function apiFetch(params, path2, init) {
 }
 
 // ../connectors/src/connectors/kintone-api-token/setup-flow.ts
+var SAMPLE_RECORD_LIMIT = 5;
 async function getAppMetadata(params, appId) {
   const res = await apiFetch(
     params,
@@ -420,15 +448,28 @@ async function getFormFields(params, appId) {
   }
   return await res.json();
 }
+async function getSampleRecords(params, appId) {
+  const res = await apiFetch(
+    params,
+    `records.json?app=${encodeURIComponent(appId)}&query=${encodeURIComponent(`limit ${SAMPLE_RECORD_LIMIT}`)}&totalCount=true`
+  );
+  if (!res.ok) return { records: [], totalCount: null };
+  return await res.json();
+}
+function formatRecordValue(val) {
+  if (val == null) return "";
+  if (typeof val === "string") return val.length > 50 ? `${val.slice(0, 50)}\u2026` : val;
+  if (Array.isArray(val)) return `[${val.length} items]`;
+  if (typeof val === "object") return JSON.stringify(val).slice(0, 50);
+  return String(val);
+}
 var kintoneApiTokenSetupFlow = {
   initialState: () => ({}),
   steps: [],
   async finalize(_state, rt) {
-    const appId = rt.params[parameters.appId.slug];
+    const appId = rt.params["app-id"];
     if (!appId) {
-      throw new Error(
-        "kintone-api-token setup: missing app-id parameter on finalize"
-      );
+      return "## kintone\n\n_App ID \u304C\u6307\u5B9A\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002_\n";
     }
     const sections = ["## kintone", ""];
     const app = await getAppMetadata(rt.params, appId);
@@ -438,15 +479,39 @@ var kintoneApiTokenSetupFlow = {
       sections.push(app.description, "");
     }
     const fields = await getFormFields(rt.params, appId);
+    const fieldEntries = Object.entries(fields.properties ?? {});
+    sections.push("#### Fields", "");
     sections.push("| Field code | Label | Type | Required |");
     sections.push("|------------|-------|------|----------|");
-    for (const [code, def] of Object.entries(fields.properties ?? {})) {
+    for (const [code, def] of fieldEntries) {
       const escapedLabel = (def.label ?? "").replace(/\|/g, "\\|");
       sections.push(
         `| ${code} | ${escapedLabel || "-"} | ${def.type} | ${def.required ? "yes" : "no"} |`
       );
     }
     sections.push("");
+    const sampleData = await getSampleRecords(rt.params, appId);
+    const totalCount = sampleData.totalCount ? Number(sampleData.totalCount) : null;
+    if (totalCount != null) {
+      sections.push(`#### Record count: ${totalCount.toLocaleString()}`, "");
+    }
+    const records = sampleData.records ?? [];
+    if (records.length > 0) {
+      const sampleFields = fieldEntries.slice(0, 8).map(([code]) => code);
+      if (sampleFields.length > 0) {
+        sections.push(`#### Sample records (${records.length})`, "");
+        sections.push(`| ${sampleFields.join(" | ")} |`);
+        sections.push(`| ${sampleFields.map(() => "---").join(" | ")} |`);
+        for (const record of records) {
+          const cells = sampleFields.map((code) => {
+            const cell = record[code];
+            return formatRecordValue(cell?.value).replace(/\|/g, "\\|");
+          });
+          sections.push(`| ${cells.join(" | ")} |`);
+        }
+        sections.push("");
+      }
+    }
     return sections.join("\n");
   }
 };
@@ -569,7 +634,7 @@ var kintoneApiTokenConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`kintone-api-key_request\`: The only way to call the kintone REST API. Use it to fetch app metadata/field definitions and read/write records. Authentication (API Token), base URL, and the connection's app id are configured automatically. Each connection is scoped to exactly one app (kintone API tokens are per-app).
+- \`connector_kintone-api-key_request\`: The only way to call the kintone REST API. Use it to fetch app metadata/field definitions and read/write records. Authentication (API Token), base URL, and the connection's app id are configured automatically. Each connection is scoped to exactly one app (kintone API tokens are per-app).
 
 ### App scoping (important)
 
@@ -642,7 +707,7 @@ export default async function handler(c: Context) {
 - String: \`like "partial match"\``,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`kintone-api-key_request\`: kintone REST API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30A2\u30D7\u30EA\u306E\u30E1\u30BF\u60C5\u5831\u30FB\u30D5\u30A3\u30FC\u30EB\u30C9\u5B9A\u7FA9\u306E\u53D6\u5F97\u3001\u30EC\u30B3\u30FC\u30C9\u306E\u8AAD\u307F\u66F8\u304D\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08API\u30C8\u30FC\u30AF\u30F3\uFF09\u3001\u30D9\u30FC\u30B9URL\u3001\u304A\u3088\u3073\u63A5\u7D9A\u306E\u30A2\u30D7\u30EAID\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002\u5404\u63A5\u7D9A\u306F\u3061\u3087\u3046\u30691\u3064\u306E\u30A2\u30D7\u30EA\u306B\u30B9\u30B3\u30FC\u30D7\u3055\u308C\u3066\u3044\u307E\u3059\uFF08kintone API\u30C8\u30FC\u30AF\u30F3\u306F\u30A2\u30D7\u30EA\u5358\u4F4D\u306E\u305F\u3081\uFF09\u3002
+- \`connector_kintone-api-key_request\`: kintone REST API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30A2\u30D7\u30EA\u306E\u30E1\u30BF\u60C5\u5831\u30FB\u30D5\u30A3\u30FC\u30EB\u30C9\u5B9A\u7FA9\u306E\u53D6\u5F97\u3001\u30EC\u30B3\u30FC\u30C9\u306E\u8AAD\u307F\u66F8\u304D\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08API\u30C8\u30FC\u30AF\u30F3\uFF09\u3001\u30D9\u30FC\u30B9URL\u3001\u304A\u3088\u3073\u63A5\u7D9A\u306E\u30A2\u30D7\u30EAID\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002\u5404\u63A5\u7D9A\u306F\u3061\u3087\u3046\u30691\u3064\u306E\u30A2\u30D7\u30EA\u306B\u30B9\u30B3\u30FC\u30D7\u3055\u308C\u3066\u3044\u307E\u3059\uFF08kintone API\u30C8\u30FC\u30AF\u30F3\u306F\u30A2\u30D7\u30EA\u5358\u4F4D\u306E\u305F\u3081\uFF09\u3002
 
 ### \u30A2\u30D7\u30EA\u30B9\u30B3\u30FC\u30D7\uFF08\u91CD\u8981\uFF09
 
@@ -720,14 +785,15 @@ export default async function handler(c: Context) {
     const baseUrl = params[parameters.baseUrl.slug];
     const apiToken = params[parameters.apiToken.slug];
     const appId = params[parameters.appId.slug];
-    if (!baseUrl || !apiToken || !appId) {
+    if (!baseUrl || !apiToken) {
       return {
         success: false,
-        error: `Missing required parameters: ${parameters.baseUrl.slug}, ${parameters.apiToken.slug}, and ${parameters.appId.slug}`
+        error: `Missing required parameters: ${parameters.baseUrl.slug}, ${parameters.apiToken.slug}`
       };
     }
     try {
-      const url = `${baseUrl.replace(/\/+$/, "")}/k/v1/app.json?id=${encodeURIComponent(appId)}`;
+      const path2 = appId ? `app.json?id=${encodeURIComponent(appId)}` : `app/form/fields.json?app=0`;
+      const url = `${baseUrl.replace(/\/+$/, "")}/k/v1/${path2}`;
       const res = await fetch(url, {
         method: "GET",
         headers: {
@@ -735,6 +801,15 @@ export default async function handler(c: Context) {
           Accept: "application/json"
         }
       });
+      if (!appId) {
+        if (res.status === 401 || res.status === 403) {
+          return {
+            success: false,
+            error: "kintone API failed: invalid API token"
+          };
+        }
+        return { success: true };
+      }
       if (!res.ok) {
         const data = await res.json().catch(() => null);
         const message = data?.message ?? `HTTP ${res.status} ${res.statusText}`;

package/dist/connectors/kintone.js

@@ -16,6 +16,7 @@ var init_parameter_definition = __esm({
       type;
       secret;
       required;
+      isDeprecated;
       constructor(config) {
         this.slug = config.slug;
         this.name = config.name;
@@ -24,6 +25,7 @@ var init_parameter_definition = __esm({
         this.type = config.type;
         this.secret = config.secret;
         this.required = config.required;
+        this.isDeprecated = config.isDeprecated ?? false;
       }
       /**
        * Get the parameter value from a ConnectorConnectionObject.
@@ -260,7 +262,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
   /**
    * Create tools for connections that belong to this connector.
    * Filters connections by connectorKey internally.
-   * Returns tools keyed as `${connectorKey}_${toolName}`.
+   * Returns tools keyed as `connector_${connectorKey}_${toolName}`.
    */
   createTools(connections, config, opts) {
     const myConnections = connections.filter(
@@ -270,7 +272,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
     for (const t of Object.values(this.tools)) {
       const tool = t.createTool(myConnections, config);
       const originalToModelOutput = tool.toModelOutput;
-      result[`${this.connectorKey}_${t.name}`] = {
+      result[`connector_${this.connectorKey}_${t.name}`] = {
         ...tool,
         toModelOutput: async (options) => {
           if (!originalToModelOutput) {
@@ -326,19 +328,34 @@ async function runSetupFlow(flow, params, ctx, config) {
   };
   let state = flow.initialState();
   let answerIdx = 0;
+  const pendingParameterUpdates = [];
   for (const step of flow.steps) {
     const ans = ctx.answers[answerIdx];
     if (ans && ans.questionSlug === step.slug) {
       state = step.applyAnswer(state, ans.answer);
+      if (step.toParameterUpdates) {
+        pendingParameterUpdates.push(...step.toParameterUpdates(state));
+      }
       answerIdx += 1;
       continue;
     }
+    const resolvedAllowFreeText = step.allowFreeText !== void 0 ? step.allowFreeText : true;
     if (step.type === "text") {
+      if (step.fetchOptions) {
+        const options2 = await step.fetchOptions(state, runtime);
+        if (options2.length === 0) {
+          continue;
+        }
+      }
       return {
         type: "nextQuestion",
         questionSlug: step.slug,
         question: step.question[ctx.language],
-        questionType: "text"
+        questionType: "text",
+        allowFreeText: resolvedAllowFreeText,
+        ...pendingParameterUpdates.length > 0 && {
+          parameterUpdates: pendingParameterUpdates
+        }
       };
     }
     const options = step.fetchOptions ? await step.fetchOptions(state, runtime) : [];
@@ -350,11 +367,21 @@ async function runSetupFlow(flow, params, ctx, config) {
       questionSlug: step.slug,
       question: step.question[ctx.language],
       questionType: step.type,
-      options
+      options,
+      allowFreeText: resolvedAllowFreeText,
+      ...pendingParameterUpdates.length > 0 && {
+        parameterUpdates: pendingParameterUpdates
+      }
     };
   }
   const dataInvestigationResult = await flow.finalize(state, runtime);
-  return { type: "fulfilled", dataInvestigationResult };
+  return {
+    type: "fulfilled",
+    dataInvestigationResult,
+    ...pendingParameterUpdates.length > 0 && {
+      parameterUpdates: pendingParameterUpdates
+    }
+  };
 }
 async function resolveSetupSelection(params) {
   const { selected, allSentinel, fetchAll, limit } = params;
@@ -375,12 +402,12 @@ var AUTH_TYPES = {
 // ../connectors/src/connectors/kintone/setup.ts
 var kintoneOnboarding = new ConnectorOnboarding({
   dataOverviewInstructions: {
-    en: `1. Call kintone_request with GET apps.json to list available apps
-2. For key apps, call kintone_request with GET app/form/fields.json?app={appId} to get field definitions
-3. Call kintone_request with GET records.json?app={appId}&query=limit 5 to sample records`,
-    ja: `1. kintone_request \u3067 GET apps.json \u3092\u547C\u3073\u51FA\u3057\u3001\u5229\u7528\u53EF\u80FD\u306A\u30A2\u30D7\u30EA\u4E00\u89A7\u3092\u53D6\u5F97
-2. \u4E3B\u8981\u30A2\u30D7\u30EA\u306B\u3064\u3044\u3066 kintone_request \u3067 GET app/form/fields.json?app={appId} \u3092\u547C\u3073\u51FA\u3057\u3001\u30D5\u30A3\u30FC\u30EB\u30C9\u5B9A\u7FA9\u3092\u53D6\u5F97
-3. kintone_request \u3067 GET records.json?app={appId}&query=limit 5 \u3092\u547C\u3073\u51FA\u3057\u3001\u30EC\u30B3\u30FC\u30C9\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0`
+    en: `1. Call connector_kintone_request with GET apps.json to list available apps
+2. For key apps, call connector_kintone_request with GET app/form/fields.json?app={appId} to get field definitions
+3. Call connector_kintone_request with GET records.json?app={appId}&query=limit 5 to sample records`,
+    ja: `1. connector_kintone_request \u3067 GET apps.json \u3092\u547C\u3073\u51FA\u3057\u3001\u5229\u7528\u53EF\u80FD\u306A\u30A2\u30D7\u30EA\u4E00\u89A7\u3092\u53D6\u5F97
+2. \u4E3B\u8981\u30A2\u30D7\u30EA\u306B\u3064\u3044\u3066 connector_kintone_request \u3067 GET app/form/fields.json?app={appId} \u3092\u547C\u3073\u51FA\u3057\u3001\u30D5\u30A3\u30FC\u30EB\u30C9\u5B9A\u7FA9\u3092\u53D6\u5F97
+3. connector_kintone_request \u3067 GET records.json?app={appId}&query=limit 5 \u3092\u547C\u3073\u51FA\u3057\u3001\u30EC\u30B3\u30FC\u30C9\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0`
   }
 });
 
@@ -408,6 +435,7 @@ async function apiFetch(params, path2, init) {
 // ../connectors/src/connectors/kintone/setup-flow.ts
 var ALL_APPS = "__ALL_APPS__";
 var KINTONE_SETUP_MAX_APPS = 20;
+var SAMPLE_RECORD_LIMIT = 5;
 async function listApps(params) {
   const results = [];
   let offset = 0;
@@ -441,6 +469,25 @@ async function getFormFields(params, appId) {
   }
   return await res.json();
 }
+async function getSampleRecords(params, appId) {
+  try {
+    const res = await apiFetch(
+      params,
+      `records.json?app=${encodeURIComponent(appId)}&query=${encodeURIComponent(`limit ${SAMPLE_RECORD_LIMIT}`)}&totalCount=true`
+    );
+    if (!res.ok) return { records: [], totalCount: null };
+    return await res.json();
+  } catch {
+    return { records: [], totalCount: null };
+  }
+}
+function formatRecordValue(val) {
+  if (val == null) return "";
+  if (typeof val === "string") return val.length > 50 ? `${val.slice(0, 50)}\u2026` : val;
+  if (Array.isArray(val)) return `[${val.length} items]`;
+  if (typeof val === "object") return JSON.stringify(val).slice(0, 50);
+  return String(val);
+}
 var kintoneSetupFlow = {
   initialState: () => ({}),
   steps: [
@@ -486,15 +533,38 @@ var kintoneSetupFlow = {
         sections.push(app.description, "");
       }
       const fields = await getFormFields(rt.params, appId);
+      const fieldEntries = Object.entries(fields.properties ?? {});
       sections.push("| Field code | Label | Type | Required |");
       sections.push("|------------|-------|------|----------|");
-      for (const [code, def] of Object.entries(fields.properties ?? {})) {
+      for (const [code, def] of fieldEntries) {
         const escapedLabel = (def.label ?? "").replace(/\|/g, "\\|");
         sections.push(
           `| ${code} | ${escapedLabel || "-"} | ${def.type} | ${def.required ? "yes" : "no"} |`
         );
       }
       sections.push("");
+      const sampleData = await getSampleRecords(rt.params, appId);
+      const totalCount = sampleData.totalCount ? Number(sampleData.totalCount) : null;
+      if (totalCount != null) {
+        sections.push(`#### Record count: ${totalCount.toLocaleString()}`, "");
+      }
+      const records = sampleData.records ?? [];
+      if (records.length > 0) {
+        const sampleFields = fieldEntries.slice(0, 8).map(([code]) => code);
+        if (sampleFields.length > 0) {
+          sections.push(`#### Sample records (${records.length})`, "");
+          sections.push(`| ${sampleFields.join(" | ")} |`);
+          sections.push(`| ${sampleFields.map(() => "---").join(" | ")} |`);
+          for (const record of records) {
+            const cells = sampleFields.map((code) => {
+              const cell = record[code];
+              return formatRecordValue(cell?.value).replace(/\|/g, "\\|");
+            });
+            sections.push(`| ${cells.join(" | ")} |`);
+          }
+          sections.push("");
+        }
+      }
     }
     return sections.join("\n");
   }
@@ -587,7 +657,7 @@ var kintoneConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`kintone_request\`: The only way to call the kintone REST API. Use it to list apps, fetch field definitions, and read/write records. The base URL (e.g., \`https://example.cybozu.com\`) is automatically resolved. See the kintone REST API Reference below for endpoints and the kintone query syntax.
+- \`connector_kintone_request\`: The only way to call the kintone REST API. Use it to list apps, fetch field definitions, and read/write records. The base URL (e.g., \`https://example.cybozu.com\`) is automatically resolved. See the kintone REST API Reference below for endpoints and the kintone query syntax.
 
 ### Business Logic
 
@@ -654,7 +724,7 @@ export default async function handler(c: Context) {
 - String: \`like "partial match"\``,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`kintone_request\`: kintone REST API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30A2\u30D7\u30EA\u4E00\u89A7\u306E\u53D6\u5F97\u3001\u30D5\u30A3\u30FC\u30EB\u30C9\u5B9A\u7FA9\u306E\u53D6\u5F97\u3001\u30EC\u30B3\u30FC\u30C9\u306E\u8AAD\u307F\u66F8\u304D\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u30D9\u30FC\u30B9URL\uFF08\u4F8B: \`https://example.cybozu.com\`\uFF09\u306F\u81EA\u52D5\u7684\u306B\u89E3\u6C7A\u3055\u308C\u307E\u3059\u3002\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u304A\u3088\u3073kintone\u30AF\u30A8\u30EA\u69CB\u6587\u306F\u4E0B\u90E8\u306E\u300Ckintone REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9\u300D\u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+- \`connector_kintone_request\`: kintone REST API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30A2\u30D7\u30EA\u4E00\u89A7\u306E\u53D6\u5F97\u3001\u30D5\u30A3\u30FC\u30EB\u30C9\u5B9A\u7FA9\u306E\u53D6\u5F97\u3001\u30EC\u30B3\u30FC\u30C9\u306E\u8AAD\u307F\u66F8\u304D\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u30D9\u30FC\u30B9URL\uFF08\u4F8B: \`https://example.cybozu.com\`\uFF09\u306F\u81EA\u52D5\u7684\u306B\u89E3\u6C7A\u3055\u308C\u307E\u3059\u3002\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u304A\u3088\u3073kintone\u30AF\u30A8\u30EA\u69CB\u6587\u306F\u4E0B\u90E8\u306E\u300Ckintone REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9\u300D\u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002
 
 ### Business Logic