@asermax/tachikoma 2.0.0

package/dist/extensions/notifications/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/extensions/notifications/format.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,CAAC,IAAU,EAAU,EAAE,CAC7C,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC;AAE7D,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAsB,EAAE,GAAS,EAAU,EAAE;IAC9E,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAE1F,OAAO,iCAAiC,OAAO,CAAC,MAAM,WAAW,eAAe,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;AACrG,CAAC,CAAC;AAEF,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAsB,EAAE,GAAS,EAAU,EAAE;IACxE,MAAM,KAAK,GAAG,CAAC,uCAAuC,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAElF,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,aAAa,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;QAC/E,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC"}

package/dist/extensions/notifications/index.d.ts

@@ -0,0 +1,13 @@
+export type { NotifyPayload, Severity } from "./payload.ts";
+interface NotificationsConfig {
+    flushWindowSeconds: number;
+    maxHoldSeconds: number;
+}
+/**
+ * Notification delivery: routes `"notify"` app events to the user by severity —
+ * urgent immediately, the rest idle-gated with a max hold, batched into a digest
+ * when several accumulate. Also exposes a notify_user tool so the agent itself
+ * can emit notifications.
+ */
+declare const _default: import("../api.ts").TachikomaExtension<NotificationsConfig>;
+export default _default;

package/dist/extensions/notifications/index.js

@@ -0,0 +1,29 @@
+import { Type } from "typebox";
+import { defineExtension } from "../api.js";
+import { NOTIFY_EVENT } from "./payload.js";
+import { NotificationRouter } from "./router.js";
+import { createNotifyToolFactory } from "./tools.js";
+/**
+ * Notification delivery: routes `"notify"` app events to the user by severity —
+ * urgent immediately, the rest idle-gated with a max hold, batched into a digest
+ * when several accumulate. Also exposes a notify_user tool so the agent itself
+ * can emit notifications.
+ */
+export default defineExtension({
+    name: "notifications",
+    configSchema: Type.Object({
+        flushWindowSeconds: Type.Number({ default: 30 }),
+        maxHoldSeconds: Type.Number({ default: 900 }),
+    }),
+    setup(app) {
+        const router = new NotificationRouter({
+            deliver: (delivery) => app.channels.deliver(delivery),
+            flushWindowSeconds: app.extensionConfig.flushWindowSeconds,
+            maxHoldSeconds: app.extensionConfig.maxHoldSeconds,
+            log: app.log,
+        });
+        app.events.on(NOTIFY_EVENT, (payload) => router.handle(payload));
+        app.agent.use(createNotifyToolFactory((event, payload) => app.events.emit(event, payload)));
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/extensions/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AASrD;;;;;GAKG;AACH,eAAe,eAAe,CAAsB;IAClD,IAAI,EAAE,eAAe;IAErB,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC;QACxB,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAChD,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;KAC9C,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC;YACpC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;YACrD,kBAAkB,EAAE,GAAG,CAAC,eAAe,CAAC,kBAAkB;YAC1D,cAAc,EAAE,GAAG,CAAC,eAAe,CAAC,cAAc;YAClD,GAAG,EAAE,GAAG,CAAC,GAAG;SACb,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAEjE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;CACF,CAAC,CAAC"}

package/dist/extensions/notifications/payload.d.ts

@@ -0,0 +1,22 @@
+/** App event channel for user-facing notifications from any extension. */
+export declare const NOTIFY_EVENT = "notify";
+export declare const SEVERITIES: {
+    readonly info: "info";
+    readonly warning: "warning";
+    readonly urgent: "urgent";
+};
+export type Severity = keyof typeof SEVERITIES;
+export interface NotifyPayload {
+    title?: string;
+    text: string;
+    severity: Severity;
+    source: string;
+}
+/**
+ * Parse an arbitrary `"notify"` event payload into a NotifyPayload.
+ *
+ * Requires a non-empty `text` string; payloads without one are not notifications
+ * and return null. Missing or unknown severity downgrades to "info", missing
+ * source becomes "unknown" — cross-extension signals stay best-effort.
+ */
+export declare const parseNotifyPayload: (payload: unknown) => NotifyPayload | null;

package/dist/extensions/notifications/payload.js

@@ -0,0 +1,29 @@
+/** App event channel for user-facing notifications from any extension. */
+export const NOTIFY_EVENT = "notify";
+export const SEVERITIES = {
+    info: "info",
+    warning: "warning",
+    urgent: "urgent",
+};
+const isSeverity = (value) => typeof value === "string" && value in SEVERITIES;
+/**
+ * Parse an arbitrary `"notify"` event payload into a NotifyPayload.
+ *
+ * Requires a non-empty `text` string; payloads without one are not notifications
+ * and return null. Missing or unknown severity downgrades to "info", missing
+ * source becomes "unknown" — cross-extension signals stay best-effort.
+ */
+export const parseNotifyPayload = (payload) => {
+    if (payload == null || typeof payload !== "object")
+        return null;
+    const candidate = payload;
+    if (typeof candidate.text !== "string" || candidate.text.trim() === "")
+        return null;
+    return {
+        title: typeof candidate.title === "string" ? candidate.title : undefined,
+        text: candidate.text,
+        severity: isSeverity(candidate.severity) ? candidate.severity : SEVERITIES.info,
+        source: typeof candidate.source === "string" ? candidate.source : "unknown",
+    };
+};
+//# sourceMappingURL=payload.js.map

package/dist/extensions/notifications/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../src/extensions/notifications/payload.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAErC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACR,CAAC;AAWX,MAAM,UAAU,GAAG,CAAC,KAAc,EAAqB,EAAE,CACvD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,UAAU,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAgB,EAAwB,EAAE;IAC3E,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEhE,MAAM,SAAS,GAAG,OAAkC,CAAC;IAErD,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAEpF,OAAO;QACL,KAAK,EAAE,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QACxE,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,QAAQ,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI;QAC/E,MAAM,EAAE,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;KAC5E,CAAC;AACJ,CAAC,CAAC"}

package/dist/extensions/notifications/router.d.ts

@@ -0,0 +1,29 @@
+import type { Delivery } from "../../channels/types.ts";
+import type { Logger } from "../../log.ts";
+export interface RouterOptions {
+    deliver: (delivery: Delivery) => void;
+    /** How long non-urgent notices accumulate before flushing as one block. */
+    flushWindowSeconds: number;
+    /** Forwarded to the idle gate so held notices are force-delivered eventually. */
+    maxHoldSeconds: number;
+    log: Logger;
+    now?: () => Date;
+}
+/**
+ * Severity router for `"notify"` events: urgent notices bypass gating and deliver
+ * immediately; everything else accumulates over a short flush window and goes out
+ * idle-gated — as a single notification or, when several piled up, as one digest.
+ */
+export declare class NotificationRouter {
+    private readonly deliver;
+    private readonly flushWindowSeconds;
+    private readonly maxHoldSeconds;
+    private readonly log;
+    private readonly now;
+    private pending;
+    private timer;
+    constructor({ deliver, flushWindowSeconds, maxHoldSeconds, log, now }: RouterOptions);
+    handle(payload: unknown): void;
+    /** Deliver everything accumulated so far as one idle-gated block. */
+    flush(): void;
+}

package/dist/extensions/notifications/router.js

@@ -0,0 +1,55 @@
+import { formatDigest, formatNotification } from "./format.js";
+import { parseNotifyPayload, SEVERITIES } from "./payload.js";
+/**
+ * Severity router for `"notify"` events: urgent notices bypass gating and deliver
+ * immediately; everything else accumulates over a short flush window and goes out
+ * idle-gated — as a single notification or, when several piled up, as one digest.
+ */
+export class NotificationRouter {
+    deliver;
+    flushWindowSeconds;
+    maxHoldSeconds;
+    log;
+    now;
+    pending = [];
+    timer = null;
+    constructor({ deliver, flushWindowSeconds, maxHoldSeconds, log, now }) {
+        this.deliver = deliver;
+        this.flushWindowSeconds = flushWindowSeconds;
+        this.maxHoldSeconds = maxHoldSeconds;
+        this.log = log;
+        this.now = now ?? (() => new Date());
+    }
+    handle(payload) {
+        const parsed = parseNotifyPayload(payload);
+        if (parsed == null) {
+            // Other extensions emit non-notification signals on this event (e.g. task
+            // status objects) — those are not for the user, so skip them quietly.
+            this.log.debug({ payload }, "ignoring notify event without notification text");
+            return;
+        }
+        if (parsed.severity === SEVERITIES.urgent) {
+            this.deliver({ text: formatNotification(parsed, this.now()), gate: "immediate" });
+            return;
+        }
+        this.pending.push(parsed);
+        if (this.timer == null) {
+            this.timer = setTimeout(() => this.flush(), this.flushWindowSeconds * 1000);
+            this.timer.unref();
+        }
+    }
+    /** Deliver everything accumulated so far as one idle-gated block. */
+    flush() {
+        if (this.timer != null)
+            clearTimeout(this.timer);
+        this.timer = null;
+        const items = this.pending;
+        this.pending = [];
+        const [single] = items;
+        if (single == null)
+            return;
+        const text = items.length === 1 ? formatNotification(single, this.now()) : formatDigest(items, this.now());
+        this.deliver({ text, gate: "idle", maxHoldSeconds: this.maxHoldSeconds });
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/extensions/notifications/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/extensions/notifications/router.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAsB,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAYlF;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAA+B;IACtC,kBAAkB,CAAS;IAC3B,cAAc,CAAS;IACvB,GAAG,CAAS;IACZ,GAAG,CAAa;IAEzB,OAAO,GAAoB,EAAE,CAAC;IAC9B,KAAK,GAA0B,IAAI,CAAC;IAE5C,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,EAAiB;QAClF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,OAAgB;QACrB,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,0EAA0E;YAC1E,sEAAsE;YACtE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,iDAAiD,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YAClF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1B,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;YAC5E,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI;YAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAElB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAElB,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QAEvB,IAAI,MAAM,IAAI,IAAI;YAAE,OAAO;QAE3B,MAAM,IAAI,GACR,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAEhG,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/extensions/notifications/tools.d.ts

@@ -0,0 +1,12 @@
+import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
+import { type Static, Type } from "typebox";
+import { type NotifyPayload } from "./payload.ts";
+export type NotifyEmitter = (event: string, payload: NotifyPayload) => void;
+export declare const NotifyUserParams: Type.TObject<{
+    text: Type.TString;
+    title: Type.TOptional<Type.TString>;
+    severity: Type.TOptional<Type.TUnsafe<"info" | "warning" | "urgent">>;
+}>;
+export declare const handleNotifyUser: (emit: NotifyEmitter, args: Static<typeof NotifyUserParams>) => string;
+/** pi extension factory exposing the notify_user tool to the agent. */
+export declare const createNotifyToolFactory: (emit: NotifyEmitter) => ExtensionFactory;

package/dist/extensions/notifications/tools.js

@@ -0,0 +1,41 @@
+import { StringEnum } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+import { NOTIFY_EVENT, SEVERITIES } from "./payload.js";
+export const NotifyUserParams = Type.Object({
+    text: Type.String({ description: "The notification message to deliver to the user" }),
+    title: Type.Optional(Type.String({ description: "Optional short headline" })),
+    severity: Type.Optional(StringEnum(["info", "warning", "urgent"], {
+        description: "'urgent' is delivered immediately; 'info' (default) and 'warning' wait for an idle moment and may be batched into a digest",
+    })),
+});
+export const handleNotifyUser = (emit, args) => {
+    if (args.text.trim() === "")
+        throw new Error("Notification text cannot be empty.");
+    emit(NOTIFY_EVENT, {
+        title: args.title,
+        text: args.text,
+        severity: args.severity ?? SEVERITIES.info,
+        source: "agent",
+    });
+    return "Notification sent.";
+};
+/** pi extension factory exposing the notify_user tool to the agent. */
+export const createNotifyToolFactory = (emit) => (pi) => {
+    pi.registerTool({
+        name: "notify_user",
+        label: "Notify User",
+        description: "Send a notification to the user outside the normal reply flow. Non-urgent notifications wait for an idle moment and may be combined into a digest; urgent ones are delivered immediately.",
+        promptSnippet: "Notify the user proactively (use sparingly; urgent severity interrupts)",
+        promptGuidelines: [
+            "Use notify_user only for information the user should see outside your direct reply; reserve severity 'urgent' for genuinely time-sensitive matters.",
+        ],
+        parameters: NotifyUserParams,
+        async execute(_toolCallId, params) {
+            return {
+                content: [{ type: "text", text: handleNotifyUser(emit, params) }],
+                details: undefined,
+            };
+        },
+    });
+};
+//# sourceMappingURL=tools.js.map

package/dist/extensions/notifications/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/extensions/notifications/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAsB,UAAU,EAAE,MAAM,cAAc,CAAC;AAI5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,iDAAiD,EAAE,CAAC;IACrF,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC,CAAC;IAC7E,QAAQ,EAAE,IAAI,CAAC,QAAQ,CACrB,UAAU,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAU,EAAE;QACjD,WAAW,EACT,4HAA4H;KAC/H,CAAC,CACH;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,IAAmB,EACnB,IAAqC,EAC7B,EAAE;IACV,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAEnF,IAAI,CAAC,YAAY,EAAE;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,UAAU,CAAC,IAAI;QAC1C,MAAM,EAAE,OAAO;KAChB,CAAC,CAAC;IAEH,OAAO,oBAAoB,CAAC;AAC9B,CAAC,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAClC,CAAC,IAAmB,EAAoB,EAAE,CAC1C,CAAC,EAAE,EAAE,EAAE;IACL,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,2LAA2L;QAC7L,aAAa,EAAE,yEAAyE;QACxF,gBAAgB,EAAE;YAChB,qJAAqJ;SACtJ;QACD,UAAU,EAAE,gBAAgB;QAC5B,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;YAC/B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACjE,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/extensions/projects/context-provider.d.ts

@@ -0,0 +1,9 @@
+import type { Logger } from "../../log.ts";
+import type { ContextProvider } from "../api.ts";
+/**
+ * Injects awareness of the registered projects: each submodule with its
+ * current branch (or detached commit) and uncommitted-change count. Always
+ * provides a block so the agent knows register_project is available even when
+ * no projects exist yet.
+ */
+export declare const createProjectsContextProvider: (workspaceRoot: string, log: Logger) => ContextProvider;

package/dist/extensions/projects/context-provider.js

@@ -0,0 +1,37 @@
+import { describeProjectState, listSubmodules, projectState } from "./git.js";
+/**
+ * Injects awareness of the registered projects: each submodule with its
+ * current branch (or detached commit) and uncommitted-change count. Always
+ * provides a block so the agent knows register_project is available even when
+ * no projects exist yet.
+ */
+export const createProjectsContextProvider = (workspaceRoot, log) => ({
+    name: "projects",
+    async provide() {
+        let submodulePaths;
+        try {
+            submodulePaths = await listSubmodules(workspaceRoot);
+        }
+        catch (error) {
+            log.warn({ err: error }, "failed to list submodules");
+            submodulePaths = [];
+        }
+        if (submodulePaths.length === 0) {
+            return {
+                tag: "projects",
+                content: "No projects registered. Use register_project to add one.",
+            };
+        }
+        const states = await Promise.allSettled(submodulePaths.map((path) => projectState(workspaceRoot, path)));
+        const lines = states
+            .filter((state) => state.status === "fulfilled")
+            .map((state) => describeProjectState(state.value));
+        for (const state of states) {
+            if (state.status === "rejected") {
+                log.warn({ err: state.reason }, "failed to get project info");
+            }
+        }
+        return { tag: "projects", content: `## Registered Projects\n\n${lines.join("\n")}` };
+    },
+});
+//# sourceMappingURL=context-provider.js.map

package/dist/extensions/projects/context-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-provider.js","sourceRoot":"","sources":["../../../src/extensions/projects/context-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,aAAqB,EACrB,GAAW,EACM,EAAE,CAAC,CAAC;IACrB,IAAI,EAAE,UAAU;IAEhB,KAAK,CAAC,OAAO;QACX,IAAI,cAAwB,CAAC;QAE7B,IAAI,CAAC;YACH,cAAc,GAAG,MAAM,cAAc,CAAC,aAAa,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,2BAA2B,CAAC,CAAC;YACtD,cAAc,GAAG,EAAE,CAAC;QACtB,CAAC;QAED,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO;gBACL,GAAG,EAAE,UAAU;gBACf,OAAO,EAAE,0DAA0D;aACpE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CACrC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAChE,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM;aACjB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC;aAC/C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAErD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAChC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,4BAA4B,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,6BAA6B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IACvF,CAAC;CACF,CAAC,CAAC"}

package/dist/extensions/projects/git.d.ts

@@ -0,0 +1,28 @@
+/** List all registered submodule paths (e.g. ["projects/my-app"]) from git state. */
+export declare const listSubmodules: (workspaceRoot: string) => Promise<string[]>;
+export declare const initSubmodule: (workspaceRoot: string, path: string) => Promise<void>;
+/**
+ * Resolve the default branch from the remote's HEAD reference: local symbolic
+ * ref first, `git remote show origin` as a fallback, "main" as a last resort.
+ */
+export declare const resolveDefaultBranch: (repoPath: string) => Promise<string>;
+export declare const checkoutBranch: (repoPath: string, branch: string) => Promise<void>;
+/** Porcelain status output, or null when the working tree is clean. */
+export declare const uncommittedChangesDetail: (repoPath: string) => Promise<string | null>;
+export declare const isDirty: (repoPath: string) => Promise<boolean>;
+export declare const addSubmodule: (workspaceRoot: string, name: string, url: string) => Promise<void>;
+/** Remove a submodule completely: deinit, git rm, and drop the .git/modules clone. */
+export declare const removeSubmodule: (workspaceRoot: string, name: string) => Promise<void>;
+/** Current branch name, or null when HEAD is detached. */
+export declare const currentBranch: (repoPath: string) => Promise<string | null>;
+export declare const currentCommitShort: (repoPath: string) => Promise<string>;
+export interface ProjectState {
+    name: string;
+    /** Branch name, or null when HEAD is detached. */
+    branch: string | null;
+    commit: string;
+    dirtyFiles: number;
+}
+/** Gather display state (branch/commit + dirty file count) for one submodule path. */
+export declare const projectState: (workspaceRoot: string, path: string) => Promise<ProjectState>;
+export declare const describeProjectState: (state: ProjectState) => string;

package/dist/extensions/projects/git.js

@@ -0,0 +1,91 @@
+import { rm } from "node:fs/promises";
+import { join } from "node:path";
+import { runGit, runGitCapture } from "../git/git.js";
+/** List all registered submodule paths (e.g. ["projects/my-app"]) from git state. */
+export const listSubmodules = async (workspaceRoot) => {
+    const result = await runGitCapture(workspaceRoot, ["submodule", "status", "--recursive"]);
+    if (result.code !== 0)
+        return [];
+    // Each line is like " abc1234 projects/my-app (heads/main)" — the first
+    // character is a status indicator (space, +, -, or U) fused to the hash.
+    return result.stdout
+        .split("\n")
+        .map((line) => line.trim().split(/\s+/))
+        .filter((parts) => parts.length >= 2)
+        .map((parts) => parts[1]);
+};
+export const initSubmodule = async (workspaceRoot, path) => {
+    await runGit(workspaceRoot, ["submodule", "update", "--init", path]);
+};
+/**
+ * Resolve the default branch from the remote's HEAD reference: local symbolic
+ * ref first, `git remote show origin` as a fallback, "main" as a last resort.
+ */
+export const resolveDefaultBranch = async (repoPath) => {
+    const symbolic = await runGitCapture(repoPath, ["symbolic-ref", "refs/remotes/origin/HEAD"]);
+    const prefix = "refs/remotes/origin/";
+    if (symbolic.code === 0 && symbolic.stdout.startsWith(prefix)) {
+        return symbolic.stdout.slice(prefix.length);
+    }
+    const show = await runGitCapture(repoPath, ["remote", "show", "origin"]);
+    if (show.code === 0) {
+        const headLine = show.stdout.split("\n").find((line) => line.includes("HEAD branch:"));
+        if (headLine != null)
+            return (headLine.split(":").at(-1) ?? "").trim() || "main";
+    }
+    return "main";
+};
+export const checkoutBranch = async (repoPath, branch) => {
+    await runGit(repoPath, ["checkout", branch]);
+};
+/** Porcelain status output, or null when the working tree is clean. */
+export const uncommittedChangesDetail = async (repoPath) => {
+    const { stdout } = await runGitCapture(repoPath, ["status", "--porcelain"]);
+    return stdout === "" ? null : stdout;
+};
+export const isDirty = async (repoPath) => (await uncommittedChangesDetail(repoPath)) != null;
+export const addSubmodule = async (workspaceRoot, name, url) => {
+    await runGit(workspaceRoot, ["submodule", "add", url, `projects/${name}`]);
+};
+/** Remove a submodule completely: deinit, git rm, and drop the .git/modules clone. */
+export const removeSubmodule = async (workspaceRoot, name) => {
+    const path = `projects/${name}`;
+    await runGit(workspaceRoot, ["submodule", "deinit", "-f", path]);
+    await runGit(workspaceRoot, ["rm", "-f", path]);
+    await rm(join(workspaceRoot, ".git", "modules", "projects", name), {
+        recursive: true,
+        force: true,
+    });
+};
+/** Current branch name, or null when HEAD is detached. */
+export const currentBranch = async (repoPath) => {
+    const result = await runGitCapture(repoPath, ["symbolic-ref", "--short", "HEAD"]);
+    if (result.code !== 0 || result.stdout === "")
+        return null;
+    return result.stdout;
+};
+export const currentCommitShort = async (repoPath) => {
+    const result = await runGitCapture(repoPath, ["rev-parse", "--short", "HEAD"]);
+    if (result.code !== 0 || result.stdout === "")
+        return "unknown";
+    return result.stdout;
+};
+/** Gather display state (branch/commit + dirty file count) for one submodule path. */
+export const projectState = async (workspaceRoot, path) => {
+    const repoPath = join(workspaceRoot, path);
+    const detail = await uncommittedChangesDetail(repoPath);
+    return {
+        name: path.split("/").at(-1) ?? path,
+        branch: await currentBranch(repoPath),
+        commit: await currentCommitShort(repoPath),
+        dirtyFiles: detail == null ? 0 : detail.split("\n").length,
+    };
+};
+export const describeProjectState = (state) => {
+    const location = state.branch ?? `${state.commit} (detached)`;
+    const dirty = state.dirtyFiles > 0
+        ? ` — ${state.dirtyFiles} uncommitted change${state.dirtyFiles === 1 ? "" : "s"}`
+        : "";
+    return `- ${state.name}: ${location}${dirty}`;
+};
+//# sourceMappingURL=git.js.map

package/dist/extensions/projects/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/extensions/projects/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEtD,qFAAqF;AACrF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,aAAqB,EAAqB,EAAE;IAC/E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAE1F,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,wEAAwE;IACxE,yEAAyE;IACzE,OAAO,MAAM,CAAC,MAAM;SACjB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SACvC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;SACpC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAW,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,aAAqB,EAAE,IAAY,EAAiB,EAAE;IACxF,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,QAAgB,EAAmB,EAAE;IAC9E,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC,cAAc,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAC7F,MAAM,MAAM,GAAG,sBAAsB,CAAC;IAEtC,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEzE,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;QAEvF,IAAI,QAAQ,IAAI,IAAI;YAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC;IACnF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,QAAgB,EAAE,MAAc,EAAiB,EAAE;IACtF,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,EAAE,QAAgB,EAA0B,EAAE;IACzF,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAC5E,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,QAAgB,EAAoB,EAAE,CAClE,CAAC,MAAM,wBAAwB,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC;AAErD,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,aAAqB,EACrB,IAAY,EACZ,GAAW,EACI,EAAE;IACjB,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,aAAqB,EAAE,IAAY,EAAiB,EAAE;IAC1F,MAAM,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;IAEhC,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAChD,MAAM,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE;QACjE,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,QAAgB,EAA0B,EAAE;IAC9E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAElF,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAE3D,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,QAAgB,EAAmB,EAAE;IAC5E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAE/E,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAEhE,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC,CAAC;AAUF,sFAAsF;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,aAAqB,EAAE,IAAY,EAAyB,EAAE;IAC/F,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAExD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI;QACpC,MAAM,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC;QACrC,MAAM,EAAE,MAAM,kBAAkB,CAAC,QAAQ,CAAC;QAC1C,UAAU,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;KAC3D,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAmB,EAAU,EAAE;IAClE,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,aAAa,CAAC;IAC9D,MAAM,KAAK,GACT,KAAK,CAAC,UAAU,GAAG,CAAC;QAClB,CAAC,CAAC,MAAM,KAAK,CAAC,UAAU,sBAAsB,KAAK,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;QACjF,CAAC,CAAC,EAAE,CAAC;IAET,OAAO,KAAK,KAAK,CAAC,IAAI,KAAK,QAAQ,GAAG,KAAK,EAAE,CAAC;AAChD,CAAC,CAAC"}

package/dist/extensions/projects/hooks.d.ts

@@ -0,0 +1,7 @@
+import type { Logger } from "../../log.ts";
+/**
+ * Bootstrap hook: ensure the projects directory exists, then initialize and
+ * sync every registered submodule (init → default branch checkout → pull) in
+ * parallel with per-submodule error isolation and one retry each.
+ */
+export declare const syncProjects: (workspaceRoot: string, log: Logger) => Promise<void>;

package/dist/extensions/projects/hooks.js

@@ -0,0 +1,42 @@
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { smartPull } from "../git/sync.js";
+import { checkoutBranch, initSubmodule, listSubmodules, resolveDefaultBranch } from "./git.js";
+const syncSubmodule = async (workspaceRoot, path, log) => {
+    const repoPath = join(workspaceRoot, path);
+    await initSubmodule(workspaceRoot, path);
+    const defaultBranch = await resolveDefaultBranch(repoPath);
+    await checkoutBranch(repoPath, defaultBranch);
+    const result = await smartPull(repoPath, "origin", defaultBranch, log);
+    log.info({ path, result }, "submodule synced");
+};
+const syncSubmoduleWithRetry = async (workspaceRoot, path, log) => {
+    try {
+        await syncSubmodule(workspaceRoot, path, log);
+    }
+    catch (error) {
+        log.debug({ path, err: error }, "submodule sync failed — retrying");
+        await syncSubmodule(workspaceRoot, path, log);
+    }
+};
+/**
+ * Bootstrap hook: ensure the projects directory exists, then initialize and
+ * sync every registered submodule (init → default branch checkout → pull) in
+ * parallel with per-submodule error isolation and one retry each.
+ */
+export const syncProjects = async (workspaceRoot, log) => {
+    await mkdir(join(workspaceRoot, "projects"), { recursive: true });
+    const submodulePaths = await listSubmodules(workspaceRoot);
+    if (submodulePaths.length === 0) {
+        log.debug("no submodules found — skipping sync");
+        return;
+    }
+    log.info({ count: submodulePaths.length, paths: submodulePaths }, "syncing submodules");
+    const results = await Promise.allSettled(submodulePaths.map((path) => syncSubmoduleWithRetry(workspaceRoot, path, log)));
+    for (const [index, result] of results.entries()) {
+        if (result.status === "rejected") {
+            log.warn({ path: submodulePaths[index], err: result.reason }, "submodule sync failed after retry");
+        }
+    }
+};
+//# sourceMappingURL=hooks.js.map

package/dist/extensions/projects/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/extensions/projects/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAE/F,MAAM,aAAa,GAAG,KAAK,EAAE,aAAqB,EAAE,IAAY,EAAE,GAAW,EAAiB,EAAE;IAC9F,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAE3C,MAAM,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAEzC,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAE9C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;IACvE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC;AACjD,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,KAAK,EAClC,aAAqB,EACrB,IAAY,EACZ,GAAW,EACI,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,kCAAkC,CAAC,CAAC;QACpE,MAAM,aAAa,CAAC,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,aAAqB,EAAE,GAAW,EAAiB,EAAE;IACtF,MAAM,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElE,MAAM,cAAc,GAAG,MAAM,cAAc,CAAC,aAAa,CAAC,CAAC;IAE3D,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,GAAG,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAExF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAC/E,CAAC;IAEF,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,GAAG,CAAC,IAAI,CACN,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,EACnD,mCAAmC,CACpC,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}

package/dist/extensions/projects/index.d.ts

@@ -0,0 +1,11 @@
+interface ProjectsConfig {
+    enabled: boolean;
+}
+/**
+ * External project management: registers git repositories as submodules under
+ * projects/, syncs them on startup, surfaces their git state on every message,
+ * and commits + pushes dirty projects at session close (before the workspace
+ * commit, so submodule pointer updates land in the same pass).
+ */
+declare const _default: import("../api.ts").TachikomaExtension<ProjectsConfig>;
+export default _default;

package/dist/extensions/projects/index.js

@@ -0,0 +1,30 @@
+import { Type } from "typebox";
+import { defineExtension } from "../api.js";
+import { createProjectsContextProvider } from "./context-provider.js";
+import { syncProjects } from "./hooks.js";
+import { createProjectsProcessor } from "./processor.js";
+import { createProjectsToolsFactory } from "./tools.js";
+/**
+ * External project management: registers git repositories as submodules under
+ * projects/, syncs them on startup, surfaces their git state on every message,
+ * and commits + pushes dirty projects at session close (before the workspace
+ * commit, so submodule pointer updates land in the same pass).
+ */
+export default defineExtension({
+    name: "projects",
+    configSchema: Type.Object({
+        enabled: Type.Boolean({ default: true }),
+    }),
+    setup(app) {
+        if (!app.extensionConfig.enabled) {
+            app.log.info("projects extension disabled by configuration");
+            return;
+        }
+        const workspaceRoot = app.workspace.root;
+        app.bootstrap("sync-projects", () => syncProjects(workspaceRoot, app.log));
+        app.agent.provideContext(createProjectsContextProvider(workspaceRoot, app.log));
+        app.agent.use(createProjectsToolsFactory({ workspaceRoot, log: app.log }));
+        app.sessions.registerProcessor(createProjectsProcessor({ workspaceRoot, side: app.agent.side }));
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/extensions/projects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/projects/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAMxD;;;;;GAKG;AACH,eAAe,eAAe,CAAiB;IAC7C,IAAI,EAAE,UAAU;IAEhB,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC;QACxB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KACzC,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;YACjC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;QAEzC,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAE3E,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,6BAA6B,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAChF,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAE3E,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAC5B,uBAAuB,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CACjE,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/extensions/projects/processor.d.ts

@@ -0,0 +1,13 @@
+import type { PostProcessor } from "../api.ts";
+import { type Completer } from "../git/commit.ts";
+export interface ProjectsProcessorDeps {
+    workspaceRoot: string;
+    side: Completer;
+}
+export declare const projectFallbackMessage: (name: string, now?: Date) => string;
+/**
+ * Pre-finalize post-processor: commits and pushes every dirty registered
+ * project before the workspace commit runs, so submodule pointer updates land
+ * in the same workspace commit pass.
+ */
+export declare const createProjectsProcessor: ({ workspaceRoot, side, }: ProjectsProcessorDeps) => PostProcessor;