@jinshuju/mcp 0.0.0-stage → 0.2.0

package/dist/config.js

@@ -0,0 +1,44 @@
+export const DEFAULTS = {
+    apiBaseUrl: 'https://jinshuju.net/api/v1',
+    authServer: 'https://account.jinshuju.net',
+    publicUrls: [],
+    maxResultChars: 120_000,
+    tokenCacheTtlMs: 5 * 60_000,
+    timeoutMs: 60_000,
+    posthogHost: 'https://us.i.posthog.com',
+    collectIntent: true
+};
+function int(value, fallback) {
+    const n = Number(value);
+    return Number.isFinite(n) && n > 0 ? n : fallback;
+}
+function bool(value, fallback) {
+    const v = (value ?? '').trim().toLowerCase();
+    if (['1', 'true', 'yes', 'on'].includes(v))
+        return true;
+    if (['0', 'false', 'no', 'off'].includes(v))
+        return false;
+    return fallback;
+}
+/** JINSHUJU_MCP_PUBLIC_URL: several comma-separated addresses, with trailing slashes and empty items removed. */
+export function publicUrlsFromEnv(value) {
+    return (value ?? '')
+        .split(',')
+        .map((u) => u.trim().replace(/\/$/, ''))
+        .filter(Boolean);
+}
+/** Reads the configuration from environment variables; keys carry the JINSHUJU_ prefix, as in @jinshuju/cli. */
+export function configFromEnv(env = process.env) {
+    return {
+        apiBaseUrl: (env.JINSHUJU_API_BASE_URL ?? DEFAULTS.apiBaseUrl).replace(/\/$/, ''),
+        authServer: (env.JINSHUJU_AUTH_HOST ?? DEFAULTS.authServer).replace(/\/$/, ''),
+        publicUrls: publicUrlsFromEnv(env.JINSHUJU_MCP_PUBLIC_URL),
+        maxResultChars: int(env.JINSHUJU_MCP_MAX_RESULT_CHARS, DEFAULTS.maxResultChars),
+        tokenCacheTtlMs: int(env.JINSHUJU_MCP_TOKEN_CACHE_TTL_MS, DEFAULTS.tokenCacheTtlMs),
+        timeoutMs: int(env.JINSHUJU_MCP_TIMEOUT_MS, DEFAULTS.timeoutMs),
+        posthogApiKey: env.POSTHOG_API_KEY?.trim() || undefined,
+        posthogHost: (env.POSTHOG_HOST?.trim() || DEFAULTS.posthogHost).replace(/\/$/, ''),
+        collectIntent: bool(env.JINSHUJU_MCP_COLLECT_INTENT, DEFAULTS.collectIntent)
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/credential.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The credential source interface and its simplest implementation.
+ *
+ * HTTP mode: every request brings its own Bearer, and the credential is that string (StaticCredential).
+ * The local credential for stdio mode (~/.jinshuju/config.json, with refresh) lives in cli-credential.ts,
+ * which depends on node:fs; this file uses no Node API, so the Worker bundle pulls in no node: modules.
+ */
+export interface Credential {
+    /** The access token currently usable */
+    token(): Promise<string>;
+    /** The API answered 401: drop the cache / try to renew. Returns true when a new credential was obtained and one retry is worthwhile. */
+    invalidate(): Promise<boolean>;
+    /** For descriptions such as auth status */
+    describe(): string;
+}
+export declare class StaticCredential implements Credential {
+    private readonly value;
+    private readonly source;
+    constructor(value: string, source?: string);
+    token(): Promise<string>;
+    invalidate(): Promise<boolean>;
+    describe(): string;
+}
+export declare class MissingCredentialError extends Error {
+    constructor();
+}

package/dist/credential.js

@@ -0,0 +1,32 @@
+/**
+ * The credential source interface and its simplest implementation.
+ *
+ * HTTP mode: every request brings its own Bearer, and the credential is that string (StaticCredential).
+ * The local credential for stdio mode (~/.jinshuju/config.json, with refresh) lives in cli-credential.ts,
+ * which depends on node:fs; this file uses no Node API, so the Worker bundle pulls in no node: modules.
+ */
+export class StaticCredential {
+    value;
+    source;
+    constructor(value, source = 'bearer') {
+        this.value = value;
+        this.source = source;
+    }
+    async token() {
+        return this.value;
+    }
+    async invalidate() {
+        return false;
+    }
+    describe() {
+        return `access token (${this.source})`;
+    }
+}
+export class MissingCredentialError extends Error {
+    constructor() {
+        super('No Jinshuju credential available. Set JINSHUJU_ACCESS_TOKEN=<personal or account access token>, ' +
+            'or log in first with `npx @jinshuju/cli auth login` (this server reuses ~/.jinshuju/config.json).');
+        this.name = 'MissingCredentialError';
+    }
+}
+//# sourceMappingURL=credential.js.map

package/dist/generated/meta.json

@@ -0,0 +1,113 @@
+{
+    "generatedFrom": {
+        "title": "Jinshuju API v1",
+        "version": "1.0",
+        "sha256": "54912d2240cc55de"
+    },
+    "baseUrl": "https://jinshuju.net/api/v1",
+    "toolCount": 60,
+    "operationCount": 123,
+    "tools": {
+        "list_forms": "listForms",
+        "get_form": "getForm",
+        "create_form": "createForm",
+        "edit_form": "updateForm",
+        "copy_form": "copyForm",
+        "move_form": "moveFormToFolder",
+        "list_form_cooperators": "listFormCooperators",
+        "get_field_rules": "listFieldRules",
+        "check_field_data": "checkFormFieldData",
+        "preview_field_type_change": "previewFormFieldTypeChange",
+        "edit_theme": "updateFormTheme",
+        "list_entries": "listEntries",
+        "get_entry": "getEntry",
+        "create_entry": "createEntry",
+        "update_entry": "updateEntry",
+        "delete_entry": "deleteEntry",
+        "create_entries": "createEntriesBatch",
+        "patch_entries": "patchEntriesBatch",
+        "aggregate_entries": "aggregateEntries",
+        "get_form_data_summary": "summarizeEntries",
+        "search_entries_in_forms": "searchEntriesAcrossForms",
+        "list_form_entry_stats": "getEntryStats",
+        "list_my_submitted_forms": "listMyFilledForms",
+        "list_my_submitted_entries": "listMySubmittedEntries",
+        "search_my_submitted_entries": "searchMySubmittedEntries",
+        "import_entries_from_file": "createEntryImport",
+        "list_entry_comments": "listEntryComments",
+        "create_entry_comment": "createEntryComment",
+        "update_entry_comment": "updateEntryComment",
+        "delete_entry_comment": "deleteEntryComment",
+        "list_form_views": "listFormViews",
+        "get_form_view": "getFormView",
+        "create_form_view": "createFormView",
+        "edit_form_view": "updateFormView",
+        "delete_form_view": "deleteFormView",
+        "list_form_view_entries": "listFormViewEntries",
+        "list_tables": "listTables",
+        "get_table": "getTable",
+        "create_table": "createTable",
+        "edit_table": "updateTable",
+        "move_table": "moveTableToFolder",
+        "list_opensearch_queries": "listOpensearchQueries",
+        "get_opensearch_query": "getOpensearchQuery",
+        "create_opensearch_query": "createOpensearchQuery",
+        "edit_opensearch_query": "updateOpensearchQuery",
+        "get_opensearch_field_suggestions": "listOpensearchQuerySuggestions",
+        "list_folders": "listFolders",
+        "create_folder": "createFolder",
+        "get_current_user": "getCurrentUser",
+        "get_current_billing_account": "getBillingAccount",
+        "list_account_users": "listBillingAccountUsers",
+        "upload_entry_attachment": "uploadEntryAttachment",
+        "upload_form_image": "uploadFormImage",
+        "upload_import_file": "uploadImportFile",
+        "edit_field_rules": "updateForm",
+        "create_exam_form": "createForm+updateExamSetting",
+        "edit_exam_form": "updateForm+updateExamSetting",
+        "create_evaluation_form": "createForm+updateEvaluationSetting",
+        "edit_evaluation_form": "updateForm+updateEvaluationSetting",
+        "count_entries": "countEntries+countEntriesAcrossForms"
+    },
+    "pointerSchemas": [
+        "BillingAccount",
+        "EntryData",
+        "EvaluationSetting",
+        "EvaluationSettingInput",
+        "FieldDefinition",
+        "FieldInput",
+        "FieldUpdateInput",
+        "FormSetting",
+        "FormSettingInput",
+        "FormSettingWriteInput",
+        "FormTheme",
+        "FormView",
+        "FormViewInput",
+        "GoodsItemInput",
+        "OpensearchQuery",
+        "OpensearchQueryInput",
+        "ThemeInput",
+        "TradeMerchant"
+    ],
+    "omitSchemas": [
+        "FormCreateConstraints"
+    ],
+    "tags": {
+        "Forms": "Forms: list, structure, create and edit, plus field display rules, cooperators, copy, move and other related operations.",
+        "Form Settings": "Form settings: submission settings, access policy, Webhook, theme, closing rules, exam / evaluation scene settings.",
+        "Entries": "Form entries: list, query, create, update, delete and batch operations.",
+        "Tables": "Tables (kind=table): structure and entries; field types are limited to the column types tables support.",
+        "Views": "Form / table views (view filters, sort, column configuration) and reading entries through a view.",
+        "Comments": "Entry comments.",
+        "Fill": "Fill links: read the fill page (`/f/`, `/v/`) as a submitter and submit entries through it.",
+        "OpenSearch": "Public queries.",
+        "Folders": "Folders.",
+        "Predefined Choices Sets": "Predefined choice sets.",
+        "Templates": "Using templates.",
+        "Contacts": "Contacts.",
+        "Account": "Current user and account: members, e-invoices, payment history, SMS signature review status.",
+        "Trade": "小金商户: merchant and onboarding progress, payment orders, transaction statistics, refunds and payouts.",
+        "Uploads": "Uploading attachments, form images and import files.",
+        "Utilities": "Utility endpoints."
+    }
+}