@wirecat/cli-core 0.530.0 → 0.531.0

package/dist/cli/schedule/schedule-command.js

@@ -0,0 +1,261 @@
+import { existsSync, rmSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { CliError, resolvePaths, writeSecurely } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Argument, Command, Option } from "commander";
+import { describeWhen, findProgram, lastRun, listSchedules, readSchedule, runSchedule, scheduleFile, scheduleName, timerFor, } from "../../background/schedules.js";
+import { thisMachine } from "../../background/system.js";
+import { locationVariables } from "../../background/units.js";
+import { parseDuration } from "../../domain/duration.js";
+import { readOnlyLockOf } from "../../ports/app.js";
+import { aheadOf } from "../../services/moment.js";
+import { storePath } from "../../store/path.js";
+import { environmentOf, setExitCode } from "../context.js";
+import { grantsAuthority, LOCAL_READ, LOCAL_WRITE, REMOTE_WRITE } from "../effects.js";
+import { itemOf, listOf, renderAnswer, snakeKeys } from "../envelope.js";
+import { withQuery } from "../list-query.js";
+import { SCHEDULES_QUERY, scheduleFilter } from "../messenger/list-result-queries.js";
+import { lineOf } from "../steps.js";
+/** Each run of an agent is a paid model call that reads chats; keeping the store current is `serve`'s job. */
+const AGENT_MINIMUM_MINUTES = 60;
+const COMMAND_MINIMUM_MINUTES = 1;
+const HARNESSES = ["claude", "codex"];
+const whenOf = ({ every, at, atTime }, minimum) => {
+    if ([every ?? at, atTime].filter(Boolean).length !== 1) {
+        throw new CliError("validation_error", "say when: --every <30m|2h|1d>, --at HH:MM (daily), or --at-time <30m|2d|ISO time>");
+    }
+    if (atTime) {
+        const time = aheadOf(atTime, "--at-time");
+        if (time <= Date.now())
+            throw new CliError("validation_error", "--at-time is in the past");
+        return { once: new Date(time).toISOString() };
+    }
+    if (at) {
+        if (!/^([01]\d|2[0-3]):[0-5]\d$/.test(at))
+            throw new CliError("validation_error", `--at takes HH:MM, not "${at}"`);
+        if (every && parseDuration(every, "--every") !== 86_400_000) {
+            throw new CliError("validation_error", "--at runs once a day; leave out --every, or use --every 1d");
+        }
+        return { daily: at };
+    }
+    const minutes = parseDuration(every ?? "", "--every") / 60_000;
+    if (!Number.isInteger(minutes) || minutes < minimum) {
+        throw new CliError("validation_error", `--every is at least ${minimum} minute${minimum === 1 ? "" : "s"} here, in whole minutes`);
+    }
+    return { every: minutes };
+};
+/** A schedule as answered: snake_case, but its environment keeps the variables' own names. */
+const scheduleAnswer = ({ environment, createdAt, ...schedule }, extra) => ({
+    ...snakeKeys(schedule),
+    environment,
+    created_at: createdAt,
+    ...snakeKeys(extra),
+});
+const withWhen = (command) => command
+    .option("--every <duration>", "repeat: 30m, 2h, 1d")
+    .option("--at <HH:MM>", "every day at this local time")
+    .option("--at-time <time>", "one run: 30m, 2d from now, or an ISO time; the schedule removes itself after it");
+/**
+ * Runs the CLI's own commands, or an agent, later or on a timer — through systemd (Linux), launchd
+ * (macOS) or Task Scheduler (Windows). Every timer runs `schedule exec <file>`; the schedule file holds
+ * the rest, so what runs and with which variables is the same on all three.
+ */
+export const scheduleCommandFor = ({ app, context: contextOf }) => {
+    const command = new Command("schedule").description(`run a ${app.command} command or an agent later or on a timer (systemd, launchd, Task Scheduler); an agent cannot send`);
+    const prepare = (self, resolving = {}) => {
+        const context = contextOf(self, resolving);
+        const system = environmentOf(self).system ?? thisMachine();
+        const state = resolvePaths({ appName: app.appName, prefix: app.envPrefix, env: context.env }).state;
+        const say = (value, lines) => renderAnswer(self, context, itemOf(value), () => lines.join("\n"));
+        const timer = () => timerFor(app, system, context.env);
+        // The command line refuses a schedule under the lock; a caller that gets here still passes the lock on.
+        const readOnly = readOnlyLockOf(app, context.env);
+        const environment = () => ({
+            [`${app.envPrefix}_PROFILE`]: context.profile,
+            ...locationVariables(app, context.env),
+            // The timer starts with almost no PATH; an agent runs `max` and its own tools by name.
+            ...(context.env.PATH ? { PATH: context.env.PATH } : {}),
+            ...(readOnly ? { [readOnly]: "1" } : {}),
+        });
+        const save = async (schedule) => {
+            const file = scheduleFile(state, schedule.name);
+            const replaced = existsSync(file);
+            if (replaced) {
+                const owner = readSchedule(file).environment[`${app.envPrefix}_PROFILE`];
+                if (owner && owner !== context.profile) {
+                    throw new CliError("validation_error", `schedule ${schedule.name} already runs for profile ${owner}; name this one for ${context.profile}, e.g. ${schedule.name}-${context.profile}`);
+                }
+            }
+            writeSecurely(file, `${JSON.stringify(schedule, null, 2)}\n`, 0o600);
+            await timer().install(schedule, [...system.entry, "schedule", "exec", file]);
+            say(scheduleAnswer(schedule, { file, timer: timer().where(schedule.name), replaced }), [
+                `${replaced ? "Replaced" : "Added"} ${schedule.name}: ${describeWhen(schedule.when)}.`,
+                `It runs: ${schedule.kind === "agent" ? schedule.argv.join(" ") : `${app.command} ${schedule.argv.join(" ")}`}`,
+                `Output: ${join(dirname(file), "runs")} · now: ${lineOf(self, `schedule run ${schedule.name}`)} · stop: ${lineOf(self, `schedule remove ${schedule.name}`)}`,
+            ]);
+        };
+        return { context, system, state, say, timer, environment, save };
+    };
+    withWhen(grantsAuthority(annotate(command.command("command"), {
+        effects: LOCAL_WRITE,
+        examples: [
+            `${app.command} personal schedule command health --every 1h -- doctor`,
+            `${app.command} personal schedule command morning-check --at 08:00 -- doctor`,
+        ],
+    }))
+        .description(`run ${app.command} <args…> on a timer — reads save what they read, so this is how a chat's history fills the store`)
+        .argument("<name>", "lowercase letters, digits and dashes")
+        .argument("<args...>", `the ${app.command} command after its name, e.g. -- messages list <chat> --limit 50`)).action(async function (name, args) {
+        const { environment, save } = prepare(this);
+        if (args[0] === "schedule")
+            throw new CliError("validation_error", "a schedule cannot run schedule");
+        await save({
+            name: scheduleName(name),
+            kind: "command",
+            argv: args,
+            when: whenOf(this.opts(), COMMAND_MINIMUM_MINUTES),
+            environment: environment(),
+            createdAt: new Date().toISOString(),
+        });
+    });
+    withWhen(grantsAuthority(annotate(command.command("agent"), {
+        effects: LOCAL_WRITE,
+        examples: [
+            `${app.command} personal schedule agent review claude "review what came in overnight and draft replies" --at 08:30`,
+            `${app.command} personal schedule agent triage codex "list what needs an answer today" --every 2h --max-cost 1`,
+        ],
+    }))
+        .description(`start an agent (claude or codex) with a prompt on a timer; it runs with ${app.envPrefix}_READ_ONLY=1, so it reads and drafts and cannot send — its answer is kept and you are notified`)
+        .argument("<name>", "lowercase letters, digits and dashes")
+        .addArgument(new Argument("<harness>", "the agent to start").choices(HARNESSES))
+        .argument("<prompt>", `what to do, e.g. "run the daily follow-up review: ${app.command} skill show follow-ups"`)
+        .addOption(new Option("--max-cost <usd>", "claude only: stop a run that costs more than this, in US dollars").argParser(Number))).action(async function (name, harness, prompt) {
+        const { context, system, environment, save } = prepare(this);
+        const options = this.opts();
+        const program = findProgram(harness, context.env, system.platform);
+        if (!program)
+            throw new CliError("not_found", `${harness} is not on PATH`);
+        const paths = resolvePaths({ appName: app.appName, prefix: app.envPrefix, env: context.env });
+        const argv = harness === "claude"
+            ? [
+                program,
+                "-p",
+                prompt,
+                // The owner's own settings may let every tool run (bypassPermissions); here only the CLI may.
+                "--permission-mode",
+                "dontAsk",
+                "--allowedTools",
+                `Bash(${app.command}:*)`,
+                "--no-session-persistence",
+                ...(options.maxCost ? ["--max-budget-usd", String(options.maxCost)] : []),
+            ]
+            : [
+                program,
+                "exec",
+                "--skip-git-repo-check",
+                "--ephemeral",
+                "--sandbox",
+                "workspace-write",
+                // The CLI reaches the messenger and writes its store and state, and nothing else.
+                "-c",
+                "sandbox_workspace_write.network_access=true",
+                ...[dirname(storePath(context.env)), paths.state, paths.config, paths.cache].flatMap((dir) => [
+                    "--add-dir",
+                    dir,
+                ]),
+                prompt,
+            ];
+        await save({
+            name: scheduleName(name),
+            kind: "agent",
+            argv,
+            when: whenOf(options, AGENT_MINIMUM_MINUTES),
+            environment: environment(),
+            createdAt: new Date().toISOString(),
+        });
+    });
+    withQuery(annotate(command.command("list"), {
+        effects: LOCAL_READ,
+        examples: [`${app.command} personal schedule list`, `${app.command} personal schedule list kind:agent`],
+    }), SCHEDULES_QUERY)
+        .description("the schedules, when they run and how their last run went")
+        .action(function (words) {
+        const filter = scheduleFilter(words);
+        const { context, state } = prepare(this);
+        const rows = listSchedules(state, filter).map((schedule) => ({
+            name: schedule.name,
+            kind: schedule.kind,
+            when: describeWhen(schedule.when),
+            last: lastRun(scheduleFile(state, schedule.name)) ?? null,
+        }));
+        const answer = listOf("schedule list", {
+            items: rows.map((row) => snakeKeys(row)),
+            limit: Math.max(1, rows.length),
+            has_more: false,
+        });
+        renderAnswer(this, context, answer, () => {
+            if (rows.length === 0) {
+                context.renderer.note(`no schedules — \`${lineOf(this, "schedule command|agent")}\` adds one`);
+                return "";
+            }
+            return rows
+                .map(({ name, kind, when, last }) => [
+                name,
+                kind,
+                when,
+                last
+                    ? `last ${last.at.slice(0, 16).replace("T", " ")} exit ${last.exitCode}` +
+                        (last.failures
+                            ? ` — failing since ${(last.failingSince ?? last.at).slice(0, 16).replace("T", " ")}, ` +
+                                `${last.failures} in a row${last.reason ? `: ${last.reason}` : ""} — ${last.output}`
+                            : "")
+                    : "not run yet",
+            ].join("  "))
+                .join("\n");
+        });
+    });
+    annotate(command.command("run"), {
+        effects: REMOTE_WRITE,
+        examples: [`${app.command} personal schedule run health`],
+    })
+        .description("run a schedule now, as its timer would, and wait for it")
+        .argument("<name>", "the schedule's name, as `schedule list` shows it")
+        .action(async function (name) {
+        const { context, system, state, say, timer } = prepare(this);
+        const last = await runSchedule(app, system, context.env, scheduleFile(state, scheduleName(name)), {
+            timer: timer(),
+        });
+        say(snakeKeys({ name, ...last }), [`${name}: exit ${last.exitCode} — ${last.output}`]);
+        if (last.exitCode !== 0)
+            setExitCode(this, 1);
+    });
+    grantsAuthority(annotate(command.command("remove"), {
+        effects: LOCAL_WRITE,
+        examples: [`${app.command} personal schedule remove health`],
+    }))
+        .description("stop a schedule and remove its timer; its past output stays")
+        .argument("<name>", "the schedule's name, as `schedule list` shows it")
+        .action(async function (name) {
+        const { state, say, timer } = prepare(this);
+        const file = scheduleFile(state, scheduleName(name));
+        if (!existsSync(file))
+            throw new CliError("not_found", `no schedule ${name} — \`${lineOf(this, "schedule list")}\``);
+        await timer().remove(name);
+        rmSync(file, { force: true });
+        say({ name, removed: true }, [`Removed ${name}.`]);
+    });
+    annotate(command.command("exec"), {
+        effects: REMOTE_WRITE,
+        examples: [`${app.command} schedule exec ~/.local/share/${app.appName}/schedules/health/schedule.json`],
+    })
+        .description("what a timer runs, given the schedule's file; to run one by hand, use run")
+        .argument("<file>", "the schedule's schedule.json in the state folder, as the timer passes it")
+        .action(async function (file) {
+        // A timer starts it with no profile named; the schedule's own environment carries the profile.
+        const { context, system, timer } = prepare(this, { needsProfile: false });
+        const last = await runSchedule(app, system, context.env, file, { timer: timer() });
+        if (last.exitCode !== 0)
+            setExitCode(this, 1);
+    });
+    return command;
+};

package/dist/cli/shared-command-exports.d.ts

@@ -765,7 +765,7 @@ export declare const stickersCommand: (messenger: import("./index.js").Messenger
 export declare const repliesCommand: (messenger: import("./index.js").Messenger) => import("commander").Command;
 export declare const reviewCommand: (messenger: import("./index.js").Messenger) => import("commander").Command;
 export declare const scheduleCommand: (messenger: import("./index.js").Messenger) => import("commander").Command;
-export declare const scheduleCommandFor: (args_0: import("./messenger/schedule-command.js").ScheduleHost) => import("commander").Command;
+export declare const scheduleCommandFor: (args_0: import("./schedule/schedule-command.js").ScheduleHost) => import("commander").Command;
 export declare const searchCommand: (messenger: import("./index.js").Messenger, args_1?: {
     topics?: boolean;
 } | undefined) => import("commander").Command;

package/dist/cli/shared-command-exports.js

@@ -41,7 +41,7 @@ import { reactionsCommand as reactionsCommandDefinition } from "./messenger/reac
 import { callsCommand as callsCommandDefinition, stickersCommand as stickersCommandDefinition, } from "./messenger/records-command.js";
 import { repliesCommand as repliesCommandDefinition } from "./messenger/replies-command.js";
 import { reviewCommand as reviewCommandDefinition } from "./messenger/review.js";
-import { scheduleCommand as scheduleCommandDefinition, scheduleCommandFor as scheduleCommandForDefinition, } from "./messenger/schedule-command.js";
+import { scheduleCommand as scheduleCommandDefinition } from "./messenger/schedule-command.js";
 import { searchCommand as searchCommandDefinition } from "./messenger/search-command.js";
 import { searchesCommand as searchesCommandDefinition } from "./messenger/searches-command.js";
 import { serveCommand as serveCommandDefinition } from "./messenger/serve-command.js";
@@ -52,6 +52,7 @@ import { tasksCommand as tasksCommandDefinition, tasksStatsCommand as tasksStats
 import { topicsCommand as topicsCommandDefinition } from "./messenger/topics-command.js";
 import { watchCommand as watchCommandDefinition } from "./messenger/watch-command.js";
 import { runsCommand as runsCommandDefinition } from "./runs/command.js";
+import { scheduleCommandFor as scheduleCommandForDefinition } from "./schedule/schedule-command.js";
 import { sharedCommand as protectedCommand } from "./shared-contracts.js";
 import { skillCommand as skillCommandDefinition } from "./skill-command.js";
 import { upgradeCommand as upgradeCommandDefinition } from "./upgrade-command.js";

package/dist/domain/models.d.ts

@@ -608,6 +608,8 @@ export interface TopicChange {
     pinned?: boolean;
     /** Only a forum's General topic can be hidden from the topic list. */
     hidden?: boolean;
+    /** An emoji from the messenger's topic icon set; `null` removes the icon. */
+    icon?: string | null;
 }
 /** Someone who asked to join a group or channel that needs an admin's approval. */
 export interface JoinRequest {

package/dist/entities/index.d.ts

@@ -40,7 +40,7 @@ import { inviteLink } from "./invite-link.js";
 import { job } from "./job.js";
 import { joinRequest } from "./join-request.js";
 import { organization, project, reminder } from "./knowledge-lists.js";
-import { botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, callRecord, scheduledJob, stickerInventory } from "./list-results.js";
+import { botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, callRecord, scheduledJob, stickerInventory, topicIcon } from "./list-results.js";
 import { messageEvent, serveSummary, watchedMessage, watchItem } from "./listener.js";
 import { mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer } from "./media-archive.js";
 import { meeting } from "./meeting.js";
@@ -88,7 +88,7 @@ import { topic } from "./topic.js";
  * subset of its fields, never a renamed one. Commands move onto these one by one; until then, a schema
  * is the target, not a description of today's output.
  */
-export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, organization, person, place, poll, pollChange, pollVote, project, ranking, reaction, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, reminder, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, storeTable, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
+export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, organization, person, place, poll, pollChange, pollVote, project, ranking, reaction, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, reminder, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, storeTable, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, topicIcon, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
 export declare const ENTITIES: {
     readonly meeting_ingestion: v.StrictObjectSchema<{
         readonly meetings: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -4441,6 +4441,9 @@ export declare const ENTITIES: {
         readonly name: v.StringSchema<undefined>;
         readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>;
+    readonly topic_icon: v.StrictObjectSchema<{
+        readonly emoji: v.StringSchema<undefined>;
+    }, undefined>;
     readonly bot_webhook: v.StrictObjectSchema<{
         readonly url: v.StringSchema<undefined>;
         readonly types: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
@@ -4763,6 +4766,12 @@ export declare const ENTITIES: {
         readonly project: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly project_key: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly project_name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly created_by: v.OptionalSchema<v.NullableSchema<v.StrictObjectSchema<{
+            readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly account: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly chat: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;
         readonly source_message: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;
@@ -4833,6 +4842,12 @@ export declare const ENTITIES: {
         readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly project_key: v.StringSchema<undefined>;
         readonly project_name: v.StringSchema<undefined>;
+        readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+            readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
         readonly title: v.StringSchema<undefined>;
         readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -4939,6 +4954,12 @@ export declare const ENTITIES: {
             readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
             readonly project_key: v.StringSchema<undefined>;
             readonly project_name: v.StringSchema<undefined>;
+            readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+                readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+                readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly owner: v.BooleanSchema<undefined>;
+            }, undefined>, undefined>;
             readonly title: v.StringSchema<undefined>;
             readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -5046,6 +5067,12 @@ export declare const ENTITIES: {
         readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly project_key: v.StringSchema<undefined>;
         readonly project_name: v.StringSchema<undefined>;
+        readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+            readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
         readonly title: v.StringSchema<undefined>;
         readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -5181,6 +5208,12 @@ export declare const ENTITIES: {
             readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
             readonly project_key: v.StringSchema<undefined>;
             readonly project_name: v.StringSchema<undefined>;
+            readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+                readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+                readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly owner: v.BooleanSchema<undefined>;
+            }, undefined>, undefined>;
             readonly title: v.StringSchema<undefined>;
             readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -5281,6 +5314,12 @@ export declare const ENTITIES: {
             readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
             readonly project_key: v.StringSchema<undefined>;
             readonly project_name: v.StringSchema<undefined>;
+            readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+                readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+                readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly owner: v.BooleanSchema<undefined>;
+            }, undefined>, undefined>;
             readonly title: v.StringSchema<undefined>;
             readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;

package/dist/entities/index.js

@@ -42,7 +42,7 @@ import { inviteLink } from "./invite-link.js";
 import { job } from "./job.js";
 import { joinRequest } from "./join-request.js";
 import { organization, project, reminder } from "./knowledge-lists.js";
-import { botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, callRecord, scheduledJob, stickerInventory, } from "./list-results.js";
+import { botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, callRecord, scheduledJob, stickerInventory, topicIcon, } from "./list-results.js";
 import { messageEvent, serveSummary, watchedMessage, watchItem } from "./listener.js";
 import { mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer } from "./media-archive.js";
 import { event, meeting, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "./meeting.js";
@@ -94,7 +94,7 @@ import { topic } from "./topic.js";
  * subset of its fields, never a renamed one. Commands move onto these one by one; until then, a schema
  * is the target, not a description of today's output.
  */
-export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, organization, person, place, poll, pollChange, pollVote, project, ranking, reaction, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, reminder, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, storeTable, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
+export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, organization, person, place, poll, pollChange, pollVote, project, ranking, reaction, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, reminder, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, storeTable, tagChange, tagging, task, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, topicIcon, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
 export const ENTITIES = {
     sync_progress: syncProgress,
     ...MEETING_RESULT_ENTITIES,
@@ -183,6 +183,7 @@ export const ENTITIES = {
     bot_seen_chat: botSeenChat,
     bot_admin: botAdmin,
     bot_menu_entry: botMenuEntry,
+    topic_icon: topicIcon,
     bot_webhook: botWebhook,
     scheduled_job: scheduledJob,
     call_record: callRecord,

package/dist/entities/list-results.d.ts

@@ -37,6 +37,9 @@ export declare const botMenuEntry: v.StrictObjectSchema<{
     readonly name: v.StringSchema<undefined>;
     readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
 }, undefined>;
+export declare const topicIcon: v.StrictObjectSchema<{
+    readonly emoji: v.StringSchema<undefined>;
+}, undefined>;
 export declare const botWebhook: v.StrictObjectSchema<{
     readonly url: v.StringSchema<undefined>;
     readonly types: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;

package/dist/entities/list-results.js

@@ -26,6 +26,7 @@ export const botAdmin = v.strictObject({
     title: v.nullable(text),
 });
 export const botMenuEntry = v.strictObject({ name: text, description: v.nullable(text) });
+export const topicIcon = v.strictObject({ emoji: text });
 export const botWebhook = v.strictObject({ url: text, types: v.optional(v.array(text)) });
 export const scheduledJob = v.strictObject({
     name: text,

package/dist/entities/task-results.d.ts

@@ -6,6 +6,12 @@ export declare const taskCard: v.StrictObjectSchema<{
     readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
     readonly project_key: v.StringSchema<undefined>;
     readonly project_name: v.StringSchema<undefined>;
+    readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+        readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly owner: v.BooleanSchema<undefined>;
+    }, undefined>, undefined>;
     readonly title: v.StringSchema<undefined>;
     readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -112,6 +118,12 @@ export declare const taskCreated: v.StrictObjectSchema<{
         readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly project_key: v.StringSchema<undefined>;
         readonly project_name: v.StringSchema<undefined>;
+        readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+            readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
         readonly title: v.StringSchema<undefined>;
         readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -219,6 +231,12 @@ export declare const taskLinks: v.UnionSchema<[v.StrictObjectSchema<{
     readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
     readonly project_key: v.StringSchema<undefined>;
     readonly project_name: v.StringSchema<undefined>;
+    readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+        readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly owner: v.BooleanSchema<undefined>;
+    }, undefined>, undefined>;
     readonly title: v.StringSchema<undefined>;
     readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -354,6 +372,12 @@ export declare const taskMerge: v.StrictObjectSchema<{
         readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly project_key: v.StringSchema<undefined>;
         readonly project_name: v.StringSchema<undefined>;
+        readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+            readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
         readonly title: v.StringSchema<undefined>;
         readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -454,6 +478,12 @@ export declare const taskUnmerge: v.StrictObjectSchema<{
         readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly project_key: v.StringSchema<undefined>;
         readonly project_name: v.StringSchema<undefined>;
+        readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+            readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
         readonly title: v.StringSchema<undefined>;
         readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;

package/dist/entities/task-results.js

@@ -27,6 +27,7 @@ export const taskCard = v.strictObject({
     project: reference,
     project_key: text,
     project_name: text,
+    created_by: v.nullable(v.strictObject({ type: v.picklist(["person", "bot"]), id, name: v.nullable(text), owner: v.boolean() })),
     title: text,
     description: v.nullable(text),
     type: v.picklist(TASK_TYPES),

package/dist/entities/task.d.ts

@@ -22,6 +22,13 @@ export declare const task: v.StrictObjectSchema<{
     /** The project's key and name, as `tasks counts` names it. */
     readonly project_key: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly project_name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** Who added it: the owner, or an agent by its bot name. */
+    readonly created_by: v.OptionalSchema<v.NullableSchema<v.StrictObjectSchema<{
+        readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly owner: v.BooleanSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
     readonly account: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     /** The chat it came from, as a `chat:` reference. */
     readonly chat: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;

package/dist/entities/task.js

@@ -25,6 +25,8 @@ export const task = v.strictObject({
     /** The project's key and name, as `tasks counts` names it. */
     project_key: v.optional(v.nullable(text)),
     project_name: v.optional(v.nullable(text)),
+    /** Who added it: the owner, or an agent by its bot name. */
+    created_by: v.optional(v.nullable(v.strictObject({ type: v.picklist(["person", "bot"]), id, name: v.nullable(text), owner: v.boolean() }))),
     account: v.optional(text),
     /** The chat it came from, as a `chat:` reference. */
     chat: v.optional(v.nullable(reference)),

package/dist/errors/reasons.js

@@ -133,6 +133,7 @@ const OTHERS = [
     ["task.stale", "configuration_error", "the task changed since it was read; read it again"],
     validation("task.column", "the task beside which it moves is in another column than the status asked for"),
     validation("task.dependency-cycle", "the task would depend on itself"),
+    validation("task.has-subtasks", "the task has subtasks; move or detach them before it moves to another project"),
     validation("task.duplicate-candidates", "open tasks may be the same job: attach to one, or add it as new"),
     validation("task.certainty-required", "an agent closes a task with its certainty, 0 to 1"),
     ["task.pair-decided", "permission_error", "the owner already decided the pair; an agent does not change it"],

package/dist/mail/account-key.d.ts

@@ -0,0 +1,2 @@
+import type { AccountKey } from "../store/index.js";
+export declare const mailAccountKey: (address: string) => AccountKey;

package/dist/mail/account-key.js

@@ -0,0 +1 @@
+export const mailAccountKey = (address) => ({ provider: "email", account: address.toLowerCase() });