@pcircle/footprint 1.5.0 → 1.6.0

package/dist/src/tools/get-session-messages.js

@@ -0,0 +1,89 @@
+import * as z from "zod";
+import { buildPageInfo, MAX_SESSION_DETAIL_PAGE_LIMIT, } from "../lib/session-history.js";
+import { formatSuccessResponse } from "../lib/tool-response.js";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { sessionDetailUiMetadata } from "./session-ui-metadata.js";
+const pageInfoSchema = z.object({
+    total: z.number(),
+    offset: z.number(),
+    limit: z.number(),
+    returned: z.number(),
+    hasMore: z.boolean(),
+    nextOffset: z.number().nullable(),
+});
+export const getSessionMessagesSchema = {
+    inputSchema: {
+        id: z.string().describe("ID of the recorded session"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .max(MAX_SESSION_DETAIL_PAGE_LIMIT)
+            .optional()
+            .describe("Optional page size for transcript pagination"),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe("Optional transcript offset for pagination"),
+    },
+    outputSchema: {
+        sessionId: z.string(),
+        total: z.number(),
+        page: pageInfoSchema,
+        messages: z.array(z.object({
+            id: z.string(),
+            sessionId: z.string(),
+            seq: z.number(),
+            role: z.enum(["user", "assistant", "system"]),
+            source: z.string(),
+            content: z.string(),
+            capturedAt: z.string(),
+            metadata: z.string().nullable(),
+        })),
+    },
+};
+export const getSessionMessagesMetadata = {
+    title: "Get Session Messages",
+    description: "Return the ordered raw transcript for a recorded session, with optional pagination.",
+    ...sessionDetailUiMetadata,
+};
+export function createGetSessionMessagesHandler(db) {
+    return wrapToolHandler("get-session-messages", "Verify the session ID exists and keep transcript pagination values valid before requesting transcript details.", async (params) => {
+        const session = db.findSessionById(params.id);
+        if (!session) {
+            throw new Error(`Session not found: ${params.id}`);
+        }
+        if (params.limit !== undefined &&
+            (params.limit <= 0 || params.limit > MAX_SESSION_DETAIL_PAGE_LIMIT)) {
+            throw new Error(`limit must be between 1 and ${MAX_SESSION_DETAIL_PAGE_LIMIT}`);
+        }
+        if (params.offset !== undefined && params.offset < 0) {
+            throw new Error("offset cannot be negative");
+        }
+        const offset = params.offset ?? 0;
+        const messages = db.getSessionMessages(params.id, {
+            limit: params.limit,
+            offset,
+        });
+        const total = db.countSessionMessages(params.id);
+        const page = buildPageInfo(total, messages.length, {
+            offset,
+            limit: params.limit ?? Math.max(messages.length, total - offset, 0),
+        });
+        return formatSuccessResponse("Session messages retrieved successfully", {
+            Session: params.id,
+            Messages: messages.length,
+            Total: total,
+            Offset: page.offset,
+            Limit: page.limit,
+        }, {
+            sessionId: params.id,
+            total,
+            page,
+            messages,
+        });
+    });
+}
+//# sourceMappingURL=get-session-messages.js.map

package/dist/src/tools/get-session-messages.js.map

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

package/dist/src/tools/get-session-narrative.d.ts

@@ -0,0 +1,72 @@
+import * as z from "zod";
+import type { EvidenceDatabase, NarrativeKind } from "../lib/storage/index.js";
+export declare const getSessionNarrativeSchema: {
+    inputSchema: {
+        id: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<{
+            journal: "journal";
+            "project-summary": "project-summary";
+            handoff: "handoff";
+        }>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    };
+    outputSchema: {
+        sessionId: z.ZodString;
+        page: z.ZodObject<{
+            total: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            returned: z.ZodNumber;
+            hasMore: z.ZodBoolean;
+            nextOffset: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        narratives: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            sessionId: z.ZodString;
+            kind: z.ZodEnum<{
+                journal: "journal";
+                "project-summary": "project-summary";
+                handoff: "handoff";
+            }>;
+            content: z.ZodString;
+            sourceRefs: z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+            }, z.core.$strip>>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, z.core.$strip>>;
+    };
+};
+export declare const getSessionNarrativeMetadata: {
+    _meta: {
+        readonly ui: {
+            readonly resourceUri: "ui://footprint/session-detail.html";
+        };
+    };
+    title: string;
+    description: string;
+};
+export declare function createGetSessionNarrativeHandler(db: EvidenceDatabase): (params: {
+    id: string;
+    kind?: NarrativeKind;
+    limit?: number;
+    offset?: number;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    sessionId: string;
+    page: import("../lib/session-history.js").PageInfo;
+    narratives: {
+        sourceRefs: {
+            type: string;
+            id: string;
+        }[];
+        id: string;
+        sessionId: string;
+        kind: NarrativeKind;
+        content: string;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+}>>;
+//# sourceMappingURL=get-session-narrative.d.ts.map

package/dist/src/tools/get-session-narrative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-session-narrative.d.ts","sourceRoot":"","sources":["../../../src/tools/get-session-narrative.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAQzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAoB/E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCrC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;CAKvC,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,EAAE,EAAE,gBAAgB;QAK3D,MAAM;WACH,aAAa;YACZ,MAAM;aACL,MAAM;;;;;;kBAxE4B,MAAM;gBAAM,MAAM;;;;;;;;;IA+HlE"}

package/dist/src/tools/get-session-narrative.js

@@ -0,0 +1,106 @@
+import * as z from "zod";
+import { buildPageInfo, DEFAULT_SESSION_DETAIL_PAGE_LIMIT, MAX_SESSION_DETAIL_PAGE_LIMIT, } from "../lib/session-history.js";
+import { formatSuccessResponse } from "../lib/tool-response.js";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { sessionDetailUiMetadata } from "./session-ui-metadata.js";
+function parseRefs(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return [];
+    }
+}
+const pageInfoSchema = z.object({
+    total: z.number(),
+    offset: z.number(),
+    limit: z.number(),
+    returned: z.number(),
+    hasMore: z.boolean(),
+    nextOffset: z.number().nullable(),
+});
+export const getSessionNarrativeSchema = {
+    inputSchema: {
+        id: z.string().describe("ID of the recorded session"),
+        kind: z
+            .enum(["journal", "project-summary", "handoff"])
+            .optional()
+            .describe("Optional narrative kind filter"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .max(MAX_SESSION_DETAIL_PAGE_LIMIT)
+            .optional()
+            .describe(`Optional page size for the narrative slice. Defaults to ${DEFAULT_SESSION_DETAIL_PAGE_LIMIT}.`),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe("Optional offset for the narrative slice."),
+    },
+    outputSchema: {
+        sessionId: z.string(),
+        page: pageInfoSchema,
+        narratives: z.array(z.object({
+            id: z.string(),
+            sessionId: z.string(),
+            kind: z.enum(["journal", "project-summary", "handoff"]),
+            content: z.string(),
+            sourceRefs: z.array(z.object({ type: z.string(), id: z.string() })),
+            createdAt: z.string(),
+            updatedAt: z.string(),
+        })),
+    },
+};
+export const getSessionNarrativeMetadata = {
+    title: "Get Session Narrative",
+    description: "Return paginated derived narratives for a session, including journal, project summary, and handoff views.",
+    ...sessionDetailUiMetadata,
+};
+export function createGetSessionNarrativeHandler(db) {
+    return wrapToolHandler("get-session-narrative", "Run reingest-session first if narratives have not been generated yet.", async (params) => {
+        const session = db.findSessionById(params.id);
+        if (!session) {
+            throw new Error(`Session not found: ${params.id}`);
+        }
+        const limit = params.limit ?? DEFAULT_SESSION_DETAIL_PAGE_LIMIT;
+        const offset = params.offset ?? 0;
+        if (limit <= 0 || limit > MAX_SESSION_DETAIL_PAGE_LIMIT) {
+            throw new Error(`limit must be between 1 and ${MAX_SESSION_DETAIL_PAGE_LIMIT}`);
+        }
+        if (offset < 0) {
+            throw new Error("offset cannot be negative");
+        }
+        const total = db.countSessionNarratives(params.id, {
+            kind: params.kind,
+        });
+        const narratives = db
+            .getSessionNarratives(params.id, {
+            kind: params.kind,
+            limit,
+            offset,
+        })
+            .map((narrative) => ({
+            ...narrative,
+            sourceRefs: parseRefs(narrative.sourceRefs),
+        }));
+        const page = buildPageInfo(total, narratives.length, {
+            offset,
+            limit,
+        });
+        return formatSuccessResponse("Session narratives retrieved successfully", {
+            Session: params.id,
+            Narratives: narratives.length,
+            Kind: params.kind ?? "all",
+            Offset: offset,
+            Limit: limit,
+        }, {
+            sessionId: params.id,
+            page,
+            narratives,
+        });
+    });
+}
+//# sourceMappingURL=get-session-narrative.js.map

package/dist/src/tools/get-session-narrative.js.map

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

package/dist/src/tools/get-session-timeline.d.ts

@@ -0,0 +1,55 @@
+import * as z from "zod";
+import type { EvidenceDatabase } from "../lib/storage/index.js";
+export declare const getSessionTimelineSchema: {
+    inputSchema: {
+        id: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    };
+    outputSchema: {
+        sessionId: z.ZodString;
+        total: z.ZodNumber;
+        page: z.ZodObject<{
+            total: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            returned: z.ZodNumber;
+            hasMore: z.ZodBoolean;
+            nextOffset: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        timeline: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            sessionId: z.ZodString;
+            seq: z.ZodNumber;
+            eventType: z.ZodString;
+            eventSubType: z.ZodNullable<z.ZodString>;
+            source: z.ZodString;
+            summary: z.ZodNullable<z.ZodString>;
+            payload: z.ZodNullable<z.ZodString>;
+            startedAt: z.ZodString;
+            endedAt: z.ZodNullable<z.ZodString>;
+            status: z.ZodNullable<z.ZodString>;
+            relatedMessageId: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    };
+};
+export declare const getSessionTimelineMetadata: {
+    _meta: {
+        readonly ui: {
+            readonly resourceUri: "ui://footprint/session-detail.html";
+        };
+    };
+    title: string;
+    description: string;
+};
+export declare function createGetSessionTimelineHandler(db: EvidenceDatabase): (params: {
+    id: string;
+    limit?: number;
+    offset?: number;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    sessionId: string;
+    total: number;
+    page: import("../lib/session-history.js").PageInfo;
+    timeline: import("../lib/storage/types.js").TimelineEventRecord[];
+}>>;
+//# sourceMappingURL=get-session-timeline.d.ts.map

package/dist/src/tools/get-session-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-session-timeline.d.ts","sourceRoot":"","sources":["../../../src/tools/get-session-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAOzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAWhE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCpC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;CAKtC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,gBAAgB;QAI3C,MAAM;YAAU,MAAM;aAAW,MAAM;;;;;;IA+C/D"}

package/dist/src/tools/get-session-timeline.js

@@ -0,0 +1,93 @@
+import * as z from "zod";
+import { buildPageInfo, MAX_SESSION_DETAIL_PAGE_LIMIT, } from "../lib/session-history.js";
+import { formatSuccessResponse } from "../lib/tool-response.js";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { sessionDetailUiMetadata } from "./session-ui-metadata.js";
+const pageInfoSchema = z.object({
+    total: z.number(),
+    offset: z.number(),
+    limit: z.number(),
+    returned: z.number(),
+    hasMore: z.boolean(),
+    nextOffset: z.number().nullable(),
+});
+export const getSessionTimelineSchema = {
+    inputSchema: {
+        id: z.string().describe("ID of the recorded session"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .max(MAX_SESSION_DETAIL_PAGE_LIMIT)
+            .optional()
+            .describe("Optional page size for timeline pagination"),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe("Optional timeline offset for pagination"),
+    },
+    outputSchema: {
+        sessionId: z.string(),
+        total: z.number(),
+        page: pageInfoSchema,
+        timeline: z.array(z.object({
+            id: z.string(),
+            sessionId: z.string(),
+            seq: z.number(),
+            eventType: z.string(),
+            eventSubType: z.string().nullable(),
+            source: z.string(),
+            summary: z.string().nullable(),
+            payload: z.string().nullable(),
+            startedAt: z.string(),
+            endedAt: z.string().nullable(),
+            status: z.string().nullable(),
+            relatedMessageId: z.string().nullable(),
+        })),
+    },
+};
+export const getSessionTimelineMetadata = {
+    title: "Get Session Timeline",
+    description: "Return the ordered timeline for a recorded session, with optional pagination.",
+    ...sessionDetailUiMetadata,
+};
+export function createGetSessionTimelineHandler(db) {
+    return wrapToolHandler("get-session-timeline", "Verify the session ID exists and keep timeline pagination values valid before requesting timeline details.", async (params) => {
+        const session = db.findSessionById(params.id);
+        if (!session) {
+            throw new Error(`Session not found: ${params.id}`);
+        }
+        if (params.limit !== undefined &&
+            (params.limit <= 0 || params.limit > MAX_SESSION_DETAIL_PAGE_LIMIT)) {
+            throw new Error(`limit must be between 1 and ${MAX_SESSION_DETAIL_PAGE_LIMIT}`);
+        }
+        if (params.offset !== undefined && params.offset < 0) {
+            throw new Error("offset cannot be negative");
+        }
+        const offset = params.offset ?? 0;
+        const timeline = db.getSessionTimeline(params.id, {
+            limit: params.limit,
+            offset,
+        });
+        const total = db.countSessionTimeline(params.id);
+        const page = buildPageInfo(total, timeline.length, {
+            offset,
+            limit: params.limit ?? Math.max(timeline.length, total - offset, 0),
+        });
+        return formatSuccessResponse("Session timeline retrieved successfully", {
+            Session: params.id,
+            Events: timeline.length,
+            Total: total,
+            Offset: page.offset,
+            Limit: page.limit,
+        }, {
+            sessionId: params.id,
+            total,
+            page,
+            timeline,
+        });
+    });
+}
+//# sourceMappingURL=get-session-timeline.js.map

package/dist/src/tools/get-session-timeline.js.map

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

package/dist/src/tools/get-session-trends.d.ts

@@ -0,0 +1,108 @@
+import * as z from "zod";
+import type { EvidenceDatabase } from "../lib/storage/index.js";
+export declare const getSessionTrendsSchema: {
+    inputSchema: {
+        id: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    };
+    outputSchema: {
+        sessionId: z.ZodString;
+        summary: z.ZodObject<{
+            totalTrends: z.ZodNumber;
+            crossSessionTrends: z.ZodNumber;
+            sessionAttempts: z.ZodNumber;
+            globalAttempts: z.ZodNumber;
+            otherSessions: z.ZodNumber;
+            activeBlockers: z.ZodNumber;
+            recoveredTrends: z.ZodNumber;
+            regressedTrends: z.ZodNumber;
+        }, z.core.$strip>;
+        page: z.ZodObject<{
+            total: z.ZodNumber;
+            offset: z.ZodNumber;
+            limit: z.ZodNumber;
+            returned: z.ZodNumber;
+            hasMore: z.ZodBoolean;
+            nextOffset: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        trends: z.ZodArray<z.ZodObject<{
+            issueKey: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodNullable<z.ZodString>;
+            issueFamilyKey: z.ZodNullable<z.ZodString>;
+            issueFamilyLabel: z.ZodNullable<z.ZodString>;
+            relatedIssueKeys: z.ZodArray<z.ZodString>;
+            blockerCategory: z.ZodString;
+            blockerState: z.ZodEnum<{
+                active: "active";
+                resolved: "resolved";
+            }>;
+            remediationState: z.ZodEnum<{
+                unresolved: "unresolved";
+                recovered: "recovered";
+                regressed: "regressed";
+                stable: "stable";
+            }>;
+            remediationSummary: z.ZodString;
+            lastSeenAt: z.ZodString;
+            latestFailureAt: z.ZodNullable<z.ZodString>;
+            latestSuccessAt: z.ZodNullable<z.ZodString>;
+            sessionCount: z.ZodNumber;
+            sessionAttempts: z.ZodNumber;
+            globalAttempts: z.ZodNumber;
+            sessionLatestOutcome: z.ZodString;
+            latestOutcome: z.ZodString;
+            hosts: z.ZodArray<z.ZodEnum<{
+                claude: "claude";
+                gemini: "gemini";
+                codex: "codex";
+            }>>;
+            statuses: z.ZodArray<z.ZodEnum<{
+                running: "running";
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>>;
+            relatedSessionCount: z.ZodNumber;
+            relatedSessions: z.ZodArray<z.ZodObject<{
+                sessionId: z.ZodString;
+                label: z.ZodString;
+                host: z.ZodEnum<{
+                    claude: "claude";
+                    gemini: "gemini";
+                    codex: "codex";
+                }>;
+                status: z.ZodEnum<{
+                    running: "running";
+                    completed: "completed";
+                    failed: "failed";
+                    interrupted: "interrupted";
+                }>;
+                lastAttemptAt: z.ZodString;
+                attempts: z.ZodNumber;
+                latestOutcome: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    };
+};
+export declare const getSessionTrendsMetadata: {
+    _meta: {
+        readonly ui: {
+            readonly resourceUri: "ui://footprint/session-detail.html";
+        };
+    };
+    title: string;
+    description: string;
+};
+export declare function createGetSessionTrendsHandler(db: EvidenceDatabase): (params: {
+    id: string;
+    limit?: number;
+    offset?: number;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    sessionId: string;
+    summary: import("../lib/session-trends.js").SessionTrendContextSummary;
+    page: import("../lib/session-history.js").PageInfo;
+    trends: import("../lib/session-trends.js").SessionTrendContextItem[];
+}>>;
+//# sourceMappingURL=get-session-trends.d.ts.map

package/dist/src/tools/get-session-trends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-session-trends.d.ts","sourceRoot":"","sources":["../../../src/tools/get-session-trends.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AASzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAmBhE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0ElC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;CAKpC,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,gBAAgB;QAIzC,MAAM;YAAU,MAAM;aAAW,MAAM;;;;;;IAiD/D"}