@skillcdn/console 0.0.0-stage → 0.1.0

package/dist/cli/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/cli/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAoB9B,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,GAAiD;IAChF,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,CAAC;IACjC,OAAO,IAAI,CACT,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAC3E,kBAAkB,CACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACxC,OAAO;QACL,KAAK,CAAC,IAAI;YACR,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAChE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,WAAW;YACpB,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACzD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACpF,mGAAmG;YACnG,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/format.d.ts

@@ -0,0 +1,16 @@
+import type { RestArtifact, RestDecision, RestRun, RestSkills, RestTask } from "../schemas.js";
+export declare function formatTaskLine(task: RestTask): string;
+/** One task in full; with the decisions about it and the runs on it, when given. */
+export declare function formatTask(task: RestTask, decisions?: readonly RestDecision[], runs?: readonly RestRun[]): string;
+export declare function formatRunLine(run: RestRun): string;
+export declare function formatRun(run: RestRun): string;
+/** What was handed in: the link, or the file with its size and where its bytes are read. */
+export declare function formatArtifact(artifact: RestArtifact): string;
+/** The organization's skills: where they are, and each with what an agent loads it by. */
+export declare function formatSkills(skills: RestSkills): string;
+export declare function formatDecisionLine(decision: RestDecision): string;
+export declare function formatOptions(decision: RestDecision): string;
+/** The answer, with who gave it; or that there is none yet. */
+export declare function formatAnswer(decision: RestDecision): string;
+export declare function formatDecision(decision: RestDecision): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/cli/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/cli/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAoB/F,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAYrD;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,SAAS,YAAY,EAAE,EACnC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,GACxB,MAAM,CA4BR;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMlD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAqB9C;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAM7D;AASD,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAoBvD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAGjE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAE5D;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAa3D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAU7D"}

package/dist/cli/format.js

@@ -0,0 +1,151 @@
+import { restPath } from "../routes.js";
+// What the command prints: one line per thing in a list, a few lines for one thing in full.
+// Plain text, for an agent to read and a person to skim; ids are given, since the commands take
+// them, and the words are the vocabulary's own, since the options take those.
+const plural = (count, word) => `${count} ${word}${count === 1 ? "" : "s"}`;
+const indent = (text) => text
+    .trimEnd()
+    .split("\n")
+    .map((line) => `    ${line}`)
+    .join("\n");
+const asker = (decision) => decision.run === null
+    ? decision.raisedBy.login
+    : `${decision.run.agent} for ${decision.raisedBy.login}`;
+export function formatTaskLine(task) {
+    const notes = [`owner ${task.owner.login}`];
+    if (task.assignee !== null) {
+        notes.push(`assigned to ${task.assignee.login}`);
+    }
+    if (task.openDecisions > 0) {
+        notes.push(`${plural(task.openDecisions, "decision")} waiting`);
+    }
+    if (task.openRuns > 0) {
+        notes.push("an agent at work");
+    }
+    return `#${task.number}  ${task.state}  ${task.priority}  ${task.title}  (${notes.join("; ")})`;
+}
+/** One task in full; with the decisions about it and the runs on it, when given. */
+export function formatTask(task, decisions, runs) {
+    const lines = [
+        `#${task.number} ${task.title}`,
+        `state: ${task.state}  priority: ${task.priority}  owner: ${task.owner.login}  assignee: ${task.assignee?.login ?? "nobody"}`,
+        `id: ${task.id}${task.parentId === null ? "" : `  part of: ${task.parentId}`}`,
+    ];
+    if (task.links.length > 0) {
+        lines.push("links:");
+        for (const link of task.links) {
+            lines.push(`  ${link.label === null ? link.url : `${link.label}: ${link.url}`}`);
+        }
+    }
+    if (task.body.trim().length > 0) {
+        lines.push("", task.body.trimEnd());
+    }
+    if (decisions !== undefined) {
+        lines.push("", decisions.length === 0 ? "decisions: none" : "decisions:");
+        for (const decision of decisions) {
+            lines.push(`  ${formatDecisionLine(decision)}`);
+        }
+    }
+    if (runs !== undefined) {
+        lines.push("", runs.length === 0 ? "runs: none" : "runs:");
+        for (const run of runs) {
+            lines.push(`  ${formatRunLine(run)}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function formatRunLine(run) {
+    const notes = [plural(run.reports.length, "report"), plural(run.artifacts.length, "artifact")];
+    if (run.waitingFor !== null) {
+        notes.push(`waiting for decision ${run.waitingFor}`);
+    }
+    return `${run.id}  ${run.status}  ${run.agent} for ${run.person.login}  task #${run.taskNumber}  (${notes.join(", ")})`;
+}
+export function formatRun(run) {
+    const lines = [
+        formatRunLine(run),
+        `started: ${run.startedAt}${run.endedAt === null ? "" : `  ended: ${run.endedAt}`}`,
+    ];
+    if (run.summary !== null) {
+        lines.push("", "summary:", indent(run.summary));
+    }
+    if (run.reports.length > 0) {
+        lines.push("", "reports:");
+        for (const report of run.reports) {
+            lines.push(`  [${report.createdAt}]`, indent(report.body));
+        }
+    }
+    if (run.artifacts.length > 0) {
+        lines.push("", "artifacts:");
+        for (const artifact of run.artifacts) {
+            lines.push(`  ${formatArtifact(artifact)}`);
+        }
+    }
+    return lines.join("\n");
+}
+/** What was handed in: the link, or the file with its size and where its bytes are read. */
+export function formatArtifact(artifact) {
+    const what = artifact.file === null
+        ? (artifact.url ?? "")
+        : `${artifact.file.name} (${artifact.file.size} bytes, ${artifact.file.contentType}; read at ${restPath("files", artifact.id)})`;
+    return artifact.label === null ? what : `${artifact.label}: ${what}`;
+}
+const SKILLS_WORDS = {
+    indexing: "SkillCDN is still indexing the repository; ask again in a moment.",
+    failed: "SkillCDN could not index the repository.",
+    not_found: "SkillCDN does not serve this address to the console.",
+    unavailable: "SkillCDN could not be reached; ask again later.",
+};
+/** The organization's skills: where they are, and each with what an agent loads it by. */
+export function formatSkills(skills) {
+    if (skills.status === "none" || skills.address === null) {
+        return "No skills address is configured on this console.";
+    }
+    const head = `skills at ${skills.address}, served by ${skills.source}: ${skills.status}`;
+    if (skills.status !== "ready") {
+        return `${head}\n${SKILLS_WORDS[skills.status]}`;
+    }
+    if (skills.items.length === 0) {
+        return `${head}\nNo skills at this address.`;
+    }
+    const lines = [head];
+    for (const skill of skills.items) {
+        lines.push(`${skill.name}  ${skill.description}`, `    ${skill.uri ?? skill.path}`);
+    }
+    lines.push("", "Load a skill by its URI through your SkillCDN connection. --json adds the page of each, for a person.");
+    return lines.join("\n");
+}
+export function formatDecisionLine(decision) {
+    const state = decision.answer === null ? "waiting" : `answered ${decision.answer.option}`;
+    return `${decision.id}  ${state}  ${decision.question}  (asked by ${asker(decision)})`;
+}
+export function formatOptions(decision) {
+    return decision.options.map((option) => `  ${option.id}) ${option.label}`).join("\n");
+}
+/** The answer, with who gave it; or that there is none yet. */
+export function formatAnswer(decision) {
+    const { answer } = decision;
+    if (answer === null) {
+        return "waits for a person.";
+    }
+    const label = decision.options.find((option) => option.id === answer.option)?.label;
+    const lines = [
+        `Answered: ${answer.option}) ${label ?? answer.option}, by ${answer.by.login} at ${answer.at}`,
+    ];
+    if (answer.note !== null && answer.note.length > 0) {
+        lines.push(`Note: ${answer.note}`);
+    }
+    return lines.join("\n");
+}
+export function formatDecision(decision) {
+    const lines = [
+        `decision ${decision.id}: ${decision.question}`,
+        `asked by ${asker(decision)}${decision.taskNumber === null ? "" : `, about task #${decision.taskNumber}`}`,
+    ];
+    if (decision.body.trim().length > 0) {
+        lines.push("", decision.body.trimEnd());
+    }
+    lines.push("", "options:", formatOptions(decision), "", formatAnswer(decision));
+    return lines.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/cli/format.js.map

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

package/dist/cli/help.d.ts

@@ -0,0 +1,16 @@
+export interface CommandHelp {
+    /** The command and its arguments, after `console`. */
+    readonly usage: string;
+    /** What it does, in a sentence. */
+    readonly about: string;
+    /** What the console holds the arguments to. */
+    readonly limits?: readonly string[];
+    /** What the console may refuse, by code, and what to do then. */
+    readonly refusals?: readonly string[];
+}
+export declare const COMMAND_HELP: Readonly<Record<string, CommandHelp>>;
+/** The whole usage, as `console help` prints it. */
+export declare function usage(): string;
+/** What `console help <command>` prints, or nothing for a command that is not one. */
+export declare function helpFor(name: string): string | undefined;
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAgBD,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CA2H9D,CAAC;AAgCF,oDAAoD;AACpD,wBAAgB,KAAK,IAAI,MAAM,CAc9B;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAaxD"}

package/dist/cli/help.js

@@ -0,0 +1,180 @@
+import { MAX_AGENT_LENGTH, MAX_ARTIFACTS_PER_RUN, MAX_BODY_LENGTH, MAX_FILE_BYTES, MAX_LINK_LABEL_LENGTH, MAX_OPTION_LABEL_LENGTH, MAX_OPTIONS, MAX_QUESTION_LENGTH, MAX_REPORTS_PER_RUN, MAX_SUMMARY_LENGTH, MAX_TITLE_LENGTH, MIN_OPTIONS, } from "../limits.js";
+/** The refusals any command may meet, said once in the overview. */
+const COMMON_REFUSALS = [
+    "auth.required: the token is not one the console knows, any more or at all; a person signs the command in again",
+    "request.invalid: what was sent is over a limit or malformed; the message names the field",
+    "network: the console could not be reached at its address",
+];
+const RUN_REFUSALS = [
+    "run.not_yours: the run is another person's",
+    "run.over: the run has ended already",
+];
+const MARKDOWN = `Markdown, up to ${MAX_BODY_LENGTH} characters`;
+export const COMMAND_HELP = {
+    login: {
+        usage: "login --url <origin> [--token-stdin]",
+        about: "A person signs the command in: it asks for a token made on the console's Tokens page and keeps it, with the console's address, in your home directory. --token-stdin reads the token from standard input instead.",
+        refusals: ["the console does not know the token: make one on the Tokens page and try again"],
+    },
+    logout: {
+        usage: "logout",
+        about: "Forgets the address and the token kept here. The token itself is removed on the Tokens page.",
+    },
+    whoami: {
+        usage: "whoami",
+        about: "Who the token acts as, and which console it is for.",
+    },
+    tasks: {
+        usage: "tasks [--state <state>]",
+        about: "The tasks on the board, newest first: number, state, priority, title, who owns and works on each, and what waits on it. States: idea, ready, in_progress, in_review, done, dropped.",
+    },
+    task: {
+        usage: "task <number|id>  |  task new <title> [--body <markdown>|--file <path>] [--state <state>] [--priority <priority>]",
+        about: "One task in full, with the decisions about it and the runs on it; or a new task written down (priorities: low, normal, high, urgent).",
+        limits: [`title: one line, up to ${MAX_TITLE_LENGTH} characters`, `body: ${MARKDOWN}`],
+        refusals: ["task.not_found: no task has that number or id"],
+    },
+    skills: {
+        usage: "skills",
+        about: "The organization's skills, as SkillCDN serves them at the console's address: each with its description and the URI you load it by through your own SkillCDN connection. --json adds the page of each, for a person.",
+    },
+    take: {
+        usage: "take <number|id> [--agent <name>]",
+        about: "Takes a task: a run begins, and the task is in progress and the person's. One agent at a time per task. --agent is what people see at work; left out, it is what the person called the token.",
+        limits: [`agent: one line, up to ${MAX_AGENT_LENGTH} characters`],
+        refusals: [
+            "task.not_found: no task has that number or id",
+            "run.task_taken: a run is open on the task already; console runs --open --mine shows whether it is yours",
+            "run.task_closed: the task is done or dropped",
+        ],
+    },
+    report: {
+        usage: "report <markdown>  |  report --file <path>  |  report -",
+        about: "Says how the work goes, in Markdown: what was found, what was done, what is next. A milestone at a time, not every step. With - the report is read from standard input.",
+        limits: [
+            `the report: ${MARKDOWN}, not blank`,
+            `at most ${MAX_REPORTS_PER_RUN} reports on one run`,
+        ],
+        refusals: [...RUN_REFUSALS, "run.too_many_reports: the run carries as many as one may"],
+    },
+    "hand-in": {
+        usage: "hand-in <https url | file path> [--label <words>]",
+        about: "Hands in what was made: a link (a branch, a pull request, a document, a page), or a file from this machine, which the console keeps and shows on the task.",
+        limits: [
+            "a link: https only",
+            `a file: up to ${MAX_FILE_BYTES} bytes, not empty; it is called by its name, without the path`,
+            `label: one line, up to ${MAX_LINK_LABEL_LENGTH} characters`,
+            `at most ${MAX_ARTIFACTS_PER_RUN} links and files on one run`,
+        ],
+        refusals: [
+            ...RUN_REFUSALS,
+            "run.too_many_artifacts: the run carries as many as one may",
+            "request.too_large: the file is over the limit",
+        ],
+    },
+    ask: {
+        usage: 'ask "<question>" --option "<label>" --option "<label>" [...] [--body <markdown>|--file <path>] [--wait <seconds>]',
+        about: "Raises a decision a person must make: the question, the options to choose from, and what they need to know. The run waits for the answer. The command waits 60 seconds for it unless --wait says otherwise, and exits with 3 if it is still to come: keep waiting with `console decision <id> --wait 100`, within what your shell gives one command, and go on meanwhile only with work that does not depend on the answer. The decision's id is printed as soon as it is raised.",
+        limits: [
+            `question: one line, up to ${MAX_QUESTION_LENGTH} characters`,
+            `options: ${MIN_OPTIONS} to ${MAX_OPTIONS}, each one line up to ${MAX_OPTION_LABEL_LENGTH} characters`,
+            `body: ${MARKDOWN}`,
+        ],
+        refusals: ["decision.invalid_run: the run is not yours, or is over"],
+    },
+    decision: {
+        usage: "decision <id> [--wait <seconds>]",
+        about: "One decision, with its options and its answer. With --wait, holds on for the answer that long, and exits with 3 if it is still to come.",
+        refusals: ["decision.not_found: no decision has that id"],
+    },
+    decisions: {
+        usage: "decisions [--open]",
+        about: "The decisions on the board, the waiting first; --open keeps only those.",
+    },
+    finish: {
+        usage: 'finish [--summary "<markdown>"|--file <path>]',
+        about: "Ends the run: the work is done and handed in, and the task goes up for review. The summary says what was done and what is left; the result itself goes in a last report before, which may be much longer.",
+        limits: [`summary: ${`Markdown, up to ${MAX_SUMMARY_LENGTH} characters`}`],
+        refusals: RUN_REFUSALS,
+    },
+    fail: {
+        usage: 'fail [--summary "<markdown>"|--file <path>]',
+        about: "Ends the run: the work could not be done. The summary says why, and what is left.",
+        limits: [`summary: Markdown, up to ${MAX_SUMMARY_LENGTH} characters`],
+        refusals: RUN_REFUSALS,
+    },
+    abandon: {
+        usage: 'abandon [<run id>] [--summary "<markdown>"]',
+        about: "Leaves a run; the task stays as it is. A person gives up this way on a run of theirs that will not come back.",
+        limits: [`summary: Markdown, up to ${MAX_SUMMARY_LENGTH} characters`],
+        refusals: RUN_REFUSALS,
+    },
+    runs: {
+        usage: "runs [--task <number|id>] [--open] [--mine]",
+        about: "The runs, newest first: agents at work and what they did. --mine keeps those begun with this token.",
+    },
+    run: {
+        usage: "run <id>",
+        about: "One run in full: its reports, what it handed in, what it waits for, how it ended.",
+        refusals: ["run.not_found: no run has that id"],
+    },
+};
+const PREAMBLE = `console: the board of your organization's work with AI agents, from the command line.
+You act as the person whose token you hold; everything you send is shown to people as text.
+
+Usage: console <command> [arguments] [--json] [--url <origin>]
+`;
+const CLOSING = `Options everywhere: --json answers with the console's own JSON; --url names another console.
+Commands on a run (report, hand-in, ask, finish, fail) act on your one open run; with several open,
+say which with --run <id>. A Markdown body given as - is read from standard input.
+console help <command> says what each command takes, the limits the console holds it to, and
+what it may refuse.
+
+Exit codes: 0 done; 1 the console refused, or could not be reached (the reason is on stderr);
+2 the command was not understood; 3 the decision still waits for a person.
+What the console refuses is printed as its code and its words. Everywhere:
+${COMMON_REFUSALS.map((refusal) => `  ${refusal}`).join("\n")}
+
+Credentials: CONSOLE_URL and CONSOLE_TOKEN in the environment, else what login kept in
+$XDG_CONFIG_HOME/skillcdn-console/credentials.json (~/.config when XDG_CONFIG_HOME is unset).
+`;
+const SECTIONS = [
+    { title: "Signing in, once, as a person", commands: ["login", "logout", "whoami"] },
+    {
+        title: "The board",
+        commands: ["tasks", "task", "decisions", "decision", "runs", "run", "skills"],
+    },
+    { title: "Working", commands: ["take", "report", "hand-in", "ask", "finish", "fail", "abandon"] },
+];
+/** The whole usage, as `console help` prints it. */
+export function usage() {
+    const parts = [PREAMBLE];
+    for (const section of SECTIONS) {
+        parts.push(`${section.title}`);
+        for (const name of section.commands) {
+            const help = COMMAND_HELP[name];
+            if (help !== undefined) {
+                parts.push(`  console ${help.usage}\n      ${help.about}`);
+            }
+        }
+        parts.push("");
+    }
+    parts.push(CLOSING);
+    return parts.join("\n");
+}
+/** What `console help <command>` prints, or nothing for a command that is not one. */
+export function helpFor(name) {
+    const help = COMMAND_HELP[name];
+    if (help === undefined) {
+        return undefined;
+    }
+    const parts = [`console ${help.usage}`, "", help.about];
+    if (help.limits !== undefined) {
+        parts.push("", "Limits:", ...help.limits.map((limit) => `  ${limit}`));
+    }
+    if (help.refusals !== undefined) {
+        parts.push("", "Refusals:", ...help.refusals.map((refusal) => `  ${refusal}`));
+    }
+    return `${parts.join("\n")}\n`;
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

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

package/dist/cli/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":""}

package/dist/cli/main.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { runCli } from "./cli.js";
+import { createFileStore, defaultConfigDir } from "./credentials.js";
+import { readBytesAt, readFileAt, readSecret, readStdin } from "./terminal.js";
+// The `console` command: the only place the command reads the process. Everything it does is in
+// cli.ts, which takes what it needs and is what the tests run.
+process.exitCode = await runCli(process.argv.slice(2), {
+    env: process.env,
+    stdout: (text) => {
+        process.stdout.write(text);
+    },
+    stderr: (text) => {
+        process.stderr.write(text);
+    },
+    fetch: (input, init) => fetch(input, init),
+    readStdin,
+    readSecret,
+    readFile: readFileAt,
+    readBytes: readBytesAt,
+    store: createFileStore(defaultConfigDir(process.env)),
+    sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+    now: () => Date.now(),
+});
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AACA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/E,gGAAgG;AAChG,+DAA+D;AAE/D,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACrD,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;IAC1C,SAAS;IACT,UAAU;IACV,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,eAAe,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrD,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAChE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;CACtB,CAAC,CAAC"}

package/dist/cli/terminal.d.ts

@@ -0,0 +1,12 @@
+/** All of standard input, once it ends. */
+export declare function readStdin(): Promise<string>;
+/**
+ * A secret typed at the terminal, shown as nothing while it is typed; when standard input is
+ * not a terminal, its first line.
+ */
+export declare function readSecret(prompt: string): Promise<string>;
+/** A file named on the command line, as text. */
+export declare function readFileAt(path: string): Promise<string>;
+/** A file named on the command line, as bytes: what is handed in. */
+export declare function readBytesAt(path: string): Promise<Uint8Array>;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/cli/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/cli/terminal.ts"],"names":[],"mappings":"AAMA,2CAA2C;AAC3C,wBAAgB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAU3C;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsChE;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAExD;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAE7D"}

package/dist/cli/terminal.js

@@ -0,0 +1,68 @@
+import { readFile } from "node:fs/promises";
+import process from "node:process";
+// The terminal's side of the command: what is read from it. Nothing here is reached by tests,
+// which hand the command readers of their own.
+/** All of standard input, once it ends. */
+export function readStdin() {
+    return new Promise((resolve, reject) => {
+        let content = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => {
+            content += chunk;
+        });
+        process.stdin.on("end", () => resolve(content));
+        process.stdin.on("error", reject);
+    });
+}
+/**
+ * A secret typed at the terminal, shown as nothing while it is typed; when standard input is
+ * not a terminal, its first line.
+ */
+export async function readSecret(prompt) {
+    const { stdin, stderr } = process;
+    if (!stdin.isTTY) {
+        return (await readStdin()).split(/\r?\n/, 1)[0] ?? "";
+    }
+    stderr.write(prompt);
+    return new Promise((resolve, reject) => {
+        let value = "";
+        const done = () => {
+            stdin.setRawMode(false);
+            stdin.pause();
+            stdin.off("data", onData);
+            stderr.write("\n");
+        };
+        const onData = (chunk) => {
+            for (const character of chunk) {
+                if (character === "\u0003") {
+                    done();
+                    reject(new Error("interrupted"));
+                    return;
+                }
+                if (character === "\r" || character === "\n") {
+                    done();
+                    resolve(value);
+                    return;
+                }
+                if (character === "\u007f" || character === "\b") {
+                    value = value.slice(0, -1);
+                    continue;
+                }
+                value += character;
+            }
+        };
+        stdin.setRawMode(true);
+        stdin.setEncoding("utf8");
+        stdin.resume();
+        stdin.on("data", onData);
+    });
+}
+/** A file named on the command line, as text. */
+export function readFileAt(path) {
+    return readFile(path, "utf8");
+}
+/** A file named on the command line, as bytes: what is handed in. */
+export function readBytesAt(path) {
+    return readFile(path);
+}
+//# sourceMappingURL=terminal.js.map

package/dist/cli/terminal.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,92 @@
+import { type RestAnswerInput, type RestArtifactInput, type RestDecision, type RestDecisionInput, type RestDecisions, type RestEvents, type RestMe, type RestPeople, type RestPerson, type RestPersonPatch, type RestReportInput, type RestRun, type RestRunEndInput, type RestRunInput, type RestRuns, type RestSkills, type RestTask, type RestTaskInput, type RestTaskPatch, type RestTasks, type RestTokenCreated, type RestTokenInput, type RestTokens } from "./schemas.js";
+import type { TaskState } from "./vocabulary.js";
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+/** A file to hand in: its bytes, what to call it, and what it is. */
+export interface FileUpload {
+    /** The file's name, without a path. */
+    readonly name: string;
+    readonly bytes: Uint8Array | Blob;
+    /** The media type; `application/octet-stream` when left out. */
+    readonly contentType?: string | undefined;
+    readonly label?: string | undefined;
+}
+export interface ClientOptions {
+    /** The origin of the console, without a path. Empty: the origin of the page. */
+    readonly baseUrl?: string;
+    /** The platform's `fetch` when left out. Tests hand in one that never leaves the process. */
+    readonly fetch?: FetchLike;
+    /**
+     * A token a person made, for an agent, a script or a console of their own: sent as
+     * `Authorization: Bearer`, and the browser's cookies left out. Left out, the session cookie of
+     * the page's own origin is what the console answers to.
+     */
+    readonly token?: string;
+}
+export declare class ApiError extends Error {
+    /** HTTP status, or 0 when there was no response at all. */
+    readonly status: number;
+    /** The stable code from the error body, `network` or `invalid_response`. */
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export interface ConsoleClient {
+    me(signal?: AbortSignal): Promise<RestMe>;
+    people(signal?: AbortSignal): Promise<RestPeople>;
+    /** Changes what a person is; for an administrator. */
+    updatePerson(id: string, patch: RestPersonPatch): Promise<RestPerson>;
+    tasks(filter?: {
+        readonly state?: TaskState;
+    }, signal?: AbortSignal): Promise<RestTasks>;
+    /** One task, by its id or by its number. */
+    task(ref: string, signal?: AbortSignal): Promise<RestTask>;
+    createTask(input: RestTaskInput): Promise<RestTask>;
+    updateTask(id: string, patch: RestTaskPatch): Promise<RestTask>;
+    /** The decisions, or only those that wait, or only those about one task. */
+    decisions(filter?: {
+        readonly open?: boolean;
+        readonly task?: string;
+    }, signal?: AbortSignal): Promise<RestDecisions>;
+    decision(id: string, signal?: AbortSignal): Promise<RestDecision>;
+    /**
+     * One decision, after waiting up to `waitSeconds` for its answer: the server holds the request
+     * while the decision waits, for as long as it allows, and answers the decision as it stands.
+     */
+    awaitDecision(id: string, waitSeconds: number, signal?: AbortSignal): Promise<RestDecision>;
+    raiseDecision(input: RestDecisionInput): Promise<RestDecision>;
+    answerDecision(id: string, input: RestAnswerInput): Promise<RestDecision>;
+    /** The runs, newest first; or only those on one task, only the open ones, only the asker's own. */
+    runs(filter?: {
+        readonly task?: string;
+        readonly open?: boolean;
+        readonly mine?: boolean;
+    }, signal?: AbortSignal): Promise<RestRuns>;
+    run(id: string, signal?: AbortSignal): Promise<RestRun>;
+    /** Takes a task: a run begins, for the person the asker is or acts for. */
+    startRun(input: RestRunInput): Promise<RestRun>;
+    /** Says how the work goes, on a run of the asker's. */
+    report(runId: string, input: RestReportInput): Promise<RestRun>;
+    /** Hands in a link, on a run of the asker's. */
+    handIn(runId: string, input: RestArtifactInput): Promise<RestRun>;
+    /** Hands in a file, on a run of the asker's: the console keeps the bytes. */
+    handInFile(runId: string, input: FileUpload): Promise<RestRun>;
+    /** Where the bytes of a file handed in are read, by the artifact's id. */
+    fileUrl(artifactId: string): string;
+    /** Ends a run: finished or failed by the agent; abandoned by the person it is for, or an administrator. */
+    endRun(runId: string, input: RestRunEndInput): Promise<RestRun>;
+    /** What happened after event number `after`; `0` for the beginning. */
+    events(after: number, signal?: AbortSignal): Promise<RestEvents>;
+    /** Where an `EventSource` subscribes to what happens after event number `after`. */
+    eventStreamUrl(after: number): string;
+    /** The organization's skills, as SkillCDN serves them at the console's address. */
+    skills(signal?: AbortSignal): Promise<RestSkills>;
+    /** The tokens of whoever asks. */
+    tokens(signal?: AbortSignal): Promise<RestTokens>;
+    /** Makes a token; the answer carries the secret, this once. */
+    createToken(input: RestTokenInput): Promise<RestTokenCreated>;
+    /** Takes a token away, whoever holds it. */
+    revokeToken(id: string): Promise<void>;
+    /** Ends the session on this browser. */
+    signOut(): Promise<void>;
+}
+export declare function createClient(options?: ClientOptions): ConsoleClient;
+//# sourceMappingURL=client.d.ts.map