@asermax/tachikoma 2.0.0

package/dist/db/schema.d.ts

@@ -0,0 +1,4 @@
+export * from "../extensions/detached-processes/schema.ts";
+export * from "../extensions/tasks/schema.ts";
+export * from "../extensions/workflows/schema.ts";
+export * from "./core-schema.ts";

package/dist/db/schema.js

@@ -0,0 +1,7 @@
+// Aggregate drizzle schema: core tables plus every first-party extension's tables.
+// drizzle-kit reads this module to generate migrations for the whole app.
+export * from "../extensions/detached-processes/schema.js";
+export * from "../extensions/tasks/schema.js";
+export * from "../extensions/workflows/schema.js";
+export * from "./core-schema.js";
+//# sourceMappingURL=schema.js.map

package/dist/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,0EAA0E;AAE1E,cAAc,4CAA4C,CAAC;AAC3D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,kBAAkB,CAAC"}

package/dist/db/state.d.ts

@@ -0,0 +1,10 @@
+import type { AppDatabase } from "./index.ts";
+/** Namespaced key-value persistence for state that does not warrant its own tables. */
+export declare class KeyValueState {
+    private readonly db;
+    private readonly namespace;
+    constructor(db: AppDatabase, namespace: string);
+    get<T>(key: string): T | null;
+    set<T>(key: string, value: T): void;
+    delete(key: string): void;
+}

package/dist/db/state.js

@@ -0,0 +1,36 @@
+import { and, eq } from "drizzle-orm";
+import { appState } from "./core-schema.js";
+/** Namespaced key-value persistence for state that does not warrant its own tables. */
+export class KeyValueState {
+    db;
+    namespace;
+    constructor(db, namespace) {
+        this.db = db;
+        this.namespace = namespace;
+    }
+    get(key) {
+        const row = this.db
+            .select()
+            .from(appState)
+            .where(and(eq(appState.namespace, this.namespace), eq(appState.key, key)))
+            .get();
+        return row == null ? null : row.value;
+    }
+    set(key, value) {
+        this.db
+            .insert(appState)
+            .values({ namespace: this.namespace, key, value, updatedAt: new Date() })
+            .onConflictDoUpdate({
+            target: [appState.namespace, appState.key],
+            set: { value, updatedAt: new Date() },
+        })
+            .run();
+    }
+    delete(key) {
+        this.db
+            .delete(appState)
+            .where(and(eq(appState.namespace, this.namespace), eq(appState.key, key)))
+            .run();
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/db/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/db/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,uFAAuF;AACvF,MAAM,OAAO,aAAa;IACP,EAAE,CAAc;IAChB,SAAS,CAAS;IAEnC,YAAY,EAAe,EAAE,SAAiB;QAC5C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,GAAG,CAAI,GAAW;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,MAAM,EAAE;aACR,IAAI,CAAC,QAAQ,CAAC;aACd,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;aACzE,GAAG,EAAE,CAAC;QAET,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,GAAG,CAAC,KAAW,CAAC;IAC/C,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ;QAC1B,IAAI,CAAC,EAAE;aACJ,MAAM,CAAC,QAAQ,CAAC;aAChB,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;aACxE,kBAAkB,CAAC;YAClB,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC;YAC1C,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE;SACtC,CAAC;aACD,GAAG,EAAE,CAAC;IACX,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,EAAE;aACJ,MAAM,CAAC,QAAQ,CAAC;aAChB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;aACzE,GAAG,EAAE,CAAC;IACX,CAAC;CACF"}

package/dist/domain/agent-events.d.ts

@@ -0,0 +1,26 @@
+export type AgentEvent = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "thinking";
+    text: string;
+} | {
+    kind: "tool-start";
+    toolCallId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+} | {
+    kind: "tool-end";
+    toolCallId: string;
+    toolName: string;
+    isError: boolean;
+} | {
+    kind: "status";
+    text: string;
+} | {
+    kind: "result";
+    stopReason: "done" | "aborted" | "error";
+} | {
+    kind: "error";
+    message: string;
+};

package/dist/domain/agent-events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-events.js.map

package/dist/domain/agent-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-events.js","sourceRoot":"","sources":["../../src/domain/agent-events.ts"],"names":[],"mappings":""}

package/dist/domain/message.d.ts

@@ -0,0 +1,25 @@
+export declare const MEDIA_KINDS: {
+    readonly photo: "photo";
+    readonly audio: "audio";
+    readonly voice: "voice";
+    readonly document: "document";
+    readonly video: "video";
+    readonly animation: "animation";
+    readonly sticker: "sticker";
+};
+export type MediaKind = keyof typeof MEDIA_KINDS;
+export interface MediaAttachment {
+    kind: MediaKind;
+    path: string;
+    mimeType?: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface InboundMessage {
+    text: string;
+    channel: string;
+    receivedAt: Date;
+    media: MediaAttachment[];
+    metadata: Record<string, unknown>;
+}
+export declare const textMessage: (channel: string, text: string) => InboundMessage;

package/dist/domain/message.js

@@ -0,0 +1,17 @@
+export const MEDIA_KINDS = {
+    photo: "photo",
+    audio: "audio",
+    voice: "voice",
+    document: "document",
+    video: "video",
+    animation: "animation",
+    sticker: "sticker",
+};
+export const textMessage = (channel, text) => ({
+    text,
+    channel,
+    receivedAt: new Date(),
+    media: [],
+    metadata: {},
+});
+//# sourceMappingURL=message.js.map

package/dist/domain/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/domain/message.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;CACV,CAAC;AAoBX,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,IAAY,EAAkB,EAAE,CAAC,CAAC;IAC7E,IAAI;IACJ,OAAO;IACP,UAAU,EAAE,IAAI,IAAI,EAAE;IACtB,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,9 @@
+import type { Logger } from "./log.ts";
+export type EventHandler<T> = (payload: T) => void | Promise<void>;
+export declare class EventBus {
+    private readonly handlers;
+    private readonly log;
+    constructor(log: Logger);
+    on<T = unknown>(event: string, handler: EventHandler<T>): () => void;
+    emit<T = unknown>(event: string, payload: T): void;
+}

package/dist/events.js

@@ -0,0 +1,27 @@
+export class EventBus {
+    handlers = new Map();
+    log;
+    constructor(log) {
+        this.log = log;
+    }
+    on(event, handler) {
+        const set = this.handlers.get(event) ?? new Set();
+        set.add(handler);
+        this.handlers.set(event, set);
+        return () => {
+            set.delete(handler);
+        };
+    }
+    emit(event, payload) {
+        const set = this.handlers.get(event);
+        if (set == null)
+            return;
+        for (const handler of set) {
+            // Handlers are isolated: one failing subscriber never affects the others.
+            void Promise.resolve()
+                .then(() => handler(payload))
+                .catch((error) => this.log.error({ event, err: error }, "event handler failed"));
+        }
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,QAAQ;IACF,QAAQ,GAAG,IAAI,GAAG,EAAoC,CAAC;IACvD,GAAG,CAAS;IAE7B,YAAY,GAAW;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,EAAE,CAAc,KAAa,EAAE,OAAwB;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,OAA8B,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAE9B,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,MAAM,CAAC,OAA8B,CAAC,CAAC;QAC7C,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAc,KAAa,EAAE,OAAU;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO;QAExB,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;YAC1B,0EAA0E;YAC1E,KAAK,OAAO,CAAC,OAAO,EAAE;iBACnB,IAAI,CAAC,GAAG,EAAE,CAAE,OAA2B,CAAC,OAAO,CAAC,CAAC;iBACjD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;CACF"}

package/dist/extensions/api.d.ts

@@ -0,0 +1,118 @@
+import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
+import type { TSchema } from "typebox";
+import type { ModelTiers } from "../agent/models.ts";
+import type { SideRunner } from "../agent/side-run.ts";
+import type { Channel, Delivery } from "../channels/types.ts";
+import type { Config } from "../config/schema.ts";
+import type { SessionRecord } from "../db/core-schema.ts";
+import type { AppDatabase } from "../db/index.ts";
+import type { KeyValueState } from "../db/state.ts";
+import type { InboundMessage } from "../domain/message.ts";
+import type { EventBus } from "../events.ts";
+import type { Logger } from "../log.ts";
+import type { Scheduler } from "../scheduler.ts";
+import type { Workspace } from "../workspace.ts";
+export interface ContextBlock {
+    /** Tag identifying the owner section, e.g. "memories", "projects". */
+    tag: string;
+    content: string;
+}
+export interface ContextProviderInput {
+    message: InboundMessage;
+    session: SessionRecord;
+}
+export interface ContextProvider {
+    name: string;
+    provide(input: ContextProviderInput): Promise<ContextBlock | null>;
+}
+export interface ExchangeContext {
+    session: SessionRecord;
+    userText: string;
+    assistantText: string;
+}
+export type ExchangeProcessor = {
+    name: string;
+    process(context: ExchangeContext): Promise<void>;
+};
+export declare const POST_PROCESSING_PHASES: {
+    readonly main: "main";
+    readonly preFinalize: "preFinalize";
+    readonly finalize: "finalize";
+};
+export type PostProcessingPhase = keyof typeof POST_PROCESSING_PHASES;
+export interface PostProcessorContext {
+    session: SessionRecord;
+    /** Path to the pi session JSONL transcript, when the session persisted one. */
+    transcriptPath: string | null;
+    log: Logger;
+}
+export interface PostProcessor {
+    name: string;
+    phase?: PostProcessingPhase;
+    process(context: PostProcessorContext): Promise<void>;
+}
+export interface InboundContext {
+    session: SessionRecord | null;
+    /** Close the active session (post-processing runs) before the message is handled. */
+    closeSession(): Promise<void>;
+    /** Resume a previously closed session and make it active. */
+    resumeSession(session: SessionRecord): Promise<void>;
+}
+export type InboundMiddleware = (message: InboundMessage, context: InboundContext, next: () => Promise<void>) => Promise<void>;
+export interface SessionsApi {
+    current(): SessionRecord | null;
+    get(id: number): SessionRecord | null;
+    update(id: number, patch: Partial<Pick<SessionRecord, "summary" | "lastExchange">>): SessionRecord;
+    listResumable(): SessionRecord[];
+    /** Close the active session immediately — callers must know no exchange is streaming. */
+    close(): Promise<void>;
+    /** Close the active session only when no exchange is in flight; returns whether it closed. */
+    closeIfIdle(): Promise<boolean>;
+    /** Abort the in-flight agent run, if any (user-initiated stop). */
+    abortExchange(): Promise<void>;
+    onOpen(hook: (session: SessionRecord) => void | Promise<void>): void;
+    onExchange(processor: ExchangeProcessor): void;
+    registerProcessor(processor: PostProcessor): void;
+}
+export interface ChannelsApi {
+    register(channel: Channel): void;
+    deliver(delivery: Delivery): void;
+}
+export interface AgentApi {
+    /** Contribute a pi extension factory to every agent session the host creates. */
+    use(factory: ExtensionFactory): void;
+    /** Contribute a section to the agent's system prompt (replaces pi's coding prompt). */
+    systemPrompt(builder: () => string): void;
+    provideContext(provider: ContextProvider): void;
+    readonly models: ModelTiers;
+    /** Side-channel LLM work: headless runs and structured classification. */
+    readonly side: SideRunner;
+}
+export interface InboundApi {
+    use(middleware: InboundMiddleware): void;
+}
+export interface AppContext<C = unknown> {
+    readonly config: Config;
+    readonly extensionConfig: C;
+    readonly workspace: Workspace;
+    readonly log: Logger;
+    readonly db: AppDatabase;
+    readonly state: KeyValueState;
+    readonly events: EventBus;
+    readonly scheduler: Scheduler;
+    readonly sessions: SessionsApi;
+    readonly channels: ChannelsApi;
+    readonly agent: AgentApi;
+    readonly inbound: InboundApi;
+    bootstrap(name: string, hook: () => void | Promise<void>): void;
+    /** Surface a progress line through the active channel while processing. */
+    status(text: string): void;
+    /** Enqueue another extension for loading (external extension support). */
+    registerExtension(extension: TachikomaExtension<never>): void;
+}
+export interface TachikomaExtension<C = unknown> {
+    name: string;
+    configSchema?: TSchema;
+    setup(app: AppContext<C>): void | Promise<void>;
+}
+export declare const defineExtension: <C = unknown>(extension: TachikomaExtension<C>) => TachikomaExtension<C>;

package/dist/extensions/api.js

@@ -0,0 +1,7 @@
+export const POST_PROCESSING_PHASES = {
+    main: "main",
+    preFinalize: "preFinalize",
+    finalize: "finalize",
+};
+export const defineExtension = (extension) => extension;
+//# sourceMappingURL=api.js.map

package/dist/extensions/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/extensions/api.ts"],"names":[],"mappings":"AA4CA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,UAAU;CACZ,CAAC;AAqGX,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,SAAgC,EACT,EAAE,CAAC,SAAS,CAAC"}

package/dist/extensions/boundary/detector.d.ts

@@ -0,0 +1,20 @@
+import { type Static, Type } from "typebox";
+import type { SideRunner } from "../../agent/side-run.ts";
+import type { Logger } from "../../log.ts";
+export declare const BoundaryDecisionSchema: Type.TObject<{
+    decision: Type.TUnsafe<"continue" | "new" | "resume">;
+    resumeSessionId: Type.TOptional<Type.TNumber>;
+}>;
+export type BoundaryDecision = Static<typeof BoundaryDecisionSchema>;
+export type Classifier = Pick<SideRunner, "classify">;
+export interface SessionCandidate {
+    id: number;
+    summary: string;
+}
+export interface BoundaryInput {
+    message: string;
+    activeSummary: string | null;
+    lastExchange: string | null;
+    candidates: SessionCandidate[];
+}
+export declare const detectBoundary: (classifier: Classifier, input: BoundaryInput, log: Logger) => Promise<BoundaryDecision>;

package/dist/extensions/boundary/detector.js

@@ -0,0 +1,57 @@
+import { StringEnum } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+export const BoundaryDecisionSchema = Type.Object({
+    decision: StringEnum(["continue", "new", "resume"]),
+    resumeSessionId: Type.Optional(Type.Number()),
+});
+const SYSTEM = `You segment an ongoing conversation with a personal assistant into topical sessions.
+
+Given the active session's rolling summary, the last exchange, a list of recently closed
+sessions, and a new incoming message, decide:
+
+- "continue": the message belongs to the active session's topic (default when in doubt,
+  and always when the message is a short reaction, follow-up, or answer to the assistant).
+- "new": the message clearly starts an unrelated topic.
+- "resume": the message clearly picks up the topic of one of the closed sessions listed
+  as candidates; set resumeSessionId to that candidate's id.
+
+Only choose "resume" when the match is unambiguous. Never invent ids.`;
+const renderInput = ({ message, activeSummary, lastExchange, candidates, }) => {
+    const sections = [
+        activeSummary != null
+            ? `<active-session-summary>\n${activeSummary}\n</active-session-summary>`
+            : "<active-session-summary>none — no session is active</active-session-summary>",
+        lastExchange != null ? `<last-exchange>\n${lastExchange}\n</last-exchange>` : null,
+        candidates.length > 0
+            ? `<closed-sessions>\n${candidates
+                .map((candidate) => `- id ${candidate.id}: ${candidate.summary}`)
+                .join("\n")}\n</closed-sessions>`
+            : null,
+        `<incoming-message>\n${message}\n</incoming-message>`,
+    ];
+    return sections.filter((section) => section != null).join("\n\n");
+};
+export const detectBoundary = async (classifier, input, log) => {
+    try {
+        const decision = await classifier.classify({
+            system: SYSTEM,
+            user: renderInput(input),
+            schema: BoundaryDecisionSchema,
+            tier: "classifier",
+        });
+        if (decision.decision === "resume") {
+            const valid = input.candidates.some((candidate) => candidate.id === decision.resumeSessionId);
+            if (!valid) {
+                log.warn({ decision }, "boundary picked an unknown session id — continuing instead");
+                return { decision: "continue" };
+            }
+        }
+        return decision;
+    }
+    catch (error) {
+        // Boundary detection is best-effort: a failure must never block the message.
+        log.error({ err: error }, "boundary detection failed — continuing active session");
+        return { decision: "continue" };
+    }
+};
+//# sourceMappingURL=detector.js.map

package/dist/extensions/boundary/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../src/extensions/boundary/detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAK5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,UAAU,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAU,CAAC;IAC5D,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;CAC9C,CAAC,CAAC;AAkBH,MAAM,MAAM,GAAG;;;;;;;;;;;sEAWuD,CAAC;AAEvE,MAAM,WAAW,GAAG,CAAC,EACnB,OAAO,EACP,aAAa,EACb,YAAY,EACZ,UAAU,GACI,EAAU,EAAE;IAC1B,MAAM,QAAQ,GAAG;QACf,aAAa,IAAI,IAAI;YACnB,CAAC,CAAC,6BAA6B,aAAa,6BAA6B;YACzE,CAAC,CAAC,8EAA8E;QAClF,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,oBAAoB,YAAY,oBAAoB,CAAC,CAAC,CAAC,IAAI;QAClF,UAAU,CAAC,MAAM,GAAG,CAAC;YACnB,CAAC,CAAC,sBAAsB,UAAU;iBAC7B,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;iBAChE,IAAI,CAAC,IAAI,CAAC,sBAAsB;YACrC,CAAC,CAAC,IAAI;QACR,uBAAuB,OAAO,uBAAuB;KACtD,CAAC;IAEF,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,UAAsB,EACtB,KAAoB,EACpB,GAAW,EACgB,EAAE;IAC7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC;YACzC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC;YACxB,MAAM,EAAE,sBAAsB;YAC9B,IAAI,EAAE,YAAY;SACnB,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,eAAe,CAAC,CAAC;YAE9F,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,4DAA4D,CAAC,CAAC;gBACrF,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;YAClC,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,6EAA6E;QAC7E,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,uDAAuD,CAAC,CAAC;QACnF,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAClC,CAAC;AACH,CAAC,CAAC"}

package/dist/extensions/boundary/idle.d.ts

@@ -0,0 +1,10 @@
+import type { Logger } from "../../log.ts";
+import type { SessionsApi } from "../api.ts";
+export type IdleSessions = Pick<SessionsApi, "onExchange" | "closeIfIdle">;
+/**
+ * Temporal session boundary: after each exchange, (re)arm a timer that closes
+ * the session once the conversation has been silent for idleCloseSeconds.
+ * closeIfIdle() no-ops when an exchange is in flight, and the timer is re-armed
+ * by the next exchange — so a firing during activity loses nothing.
+ */
+export declare const registerIdleClose: (sessions: IdleSessions, idleCloseSeconds: number, log: Logger) => void;

package/dist/extensions/boundary/idle.js

@@ -0,0 +1,28 @@
+/**
+ * Temporal session boundary: after each exchange, (re)arm a timer that closes
+ * the session once the conversation has been silent for idleCloseSeconds.
+ * closeIfIdle() no-ops when an exchange is in flight, and the timer is re-armed
+ * by the next exchange — so a firing during activity loses nothing.
+ */
+export const registerIdleClose = (sessions, idleCloseSeconds, log) => {
+    let timer = null;
+    sessions.onExchange({
+        name: "idle-close-timer",
+        async process() {
+            if (timer != null)
+                clearTimeout(timer);
+            timer = setTimeout(() => {
+                timer = null;
+                void sessions
+                    .closeIfIdle()
+                    .then((closed) => {
+                    if (closed)
+                        log.info({ idleCloseSeconds }, "idle timeout reached — session closed");
+                })
+                    .catch((error) => log.error({ err: error }, "idle close failed"));
+            }, idleCloseSeconds * 1000);
+            timer.unref();
+        },
+    });
+};
+//# sourceMappingURL=idle.js.map

package/dist/extensions/boundary/idle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle.js","sourceRoot":"","sources":["../../../src/extensions/boundary/idle.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,QAAsB,EACtB,gBAAwB,EACxB,GAAW,EACL,EAAE;IACR,IAAI,KAAK,GAA0B,IAAI,CAAC;IAExC,QAAQ,CAAC,UAAU,CAAC;QAClB,IAAI,EAAE,kBAAkB;QAExB,KAAK,CAAC,OAAO;YACX,IAAI,KAAK,IAAI,IAAI;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAEvC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,KAAK,GAAG,IAAI,CAAC;gBAEb,KAAK,QAAQ;qBACV,WAAW,EAAE;qBACb,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;oBACf,IAAI,MAAM;wBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,EAAE,uCAAuC,CAAC,CAAC;gBACtF,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;YACtE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC,CAAC;YAC5B,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+interface BoundaryConfig {
+    enabled: boolean;
+    idleCloseSeconds: number;
+}
+/**
+ * Conversation boundaries, temporal and topical: closes sessions after a silence
+ * window, keeps a rolling per-session summary after every exchange, and classifies
+ * each incoming message as continuing the active session, starting a fresh one,
+ * or resuming a recently closed one.
+ */
+declare const _default: import("../api.ts").TachikomaExtension<BoundaryConfig>;
+export default _default;

package/dist/extensions/boundary/index.js

@@ -0,0 +1,65 @@
+import { Type } from "typebox";
+import { defineExtension } from "../api.js";
+import { detectBoundary } from "./detector.js";
+import { registerIdleClose } from "./idle.js";
+import { createSummaryProcessor } from "./summary.js";
+/**
+ * Conversation boundaries, temporal and topical: closes sessions after a silence
+ * window, keeps a rolling per-session summary after every exchange, and classifies
+ * each incoming message as continuing the active session, starting a fresh one,
+ * or resuming a recently closed one.
+ */
+export default defineExtension({
+    name: "boundary",
+    configSchema: Type.Object({
+        // Gates topic-shift detection; the idle boundary is governed only by idleCloseSeconds.
+        enabled: Type.Boolean({ default: true }),
+        // Seconds of conversation silence before the active session closes (0 disables).
+        idleCloseSeconds: Type.Number({ default: 900 }),
+    }),
+    setup(app) {
+        if (app.extensionConfig.idleCloseSeconds > 0) {
+            registerIdleClose(app.sessions, app.extensionConfig.idleCloseSeconds, app.log);
+        }
+        if (!app.extensionConfig.enabled) {
+            app.log.info("boundary detection disabled by configuration");
+            return;
+        }
+        app.sessions.onExchange(createSummaryProcessor(app.agent.side, app.sessions, app.log));
+        app.inbound.use(async (message, context, next) => {
+            // System-originated injections (session tasks, notices) never shift topics.
+            if (message.metadata.boundary === "skip")
+                return next();
+            const active = context.session;
+            const candidates = app.sessions
+                .listResumable()
+                .filter((session) => session.summary != null && session.id !== active?.id)
+                .map((session) => ({ id: session.id, summary: session.summary }));
+            // Nothing to compare against: first-ever message, or an active session that
+            // has not produced a summary yet and no resumable history.
+            if ((active == null || active.summary == null) && candidates.length === 0) {
+                return next();
+            }
+            app.status("Checking conversation topic…");
+            const decision = await detectBoundary(app.agent.side, {
+                message: message.text,
+                activeSummary: active?.summary ?? null,
+                lastExchange: active?.lastExchange ?? null,
+                candidates,
+            }, app.log);
+            if (decision.decision === "new" && active != null) {
+                app.status("Topic shift — closing the previous session");
+                await context.closeSession();
+            }
+            else if (decision.decision === "resume" && decision.resumeSessionId != null) {
+                const target = app.sessions.get(decision.resumeSessionId);
+                if (target != null) {
+                    app.status("Resuming a previous conversation");
+                    await context.resumeSession(target);
+                }
+            }
+            return next();
+        });
+    },
+});
+//# sourceMappingURL=index.js.map

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

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

package/dist/extensions/boundary/summary.d.ts

@@ -0,0 +1,5 @@
+import type { SideRunner } from "../../agent/side-run.ts";
+import type { Logger } from "../../log.ts";
+import type { ExchangeProcessor, SessionsApi } from "../api.ts";
+export type Completer = Pick<SideRunner, "complete">;
+export declare const createSummaryProcessor: (side: Completer, sessions: SessionsApi, log: Logger) => ExchangeProcessor;

package/dist/extensions/boundary/summary.js

@@ -0,0 +1,33 @@
+const SUMMARY_SYSTEM = `You maintain a rolling one-paragraph summary of a conversation session.
+
+Given the previous summary (possibly empty) and the latest exchange, produce an updated
+summary capturing the session's topic and current state. Keep it under 80 words, factual,
+no preamble.`;
+const MAX_EXCHANGE_CHARS = 2000;
+const clip = (text, max) => text.length <= max ? text : `${text.slice(0, max)}…`;
+export const createSummaryProcessor = (side, sessions, log) => ({
+    name: "rolling-summary",
+    async process({ session, userText, assistantText }) {
+        const lastExchange = clip(`user: ${userText}\nassistant: ${assistantText}`, MAX_EXCHANGE_CHARS);
+        try {
+            const summary = await side.complete({
+                tier: "processor",
+                system: SUMMARY_SYSTEM,
+                user: [
+                    session.summary != null
+                        ? `Previous summary:\n${session.summary}`
+                        : "Previous summary: (none)",
+                    `Latest exchange:\n${lastExchange}`,
+                ].join("\n\n"),
+            });
+            sessions.update(session.id, { summary: clip(summary.trim(), 600), lastExchange });
+        }
+        catch (error) {
+            // Keep the verbatim exchange even when summarization fails — the boundary
+            // detector can still work with it on the next message.
+            log.error({ err: error }, "rolling summary failed");
+            sessions.update(session.id, { lastExchange });
+        }
+    },
+});
+//# sourceMappingURL=summary.js.map

package/dist/extensions/boundary/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../../src/extensions/boundary/summary.ts"],"names":[],"mappings":"AAIA,MAAM,cAAc,GAAG;;;;aAIV,CAAC;AAEd,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,GAAW,EAAU,EAAE,CACjD,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;AAIvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,IAAe,EACf,QAAqB,EACrB,GAAW,EACQ,EAAE,CAAC,CAAC;IACvB,IAAI,EAAE,iBAAiB;IAEvB,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,QAAQ,gBAAgB,aAAa,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAEhG,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;gBAClC,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,cAAc;gBACtB,IAAI,EAAE;oBACJ,OAAO,CAAC,OAAO,IAAI,IAAI;wBACrB,CAAC,CAAC,sBAAsB,OAAO,CAAC,OAAO,EAAE;wBACzC,CAAC,CAAC,0BAA0B;oBAC9B,qBAAqB,YAAY,EAAE;iBACpC,CAAC,IAAI,CAAC,MAAM,CAAC;aACf,CAAC,CAAC;YAEH,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0EAA0E;YAC1E,uDAAuD;YACvD,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,wBAAwB,CAAC,CAAC;YACpD,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Channel-agnostic conversation commands handled before the agent sees them.
+ * (/queue is handled at submit time by the coordinator, since steering happens
+ * before middleware runs; /stop is channel-level because it must act mid-stream.)
+ */
+declare const _default: import("../api.ts").TachikomaExtension<unknown>;
+export default _default;

package/dist/extensions/commands/index.js

@@ -0,0 +1,21 @@
+import { defineExtension } from "../api.js";
+/**
+ * Channel-agnostic conversation commands handled before the agent sees them.
+ * (/queue is handled at submit time by the coordinator, since steering happens
+ * before middleware runs; /stop is channel-level because it must act mid-stream.)
+ */
+export default defineExtension({
+    name: "commands",
+    setup(app) {
+        app.inbound.use(async (message, context, next) => {
+            if (message.text.trim() === "/new") {
+                message.metadata.handled = true;
+                await context.closeSession();
+                app.channels.deliver({ text: "🆕 Started a fresh session.", gate: "immediate" });
+                return;
+            }
+            return next();
+        });
+    },
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;GAIG;AACH,eAAe,eAAe,CAAC;IAC7B,IAAI,EAAE,UAAU;IAEhB,KAAK,CAAC,GAAG;QACP,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YAC/C,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;gBACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;gBAEhC,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;gBAC7B,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,6BAA6B,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;gBACjF,OAAO;YACT,CAAC;YAED,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Foundational context: SOUL.md (personality) and USER.md (durable user knowledge)
+ * compose the system prompt. AGENTS.md is discovered natively by pi from the
+ * workspace root, so it needs no handling here.
+ */
+declare const _default: import("../api.ts").TachikomaExtension<unknown>;
+export default _default;