toolroll 0.9.32 → 0.9.34

package/dist/surface.js

@@ -81,8 +81,14 @@ export const COMMAND_GUIDE = [
     operator('conversation read', 'explicitly record your read position at --message within --conversation'),
     operator('conversation follow', 'enable or pause automatic lead summaries with --conversation and --enabled true|false, within the existing paid chat authorization; passive chat --follow only reads updates'),
     operator('conversation stop', 'request stopping the exact --message in --conversation; retain uncertain work until its owner settles it'),
-    operator("repos add", "connect a repository to the installation"),
-    operator("repos remove", "disconnect a repository"),
+    { invocation: "repos add", synopsis: "add a project: a Git repository, in the console at once; the lead adds with its token", audience: "agent", agentMayInvoke: true, mutation: "identity-idempotent",
+        positionals: [{ name: "path", required: false, meaning: "the repository (default: the one you are in)" }],
+        flags: [jsonFlag, { name: "token", takesValue: true, meaning: "the lead token (or TOOLROLL_LEAD_TOKEN)" }],
+        notableReasons: ["not-git", "unavailable", "refused", "locked"] },
+    { invocation: "repos remove", synopsis: "remove a project from the console and the builder; its tasks and results stay saved", audience: "agent", agentMayInvoke: true, mutation: "identity-idempotent",
+        positionals: [{ name: "path", required: true, meaning: "the repository" }],
+        flags: [jsonFlag, { name: "token", takesValue: true, meaning: "the lead token (or TOOLROLL_LEAD_TOKEN)" }],
+        notableReasons: ["refused", "locked"] },
     operator("repos add-from-github", "preview, clone from GitHub, and connect - the console onboarding ceremony as a CLI verb"),
     { invocation: "contract", synopsis: "the machine contract: envelope version + capability tokens; --commands dumps this guide", audience: "agent", agentMayInvoke: true, mutation: "none",
         flags: [jsonFlag, { name: "commands", takesValue: false, meaning: "dump the declared command guide" }] },
@@ -114,7 +120,7 @@ export const COMMAND_GUIDE = [
         mutation: spec.mutation ? 'keyed' : 'none', inputSchema: spec.inputSchema,
         flags: Object.entries(sessionCliFlags(spec)).map(([name, arity]) => ({ name, takesValue: arity === 'value', meaning: name === 'key' ? 'keep the same key when reconciling; inspect after unknown delivery, never blind-retry' : `see session ${spec.operation} --help` })),
     })),
-    ...KNOWLEDGE_DESCRIPTORS.map(spec => ({ invocation: `knowledge ${spec.action}`, synopsis: spec.synopsis, audience: "agent", agentMayInvoke: true, mutation: spec.mutation, flags: spec.flags, ...(spec.takesQuery ? { positionals: [{ name: "query", required: true, meaning: "search text or source file for impact" }] } : {}) })),
+    ...KNOWLEDGE_DESCRIPTORS.map(spec => ({ invocation: `knowledge ${spec.action}`, synopsis: spec.synopsis, audience: "audience" in spec ? spec.audience : "agent", agentMayInvoke: !("audience" in spec), mutation: spec.mutation, flags: spec.flags, ...(spec.takesQuery ? { positionals: [{ name: "query", required: true, meaning: "search text or source file for impact" }] } : {}) })),
     ...MEMORY_DESCRIPTORS.map(spec => ({ invocation: `memory ${spec.action}`, synopsis: spec.synopsis, audience: "agent", agentMayInvoke: true, mutation: spec.mutation, flags: spec.flags, ...(spec.takesQuery ? { positionals: [{ name: "query", required: true, meaning: "search text, a decision id, or the decision sentence" }] } : {}) })),
     // Flow writes carry an approver's credential: an agent runs them only as the person asked, after showing the preview.
     ...FLOWS_DESCRIPTORS.map(spec => ({ invocation: `flows ${spec.action}`, synopsis: spec.synopsis, audience: "agent", agentMayInvoke: true, mutation: spec.mutation, flags: spec.flags,

package/dist/text-limits.d.ts

@@ -20,7 +20,24 @@ export declare const TEXT_LIMITS: {
     readonly reportSummary: 2500;
     /** What one flow step passes on to the steps after it. */
     readonly stageOutput: 12000;
+    /** The planner's whole handoff file, in UTF-8 bytes. */
+    readonly planPayloadBytes: number;
+    /** The plan document (markdown), in UTF-8 bytes. */
+    readonly planDocumentBytes: number;
+    /** The plan document's Approach section. */
+    readonly planApproach: 2000;
+    /** One Milestones, Dependencies, Risks or Proof item in the plan document. */
+    readonly planItem: 600;
+    /** One path a plan expects to touch. */
+    readonly planTouch: 200;
+    /** A planner's amendment note: why the filed contract must change. */
+    readonly planAmendment: 1000;
+    /** An acceptance criterion's id, statement and advisory how, in UTF-8 bytes. */
+    readonly acceptanceIdBytes: 40;
+    readonly acceptanceStatementBytes: 1000;
+    readonly acceptanceHowBytes: 500;
 };
+export type TextLimitKey = keyof typeof TEXT_LIMITS;
 /** One chat message on each platform. Longer text is split across messages, never cut. Teams: the text one Adaptive Card
  * holds, well inside its 28 KB message. */
 export declare const PLATFORM_LIMITS: {

package/dist/text-limits.js

@@ -20,6 +20,22 @@ export const TEXT_LIMITS = {
     reportSummary: 2_500,
     /** What one flow step passes on to the steps after it. */
     stageOutput: 12_000,
+    /** The planner's whole handoff file, in UTF-8 bytes. */
+    planPayloadBytes: 64 * 1024,
+    /** The plan document (markdown), in UTF-8 bytes. */
+    planDocumentBytes: 16 * 1024,
+    /** The plan document's Approach section. */
+    planApproach: 2_000,
+    /** One Milestones, Dependencies, Risks or Proof item in the plan document. */
+    planItem: 600,
+    /** One path a plan expects to touch. */
+    planTouch: 200,
+    /** A planner's amendment note: why the filed contract must change. */
+    planAmendment: 1_000,
+    /** An acceptance criterion's id, statement and advisory how, in UTF-8 bytes. */
+    acceptanceIdBytes: 40,
+    acceptanceStatementBytes: 1_000,
+    acceptanceHowBytes: 500,
 };
 /** One chat message on each platform. Longer text is split across messages, never cut. Teams: the text one Adaptive Card
  * holds, well inside its 28 KB message. */

package/dist/when-html.d.ts

@@ -10,6 +10,8 @@ export declare function deadlineWords(deadline: {
     at: string;
     label: string;
 }, now?: Date, zone?: string): string;
+/** How long ago, in one short mark: "now", "4m", "2h", "3d". A future stamp reads "now"; an unreadable one, "". */
+export declare function shortAge(iso: string, now?: Date): string;
 /** The exact minute in `zone` ("2026-09-30 16:39", with " UTC" when it is UTC): a time's title, one hover away. */
 export declare function fullWhen(iso: string, zone?: string): string;
 /** Every server-rendered stamp (`whenHtml`'s `<time data-when>`) inside `root`, reworded by the one formatter in the

package/dist/when-html.js

@@ -66,6 +66,19 @@ export function deadlineWords(deadline, now = new Date(), zone = viewerZone()) {
     const words = shortWhen(deadline.at, now, zone, true);
     return /^(?:\d|Tomorrow|Yesterday)/.test(words) ? `${deadline.label} ${words}` : `${deadline.label.replace(/ at$/, "")} ${words}`;
 }
+/** How long ago, in one short mark: "now", "4m", "2h", "3d". A future stamp reads "now"; an unreadable one, "". */
+export function shortAge(iso, now = new Date()) {
+    const at = new Date(iso).getTime();
+    if (Number.isNaN(at))
+        return "";
+    const minutes = Math.max(0, Math.floor((now.getTime() - at) / 60_000));
+    if (minutes < 1)
+        return "now";
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    return hours < 24 ? `${hours}h` : `${Math.floor(hours / 24)}d`;
+}
 /** The exact minute in `zone` ("2026-09-30 16:39", with " UTC" when it is UTC): a time's title, one hover away. */
 export function fullWhen(iso, zone = "UTC") {
     const at = new Date(iso);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolroll",
-  "version": "0.9.32",
+  "version": "0.9.34",
   "description": "A control plane for unattended coding agents — queue tasks, walk away, come back to pull requests. Agents build in leased worktrees, never touch your default branch, and interrupt you only for decisions that need a human.",
   "directories": {
     "doc": "docs"
@@ -120,6 +120,7 @@
     "tailwind-merge": "3.7.0",
     "typescript-parser": "npm:typescript@6.0.3",
     "use-stick-to-bottom": "1.1.6",
-    "yaml": "2.9.1"
+    "yaml": "2.9.1",
+    "zod": "^4.6.5"
   }
 }