@yijiancaotang/cli 0.0.0-stage → 1.1.0

package/dist/commands.js

@@ -0,0 +1,356 @@
+import { verifiedFileFailure } from "./create-file-failure.js";
+import { CliError, expectOK, expectProjectTextOK, expectKnowledgeChangeNotBlocked, checkApplicationReceipt, asRecord, unverifiedSwitchError, directPublicWriteError } from "./errors.js";
+import { executeUpload } from "./upload.js";
+import { readContext } from "./context.js";
+import { requestPendingAction } from "./pending-requests.js";
+import { commandAcceptsSwitch, expectCapabilityResult } from "./capability-result.js";
+import { dateFlags, validateDateFlags, expectQueryOK, isPagedQueryPath, isProjectIDParameterError } from "./query-validation.js";
+import { expectSearchOK, validateSearch } from "./query-search.js";
+import { expectDailyOK, validateDailyDates } from "./query-daily.js";
+import { createText, createHTTPURL, validateCreateSources, isCreatePath, expectCreateOK, expectKnowledgeTextOK } from "./create-bundle.js";
+import { withKnowledgeGrowth } from "./knowledge-growth.js";
+import { readHabit } from "./habit-read.js";
+import { citationOrigin, webCitations } from "./web-citations.js";
+import { KNOWLEDGE_GROWTH_STEPS, knowledgeGrowthMetadata } from "./generated/knowledge-growth.js";
+import { inputDetails, invalidInput, validateInput, validateCommandArguments } from "./input-validation.js";
+import { executeSchedule } from "./schedule.js";
+import { executeCalendar } from "./calendar.js";
+const root = "/api/v1/agent";
+// Go limits display text by Unicode code points, not UTF-16 code units.
+const runeLength = (value) => [...value].length;
+const text = (min = 0, max = Infinity) => value => typeof value === "string" && runeLength(value) >= min && runeLength(value) <= max;
+const oneOf = (...values) => value => typeof value === "string" && values.includes(value);
+const stageText = value => typeof value === "string" && value.trim().length > 0 && runeLength(value) <= 30;
+const stages = value => Array.isArray(value) && value.length >= 1 && value.length <= 8 && value.every(stageText);
+const url = value => {
+    if (typeof value !== "string")
+        return false;
+    try {
+        new URL(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const visibility = oneOf("private");
+const projectStatus = oneOf("draft", "active", "paused", "archived", "hidden");
+const sourceType = oneOf("knowledge_card", "project", "project_update", "checkin", "discussion_post", "discussion_reply", "collaboration_application", "external_url", "file");
+const knowledgeSourceTypes = ["manual", "douyin", "xiaohongshu", "forum", "book", "publisher_preview", "expert", "agent", "web"];
+const knowledgeSourceHelp = "source_type 可选：manual、douyin、xiaohongshu、forum、book、publisher_preview、expert、agent、web；请按实际来源选择，不补默认值。";
+const knowledgeRequiredFields = ["title", "intent", "summary", "source_type"];
+const schemas = {
+    project: {
+        fields: { title: createText(2, 80), summary: createText(0, 280), stage: createText(0, 30), stages: value => Array.isArray(value) && value.length <= 8 && value.every(createText(0, 30)), cognition_summary: createText(0, 1000), visibility, status: projectStatus },
+        required: ["title", "summary"]
+    },
+    projectUpdate: { fields: { title: text(2, 80), summary: text(0, 280) }, trimText: true },
+    progress: { fields: { body: text(2, 360), update_type: oneOf("progress", "knowledge_applied", "cognition", "stage"), visibility }, required: ["body"] },
+    cognition: { fields: { cognition_summary: text(0, 1000) }, required: ["cognition_summary"] },
+    stages: { fields: { stage: stageText, stages, status: oneOf("draft", "active", "paused") } },
+    knowledge: {
+        fields: { title: createText(2, 160), intent: createText(2, 500), summary: createText(1, 4000), source_type: oneOf(...knowledgeSourceTypes), source_label: createText(0, 300), topic: createText(0, 120), linked_project_id: text(), origin_url: createHTTPURL, visibility, publication_status: oneOf("draft", "published"), sources: value => validateCreateSources(value, schemas.source.fields) },
+        required: knowledgeRequiredFields
+    },
+    knowledgeUpdate: { fields: { title: text(2, 160), intent: text(2, 500), summary: text(1, 4000), topic: text(0, 120) } },
+    source: {
+        fields: { evidence_type: oneOf("source", "summary", "project_link", "application", "review", "template"), source_type: sourceType, source_id: text(), source_url: url, source_title: text(0, 300), excerpt: text(0, 2000), file_key: text(0, 500), summary: text(0, 1200) },
+        required: ["source_type"]
+    },
+    advance: { fields: { internalization_status: value => knowledgeGrowthMetadata(value) !== undefined, evidence_summary: text(0, 1200), source_type: sourceType, source_id: text() }, required: ["internalization_status"] }
+};
+function invalid() {
+    throw new CliError("invalid_arguments", "命令或参数无效。", "请检查命令帮助；写入JSON请使用 --input 文件路径 或 --input -。");
+}
+function allowedFlags(flags, allowed) {
+    if (Object.entries(flags).some(([name, value]) => value !== undefined && !allowed.includes(name)))
+        invalid();
+}
+function id(value) {
+    if (typeof value !== "string" || !value.trim() || value === "." || value === ".." || /[\x00-\x1f\x7f]/.test(value))
+        invalid();
+    try {
+        return encodeURIComponent(value);
+    }
+    catch {
+        return invalid();
+    }
+}
+const queryNames = { limit: "limit", offset: "offset", "core-only": "core_only", q: "q", project: "project_id", topic: "topic", status: "status", "publication-status": "publication_status", since: "since", filter: "filter", "start-date": "start_date", "end-date": "end_date", "date-field": "date_field" };
+const knowledgeFilters = ["limit", "offset", "core-only", "q", "project", "topic", "status", "publication-status", ...dateFlags];
+function validateKnowledgeStatus(flags) {
+    if (flags.status === undefined)
+        return;
+    if (!knowledgeGrowthMetadata(flags.status)) {
+        throw new CliError("invalid_arguments", "知识长势筛选值无效。", "--status 请使用 allowed_values 中的机器枚举，中文名称、说明和级数一并列出；不筛选时省略 --status，草稿筛选请用 --publication-status draft。", 2, { allowed_values: KNOWLEDGE_GROWTH_STEPS.map(step => ({ value: step.value, ...knowledgeGrowthMetadata(step.value) })) });
+    }
+}
+function query(path, flags, maxLimit) {
+    validateDateFlags(flags, path.endsWith("/updates") || path.endsWith("/checkins"));
+    const params = new URLSearchParams();
+    for (const [flag, name] of Object.entries(queryNames)) {
+        const value = flags[flag];
+        if (value === undefined)
+            continue;
+        if (flag === "core-only") {
+            if (typeof value !== "boolean")
+                invalid();
+            params.set(name, String(value));
+            continue;
+        }
+        if (flag === "limit" || flag === "offset") {
+            const minimum = flag === "limit" ? 1 : 0;
+            const maximum = flag === "limit" ? maxLimit : Number.MAX_SAFE_INTEGER;
+            if (typeof value !== "string" || !/^\d+$/.test(value) || !Number.isSafeInteger(Number(value)) || Number(value) < minimum || Number(value) > maximum) {
+                const message = flag === "limit" ? "--limit 参数无效。" : "--offset 参数无效。";
+                const nextAction = flag === "offset" ? "--offset 必须是 0 至 9007199254740991 的整数。"
+                    : maxLimit === 50 ? "--limit 必须是 1 至 50 的整数。" : "--limit 必须是 1 至 100 的整数。";
+                throw new CliError("invalid_arguments", message, nextAction);
+            }
+        }
+        if (typeof value !== "string")
+            invalid();
+        if ((flag === "q" && !path.endsWith("/m1/search") && runeLength(value) > 200) || (flag === "since" && (!value || value.length > 4096)))
+            invalid();
+        if (flag === "publication-status" && !["published", "draft", "all"].includes(value))
+            invalid();
+        params.set(name, value);
+    }
+    const suffix = params.toString();
+    return suffix ? `${path}?${suffix}` : path;
+}
+async function readCommandInput(flags, ctx, command) {
+    if (flags.input === undefined)
+        throw invalidInput(command, { missing: ["--input"] });
+    if (typeof flags.input !== "string" || !flags.input.trim())
+        throw invalidInput(command, { invalid: ["--input"] });
+    try {
+        return await ctx.readInput(flags.input);
+    }
+    catch (error) {
+        if (error instanceof CliError && error.code === "invalid_input") {
+            Object.assign(error.details, inputDetails(command, { invalid: ["$input"] }));
+            throw error;
+        }
+        throw error;
+    }
+}
+async function inputBody(flags, ctx, schema, command) {
+    const body = asRecord(await readCommandInput(flags, ctx, command));
+    if (body?.visibility === "public" && [schemas.knowledge, schemas.project, schemas.progress].includes(schema)) {
+        const error = directPublicWriteError(true);
+        Object.assign(error.details, inputDetails(command, { invalid: ["visibility"] }));
+        throw error;
+    }
+    let normalized;
+    const sourceField = schema === schemas.source && body && schemas.source.fields.source_type(body.source_type)
+        ? body.source_type === "external_url" ? "source_url" : body.source_type === "file" ? "file_key" : "source_id" : undefined;
+    try {
+        normalized = validateInput(body, sourceField ? { ...schema, required: [...schema.required ?? [], sourceField] } : schema, command);
+    }
+    catch (error) {
+        if (error instanceof CliError && schema === schemas.knowledge && Array.isArray(body?.sources)
+            && body.sources.some(entry => { const source = asRecord(entry); return source && Object.keys(source).some(key => !Object.hasOwn(schemas.source.fields, key)); })) {
+            error.details.unknown_fields = ["<unknown_field>"];
+        }
+        if (error instanceof CliError && body && schema === schemas.knowledge) {
+            const missing = knowledgeRequiredFields.filter(field => !Object.hasOwn(body, field));
+            if (missing.length)
+                throw new CliError("invalid_arguments", `缺少必填字段：${missing.join("、")}。`, missing.includes("source_type") ? knowledgeSourceHelp : "请在 --input 的 JSON 中补齐 missing_fields 列出的所有字段；只提交本人确认的内容。", 2, error.details);
+            if (!schema.fields.source_type(body.source_type))
+                throw new CliError("invalid_arguments", "source_type 参数无效。", knowledgeSourceHelp, 2, error.details);
+        }
+        throw error;
+    }
+    // Creation knows the intended status; PATCH deliberately leaves the current
+    // stored status check on the server without adding a read-permission dependency.
+    if (schema === schemas.project && body?.status !== "draft" && !createText(1, 280)(body?.summary)) {
+        throw invalidInput(command, { invalid: ["summary"] });
+    }
+    if (sourceField && !(sourceField === "source_url" ? createHTTPURL(normalized[sourceField]) : createText(1, Infinity)(normalized[sourceField]))) {
+        throw invalidInput(command, { invalid: [sourceField] });
+    }
+    return normalized;
+}
+async function dispatch(p, flags, ctx) {
+    const request = async (path, options = {}) => {
+        const raw = await ctx.api.request(path, { ...options, token: ctx.token });
+        const growth = withKnowledgeGrowth(path, raw.body, raw.status);
+        const mapped = options.method === "GET" && raw.status === 200 ? webCitations(path, growth, citationOrigin(ctx.api.baseUrl)) : growth;
+        const result = mapped === raw.body ? raw : { ...raw, body: mapped };
+        if (options.method === "GET" && result.status === 400
+            && isProjectIDParameterError(path.split("?")[0], result.body))
+            throw new CliError("invalid_arguments", "项目 ID 格式无效。", "请使用项目列表或详情返回的项目 UUID；progress list 的项目参数、knowledge --project 均需有效项目 ID。", 2, { http_status: 400 });
+        if (options.method === "POST" && path === `${root}/m2/knowledge-cards`) {
+            const failure = verifiedFileFailure(result.status, result.body, options.body, options.headers?.["Idempotency-Key"] !== undefined);
+            if (failure) {
+                const { code, message, ...details } = failure;
+                throw new CliError(code, message, "请先核对这次文件确认回执，不自动重试。", result.status === 503 ? 7 : 2, details);
+            }
+        }
+        if (options.method === "POST" && path === `${root}/m2/projects` && result.status === 400
+            && (result.body === "project payload is invalid" || result.body === "project payload is invalid\n")) {
+            throw new CliError("invalid_arguments", "服务端拒绝了项目创建参数。", "请按 requirements 核对项目字段；非草稿简介必填，但服务端未提供具体字段，不能断言只是哪一项错误。只提交本人确认的内容，不自动补简介、改状态或重试。", 2, { http_status: 400, ...inputDetails(p, { invalid: ["$input"] }) });
+        }
+        if (options.method === "PATCH" && /^\/api\/v1\/agent\/m2\/knowledge-cards\/[^/]+\/stage$/.test(path))
+            checkApplicationReceipt(result, asRecord(options.body)?.internalization_status);
+        if (options.method === "GET" && [`${root}/m1/projects`, `${root}/m1/knowledge`].includes(path.split("?")[0]) && result.status === 400 && (result.body === "invalid core_only" || result.body === "invalid core_only\n"))
+            throw new CliError("invalid_arguments", "核心筛选参数无效。", "只看核心请使用 --core-only，不筛选时省略。", 2, { http_status: 400 });
+        if (options.method === "PATCH" && /^\/api\/v1\/agent\/m2\/knowledge-cards\/[^/]+(?:\/stage)?$/.test(path))
+            expectKnowledgeChangeNotBlocked(result);
+        if (options.method === "POST" && isCreatePath(path))
+            return expectCreateOK(result, path.endsWith("/knowledge-cards") ? "knowledge" : "project", options.headers?.["Idempotency-Key"] !== undefined, Array.isArray(asRecord(options.body)?.sources) && asRecord(options.body).sources.length > 0);
+        if (options.method === "PATCH" && /^\/api\/v1\/agent\/m2\/knowledge-cards\/[^/]+$/.test(path))
+            return expectKnowledgeTextOK(result);
+        if (options.method === "GET" && path.split("?")[0] === `${root}/m1/activity/daily`)
+            return expectDailyOK(result);
+        if (options.method === "GET" && path.split("?")[0] === `${root}/m1/search`)
+            return expectSearchOK(result);
+        return options.method === "GET" && isPagedQueryPath(path.split("?")[0])
+            ? expectQueryOK(result, path.split("?")[0].endsWith("/pending-actions") ? 100 : 50)
+            : expectOK(result, options.method === "GET" ? "read" : "write");
+    };
+    const read = async (path, allowed, maxLimit = 50, capability) => {
+        allowedFlags(flags, allowed);
+        const target = query(path, flags, maxLimit);
+        return capability ? expectCapabilityResult(await ctx.api.request(target, { method: "GET", token: ctx.token }), capability, "read") : request(target, { method: "GET" });
+    };
+    const write = async (path, method, schema, progress = false) => {
+        allowedFlags(flags, progress ? ["input", "idempotency-key"] : ["input"]);
+        const key = flags["idempotency-key"];
+        if (key !== undefined && (typeof key !== "string" || !/^[A-Za-z0-9._:-]{16,128}(?![\s\S])/.test(key)))
+            throw invalidInput(p, { invalid: ["--idempotency-key"] });
+        const body = await inputBody(flags, ctx, schema, p);
+        return request(path, { method, body, ...(key === undefined ? {} : { headers: { "Idempotency-Key": key } }) });
+    };
+    if (p[0] === "rules" && p.length === 1) {
+        allowedFlags(flags, []);
+        return readHabit(ctx, false);
+    }
+    if (p[0] === "context" && p.length === 1 && flags.start === true) {
+        allowedFlags(flags, ["start"]);
+        return readHabit(ctx, true);
+    }
+    if (p[0] === "context" && p.length === 1) {
+        allowedFlags(flags, ["limit", "since"]);
+        const briefingPath = query(`${root}/m1/briefing`, flags, 100);
+        return readContext(ctx, briefingPath);
+    }
+    if (p[0] === "notifications" && p.length === 1) {
+        if (flags.filter !== undefined && (typeof flags.filter !== "string" || !["all", "unread", "read", "agent", "official"].includes(flags.filter)))
+            invalid();
+        return read(`${root}/m3/notifications`, ["limit", "filter", "offset"], 50, "read_notifications");
+    }
+    if (p[0] === "drafts" && p.length === 1)
+        return read(`${root}/m3/drafts`, ["limit"], 50, "read_drafts");
+    if (p[0] === "request" && p.length === 2 && ["delete", "archive", "visibility"].includes(p[1])) {
+        allowedFlags(flags, ["input"]);
+        return requestPendingAction(p[1], await readCommandInput(flags, ctx, p), ctx);
+    }
+    if (p[0] === "projects" && p.length === 1)
+        return read(`${root}/m1/projects`, ["limit", "offset", "status", "core-only", ...dateFlags]);
+    if (p[0] === "activity" && p.length === 1) {
+        allowedFlags(flags, ["start-date", "end-date", "limit", "offset"]);
+        validateDailyDates(flags);
+        return read(`${root}/m1/activity/daily`, ["start-date", "end-date", "limit", "offset"]);
+    }
+    if (p[0] === "checkins" && p.length === 1)
+        return read(`${root}/m1/checkins`, ["limit", "offset", ...dateFlags]);
+    if (p[0] === "progress" && p[1] === "list" && p.length === 3)
+        return read(`${root}/m1/projects/${id(p[2])}/updates`, ["limit", "offset", ...dateFlags]);
+    if (p[0] === "project" && p[1] === "update") {
+        if (p.length !== 3)
+            invalid();
+        allowedFlags(flags, ["input"]);
+        const path = `${root}/m2/projects/${id(p[2])}`;
+        const body = await inputBody(flags, ctx, schemas.projectUpdate, p);
+        return expectProjectTextOK(await ctx.api.request(path, { method: "PATCH", body, token: ctx.token }));
+    }
+    if (p[0] === "project" && p.length === 2) {
+        if (p[1] === "create")
+            return write(`${root}/m2/projects`, "POST", schemas.project, true);
+        return read(`${root}/m1/projects/${id(p[1])}`, []);
+    }
+    if (p[0] === "knowledge") {
+        if (p.length === 1) {
+            validateKnowledgeStatus(flags);
+            return read(`${root}/m1/knowledge`, knowledgeFilters);
+        }
+        if (p[1] === "show" && p.length === 3)
+            return read(`${root}/m1/knowledge/${id(p[2])}`, []);
+        if (p[1] === "add" && p.length === 2)
+            return write(`${root}/m2/knowledge-cards`, "POST", schemas.knowledge, true);
+        if (p[1] === "update" && p.length === 3)
+            return write(`${root}/m2/knowledge-cards/${id(p[2])}`, "PATCH", schemas.knowledgeUpdate);
+    }
+    if (p[0] === "search" && (p.length === 1 || p.length === 2)) {
+        allowedFlags(flags, knowledgeFilters.filter(flag => flag !== "q"));
+        validateKnowledgeStatus(flags);
+        validateSearch(p[1], flags);
+        return request(query(`${root}/m1/search`, { ...flags, q: p[1] }, 50), { method: "GET" });
+    }
+    if (p[0] === "pending" && p.length === 1) {
+        if (flags.status !== undefined && !["", "all", "pending", "confirmed", "rejected", "expired"].includes(String(flags.status)))
+            invalid();
+        return read(`${root}/pending-actions`, ["limit", "offset", "status"], 100);
+    }
+    if (p[0] === "progress" && p[1] === "add" && p.length === 3)
+        return write(`${root}/m2/projects/${id(p[2])}/updates`, "POST", schemas.progress, true);
+    if (p[0] === "cognition" && p[1] === "set" && p.length === 3)
+        return write(`${root}/m2/projects/${id(p[2])}/cognition`, "PATCH", schemas.cognition);
+    if (p[0] === "stage" && p[1] === "set" && p.length === 3)
+        return write(`${root}/m2/projects/${id(p[2])}/stages`, "PATCH", schemas.stages);
+    if (p[0] === "source" && p[1] === "add" && p.length === 3)
+        return write(`${root}/m2/knowledge-cards/${id(p[2])}/sources`, "POST", schemas.source);
+    if (p[0] === "advance" && p.length === 2)
+        return write(`${root}/m2/knowledge-cards/${id(p[1])}/stage`, "PATCH", schemas.advance);
+    if (p[0] === "link" && p.length === 3) {
+        allowedFlags(flags, ["core"]);
+        if (flags.core !== undefined && typeof flags.core !== "boolean")
+            invalid();
+        const path = `${root}/m2/knowledge-cards/${id(p[1])}/project-link`;
+        id(p[2]);
+        const result = await request(path, { method: "POST", body: { project_id: p[2], ...(flags.core === undefined ? {} : { is_core: flags.core }) } });
+        const body = asRecord(result.body);
+        return flags.core === true && body ? { ...result, body: { ...body, core_note: "此参数仅用于关联，不会设置项目或知识的核心标记。" } } : result;
+    }
+    if (p[0] === "unlink" && p.length === 3) {
+        allowedFlags(flags, []);
+        return request(`${root}/m2/knowledge-cards/${id(p[1])}/project-link/${id(p[2])}`, { method: "DELETE" });
+    }
+    if (p[0] === "upload" && p.length === 2) {
+        allowedFlags(flags, ["card", "source-title", "summary"]);
+        return executeUpload(p[1], flags, ctx);
+    }
+    return invalid();
+}
+export async function executeCommand(positionals, flags, ctx) {
+    if (positionals[0] === "schedule")
+        return executeSchedule(positionals, flags, ctx);
+    if (["calendar", "timeline", "daily-summary"].includes(positionals[0]))
+        return executeCalendar(positionals, flags, ctx);
+    try {
+        validateCommandArguments(positionals, flags);
+        const result = await dispatch(positionals, flags, ctx);
+        if (positionals[0] !== "context")
+            return result;
+        const body = asRecord(result.body);
+        if (!body)
+            return result;
+        const path = "/api/v1/agent/m1/workbench";
+        const workbench = webCitations(path, withKnowledgeGrowth(path, body.workbench, result.status), citationOrigin(ctx.api.baseUrl));
+        return workbench === body.workbench ? result : { ...result, body: { ...body, workbench } };
+    }
+    catch (error) {
+        if (error instanceof CliError && error.code === "invalid_arguments" && error.details.missing_fields === undefined
+            && ["project", "progress", "cognition", "stage", "knowledge", "source", "advance", "link", "unlink", "upload", "request"].includes(positionals[0])
+            && (flags.input !== undefined || ["link", "unlink", "upload"].includes(positionals[0]))) {
+            Object.assign(error.details, inputDetails(positionals, { invalid: ["$arguments"] }));
+        }
+        if (error instanceof CliError && error.code === "capability_disabled" && error.details.required_capability !== undefined && !commandAcceptsSwitch(positionals, error.details.required_capability))
+            throw unverifiedSwitchError();
+        if (error instanceof CliError)
+            throw error;
+        throw new CliError("command_failed", "未能完成命令。", "请先在网页核对实际结果，不要重复结果尚未确认的写入。", 7);
+    }
+}

package/dist/config.js

@@ -0,0 +1,14 @@
+import { CliError, validToken } from "./errors.js";
+export const productionOrigin = "https://caotang.gtcai.cn";
+export const legacyProductionOrigin = "https://opc.gtcai.cn";
+export function resolveConfig(environment, env, homeDir) {
+    if (environment !== undefined && environment !== "production" && environment !== "test")
+        throw new CliError("invalid_environment", "环境只能是 production 或 test。", "默认使用生产环境；测试时指定 --env test。");
+    const selected = environment === "test" ? "test" : "production";
+    if (env.CAOTANG_CLI_DEV_TOKEN !== undefined)
+        throw new CliError("invalid_token_environment", "通用令牌变量没有绑定目标环境。", "使用按环境区分的开发变量；不要把测试令牌传给生产环境。", 3);
+    const tokenOverride = selected === "test" ? env.CAOTANG_CLI_DEV_TEST_TOKEN : env.CAOTANG_CLI_DEV_PRODUCTION_TOKEN;
+    if (tokenOverride !== undefined && !validToken(tokenOverride))
+        throw new CliError("invalid_token", "环境中的授权令牌格式无效。", "检查环境变量，不要将令牌作为命令行参数或发到聊天中。", 3);
+    return { environment: selected, baseUrl: selected === "test" ? "https://test.gtcai.cn" : productionOrigin, homeDir, tokenOverride };
+}

package/dist/connection-copy.js

@@ -0,0 +1,40 @@
+// Shared connection copy: skills and the later connection page use this table.
+export const connectionCopy = Object.freeze({
+    connected: "接好了。",
+    first_empty: "接好了。刚才聊的，要存几条吗？",
+    first_existing: "接好了。要我看看你最近在忙什么吗？内容会发给当前这个 AI。",
+    repeated: "已经接好了，不用批准。",
+    read_only: "接好了，目前只能读取。改权限要在网页重新批准一条连接。",
+    read_only_existing: "接好了，目前只能读取。改权限要在网页重新批准一条连接。要我看看你最近在忙什么吗？内容会发给当前这个 AI。",
+    daily_next_step: "上次说下一步是 XX，接着来？",
+    expired: "确认码过期了，再运行一次拿新的。",
+    denied: "已取消，没有接入。",
+    uncertain: "没确认接上。去“Agent 管理”看有没有这条连接，有就告诉我。",
+    disconnected: "连接已断开，要用就重新接入。",
+    not_ready: "还没接好，请先按提示处理。",
+});
+export function approvalMessage(verificationUrl, userCode) {
+    try {
+        const url = new URL(verificationUrl);
+        if (url.username || url.password || url.search || url.hash || url.pathname !== "/app/device-auth"
+            || verificationUrl !== `${url.origin}/app/device-auth`
+            || !(url.protocol === "https:" || url.protocol === "http:" && ["127.0.0.1", "localhost", "[::1]"].includes(url.hostname))
+            || !/^[ABCDEFGHJKLMNPQRSTUVWXYZ23456789]{4}-[ABCDEFGHJKLMNPQRSTUVWXYZ23456789]{4}$/.test(userCode))
+            return connectionCopy.not_ready;
+    }
+    catch {
+        return connectionCopy.not_ready;
+    }
+    return `打开这个链接（${verificationUrl}），输入 ${userCode}，点批准。`;
+}
+export function setupFailureMessage(code) {
+    if (code === "access_denied")
+        return connectionCopy.denied;
+    if (code === "expired_token")
+        return connectionCopy.expired;
+    if (code === "authorization_delivery_unknown" || code === "authorization_identity_changed" || code === "authorization_consumed")
+        return connectionCopy.uncertain;
+    if (code === "unauthorized")
+        return connectionCopy.disconnected;
+    return connectionCopy.not_ready;
+}

package/dist/context.js

@@ -0,0 +1,30 @@
+import { apiError, asRecord, CliError, expectOK } from "./errors.js";
+/** Only a permission denial may make a context section unavailable. */
+export async function readContext(ctx, briefingPath) {
+    const parts = [
+        { section: "workbench", capability: "read_workbench", path: "/api/v1/agent/m1/workbench" },
+        { section: "briefing", capability: "read_notifications", path: briefingPath },
+    ];
+    const available = { workbench: null, briefing: null };
+    const missing = [];
+    for (const part of parts) {
+        const result = await ctx.api.request(part.path, { method: "GET", token: ctx.token });
+        if (result.status === 403) {
+            const denial = apiError(result, "read");
+            if (denial.code === "legal_consent_required")
+                throw denial;
+            const mismatch = denial.details.required_capability !== undefined && denial.details.required_capability !== part.capability;
+            missing.push({ section: part.section, required_capability: part.capability, reason: mismatch ? "permission_denied" : denial.code });
+            continue;
+        }
+        expectOK(result, "read");
+        if (result.status !== 200 || !asRecord(result.body)) {
+            throw new CliError("invalid_response", "无法核对工作现状的返回内容。", "请稍后重新读取；不要把本次读取失败理解为没有资料。", 7);
+        }
+        available[part.section] = result.body;
+    }
+    if (missing.length === parts.length) {
+        throw new CliError("context_unavailable", "当前没有可读取的工作现状。", "请在网页检查“读取工作台”和“读取通知”开关及这台设备的权限。", 4, { http_status: 403, partial: false, missing_sections: missing });
+    }
+    return { status: 200, body: missing.length ? { ...available, partial: true, missing_sections: missing } : available };
+}

package/dist/contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/create-bundle.js

@@ -0,0 +1,103 @@
+import { asRecord, CliError, expectOK, singleSwitchMetadata, unverifiedSwitchError } from "./errors.js";
+import { writeMissingSections } from "./write-permissions.js";
+export const trimCreateText = (value) => value.replace(/^\p{White_Space}+|\p{White_Space}+$/gu, "");
+export const createText = (min, max) => (value) => typeof value === "string" && [...trimCreateText(value)].length >= min && [...trimCreateText(value)].length <= max;
+export function createHTTPURL(value) {
+    if (typeof value !== "string" || [...trimCreateText(value)].length > 1000)
+        return false;
+    try {
+        const parsed = new URL(trimCreateText(value));
+        return ["http:", "https:"].includes(parsed.protocol) && parsed.hostname !== "";
+    }
+    catch {
+        return false;
+    }
+}
+export function validateCreateSources(value, fields) {
+    if (!Array.isArray(value))
+        return false;
+    if (value.length > 20)
+        throw new CliError("invalid_arguments", "sources 最多20项，本次未创建卡片。", "请明确选择本次要保存的来源；不会自动截断、拆批或去重。");
+    return value.every(entry => {
+        const source = asRecord(entry);
+        if (!source || typeof source.source_type !== "string")
+            return false;
+        const normalized = {};
+        for (const [key, raw] of Object.entries(source)) {
+            const item = typeof raw === "string" ? trimCreateText(raw) : raw;
+            if (!Object.hasOwn(fields, key) || !fields[key](item) || key === "source_url" && !createHTTPURL(item))
+                return false;
+            normalized[key] = item;
+        }
+        if (normalized.source_type === "external_url")
+            return typeof normalized.source_url === "string" && normalized.source_url !== "";
+        if (normalized.source_type === "file")
+            return typeof normalized.file_key === "string" && normalized.file_key !== "";
+        return typeof normalized.source_id === "string" && normalized.source_id !== "";
+    });
+}
+export function isCreatePath(path) { return path === "/api/v1/agent/m2/projects" || path === "/api/v1/agent/m2/knowledge-cards"; }
+const receiptID = (value) => typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value);
+const fixedReceiptMessage = "这是原回执，当前审核请到网页核对；本次未重新执行，不要自动重试。";
+export function expectKnowledgeTextOK(result) {
+    const body = asRecord(result.body), code = body?.code ?? body?.error;
+    if (result.status === 400 && code === "knowledge_text_contains_url" && (body?.code === undefined || body.code === code) && (body?.error === undefined || body.error === code)) {
+        const fields = Array.isArray(body?.fields) ? [...new Set(body.fields.filter(value => value === "summary" || value === "intent"))] : [];
+        throw new CliError(code, "摘要和想解决的问题不能包含网址，本次未写入。", "请把链接放进sources或通过source add保存来源；不要把来源塞回正文，不会自动改写内容。", 2, { http_status: 400, ...(fields.length ? { fields } : {}) });
+    }
+    return expectOK(result);
+}
+export function expectCreateOK(result, kind, keyed, hasSources) {
+    const body = asRecord(result.body), code = body?.code ?? body?.error;
+    const aliasesAgree = (body?.code === undefined || body.code === code) && (body?.error === undefined || body.error === code);
+    // New create failures cannot activate a legacy error branch through one
+    // conflicting alias. Keep transport facts, not disputed business metadata.
+    if (!aliasesAgree && (result.status < 200 || result.status >= 300))
+        return expectOK({ ...result, body: undefined });
+    if (aliasesAgree) {
+        if (result.status === 403 && code === "capability_disabled" && body?.required_capability === "write_knowledge_sources"
+            && (kind !== "knowledge" || !hasSources || !singleSwitchMetadata(body) || body.phase === "publication" || body.private_candidate_may_exist === true))
+            throw unverifiedSwitchError();
+        if (((result.status === 500 && code === "write_publication_failed") || (result.status === 404 && code === "write_target_not_found")) && body?.write_status === "failed" && body.phase === "publication" && body.private_candidate_may_exist === true && body.idempotency_replayed === false)
+            throw new CliError(code, "公开流程未完成；先前暂存的完整私有候选可能保留。", "请到网页核对，不要自动重试、换键或去掉幂等键重发。", result.status === 404 ? 2 : 7, { http_status: result.status, write_status: "failed", phase: "publication", private_candidate_may_exist: true, idempotency_replayed: false, ...(receiptID(body.request_id) ? { request_id: body.request_id } : {}) });
+        if (result.status === 403 && code === "capability_disabled" && kind === "knowledge" && hasSources && body?.required_capability === "write_knowledge_sources" && body.phase !== "publication" && body.private_candidate_may_exist !== true)
+            throw new CliError(code, "本次调用未新建卡片；写入知识来源所需的“管理知识来源”开关未开启。", "请本人到网页的 Agent 管理核对开关；不要重新授权或重试，不要把链接写回正文；如为幂等重放，请核对原请求结果。", 4, { http_status: 403, required_capability: "write_knowledge_sources" });
+        if (result.status === 400 && code === "sources_limit_exceeded")
+            throw new CliError(code, "sources最多20项，本次未创建卡片。", "不会截断来源；请明确选择本次要保存的来源后再提交。", 2, { http_status: 400 });
+        if (result.status === 400 && code === "invalid_sources")
+            throw new CliError(code, "sources必须是合法来源数组，本次未创建卡片。", "请检查来源字段与类型；只保存元数据，不会抓取URL或自动补协议。", 2, { http_status: 400 });
+        if (result.status === 409 && code === "duplicate_title") {
+            const missing = writeMissingSections(body?.missing_sections);
+            throw new CliError(code, body?.idempotency_replayed === true ? "原请求因同名冲突未创建；这是原回执，当前详情请网页核对。" : "本次请求因同名冲突未创建，当前详情请网页核对。", "不要自动换键重试；当前目标可能已经改名或删除，不能从原回执推断当前仍同名。", 2, { http_status: 409, created: false, ...(typeof body?.idempotency_replayed === "boolean" ? { idempotency_replayed: body.idempotency_replayed } : {}), ...(receiptID(body?.request_id) ? { request_id: body.request_id } : {}), ...(missing.length ? { missing_sections: missing } : {}) });
+        }
+        if (result.status === 422 && code === "content_blocked") {
+            const original = body?.idempotency_replayed === true && body.original_receipt === true && body.receipt_status === "failed";
+            throw new CliError(code, original ? "原请求发布被拦；这是原回执，不是当前审核结论。" : "本次发布被拦，不代表用户输入格式错误。", "完整私有候选可能已保留，请到网页核对；不要自动重试、换键或改成公开操作。", 2, { http_status: 422, ...(original ? { idempotency_replayed: true, original_receipt: true, receipt_status: "failed" } : {}), ...(receiptID(body?.request_id) ? { request_id: body.request_id } : {}), ...(receiptID(body?.moderation_case_id) ? { moderation_case_id: body.moderation_case_id } : {}) });
+        }
+    }
+    expectKnowledgeTextOK(result);
+    if (keyed && result.status >= 200 && result.status < 300 && result.status !== 202 && (![200, 201].includes(result.status) || !body || !receiptID(body.request_id) || typeof body.idempotency_replayed !== "boolean" || body.write_status !== "succeeded"))
+        throw new CliError("idempotency_unverified", "响应可能已经写入，但未核到有效幂等收据，不能确认防重。", "请先到网页核对；不要自动重试、换键或去掉幂等键降级重发。", 7, { http_status: result.status });
+    if (!body)
+        return result;
+    if (!Object.hasOwn(body, "draft_notice") && !(body.original_receipt === true && body.idempotency_replayed === true && body.receipt_status === "moderation_pending" && result.status === 202))
+        return result;
+    const { draft_notice: notice, ...rest } = body;
+    const validNotice = (result.status === 200 || result.status === 201) && body.write_status === "succeeded" && body.idempotency_replayed === false && notice === `${kind}_draft`;
+    const normalized = validNotice ? { ...rest, draft_notice: notice } : rest;
+    if (body.original_receipt === true && body.idempotency_replayed === true && body.receipt_status === "moderation_pending" && result.status === 202) {
+        delete normalized.moderation_status;
+        normalized.message = fixedReceiptMessage;
+    }
+    return { ...result, body: normalized };
+}
+export function createDraftNotice(value) {
+    const body = asRecord(value);
+    if (body?.write_status !== "succeeded" || body.idempotency_replayed !== false)
+        return "";
+    if (body.draft_notice === "knowledge_draft")
+        return "已创建为知识草稿，不在默认published列表；可用knowledge --publication-status draft查询，需要读取知识和读取草稿权限。\n";
+    if (body.draft_notice === "project_draft")
+        return "已创建为项目草稿；可用projects --status draft查询，需要读取项目和读取草稿权限。项目默认列表在权限允许时可以包含草稿。\n";
+    return "";
+}

package/dist/create-file-failure.js

@@ -0,0 +1,18 @@
+// Interpreted only for an explicit keyed creation with an actual file source.
+// A generic 503, a publication failure, or an uncertain commit cannot authorize a new key.
+export function verifiedFileFailure(status, value, input, keyed) {
+    if (!keyed || !value || typeof value !== "object" || !input || typeof input !== "object")
+        return;
+    const b = value, sources = input.sources;
+    if (!Array.isArray(sources) || !sources.some(s => typeof s?.file_key === "string" && s.file_key.trim()))
+        return;
+    const codes = { 400: ["invalid_upload"], 401: ["upload_unauthorized"], 404: ["upload_not_found"],
+        409: ["storage_quota_exceeded", "upload_unverified", "upload_in_progress", "upload_conflict"], 503: ["storage_unavailable"] };
+    if (typeof b.code !== "string" || b.error !== b.code || !codes[status]?.includes(b.code) || b.write_status !== "failed"
+        || b.retry_with_new_key_after_verification !== true || typeof b.idempotency_replayed !== "boolean"
+        || typeof b.request_id !== "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}(?![\s\S])/i.test(b.request_id)
+        || b.private_candidate_may_exist === true || b.phase !== undefined)
+        return;
+    return { code: b.code, http_status: status, request_id: b.request_id, write_status: "failed", idempotency_replayed: b.idempotency_replayed,
+        retry_with_new_key_after_verification: true, message: "本次未创建卡片；请先核实或修复文件，确认后可使用新幂等键重新提交。不要自动重试。" };
+}