@bryti/agent 0.0.1 → 0.1.0

package/dist/projection/tools.js

@@ -0,0 +1,237 @@
+/**
+ * Projection tools: create, list, resolve, and link projections.
+ */
+import { Type } from "@sinclair/typebox";
+// ---------------------------------------------------------------------------
+// Tool schemas
+// ---------------------------------------------------------------------------
+const projectSchema = Type.Object({
+    summary: Type.String({ description: "One-line description of the future event or expectation" }),
+    when: Type.Optional(Type.String({
+        description: "When this is expected to happen. Use a specific ISO datetime for exact events " +
+            "(e.g. '2026-02-19T10:00'). IMPORTANT: always express times in UTC. " +
+            "If the user said '13:45' in their local timezone, convert to UTC before storing. " +
+            "Use a date string for day-resolution (e.g. '2026-02-19'), " +
+            "'someday' for no specific time, or a natural phrase if UTC conversion is not possible.",
+    })),
+    resolution: Type.Optional(Type.Union([
+        Type.Literal("exact"),
+        Type.Literal("day"),
+        Type.Literal("week"),
+        Type.Literal("month"),
+        Type.Literal("someday"),
+    ], { description: "Granularity of the time expression: exact | day | week | month | someday" })),
+    recurrence: Type.Optional(Type.String({
+        description: "Cron expression for repeating events. " +
+            "Use standard 5-field cron syntax (minute hour day month weekday). " +
+            "Examples: '0 9 * * 1' (every Monday at 09:00 UTC), '0 9 1 * *' (first of each month at 09:00 UTC), " +
+            "'0 9 * * 5' (every Friday at 09:00 UTC). " +
+            "Only set this for genuinely recurring events. Leave unset for one-off events.",
+    })),
+    trigger_on_fact: Type.Optional(Type.String({
+        description: "Keyword or short phrase that will activate this projection when a matching fact is archived. " +
+            "Use for 'when X happens, do Y' situations where X is an external event, not a time. " +
+            "Example: 'dentist confirmed' activates a projection when the user archives a fact containing those words. " +
+            "Keep it short and distinctive. Leave unset for time-driven projections.",
+    })),
+    context: Type.Optional(Type.String({
+        description: "Optional notes: related events, implications, what to watch for",
+    })),
+    linked_ids: Type.Optional(Type.Array(Type.String(), {
+        description: "IDs of related projections",
+    })),
+    depends_on: Type.Optional(Type.Array(Type.Object({
+        projection_id: Type.String({ description: "Projection id this new projection depends on" }),
+        condition: Type.String({ description: "Condition to satisfy (e.g. done, cancelled, or natural language)" }),
+        condition_type: Type.Optional(Type.Union([
+            Type.Literal("status_change"),
+            Type.Literal("llm"),
+        ])),
+    }), {
+        description: "Optional dependency rules that must be met before this projection activates",
+    })),
+});
+const getProjectionsSchema = Type.Object({
+    horizon_days: Type.Optional(Type.Number({
+        description: "How many days ahead to look (default: 7). Always includes someday items.",
+    })),
+});
+const resolveProjectionSchema = Type.Object({
+    id: Type.String({ description: "Projection ID to resolve" }),
+    outcome: Type.Union([
+        Type.Literal("done"),
+        Type.Literal("cancelled"),
+        Type.Literal("passed"),
+    ], { description: "How the projection resolved: done | cancelled | passed" }),
+});
+const linkProjectionSchema = Type.Object({
+    observer_id: Type.String({ description: "Projection that waits for a condition" }),
+    subject_id: Type.String({ description: "Projection being observed" }),
+    condition: Type.String({ description: "Condition to satisfy (e.g. done, cancelled, or natural language)" }),
+    condition_type: Type.Optional(Type.Union([
+        Type.Literal("status_change"),
+        Type.Literal("llm"),
+    ])),
+});
+// ---------------------------------------------------------------------------
+// Tool factory
+// ---------------------------------------------------------------------------
+/**
+ * Convert a naive local datetime to UTC ("YYYY-MM-DD HH:MM"). Strings with
+ * explicit offsets are normalized; no timezone means returned unchanged.
+ */
+function toUtcDatetime(naive, timezone) {
+    if (!timezone)
+        return naive.replace("T", " ");
+    // If it already carries offset info, just normalise separator and return
+    if (/[Z+\-]\d{2}:?\d{2}$/.test(naive) || naive.endsWith("Z")) {
+        return naive.replace("T", " ");
+    }
+    // Parse as local time in the given timezone using the Temporal-free approach:
+    // construct an ISO string with the timezone, let Date parse it via toLocaleString trick.
+    // We use the "sv-SE" locale which gives YYYY-MM-DD HH:MM:SS format.
+    const normalized = naive.replace(" ", "T");
+    // Append seconds if missing so Date can parse it
+    const withSeconds = /T\d{2}:\d{2}$/.test(normalized) ? normalized + ":00" : normalized;
+    // Parse as if it were UTC, then compute the offset for the target timezone
+    const asUtcDate = new Date(withSeconds + "Z");
+    // Get what the target timezone thinks this UTC moment is
+    const localStr = asUtcDate.toLocaleString("sv-SE", { timeZone: timezone, hour12: false });
+    // localStr is YYYY-MM-DD HH:MM:SS - compare to our input to find the offset
+    const localParsed = new Date(localStr.replace(" ", "T") + "Z");
+    // offset in ms: localParsed - asUtcDate (positive = ahead of UTC)
+    const offsetMs = localParsed.getTime() - asUtcDate.getTime();
+    // The actual UTC time = input local time - offset
+    const inputLocal = new Date(withSeconds + "Z");
+    const utcTime = new Date(inputLocal.getTime() - offsetMs);
+    return utcTime.toISOString().slice(0, 16).replace("T", " ");
+}
+/**
+ * Create projection tools. When timezone is set, naive datetimes from the
+ * agent are converted to UTC before storage.
+ */
+export function createProjectionTools(store, timezone) {
+    const projectTool = {
+        name: "projection_create",
+        label: "projection_create",
+        description: "Store a future event, plan, or expectation in projection memory. " +
+            "Use when the user mentions anything about the future: appointments, deadlines, " +
+            "plans, reminders, or things they intend to do. " +
+            "Resolve the time expression to an ISO datetime or date when possible. " +
+            "Link related projections using linked_ids.",
+        parameters: projectSchema,
+        async execute(_toolCallId, { summary, when, resolution, recurrence, trigger_on_fact, context, linked_ids, depends_on }) {
+            try {
+                let resolved_when;
+                let raw_when;
+                let res = resolution ?? "day";
+                if (when) {
+                    const isoPattern = /^\d{4}-\d{2}-\d{2}([T ]\d{2}:\d{2})?/;
+                    if (isoPattern.test(when)) {
+                        const hasTime = when.includes("T") || (when.length > 10 && when[10] === " ");
+                        // Normalize to UTC if the string contains a time component
+                        resolved_when = hasTime ? toUtcDatetime(when, timezone) : when;
+                        res = hasTime ? "exact" : (resolution ?? "day");
+                    }
+                    else if (when === "someday") {
+                        res = "someday";
+                        raw_when = when;
+                    }
+                    else {
+                        raw_when = when;
+                        res = resolution ?? "day";
+                    }
+                }
+                const id = store.add({
+                    summary,
+                    raw_when,
+                    resolved_when,
+                    resolution: res,
+                    recurrence,
+                    trigger_on_fact,
+                    context,
+                    linked_ids,
+                    depends_on: depends_on?.map((dep) => ({
+                        subject_id: dep.projection_id,
+                        condition: dep.condition,
+                        condition_type: dep.condition_type,
+                    })),
+                });
+                const text = JSON.stringify({ success: true, id }, null, 2);
+                return { content: [{ type: "text", text }], details: { success: true, id } };
+            }
+            catch (error) {
+                const err = error;
+                const text = JSON.stringify({ error: err.message });
+                return { content: [{ type: "text", text }], details: { error: err.message } };
+            }
+        },
+    };
+    const getProjectionsTool = {
+        name: "projection_list",
+        label: "projection_list",
+        description: "Retrieve your active (pending) projections. Default horizon is 7 days. " +
+            "Always includes someday items. Use to review what's coming up or to find " +
+            "IDs for projection_resolve.",
+        parameters: getProjectionsSchema,
+        async execute(_toolCallId, { horizon_days }) {
+            try {
+                const days = horizon_days ?? 7;
+                const projections = store.getUpcoming(days);
+                const text = JSON.stringify({ projections }, null, 2);
+                return { content: [{ type: "text", text }], details: { projections } };
+            }
+            catch (error) {
+                const err = error;
+                const text = JSON.stringify({ error: err.message });
+                return { content: [{ type: "text", text }], details: { error: err.message } };
+            }
+        },
+    };
+    const resolveProjectionTool = {
+        name: "projection_resolve",
+        label: "projection_resolve",
+        description: "Mark a projection as resolved. Use 'done' when something happened as expected, " +
+            "'cancelled' when a plan fell through, 'passed' when the time passed without confirmation. " +
+            "Call this when the user tells you an outcome, or when you observe that a projected " +
+            "time has passed.",
+        parameters: resolveProjectionSchema,
+        async execute(_toolCallId, { id, outcome }) {
+            try {
+                const found = store.resolve(id, outcome);
+                if (!found) {
+                    const text = JSON.stringify({ error: `Projection not found or already resolved: ${id}` });
+                    return { content: [{ type: "text", text }], details: { error: "not found" } };
+                }
+                const text = JSON.stringify({ success: true, id, outcome }, null, 2);
+                return { content: [{ type: "text", text }], details: { success: true, id, outcome } };
+            }
+            catch (error) {
+                const err = error;
+                const text = JSON.stringify({ error: err.message });
+                return { content: [{ type: "text", text }], details: { error: err.message } };
+            }
+        },
+    };
+    const linkProjectionTool = {
+        name: "projection_link",
+        label: "projection_link",
+        description: "Create a dependency between two existing projections. " +
+            "Use this when the dependency is discovered after both projections already exist.",
+        parameters: linkProjectionSchema,
+        async execute(_toolCallId, { observer_id, subject_id, condition, condition_type }) {
+            try {
+                const id = store.linkDependency(observer_id, subject_id, condition, condition_type);
+                const text = JSON.stringify({ success: true, id }, null, 2);
+                return { content: [{ type: "text", text }], details: { success: true, id } };
+            }
+            catch (error) {
+                const err = error;
+                const text = JSON.stringify({ error: err.message });
+                return { content: [{ type: "text", text }], details: { error: err.message } };
+            }
+        },
+    };
+    return [projectTool, getProjectionsTool, resolveProjectionTool, linkProjectionTool];
+}
+//# sourceMappingURL=tools.js.map

package/dist/projection/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/projection/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;IAChC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yDAAyD,EAAE,CAAC;IAChG,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAC9B,WAAW,EACT,gFAAgF;YAChF,qEAAqE;YACrE,mFAAmF;YACnF,4DAA4D;YAC5D,wFAAwF;KAC3F,CAAC,CAAC;IACH,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAClC;QACE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;KACxB,EACD,EAAE,WAAW,EAAE,0EAA0E,EAAE,CAC5F,CAAC;IACF,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QACpC,WAAW,EACT,wCAAwC;YACxC,oEAAoE;YACpE,qGAAqG;YACrG,2CAA2C;YAC3C,+EAA+E;KAClF,CAAC,CAAC;IACH,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QACzC,WAAW,EACT,+FAA+F;YAC/F,sFAAsF;YACtF,4GAA4G;YAC5G,yEAAyE;KAC5E,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QACjC,WAAW,EAAE,iEAAiE;KAC/E,CAAC,CAAC;IACH,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE;QAClD,WAAW,EAAE,4BAA4B;KAC1C,CAAC,CAAC;IACH,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QAC/C,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,8CAA8C,EAAE,CAAC;QAC3F,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kEAAkE,EAAE,CAAC;QAC3G,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC,EAAE;QACF,WAAW,EAAE,6EAA6E;KAC3F,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC;IACvC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QACtC,WAAW,EAAE,0EAA0E;KACxF,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0BAA0B,EAAE,CAAC;IAC5D,OAAO,EAAE,IAAI,CAAC,KAAK,CACjB;QACE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;KACvB,EACD,EAAE,WAAW,EAAE,wDAAwD,EAAE,CAC1E;CACF,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC;IACvC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC;IAClF,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;IACrE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kEAAkE,EAAE,CAAC;IAC3G,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;KACpB,CAAC,CAAC;CACJ,CAAC,CAAC;AAOH,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,aAAa,CAAC,KAAa,EAAE,QAA4B;IAChE,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9C,yEAAyE;IACzE,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,8EAA8E;IAC9E,yFAAyF;IACzF,oEAAoE;IACpE,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3C,iDAAiD;IACjD,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;IACvF,2EAA2E;IAC3E,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;IAC9C,yDAAyD;IACzD,MAAM,QAAQ,GAAG,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1F,4EAA4E;IAC5E,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IAC/D,kEAAkE;IAClE,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;IAC7D,kDAAkD;IAClD,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC1D,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAsB,EAAE,QAAiB;IAC7E,MAAM,WAAW,GAAoC;QACnD,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,mEAAmE;YACnE,iFAAiF;YACjF,iDAAiD;YACjD,wEAAwE;YACxE,4CAA4C;QAC9C,UAAU,EAAE,aAAa;QACzB,KAAK,CAAC,OAAO,CACX,WAAmB,EACnB,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAgB;YAEzG,IAAI,CAAC;gBACH,IAAI,aAAiC,CAAC;gBACtC,IAAI,QAA4B,CAAC;gBACjC,IAAI,GAAG,GAAyB,UAAU,IAAI,KAAK,CAAC;gBAEpD,IAAI,IAAI,EAAE,CAAC;oBACT,MAAM,UAAU,GAAG,sCAAsC,CAAC;oBAC1D,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;wBAC7E,2DAA2D;wBAC3D,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;wBAC/D,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC;oBAClD,CAAC;yBAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;wBAC9B,GAAG,GAAG,SAAS,CAAC;wBAChB,QAAQ,GAAG,IAAI,CAAC;oBAClB,CAAC;yBAAM,CAAC;wBACN,QAAQ,GAAG,IAAI,CAAC;wBAChB,GAAG,GAAG,UAAU,IAAI,KAAK,CAAC;oBAC5B,CAAC;gBACH,CAAC;gBAED,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC;oBACnB,OAAO;oBACP,QAAQ;oBACR,aAAa;oBACb,UAAU,EAAE,GAAG;oBACf,UAAU;oBACV,eAAe;oBACf,OAAO;oBACP,UAAU;oBACV,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;wBACpC,UAAU,EAAE,GAAG,CAAC,aAAa;wBAC7B,SAAS,EAAE,GAAG,CAAC,SAAS;wBACxB,cAAc,EAAE,GAAG,CAAC,cAAqD;qBAC1E,CAAC,CAAC;iBACJ,CAAC,CAAC;gBAEH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC5D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC;YAC/E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,KAAc,CAAC;gBAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YAChF,CAAC;QACH,CAAC;KACF,CAAC;IAEF,MAAM,kBAAkB,GAA2C;QACjE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,yEAAyE;YACzE,2EAA2E;YAC3E,6BAA6B;QAC/B,UAAU,EAAE,oBAAoB;QAChC,KAAK,CAAC,OAAO,CACX,WAAmB,EACnB,EAAE,YAAY,EAAuB;YAErC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,YAAY,IAAI,CAAC,CAAC;gBAC/B,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACtD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC;YACzE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,KAAc,CAAC;gBAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YAChF,CAAC;QACH,CAAC;KACF,CAAC;IAEF,MAAM,qBAAqB,GAA8C;QACvE,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,iFAAiF;YACjF,4FAA4F;YAC5F,qFAAqF;YACrF,kBAAkB;QACpB,UAAU,EAAE,uBAAuB;QACnC,KAAK,CAAC,OAAO,CACX,WAAmB,EACnB,EAAE,EAAE,EAAE,OAAO,EAA0B;YAEvC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBACzC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC1F,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC;gBAChF,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC;YACxF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,KAAc,CAAC;gBAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YAChF,CAAC;QACH,CAAC;KACF,CAAC;IAEF,MAAM,kBAAkB,GAA2C;QACjE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,wDAAwD;YACxD,kFAAkF;QACpF,UAAU,EAAE,oBAAoB;QAChC,KAAK,CAAC,OAAO,CACX,WAAmB,EACnB,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAuB;YAE3E,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,KAAK,CAAC,cAAc,CAC7B,WAAW,EACX,UAAU,EACV,SAAS,EACT,cAAqD,CACtD,CAAC;gBACF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC5D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC;YAC/E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,GAAG,KAAc,CAAC;gBAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YAChF,CAAC;QACH,CAAC;KACF,CAAC;IAEF,OAAO,CAAC,WAAW,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,kBAAkB,CAAC,CAAC;AACtF,CAAC"}

package/dist/scheduler.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Scheduler: three job types, all driving the agent via synthetic messages.
+ *
+ * 1. Config-driven jobs (startConfigJobs): cron entries from config.yml. The
+ *    operator defines the schedule and the message text. Fire unconditionally
+ *    regardless of active-hours config.
+ *
+ * 2. Projection daily review (startProjectionJobs — daily): fires at 08:00 UTC
+ *    every day. Sends the agent a broad "what's coming up?" prompt listing all
+ *    projections due in the next 7 days. The agent decides what (if anything)
+ *    to surface to the user.
+ *
+ * 3. Projection exact-time check (startProjectionJobs — every 5 min): precise
+ *    trigger for projections with a specific datetime. Checks for anything due
+ *    within the next 15 minutes. Skips silently outside active hours.
+ *
+ * All three types construct a synthetic IncomingMessage and pass it to the
+ * onMessage callback, which feeds it into the main agent loop exactly as if
+ * a real user had sent it.
+ */
+import type { Config } from "./config.js";
+import type { IncomingMessage } from "./channels/types.js";
+export interface Scheduler {
+    /** Start all jobs (config-driven and projection-driven). */
+    start(): void;
+    /** Stop all running jobs. */
+    stop(): void;
+}
+/**
+ * Create the scheduler.
+ *
+ * @param config      App config (for config.yml cron jobs and the default channel).
+ * @param onMessage   Callback to inject synthetic messages into the agent loop.
+ */
+export declare function createScheduler(config: Config, onMessage: (msg: IncomingMessage) => Promise<void>): Scheduler;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAkC3D,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,KAAK,IAAI,IAAI,CAAC;IAEd,6BAA6B;IAC7B,IAAI,IAAI,IAAI,CAAC;CACd;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GACjD,SAAS,CA4PX"}

package/dist/scheduler.js

@@ -0,0 +1,286 @@
+/**
+ * Scheduler: three job types, all driving the agent via synthetic messages.
+ *
+ * 1. Config-driven jobs (startConfigJobs): cron entries from config.yml. The
+ *    operator defines the schedule and the message text. Fire unconditionally
+ *    regardless of active-hours config.
+ *
+ * 2. Projection daily review (startProjectionJobs — daily): fires at 08:00 UTC
+ *    every day. Sends the agent a broad "what's coming up?" prompt listing all
+ *    projections due in the next 7 days. The agent decides what (if anything)
+ *    to surface to the user.
+ *
+ * 3. Projection exact-time check (startProjectionJobs — every 5 min): precise
+ *    trigger for projections with a specific datetime. Checks for anything due
+ *    within the next 15 minutes. Skips silently outside active hours.
+ *
+ * All three types construct a synthetic IncomingMessage and pass it to the
+ * onMessage callback, which feeds it into the main agent loop exactly as if
+ * a real user had sent it.
+ */
+import { Cron } from "croner";
+import { createProjectionStore, formatProjectionsForPrompt, runReflection } from "./projection/index.js";
+import { isActiveNow } from "./active-hours.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Given a cron expression, calculate the next fire time after `after` and
+ * return it as a UTC datetime string suitable for SQLite ("YYYY-MM-DD HH:MM").
+ * Returns null if the expression is invalid or produces no next occurrence.
+ *
+ * Implementation note: croner does not expose a pure "next occurrence"
+ * function without constructing a live job. This creates a temporary Cron
+ * instance, reads the next run time, then immediately stops it to avoid
+ * leaking a running interval.
+ */
+function nextCronOccurrence(cronExpr, after) {
+    try {
+        const job = new Cron(cronExpr, { timezone: "UTC", startAt: after });
+        const next = job.nextRun(after);
+        job.stop();
+        if (!next)
+            return null;
+        return next.toISOString().slice(0, 16).replace("T", " ");
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create the scheduler.
+ *
+ * @param config      App config (for config.yml cron jobs and the default channel).
+ * @param onMessage   Callback to inject synthetic messages into the agent loop.
+ */
+export function createScheduler(config, onMessage) {
+    const cronJobs = new Map();
+    function defaultChannelId() {
+        const firstUser = config.telegram.allowed_users[0];
+        return firstUser ? String(firstUser) : "cron";
+    }
+    function startConfigJobs() {
+        for (let i = 0; i < config.cron.length; i++) {
+            const cronJob = config.cron[i];
+            const key = `config-${i}`;
+            try {
+                const job = new Cron(cronJob.schedule, async () => {
+                    console.log(`[scheduler] Config job triggered: ${cronJob.schedule}`);
+                    const channelId = defaultChannelId();
+                    // raw.type identifies this as a scheduler message. processMessage() in
+                    // index.ts checks for this field to skip crash-recovery checkpoints
+                    // that only make sense for real user messages.
+                    const msg = {
+                        channelId,
+                        userId: "cron",
+                        text: cronJob.message,
+                        platform: "telegram",
+                        raw: { type: "cron", schedule: cronJob.schedule },
+                    };
+                    await onMessage(msg);
+                }, { timezone: "UTC" });
+                cronJobs.set(key, job);
+                const preview = cronJob.message.length > 50
+                    ? `${cronJob.message.substring(0, 50)}...`
+                    : cronJob.message;
+                console.log(`[scheduler] Config job scheduled: ${cronJob.schedule} -> ${preview}`);
+            }
+            catch (err) {
+                console.error(`[scheduler] Failed to schedule config job: ${cronJob.schedule}`, err);
+            }
+        }
+    }
+    /**
+     * Two projection jobs for the primary user:
+     *
+     * - Daily review at 8am UTC: a broad "what's coming up?" pass. The agent
+     *   receives all projections due in the next 7 days and decides what to
+     *   surface. Outside active hours the job silently skips — the review is
+     *   informational, not time-critical.
+     *
+     * - Exact-time check every 5 min: a precise trigger for projections that
+     *   have a specific datetime (resolution='exact'). Only fires when something
+     *   is actually due; skips silently outside active hours.
+     *
+     * The daily review is intentionally broad and agent-mediated; the exact-time
+     * check is a direct trigger for a concrete commitment. Both are distinct from
+     * config-driven jobs, which fire unconditionally and carry operator-authored
+     * message text.
+     */
+    function startProjectionJobs() {
+        const primaryUserId = String(config.telegram.allowed_users[0] ?? "");
+        if (!primaryUserId || primaryUserId === "undefined") {
+            console.warn("[projections] No primary user configured (telegram.allowed_users is empty) — projection jobs not started");
+            return;
+        }
+        const channelId = defaultChannelId();
+        // Daily review: 8am UTC every day
+        const dailyJob = new Cron("0 8 * * *", async () => {
+            // Projection jobs respect active hours; config-driven jobs do not.
+            // This asymmetry is intentional: config jobs are operator-controlled
+            // and may need to fire at any time (e.g., system maintenance notices),
+            // while projection jobs are conversational and should not wake the user.
+            if (!isActiveNow(config.active_hours)) {
+                console.log("[projections] Daily review skipped (outside active hours)");
+                return;
+            }
+            console.log("[projections] Daily review triggered");
+            const store = createProjectionStore(primaryUserId, config.data_dir);
+            try {
+                const expired = store.autoExpire(24);
+                if (expired > 0) {
+                    console.log(`[projections] Auto-expired ${expired} stale projection(s)`);
+                }
+                const activated = store.evaluateDependencies();
+                if (activated > 0) {
+                    console.log(`[projections] Activated ${activated} projection(s) via dependencies`);
+                }
+                const upcoming = store.getUpcoming(7);
+                if (upcoming.length === 0) {
+                    console.log("[projections] Daily review: no upcoming projections, skipping");
+                    return;
+                }
+                const formatted = formatProjectionsForPrompt(upcoming, 20);
+                // raw.type marks this as a scheduler message so processMessage() can
+                // distinguish it from a real user message and skip crash checkpoints.
+                const msg = {
+                    channelId,
+                    userId: primaryUserId,
+                    text: `[Daily review]\n\nHere is what's coming up:\n\n${formatted}\n\n` +
+                        `Review each item. For each projection, decide whether to surface it TODAY:\n` +
+                        `1. Search your memory for related context (use memory_archival_search)\n` +
+                        `2. If due today or overdue: compose a message or take action.\n` +
+                        `3. If due later this week: surface only if today is the right day for it.\n` +
+                        `4. If further out: only act if something needs attention now.\n` +
+                        `5. If cancelled, resolved, or clearly passed: resolve it and move on.\n` +
+                        `6. If nothing needs to happen: say nothing (NOOP is fine).\n\n` +
+                        `Timing rules:\n` +
+                        `- If a task has a hard deadline AND an unresolved blocker (waiting on someone, missing info), ` +
+                        `surface it EARLY so the user can start unblocking. Don't wait for the blocker to resolve itself.\n` +
+                        `- If today is a light day and a task is due this week, today is probably a good day to surface it. ` +
+                        `Don't skip it just because other days look busy.\n` +
+                        `- Only defer if today is genuinely a bad day (too busy, user is overwhelmed, or a later day is ` +
+                        `clearly better for a specific reason).`,
+                    platform: "telegram",
+                    raw: { type: "projection_daily_review" },
+                };
+                await onMessage(msg);
+            }
+            finally {
+                store.close();
+            }
+        }, { timezone: "UTC" });
+        cronJobs.set("projection-daily", dailyJob);
+        console.log("[projections] Daily review scheduled at 08:00 UTC");
+        // Exact-time check: every 5 minutes
+        const exactJob = new Cron("*/5 * * * *", async () => {
+            if (!isActiveNow(config.active_hours)) {
+                return; // Silent skip - fires every 5 min, no need to log each one
+            }
+            const store = createProjectionStore(primaryUserId, config.data_dir);
+            try {
+                store.evaluateDependencies();
+                const due = store.getExactDue(15);
+                if (due.length === 0) {
+                    return;
+                }
+                console.log(`[projections] Exact-time check: ${due.length} item(s) due`);
+                const formatted = formatProjectionsForPrompt(due, 10);
+                // Settle each projection: rearm recurring ones, mark one-offs as passed.
+                const now = new Date();
+                for (const p of due) {
+                    if (p.recurrence) {
+                        const next = nextCronOccurrence(p.recurrence, now);
+                        if (next) {
+                            store.rearm(p.id, next);
+                            console.log(`[projections] Rearmed recurring projection ${p.id} → next: ${next}`);
+                        }
+                        else {
+                            // Cron produced no future occurrence — treat as one-off.
+                            store.resolve(p.id, "passed");
+                            console.warn(`[projections] Recurring projection ${p.id} produced no next occurrence, marked passed`);
+                        }
+                    }
+                    else {
+                        store.resolve(p.id, "passed");
+                    }
+                }
+                // raw.type marks this as a scheduler message so processMessage() can
+                // distinguish it from a real user message and skip crash checkpoints.
+                const msg = {
+                    channelId,
+                    userId: primaryUserId,
+                    text: `[Scheduled reminder]\n\nThe following reminder(s) are due now:\n\n` +
+                        `${formatted}\n\n` +
+                        `For each item:\n` +
+                        `1. Search your memory for related context (use memory_archival_search)\n` +
+                        `2. Send the user a helpful, natural message — or reply NOOP if nothing needs to be said.`,
+                    platform: "telegram",
+                    raw: { type: "projection_exact_check" },
+                };
+                await onMessage(msg);
+            }
+            finally {
+                store.close();
+            }
+        }, { timezone: "UTC" });
+        cronJobs.set("projection-exact", exactJob);
+        console.log("[projections] Exact-time check scheduled every 5 minutes");
+    }
+    /**
+     * Reflection cron: every 30 minutes, scan recent conversation for future
+     * references the agent missed. Writes projections directly to SQLite
+     * without touching the agent loop. Skips when there are no new messages.
+     */
+    function startReflectionJob() {
+        const primaryUserId = String(config.telegram.allowed_users[0] ?? "");
+        if (!primaryUserId || primaryUserId === "undefined") {
+            return;
+        }
+        const job = new Cron("*/30 * * * *", async () => {
+            try {
+                const result = await runReflection(config, primaryUserId, 30);
+                if (result.skipped) {
+                    // Only log at debug level — this fires often and is usually a no-op
+                    return;
+                }
+                if (result.projectionsAdded > 0) {
+                    console.log(`[reflection] Added ${result.projectionsAdded} projection(s) from recent conversation`);
+                }
+                else {
+                    console.log("[reflection] No new projections found in recent conversation");
+                }
+            }
+            catch (err) {
+                console.error("[reflection] Unhandled error:", err.message);
+            }
+        }, { timezone: "UTC" });
+        cronJobs.set("projection-reflection", job);
+        console.log("[projections] Reflection pass scheduled every 30 minutes");
+    }
+    return {
+        start() {
+            startConfigJobs();
+            startProjectionJobs();
+            startReflectionJob();
+            const total = cronJobs.size;
+            if (total > 0) {
+                console.log(`[scheduler] Started ${total} jobs (${config.cron.length} config, rest projection)`);
+            }
+        },
+        stop() {
+            for (const job of cronJobs.values()) {
+                job.stop();
+            }
+            const count = cronJobs.size;
+            cronJobs.clear();
+            if (count > 0) {
+                console.log(`[scheduler] Stopped ${count} jobs`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

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

package/dist/system-prompt.d.ts

@@ -0,0 +1,41 @@
+/**
+ * System prompt assembly for the agent.
+ *
+ * Builds the complete system prompt from config, core memory, tools,
+ * projections, and behavioral instructions. This is prompt engineering
+ * separated from session management to make iteration easier.
+ */
+import type { Config } from "./config.js";
+/**
+ * Summary of a tool for the system prompt listing.
+ */
+export interface ToolSummary {
+    name: string;
+    description?: string;
+}
+/**
+ * Token used to signal that there is nothing to say in a scheduled/proactive turn.
+ */
+export declare const SILENT_REPLY_TOKEN = "NOOP";
+/**
+ * Build the tool listing section of the system prompt.
+ */
+export declare function buildToolSection(tools: ToolSummary[], extensionToolNames: Set<string>): string;
+/**
+ * Build the complete system prompt from config, core memory, tools, and projections.
+ *
+ * This function assembles all the sections that make up the agent's system prompt:
+ * - Base system prompt from config
+ * - Image handling capabilities
+ * - Current date and time (with timezone if configured)
+ * - Communication style and tool call guidelines
+ * - Tool listings (including extension tools)
+ * - Extension management instructions
+ * - Skill management instructions
+ * - Core memory
+ * - Projections (upcoming events and commitments)
+ * - Background worker instructions
+ * - Silent reply mechanism
+ */
+export declare function buildSystemPrompt(config: Config, coreMemory: string, tools: ToolSummary[], extensionToolNames: Set<string>, projections: string): string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAAE,EACpB,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,MAAM,CAgBR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,EAAE,EACpB,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC/B,WAAW,EAAE,MAAM,GAClB,MAAM,CA4IR"}