toolroll 0.9.34 → 0.9.37

package/dist/contracts/lead-context.d.ts

@@ -0,0 +1,165 @@
+/**
+ * The lead's catch-up bundle (lead-context.ts): one schema for the DATA each lead turn opens with, built fresh from the
+ * local database, in order of importance. The bundle is checked before it is scrubbed and serialized; its whole size
+ * (TEXT_LIMITS.leadContextBytes, in UTF-8 bytes) is met in plain code after, by dropping the least important parts.
+ */
+import { z } from "zod";
+/** How many tasks the bundle reads, projects it names, and open promises, corrections and proposals it shows. */
+export declare const LEAD_CONTEXT_COUNTS: {
+    readonly tasks: 8;
+    readonly projects: 8;
+    readonly promises: 10;
+    readonly corrections: 5;
+    readonly proposals: 5;
+};
+export declare const LEAD_CHANNELS: readonly ["console", "terminal", "telegram", "slack", "discord", "teams"];
+/** A task as the lead reads it: which project (`r1`...), its ids, state, goal, outcome, checks, the next action and
+ * the questions still open on it. */
+export declare const leadTaskSchema: z.ZodObject<{
+    repo: z.ZodString;
+    id: z.ZodString;
+    currentExecution: z.ZodString;
+    title: z.ZodString;
+    state: z.ZodString;
+    goal: z.ZodNullable<z.ZodString>;
+    outcome: z.ZodNullable<z.ZodString>;
+    checks: z.ZodNullable<z.ZodString>;
+    next: z.ZodNullable<z.ZodString>;
+    decisions: z.ZodArray<z.ZodObject<{
+        id: z.ZodInt;
+        question: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** The lead's own open promise in this conversation, and when it is due. */
+export declare const leadPromiseSchema: z.ZodObject<{
+    id: z.ZodInt;
+    what: z.ZodString;
+    when: z.ZodString;
+    expires: z.ZodString;
+}, z.core.$strict>;
+/** A correction the operator confirmed since the lead's last reply. */
+export declare const leadCorrectionSchema: z.ZodObject<{
+    proposal: z.ZodInt;
+    change: z.ZodString;
+}, z.core.$strict>;
+/** A proposal still open in this conversation, which a correction may affect. */
+export declare const leadOpenProposalSchema: z.ZodObject<{
+    proposal: z.ZodInt;
+    kind: z.ZodString;
+    about: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const LEAD_CONTEXT_VERSION = 3;
+export declare const leadContextSchema: z.ZodObject<{
+    snapshotVersion: z.ZodLiteral<3>;
+    source: z.ZodLiteral<"local-database">;
+    me: z.ZodObject<{
+        name: z.ZodString;
+        persona: z.ZodString;
+    }, z.core.$strict>;
+    you: z.ZodObject<{
+        firstName: z.ZodNullable<z.ZodString>;
+        timeZone: z.ZodString;
+        today: z.ZodString;
+    }, z.core.$strict>;
+    aboutYou: z.ZodArray<z.ZodString>;
+    people: z.ZodObject<{
+        people: z.ZodArray<z.ZodString>;
+        teammates: z.ZodArray<z.ZodString>;
+        teams: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    channel: z.ZodNullable<z.ZodObject<{
+        id: z.ZodEnum<{
+            console: "console";
+            discord: "discord";
+            slack: "slack";
+            teams: "teams";
+            telegram: "telegram";
+            terminal: "terminal";
+        }>;
+        fit: z.ZodString;
+        replyLimit: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>>;
+    needsYou: z.ZodArray<z.ZodObject<{
+        repo: z.ZodString;
+        id: z.ZodString;
+        currentExecution: z.ZodString;
+        title: z.ZodString;
+        state: z.ZodString;
+        goal: z.ZodNullable<z.ZodString>;
+        outcome: z.ZodNullable<z.ZodString>;
+        checks: z.ZodNullable<z.ZodString>;
+        next: z.ZodNullable<z.ZodString>;
+        decisions: z.ZodArray<z.ZodObject<{
+            id: z.ZodInt;
+            question: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    commitments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodInt;
+        what: z.ZodString;
+        when: z.ZodString;
+        expires: z.ZodString;
+    }, z.core.$strict>>>;
+    corrections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        proposal: z.ZodInt;
+        change: z.ZodString;
+    }, z.core.$strict>>>;
+    openProposals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        proposal: z.ZodInt;
+        kind: z.ZodString;
+        about: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>>;
+    followThrough: z.ZodOptional<z.ZodString>;
+    projects: z.ZodArray<z.ZodObject<{
+        repo: z.ZodString;
+        name: z.ZodString;
+        decisions: z.ZodArray<z.ZodObject<{
+            id: z.ZodInt;
+            title: z.ZodString;
+            why: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    rest: z.ZodObject<{
+        tasks: z.ZodArray<z.ZodObject<{
+            repo: z.ZodString;
+            id: z.ZodString;
+            currentExecution: z.ZodString;
+            title: z.ZodString;
+            state: z.ZodString;
+            goal: z.ZodNullable<z.ZodString>;
+            outcome: z.ZodNullable<z.ZodString>;
+            checks: z.ZodNullable<z.ZodString>;
+            next: z.ZodNullable<z.ZodString>;
+            decisions: z.ZodArray<z.ZodObject<{
+                id: z.ZodInt;
+                question: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        knowledge: z.ZodArray<z.ZodObject<{
+            repo: z.ZodString;
+            status: z.ZodEnum<{
+                none: "none";
+                stored: "stored";
+                unavailable: "unavailable";
+            }>;
+            revision: z.ZodNullable<z.ZodInt>;
+            instructions: z.ZodString;
+            sources: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    omissions: z.ZodObject<{
+        assignments: z.ZodInt;
+        decisions: z.ZodInt;
+        projects: z.ZodInt;
+        textFields: z.ZodInt;
+        candidateScanLimited: z.ZodBoolean;
+        notes: z.ZodArray<z.ZodString>;
+        people: z.ZodInt;
+    }, z.core.$strict>;
+    notice: z.ZodString;
+}, z.core.$strict>;
+export type LeadContextBundle = z.infer<typeof leadContextSchema>;
+export type LeadChannel = (typeof LEAD_CHANNELS)[number];

package/dist/contracts/lead-context.js

@@ -0,0 +1,73 @@
+/**
+ * The lead's catch-up bundle (lead-context.ts): one schema for the DATA each lead turn opens with, built fresh from the
+ * local database, in order of importance. The bundle is checked before it is scrubbed and serialized; its whole size
+ * (TEXT_LIMITS.leadContextBytes, in UTF-8 bytes) is met in plain code after, by dropping the least important parts.
+ */
+import { z } from "zod";
+import { limited } from "./contract.js";
+/** How many tasks the bundle reads, projects it names, and open promises, corrections and proposals it shows. */
+export const LEAD_CONTEXT_COUNTS = { tasks: 8, projects: 8, promises: 10, corrections: 5, proposals: 5 };
+export const LEAD_CHANNELS = ["console", "terminal", "telegram", "slack", "discord", "teams"];
+/** A task as the lead reads it: which project (`r1`...), its ids, state, goal, outcome, checks, the next action and
+ * the questions still open on it. */
+export const leadTaskSchema = z.strictObject({
+    repo: z.string(),
+    id: z.string(),
+    currentExecution: z.string(),
+    title: z.string(),
+    state: z.string(),
+    goal: z.string().nullable(),
+    outcome: z.string().nullable(),
+    checks: z.string().nullable(),
+    next: z.string().nullable(),
+    decisions: z.array(z.strictObject({ id: z.int(), question: z.string() })),
+});
+/** The lead's own open promise in this conversation, and when it is due. */
+export const leadPromiseSchema = z.strictObject({ id: z.int(), what: limited("promise", "leadPromise"), when: z.string(), expires: z.string() });
+/** A correction the operator confirmed since the lead's last reply. */
+export const leadCorrectionSchema = z.strictObject({ proposal: z.int(), change: limited("correction", "leadCorrection") });
+/** A proposal still open in this conversation, which a correction may affect. */
+export const leadOpenProposalSchema = z.strictObject({ proposal: z.int(), kind: z.string(), about: limited("about", "leadProposalAbout").nullable() });
+export const LEAD_CONTEXT_VERSION = 3;
+export const leadContextSchema = z.strictObject({
+    snapshotVersion: z.literal(LEAD_CONTEXT_VERSION),
+    source: z.literal("local-database"),
+    me: z.strictObject({ name: z.string(), persona: z.string() }),
+    you: z.strictObject({ firstName: z.string().nullable(), timeZone: z.string(), today: z.string() }),
+    /** Lines the person confirmed about themselves. */
+    aboutYou: z.array(z.string()),
+    /** The people, AI teammates and team chats the lead works with, one line each. */
+    people: z.strictObject({ people: z.array(z.string()), teammates: z.array(z.string()), teams: z.array(z.string()) }),
+    channel: z.strictObject({ id: z.enum(LEAD_CHANNELS), fit: z.string(), replyLimit: z.int().nullable() }).nullable(),
+    needsYou: z.array(leadTaskSchema),
+    /** This conversation's follow-through; absent outside one. */
+    commitments: z.array(leadPromiseSchema).max(LEAD_CONTEXT_COUNTS.promises).optional(),
+    corrections: z.array(leadCorrectionSchema).max(LEAD_CONTEXT_COUNTS.corrections).optional(),
+    openProposals: z.array(leadOpenProposalSchema).max(LEAD_CONTEXT_COUNTS.proposals).optional(),
+    followThrough: z.string().optional(),
+    projects: z.array(z.strictObject({
+        repo: z.string(),
+        name: z.string(),
+        decisions: z.array(z.strictObject({ id: z.int(), title: z.string(), why: z.string() })),
+    })).max(LEAD_CONTEXT_COUNTS.projects),
+    rest: z.strictObject({
+        tasks: z.array(leadTaskSchema),
+        knowledge: z.array(z.strictObject({
+            repo: z.string(),
+            status: z.enum(["stored", "none", "unavailable"]),
+            revision: z.int().nullable(),
+            instructions: z.string(),
+            sources: z.array(z.strictObject({ id: z.string(), title: z.string() })),
+        })),
+    }),
+    omissions: z.strictObject({
+        assignments: z.int(),
+        decisions: z.int(),
+        projects: z.int(),
+        textFields: z.int(),
+        candidateScanLimited: z.boolean(),
+        notes: z.array(z.string()),
+        people: z.int(),
+    }),
+    notice: z.string(),
+});