@pcircle/footprint 1.5.0 → 1.7.0

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

@@ -0,0 +1,151 @@
+import * as z from "zod";
+import type { ArtifactType, EvidenceDatabase } from "../lib/storage/index.js";
+export declare const getSessionArtifactsSchema: {
+    inputSchema: {
+        id: z.ZodString;
+        artifactType: z.ZodOptional<z.ZodEnum<{
+            "file-change": "file-change";
+            "command-output": "command-output";
+            "test-result": "test-result";
+            "git-commit": "git-commit";
+        }>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    };
+    outputSchema: {
+        sessionId: z.ZodString;
+        artifactSummary: z.ZodObject<{
+            total: z.ZodNumber;
+            byType: z.ZodObject<{
+                fileChange: z.ZodNumber;
+                commandOutput: z.ZodNumber;
+                testResult: z.ZodNumber;
+                gitCommit: z.ZodNumber;
+            }, z.core.$strip>;
+        }, 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>;
+        artifacts: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            sessionId: z.ZodString;
+            eventId: z.ZodNullable<z.ZodString>;
+            artifactType: z.ZodEnum<{
+                "file-change": "file-change";
+                "command-output": "command-output";
+                "test-result": "test-result";
+                "git-commit": "git-commit";
+            }>;
+            path: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodString;
+            summary: z.ZodString;
+            category: z.ZodNullable<z.ZodString>;
+            status: z.ZodNullable<z.ZodString>;
+            outcome: z.ZodNullable<z.ZodString>;
+            intent: z.ZodNullable<z.ZodString>;
+            commandFamily: z.ZodNullable<z.ZodString>;
+            command: z.ZodNullable<z.ZodString>;
+            args: z.ZodArray<z.ZodString>;
+            framework: z.ZodNullable<z.ZodString>;
+            packageManager: z.ZodNullable<z.ZodString>;
+            scriptName: z.ZodNullable<z.ZodString>;
+            dependencyAction: z.ZodNullable<z.ZodString>;
+            dependencyNames: z.ZodArray<z.ZodString>;
+            failureSignatureKey: z.ZodNullable<z.ZodString>;
+            failureSignatureLabel: z.ZodNullable<z.ZodString>;
+            errorCode: z.ZodNullable<z.ZodString>;
+            lintRuleId: z.ZodNullable<z.ZodString>;
+            testSuite: z.ZodNullable<z.ZodString>;
+            testCase: z.ZodNullable<z.ZodString>;
+            issueKey: z.ZodNullable<z.ZodString>;
+            issueLabel: z.ZodNullable<z.ZodString>;
+            issueFamilyKey: z.ZodNullable<z.ZodString>;
+            issueFamilyLabel: z.ZodNullable<z.ZodString>;
+            pathCategory: z.ZodNullable<z.ZodString>;
+            changeScope: z.ZodNullable<z.ZodString>;
+            manifestKind: z.ZodNullable<z.ZodString>;
+            previousHead: z.ZodNullable<z.ZodString>;
+            currentHead: z.ZodNullable<z.ZodString>;
+            sourceRefs: z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    message: "message";
+                    event: "event";
+                    artifact: "artifact";
+                }>;
+                id: z.ZodString;
+            }, z.core.$strip>>;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>;
+    };
+};
+export declare const getSessionArtifactsMetadata: {
+    _meta: {
+        readonly ui: {
+            readonly resourceUri: "ui://footprint/session-detail.html";
+        };
+    };
+    title: string;
+    description: string;
+};
+export declare function createGetSessionArtifactsHandler(db: EvidenceDatabase): (params: {
+    id: string;
+    artifactType?: ArtifactType;
+    limit?: number;
+    offset?: number;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    sessionId: string;
+    artifactSummary: {
+        total: number;
+        byType: {
+            fileChange: number;
+            commandOutput: number;
+            testResult: number;
+            gitCommit: number;
+        };
+    };
+    page: import("../lib/session-history.js").PageInfo;
+    artifacts: {
+        id: string;
+        sessionId: string;
+        eventId: string | null;
+        artifactType: ArtifactType;
+        path: string | null;
+        createdAt: string;
+        summary: string;
+        category: string | null;
+        status: string | null;
+        outcome: string | null;
+        intent: string | null;
+        commandFamily: string | null;
+        command: string | null;
+        args: string[];
+        framework: string | null;
+        packageManager: string | null;
+        scriptName: string | null;
+        dependencyAction: string | null;
+        dependencyNames: string[];
+        failureSignatureKey: string | null;
+        failureSignatureLabel: string | null;
+        errorCode: string | null;
+        lintRuleId: string | null;
+        testSuite: string | null;
+        testCase: string | null;
+        issueKey: string | null;
+        issueLabel: string | null;
+        issueFamilyKey: string | null;
+        issueFamilyLabel: string | null;
+        pathCategory: string | null;
+        changeScope: string | null;
+        manifestKind: string | null;
+        previousHead: string | null;
+        currentHead: string | null;
+        sourceRefs: import("../lib/session-artifacts.js").ArtifactSourceRef[];
+        details: Record<string, unknown>;
+    }[];
+}>>;
+//# sourceMappingURL=get-session-artifacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-session-artifacts.d.ts","sourceRoot":"","sources":["../../../src/tools/get-session-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AASzB,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAkB9E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFrC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;CAKvC,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,EAAE,EAAE,gBAAgB;QAK3D,MAAM;mBACK,YAAY;YACnB,MAAM;aACL,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8FpB"}

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

@@ -0,0 +1,184 @@
+import * as z from "zod";
+import { buildPageInfo, DEFAULT_SESSION_DETAIL_PAGE_LIMIT, MAX_SESSION_DETAIL_PAGE_LIMIT, } from "../lib/session-history.js";
+import { parseArtifactMetadata } from "../lib/session-artifacts.js";
+import { formatSuccessResponse } from "../lib/tool-response.js";
+import { wrapToolHandler } from "../lib/tool-wrapper.js";
+import { sessionDetailUiMetadata } from "./session-ui-metadata.js";
+const artifactTypeEnum = z.enum([
+    "file-change",
+    "command-output",
+    "test-result",
+    "git-commit",
+]);
+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 getSessionArtifactsSchema = {
+    inputSchema: {
+        id: z.string().describe("ID of the recorded session"),
+        artifactType: artifactTypeEnum
+            .optional()
+            .describe("Optional deterministic artifact type filter"),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .max(MAX_SESSION_DETAIL_PAGE_LIMIT)
+            .optional()
+            .describe(`Optional page size for the artifact slice. Defaults to ${DEFAULT_SESSION_DETAIL_PAGE_LIMIT}.`),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe("Optional offset for the artifact slice."),
+    },
+    outputSchema: {
+        sessionId: z.string(),
+        artifactSummary: z.object({
+            total: z.number(),
+            byType: z.object({
+                fileChange: z.number(),
+                commandOutput: z.number(),
+                testResult: z.number(),
+                gitCommit: z.number(),
+            }),
+        }),
+        page: pageInfoSchema,
+        artifacts: z.array(z.object({
+            id: z.string(),
+            sessionId: z.string(),
+            eventId: z.string().nullable(),
+            artifactType: artifactTypeEnum,
+            path: z.string().nullable(),
+            createdAt: z.string(),
+            summary: z.string(),
+            category: z.string().nullable(),
+            status: z.string().nullable(),
+            outcome: z.string().nullable(),
+            intent: z.string().nullable(),
+            commandFamily: z.string().nullable(),
+            command: z.string().nullable(),
+            args: z.array(z.string()),
+            framework: z.string().nullable(),
+            packageManager: z.string().nullable(),
+            scriptName: z.string().nullable(),
+            dependencyAction: z.string().nullable(),
+            dependencyNames: z.array(z.string()),
+            failureSignatureKey: z.string().nullable(),
+            failureSignatureLabel: z.string().nullable(),
+            errorCode: z.string().nullable(),
+            lintRuleId: z.string().nullable(),
+            testSuite: z.string().nullable(),
+            testCase: z.string().nullable(),
+            issueKey: z.string().nullable(),
+            issueLabel: z.string().nullable(),
+            issueFamilyKey: z.string().nullable(),
+            issueFamilyLabel: z.string().nullable(),
+            pathCategory: z.string().nullable(),
+            changeScope: z.string().nullable(),
+            manifestKind: z.string().nullable(),
+            previousHead: z.string().nullable(),
+            currentHead: z.string().nullable(),
+            sourceRefs: z.array(z.object({
+                type: z.enum(["message", "event", "artifact"]),
+                id: z.string(),
+            })),
+            details: z.record(z.string(), z.unknown()),
+        })),
+    },
+};
+export const getSessionArtifactsMetadata = {
+    title: "Get Session Artifacts",
+    description: "Return paginated deterministic artifacts extracted from a session history, including commands, tests, file changes, and git commits.",
+    ...sessionDetailUiMetadata,
+};
+export function createGetSessionArtifactsHandler(db) {
+    return wrapToolHandler("get-session-artifacts", "Run reingest-session first if deterministic artifacts 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 summary = db.getSessionArtifactSummary(params.id);
+        const total = db.countSessionArtifacts(params.id, {
+            artifactType: params.artifactType,
+        });
+        const artifacts = db
+            .getSessionArtifacts(params.id, {
+            artifactType: params.artifactType,
+            limit,
+            offset,
+        })
+            .map((artifact) => {
+            const metadata = parseArtifactMetadata(artifact.metadata);
+            return {
+                id: artifact.id,
+                sessionId: artifact.sessionId,
+                eventId: artifact.eventId,
+                artifactType: artifact.artifactType,
+                path: artifact.path,
+                createdAt: artifact.createdAt,
+                summary: metadata.summary ?? artifact.path ?? artifact.artifactType,
+                category: metadata.category,
+                status: metadata.status,
+                outcome: metadata.outcome,
+                intent: metadata.intent,
+                commandFamily: metadata.commandFamily,
+                command: metadata.command,
+                args: metadata.args,
+                framework: metadata.framework,
+                packageManager: metadata.packageManager,
+                scriptName: metadata.scriptName,
+                dependencyAction: metadata.dependencyAction,
+                dependencyNames: metadata.dependencyNames,
+                failureSignatureKey: metadata.failureSignatureKey,
+                failureSignatureLabel: metadata.failureSignatureLabel,
+                errorCode: metadata.errorCode,
+                lintRuleId: metadata.lintRuleId,
+                testSuite: metadata.testSuite,
+                testCase: metadata.testCase,
+                issueKey: metadata.issueKey,
+                issueLabel: metadata.issueLabel,
+                issueFamilyKey: metadata.issueFamilyKey,
+                issueFamilyLabel: metadata.issueFamilyLabel,
+                pathCategory: metadata.pathCategory,
+                changeScope: metadata.changeScope,
+                manifestKind: metadata.manifestKind,
+                previousHead: metadata.previousHead,
+                currentHead: metadata.currentHead,
+                sourceRefs: metadata.sourceRefs,
+                details: metadata.details,
+            };
+        });
+        const page = buildPageInfo(total, artifacts.length, {
+            offset,
+            limit,
+        });
+        return formatSuccessResponse("Session artifacts retrieved successfully", {
+            Session: params.id,
+            Artifacts: artifacts.length,
+            Filter: params.artifactType ?? "all",
+            Offset: offset,
+            Limit: limit,
+        }, {
+            sessionId: params.id,
+            artifactSummary: summary,
+            page,
+            artifacts,
+        });
+    });
+}
+//# sourceMappingURL=get-session-artifacts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-session-artifacts.js","sourceRoot":"","sources":["../../../src/tools/get-session-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EACL,aAAa,EACb,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC9B,aAAa;IACb,gBAAgB;IAChB,aAAa;IACb,YAAY;CACb,CAAC,CAAC;AACH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,WAAW,EAAE;QACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACrD,YAAY,EAAE,gBAAgB;aAC3B,QAAQ,EAAE;aACV,QAAQ,CAAC,6CAA6C,CAAC;QAC1D,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,GAAG,CAAC,6BAA6B,CAAC;aAClC,QAAQ,EAAE;aACV,QAAQ,CACP,0DAA0D,iCAAiC,GAAG,CAC/F;QACH,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,yCAAyC,CAAC;KACvD;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC;YACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;gBACtB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;gBACzB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;gBACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;aACtB,CAAC;SACH,CAAC;QACF,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,CAAC,CAAC,KAAK,CAChB,CAAC,CAAC,MAAM,CAAC;YACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,YAAY,EAAE,gBAAgB;YAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACjC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACvC,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YACpC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC1C,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACjC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACrC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACvC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,UAAU,EAAE,CAAC,CAAC,KAAK,CACjB,CAAC,CAAC,MAAM,CAAC;gBACP,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;gBAC9C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;aACf,CAAC,CACH;YACD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;SAC3C,CAAC,CACH;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,sIAAsI;IACxI,GAAG,uBAAuB;CAC3B,CAAC;AAEF,MAAM,UAAU,gCAAgC,CAAC,EAAoB;IACnE,OAAO,eAAe,CACpB,uBAAuB,EACvB,oFAAoF,EACpF,KAAK,EAAE,MAKN,EAAE,EAAE;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,iCAAiC,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAElC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,6BAA6B,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CACb,+BAA+B,6BAA6B,EAAE,CAC/D,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,EAAE,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,EAAE;YAChD,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,EAAE;aACjB,mBAAmB,CAAC,MAAM,CAAC,EAAE,EAAE;YAC9B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,KAAK;YACL,MAAM;SACP,CAAC;aACD,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChB,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC1D,OAAO;gBACL,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,YAAY;gBACnE,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,aAAa,EAAE,QAAQ,CAAC,aAAa;gBACrC,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,cAAc,EAAE,QAAQ,CAAC,cAAc;gBACvC,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;gBAC3C,eAAe,EAAE,QAAQ,CAAC,eAAe;gBACzC,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;gBACjD,qBAAqB,EAAE,QAAQ,CAAC,qBAAqB;gBACrD,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,cAAc,EAAE,QAAQ,CAAC,cAAc;gBACvC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;gBAC3C,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;aAC1B,CAAC;QACJ,CAAC,CAAC,CAAC;QACL,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE;YAClD,MAAM;YACN,KAAK;SACN,CAAC,CAAC;QAEH,OAAO,qBAAqB,CAC1B,0CAA0C,EAC1C;YACE,OAAO,EAAE,MAAM,CAAC,EAAE;YAClB,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,MAAM,EAAE,MAAM,CAAC,YAAY,IAAI,KAAK;YACpC,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,KAAK;SACb,EACD;YACE,SAAS,EAAE,MAAM,CAAC,EAAE;YACpB,eAAe,EAAE,OAAO;YACxB,IAAI;YACJ,SAAS;SACV,CACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,69 @@
+import * as z from "zod";
+import type { EvidenceDatabase } from "../lib/storage/index.js";
+export declare const getSessionDecisionsSchema: {
+    inputSchema: {
+        id: z.ZodString;
+        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>;
+        decisions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            sessionId: z.ZodString;
+            title: z.ZodString;
+            summary: z.ZodString;
+            rationale: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                proposed: "proposed";
+                accepted: "accepted";
+                rejected: "rejected";
+                open: "open";
+            }>;
+            sourceRefs: z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                id: z.ZodString;
+            }, z.core.$strip>>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>;
+    };
+};
+export declare const getSessionDecisionsMetadata: {
+    _meta: {
+        readonly ui: {
+            readonly resourceUri: "ui://footprint/session-detail.html";
+        };
+    };
+    title: string;
+    description: string;
+};
+export declare function createGetSessionDecisionsHandler(db: EvidenceDatabase): (params: {
+    id: string;
+    limit?: number;
+    offset?: number;
+}) => Promise<import("../lib/tool-response.js").ToolResponse<{
+    sessionId: string;
+    page: import("../lib/session-history.js").PageInfo;
+    decisions: {
+        sourceRefs: {
+            type: string;
+            id: string;
+        }[];
+        id: string;
+        sessionId: string;
+        title: string;
+        summary: string;
+        rationale: string | null;
+        status: import("../lib/storage/types.js").DecisionStatus;
+        createdAt: string;
+    }[];
+}>>;
+//# sourceMappingURL=get-session-decisions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-session-decisions.d.ts","sourceRoot":"","sources":["../../../src/tools/get-session-decisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAQzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAoBhE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCrC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;CAKvC,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,EAAE,EAAE,gBAAgB;QAI5C,MAAM;YAAU,MAAM;aAAW,MAAM;;;;;;kBAjEf,MAAM;gBAAM,MAAM;;;;;;;;;;IAmHlE"}

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

@@ -0,0 +1,99 @@
+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 getSessionDecisionsSchema = {
+    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 the decision slice. Defaults to ${DEFAULT_SESSION_DETAIL_PAGE_LIMIT}.`),
+        offset: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe("Optional offset for the decision slice."),
+    },
+    outputSchema: {
+        sessionId: z.string(),
+        page: pageInfoSchema,
+        decisions: z.array(z.object({
+            id: z.string(),
+            sessionId: z.string(),
+            title: z.string(),
+            summary: z.string(),
+            rationale: z.string().nullable(),
+            status: z.enum(["proposed", "accepted", "rejected", "open"]),
+            sourceRefs: z.array(z.object({ type: z.string(), id: z.string() })),
+            createdAt: z.string(),
+        })),
+    },
+};
+export const getSessionDecisionsMetadata = {
+    title: "Get Session Decisions",
+    description: "Return paginated derived decisions extracted from a session history.",
+    ...sessionDetailUiMetadata,
+};
+export function createGetSessionDecisionsHandler(db) {
+    return wrapToolHandler("get-session-decisions", "Run reingest-session first if decisions 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.countSessionDecisions(params.id);
+        const decisions = db
+            .getSessionDecisions(params.id, {
+            limit,
+            offset,
+        })
+            .map((decision) => ({
+            ...decision,
+            sourceRefs: parseRefs(decision.sourceRefs),
+        }));
+        const page = buildPageInfo(total, decisions.length, {
+            offset,
+            limit,
+        });
+        return formatSuccessResponse("Session decisions retrieved successfully", {
+            Session: params.id,
+            Decisions: decisions.length,
+            Offset: offset,
+            Limit: limit,
+        }, {
+            sessionId: params.id,
+            page,
+            decisions,
+        });
+    });
+}
+//# sourceMappingURL=get-session-decisions.js.map

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

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

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

@@ -0,0 +1,55 @@
+import * as z from "zod";
+import type { EvidenceDatabase } from "../lib/storage/index.js";
+export declare const getSessionMessagesSchema: {
+    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>;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            sessionId: z.ZodString;
+            seq: z.ZodNumber;
+            role: z.ZodEnum<{
+                user: "user";
+                assistant: "assistant";
+                system: "system";
+            }>;
+            source: z.ZodString;
+            content: z.ZodString;
+            capturedAt: z.ZodString;
+            metadata: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    };
+};
+export declare const getSessionMessagesMetadata: {
+    _meta: {
+        readonly ui: {
+            readonly resourceUri: "ui://footprint/session-detail.html";
+        };
+    };
+    title: string;
+    description: string;
+};
+export declare function createGetSessionMessagesHandler(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;
+    messages: import("../lib/storage/types.js").SessionMessageRecord[];
+}>>;
+//# sourceMappingURL=get-session-messages.d.ts.map

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

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