ollama-intern-mcp 1.0.0

package/dist/tools/artifactDiff.d.ts

@@ -0,0 +1,66 @@
+/**
+ * ollama_artifact_diff — structured same-pack comparison.
+ *
+ * Identity-first: both sides come in as {pack, slug}. No path-based
+ * escape hatch in this slice — artifact_read already covers that
+ * surface for callers who need it.
+ *
+ * Cross-pack diffs throw SCHEMA_INVALID. Pack payloads stay distinct
+ * by design; a flattened "generic" diff would defeat the job-shape
+ * discipline the rest of the product enforces.
+ *
+ * Weak flip is surfaced at the result top level, not buried inside the
+ * field diff — a brief going from strong to weak (or vice versa) is
+ * the single most important review signal.
+ */
+import { z } from "zod";
+import type { Envelope } from "../envelope.js";
+import type { RunContext } from "../runContext.js";
+import { type PackName } from "./artifacts/scan.js";
+import { type ArtifactDiffResult } from "./artifacts/diff.js";
+export declare const artifactDiffSchema: z.ZodObject<{
+    a: z.ZodObject<{
+        pack: z.ZodEnum<[PackName, ...PackName[]]>;
+        slug: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        pack: PackName;
+        slug: string;
+    }, {
+        pack: PackName;
+        slug: string;
+    }>;
+    b: z.ZodObject<{
+        pack: z.ZodEnum<[PackName, ...PackName[]]>;
+        slug: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        pack: PackName;
+        slug: string;
+    }, {
+        pack: PackName;
+        slug: string;
+    }>;
+    extra_artifact_dirs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    a: {
+        pack: PackName;
+        slug: string;
+    };
+    b: {
+        pack: PackName;
+        slug: string;
+    };
+    extra_artifact_dirs?: string[] | undefined;
+}, {
+    a: {
+        pack: PackName;
+        slug: string;
+    };
+    b: {
+        pack: PackName;
+        slug: string;
+    };
+    extra_artifact_dirs?: string[] | undefined;
+}>;
+export type ArtifactDiffInput = z.infer<typeof artifactDiffSchema>;
+export declare function handleArtifactDiff(input: ArtifactDiffInput, ctx: RunContext): Promise<Envelope<ArtifactDiffResult>>;
+//# sourceMappingURL=artifactDiff.d.ts.map

package/dist/tools/artifactDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactDiff.d.ts","sourceRoot":"","sources":["../../src/tools/artifactDiff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAO7E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CA0CvC"}

package/dist/tools/artifactDiff.js

@@ -0,0 +1,66 @@
+/**
+ * ollama_artifact_diff — structured same-pack comparison.
+ *
+ * Identity-first: both sides come in as {pack, slug}. No path-based
+ * escape hatch in this slice — artifact_read already covers that
+ * surface for callers who need it.
+ *
+ * Cross-pack diffs throw SCHEMA_INVALID. Pack payloads stay distinct
+ * by design; a flattened "generic" diff would defeat the job-shape
+ * discipline the rest of the product enforces.
+ *
+ * Weak flip is surfaced at the result top level, not buried inside the
+ * field diff — a brief going from strong to weak (or vice versa) is
+ * the single most important review signal.
+ */
+import { z } from "zod";
+import { buildEnvelope } from "../envelope.js";
+import { callEvent } from "../observability.js";
+import { InternError } from "../errors.js";
+import { KNOWN_PACKS, resolveArtifactByIdentity, readArtifactAtPath, } from "./artifacts/scan.js";
+import { diffArtifacts } from "./artifacts/diff.js";
+const identitySchema = z.object({
+    pack: z.enum(KNOWN_PACKS).describe("Pack identity."),
+    slug: z.string().min(1).describe("Artifact slug (filename stem)."),
+});
+export const artifactDiffSchema = z.object({
+    a: identitySchema.describe("First artifact identity."),
+    b: identitySchema.describe("Second artifact identity. Must share a.pack — cross-pack diffs are refused."),
+    extra_artifact_dirs: z
+        .array(z.string().min(1))
+        .optional()
+        .describe("Extra read-only search dirs (same as artifact_list / artifact_read). Canonical identity is still (pack, slug)."),
+});
+export async function handleArtifactDiff(input, ctx) {
+    const startedAt = Date.now();
+    // Enforce same-pack at the input level too — gives a clearer error
+    // than waiting for the payload-level check after both files load.
+    if (input.a.pack !== input.b.pack) {
+        throw new InternError("SCHEMA_INVALID", `Cross-pack diff refused: a.pack="${input.a.pack}" vs b.pack="${input.b.pack}"`, "artifact_diff compares within a single pack only. Pick two artifacts of the same pack.", false);
+    }
+    const extraDirs = input.extra_artifact_dirs ?? [];
+    // Resolve both sides by identity in parallel — each resolution fails
+    // loud on ambiguity or absence, per the Artifact Spine A contract.
+    const [metaA, metaB] = await Promise.all([
+        resolveArtifactByIdentity(input.a.pack, input.a.slug, { extra_artifact_dirs: extraDirs }),
+        resolveArtifactByIdentity(input.b.pack, input.b.slug, { extra_artifact_dirs: extraDirs }),
+    ]);
+    const [artA, artB] = await Promise.all([
+        readArtifactAtPath(metaA.json_path, { extra_artifact_dirs: extraDirs }),
+        readArtifactAtPath(metaB.json_path, { extra_artifact_dirs: extraDirs }),
+    ]);
+    const result = diffArtifacts(artA, artB);
+    const envelope = buildEnvelope({
+        result,
+        tier: "instant", // pure file I/O + in-memory diff; no model call
+        model: "",
+        hardwareProfile: ctx.hardwareProfile,
+        tokensIn: 0,
+        tokensOut: 0,
+        startedAt,
+        residency: null,
+    });
+    await ctx.logger.log(callEvent("ollama_artifact_diff", envelope));
+    return envelope;
+}
+//# sourceMappingURL=artifactDiff.js.map

package/dist/tools/artifactDiff.js.map

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

package/dist/tools/artifactExportToPath.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ollama_artifact_export_to_path — handoff move, not a writer framework.
+ *
+ * Reads the artifact's existing markdown (no re-render, no model call),
+ * prepends a provenance header so exported files keep identity, and
+ * writes to a caller-supplied absolute path under caller-supplied
+ * allowed_roots. Overwrite is opt-in by design.
+ */
+import { z } from "zod";
+import type { Envelope } from "../envelope.js";
+import type { RunContext } from "../runContext.js";
+import { type PackName } from "./artifacts/scan.js";
+import { type ExportResult } from "./artifacts/export.js";
+export declare const artifactExportToPathSchema: z.ZodObject<{
+    pack: z.ZodEnum<[PackName, ...PackName[]]>;
+    slug: z.ZodString;
+    target_path: z.ZodString;
+    allowed_roots: z.ZodArray<z.ZodString, "many">;
+    overwrite: z.ZodOptional<z.ZodBoolean>;
+    extra_artifact_dirs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    target_path: string;
+    pack: PackName;
+    slug: string;
+    allowed_roots: string[];
+    extra_artifact_dirs?: string[] | undefined;
+    overwrite?: boolean | undefined;
+}, {
+    target_path: string;
+    pack: PackName;
+    slug: string;
+    allowed_roots: string[];
+    extra_artifact_dirs?: string[] | undefined;
+    overwrite?: boolean | undefined;
+}>;
+export type ArtifactExportToPathInput = z.infer<typeof artifactExportToPathSchema>;
+export declare function handleArtifactExportToPath(input: ArtifactExportToPathInput, ctx: RunContext): Promise<Envelope<ExportResult>>;
+//# sourceMappingURL=artifactExportToPath.d.ts.map

package/dist/tools/artifactExportToPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactExportToPath.d.ts","sourceRoot":"","sources":["../../src/tools/artifactExportToPath.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAElF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;EAarC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEnF,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,yBAAyB,EAChC,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAyBjC"}

package/dist/tools/artifactExportToPath.js

@@ -0,0 +1,51 @@
+/**
+ * ollama_artifact_export_to_path — handoff move, not a writer framework.
+ *
+ * Reads the artifact's existing markdown (no re-render, no model call),
+ * prepends a provenance header so exported files keep identity, and
+ * writes to a caller-supplied absolute path under caller-supplied
+ * allowed_roots. Overwrite is opt-in by design.
+ */
+import { z } from "zod";
+import { buildEnvelope } from "../envelope.js";
+import { callEvent } from "../observability.js";
+import { KNOWN_PACKS, resolveArtifactByIdentity, readArtifactAtPath, } from "./artifacts/scan.js";
+import { exportArtifactMarkdown } from "./artifacts/export.js";
+export const artifactExportToPathSchema = z.object({
+    pack: z.enum(KNOWN_PACKS).describe("Pack identity of the source artifact."),
+    slug: z.string().min(1).describe("Source artifact slug."),
+    target_path: z.string().min(1).describe("Absolute target path. Must end in .md, must live under one of allowed_roots, no '..' segments."),
+    allowed_roots: z
+        .array(z.string().min(1))
+        .min(1)
+        .describe("Absolute directories the export may write into. REQUIRED — the caller declares intent; the tool never guesses a default. Empty list is refused."),
+    overwrite: z.boolean().optional().describe("If true, replace an existing file at target_path. Default false; existing files refuse the export so re-runs never clobber hand-edits."),
+    extra_artifact_dirs: z
+        .array(z.string().min(1))
+        .optional()
+        .describe("Extra read-only search dirs for locating the source artifact (same as artifact_read)."),
+});
+export async function handleArtifactExportToPath(input, ctx) {
+    const startedAt = Date.now();
+    const extraDirs = input.extra_artifact_dirs ?? [];
+    const metadata = await resolveArtifactByIdentity(input.pack, input.slug, { extra_artifact_dirs: extraDirs });
+    const artifact = await readArtifactAtPath(metadata.json_path, { extra_artifact_dirs: extraDirs });
+    const result = await exportArtifactMarkdown(artifact, {
+        target_path: input.target_path,
+        allowed_roots: input.allowed_roots,
+        overwrite: input.overwrite,
+    });
+    const envelope = buildEnvelope({
+        result,
+        tier: "instant",
+        model: "",
+        hardwareProfile: ctx.hardwareProfile,
+        tokensIn: 0,
+        tokensOut: 0,
+        startedAt,
+        residency: null,
+    });
+    await ctx.logger.log(callEvent("ollama_artifact_export_to_path", envelope));
+    return envelope;
+}
+//# sourceMappingURL=artifactExportToPath.js.map

package/dist/tools/artifactExportToPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactExportToPath.js","sourceRoot":"","sources":["../../src/tools/artifactExportToPath.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,kBAAkB,GAEnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAqB,MAAM,uBAAuB,CAAC;AAElF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,WAAmD,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACnH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACzD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gGAAgG,CAAC;IACzI,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,iJAAiJ,CAAC;IAC9J,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wIAAwI,CAAC;IACpL,mBAAmB,EAAE,CAAC;SACnB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,QAAQ,EAAE;SACV,QAAQ,CAAC,uFAAuF,CAAC;CACrG,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAgC,EAChC,GAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC;IAElD,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7G,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC,CAAC;IAElG,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,QAAQ,EAAE;QACpD,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,aAAa,CAAe;QAC3C,MAAM;QACN,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,EAAE;QACT,eAAe,EAAE,GAAG,CAAC,eAAe;QACpC,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,CAAC;QACZ,SAAS;QACT,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IACH,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC5E,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/artifactList.d.ts

@@ -0,0 +1,60 @@
+/**
+ * ollama_artifact_list — metadata-only index of pack artifacts on disk.
+ *
+ * Artifact tier, not an atom, not a pack. Turns pack outputs into a
+ * reusable working surface: what exists, when it was made, is it weak,
+ * which pack produced it, which corpus (if any) grounded it.
+ *
+ * Returns ONE metadata record per artifact. Full payloads belong to
+ * artifact_read — listing stays cheap and scan-friendly.
+ *
+ * Identity is (pack, slug). Collisions across dirs surface as warnings
+ * in the response, but every colliding record still appears so the
+ * operator can see the duplication and resolve it.
+ *
+ * Default sort: newest first by created_at, then pack, then slug.
+ * Filter → sort → limit, in that order.
+ */
+import { z } from "zod";
+import type { Envelope } from "../envelope.js";
+import type { RunContext } from "../runContext.js";
+import { type ArtifactMetadata, type PackName } from "./artifacts/scan.js";
+export declare const artifactListSchema: z.ZodObject<{
+    pack: z.ZodOptional<z.ZodEnum<[PackName, ...PackName[]]>>;
+    date_after: z.ZodOptional<z.ZodString>;
+    date_before: z.ZodOptional<z.ZodString>;
+    weak_only: z.ZodOptional<z.ZodBoolean>;
+    strong_only: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    extra_artifact_dirs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    pack?: PackName | undefined;
+    date_after?: string | undefined;
+    date_before?: string | undefined;
+    weak_only?: boolean | undefined;
+    strong_only?: boolean | undefined;
+    limit?: number | undefined;
+    extra_artifact_dirs?: string[] | undefined;
+}, {
+    pack?: PackName | undefined;
+    date_after?: string | undefined;
+    date_before?: string | undefined;
+    weak_only?: boolean | undefined;
+    strong_only?: boolean | undefined;
+    limit?: number | undefined;
+    extra_artifact_dirs?: string[] | undefined;
+}>;
+export type ArtifactListInput = z.infer<typeof artifactListSchema>;
+export interface ArtifactListResult {
+    items: ArtifactMetadata[];
+    /** (pack, slug) pairs present in more than one location. Surfaces so the operator can resolve. */
+    duplicates: Array<{
+        pack: PackName;
+        slug: string;
+        paths: string[];
+    }>;
+    /** Total matches BEFORE limit was applied. */
+    total_matches: number;
+}
+export declare function handleArtifactList(input: ArtifactListInput, ctx: RunContext): Promise<Envelope<ArtifactListResult>>;
+//# sourceMappingURL=artifactList.d.ts.map

package/dist/tools/artifactList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactList.d.ts","sourceRoot":"","sources":["../../src/tools/artifactList.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;EAc7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,kGAAkG;IAClG,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACrE,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB;AAuCD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAuCvC"}

package/dist/tools/artifactList.js

@@ -0,0 +1,107 @@
+/**
+ * ollama_artifact_list — metadata-only index of pack artifacts on disk.
+ *
+ * Artifact tier, not an atom, not a pack. Turns pack outputs into a
+ * reusable working surface: what exists, when it was made, is it weak,
+ * which pack produced it, which corpus (if any) grounded it.
+ *
+ * Returns ONE metadata record per artifact. Full payloads belong to
+ * artifact_read — listing stays cheap and scan-friendly.
+ *
+ * Identity is (pack, slug). Collisions across dirs surface as warnings
+ * in the response, but every colliding record still appears so the
+ * operator can see the duplication and resolve it.
+ *
+ * Default sort: newest first by created_at, then pack, then slug.
+ * Filter → sort → limit, in that order.
+ */
+import { z } from "zod";
+import { buildEnvelope } from "../envelope.js";
+import { callEvent } from "../observability.js";
+import { InternError } from "../errors.js";
+import { KNOWN_PACKS, scanAllArtifacts, } from "./artifacts/scan.js";
+export const artifactListSchema = z.object({
+    pack: z
+        .enum(KNOWN_PACKS)
+        .optional()
+        .describe("Filter to a single pack. Omit to include all three."),
+    date_after: z.string().optional().describe("ISO timestamp. Include only artifacts with created_at >= date_after."),
+    date_before: z.string().optional().describe("ISO timestamp. Include only artifacts with created_at <= date_before."),
+    weak_only: z.boolean().optional().describe("If true, keep only artifacts where the brief flagged weak=true."),
+    strong_only: z.boolean().optional().describe("If true, keep only artifacts where weak=false. Mutually exclusive with weak_only."),
+    limit: z.number().int().min(1).max(500).optional().describe("Cap on entries returned after sorting (default 50). Apply after filters."),
+    extra_artifact_dirs: z
+        .array(z.string().min(1))
+        .optional()
+        .describe("Additional read-only search dirs. Canonical identity is still (pack, slug) — extras don't shift precedence."),
+});
+function parseIso(s, fieldName) {
+    if (s === undefined)
+        return null;
+    const d = new Date(s);
+    if (Number.isNaN(d.getTime())) {
+        throw new InternError("SCHEMA_INVALID", `Invalid ISO timestamp on ${fieldName}: ${s}`, "Pass an ISO-8601 string like 2026-04-17T00:00:00Z.", false);
+    }
+    return d;
+}
+function assertMutex(input) {
+    if (input.weak_only && input.strong_only) {
+        throw new InternError("SCHEMA_INVALID", "weak_only and strong_only are mutually exclusive.", "Pick one — weak_only keeps weak artifacts, strong_only keeps non-weak.", false);
+    }
+}
+function sortAndLimit(items, limit) {
+    // Deterministic sort: created_at desc, then pack asc, then slug asc.
+    const sorted = items.slice().sort((a, b) => {
+        if (a.created_at !== b.created_at)
+            return a.created_at < b.created_at ? 1 : -1;
+        if (a.pack !== b.pack)
+            return a.pack < b.pack ? -1 : 1;
+        if (a.slug !== b.slug)
+            return a.slug < b.slug ? -1 : 1;
+        // Fall back to json_path if everything else ties — still deterministic.
+        return a.json_path < b.json_path ? -1 : a.json_path > b.json_path ? 1 : 0;
+    });
+    return sorted.slice(0, limit);
+}
+export async function handleArtifactList(input, ctx) {
+    assertMutex(input);
+    const startedAt = Date.now();
+    const after = parseIso(input.date_after, "date_after");
+    const before = parseIso(input.date_before, "date_before");
+    const limit = input.limit ?? 50;
+    const scan = await scanAllArtifacts({ extra_artifact_dirs: input.extra_artifact_dirs });
+    let filtered = scan.all;
+    if (input.pack)
+        filtered = filtered.filter((m) => m.pack === input.pack);
+    if (after)
+        filtered = filtered.filter((m) => new Date(m.created_at).getTime() >= after.getTime());
+    if (before)
+        filtered = filtered.filter((m) => new Date(m.created_at).getTime() <= before.getTime());
+    if (input.weak_only)
+        filtered = filtered.filter((m) => m.weak === true);
+    if (input.strong_only)
+        filtered = filtered.filter((m) => m.weak === false);
+    const total_matches = filtered.length;
+    const items = sortAndLimit(filtered, limit);
+    const result = {
+        items,
+        duplicates: scan.duplicates,
+        total_matches,
+    };
+    const envelope = buildEnvelope({
+        result,
+        tier: "instant", // no model call; "instant" is the cheapest tier we report
+        model: "",
+        hardwareProfile: ctx.hardwareProfile,
+        tokensIn: 0,
+        tokensOut: 0,
+        startedAt,
+        residency: null,
+        ...(scan.duplicates.length > 0
+            ? { warnings: [`Found ${scan.duplicates.length} slug collision(s) across artifact dirs — see result.duplicates.`] }
+            : {}),
+    });
+    await ctx.logger.log(callEvent("ollama_artifact_list", envelope));
+    return envelope;
+}
+//# sourceMappingURL=artifactList.js.map

package/dist/tools/artifactList.js.map

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

package/dist/tools/artifactRead.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ollama_artifact_read — typed read of a pack artifact.
+ *
+ * Primary entry = {pack, slug}. Keeps reads anchored to job identity,
+ * not file paths. Collisions within (pack, slug) fail loud.
+ *
+ * Secondary entry = {json_path}. Strict path safety: must be absolute,
+ * must normalize cleanly, must end in .json, must live under a
+ * recognized artifact dir (canonical roots + extra_artifact_dirs).
+ *
+ * Return shape is a discriminated union on `pack` — incident/repo/
+ * change payloads stay distinct. Metadata is also surfaced so callers
+ * can do weak-checks / section-counts without parsing the full
+ * artifact themselves.
+ */
+import { z } from "zod";
+import type { Envelope } from "../envelope.js";
+import type { RunContext } from "../runContext.js";
+import { type ArtifactMetadata, type PackArtifact, type PackName } from "./artifacts/scan.js";
+export declare const artifactReadSchema: z.ZodObject<{
+    pack: z.ZodOptional<z.ZodEnum<[PackName, ...PackName[]]>>;
+    slug: z.ZodOptional<z.ZodString>;
+    json_path: z.ZodOptional<z.ZodString>;
+    extra_artifact_dirs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    pack?: PackName | undefined;
+    slug?: string | undefined;
+    json_path?: string | undefined;
+    extra_artifact_dirs?: string[] | undefined;
+}, {
+    pack?: PackName | undefined;
+    slug?: string | undefined;
+    json_path?: string | undefined;
+    extra_artifact_dirs?: string[] | undefined;
+}>;
+export type ArtifactReadInput = z.infer<typeof artifactReadSchema>;
+export interface ArtifactReadResult {
+    metadata: ArtifactMetadata;
+    /** The full artifact payload, typed by pack. */
+    artifact: PackArtifact;
+}
+export declare function handleArtifactRead(input: ArtifactReadInput, ctx: RunContext): Promise<Envelope<ArtifactReadResult>>;
+//# sourceMappingURL=artifactRead.d.ts.map

package/dist/tools/artifactRead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactRead.d.ts","sourceRoot":"","sources":["../../src/tools/artifactRead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAe7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,YAAY,CAAC;CACxB;AAyBD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAwCvC"}

package/dist/tools/artifactRead.js

@@ -0,0 +1,83 @@
+/**
+ * ollama_artifact_read — typed read of a pack artifact.
+ *
+ * Primary entry = {pack, slug}. Keeps reads anchored to job identity,
+ * not file paths. Collisions within (pack, slug) fail loud.
+ *
+ * Secondary entry = {json_path}. Strict path safety: must be absolute,
+ * must normalize cleanly, must end in .json, must live under a
+ * recognized artifact dir (canonical roots + extra_artifact_dirs).
+ *
+ * Return shape is a discriminated union on `pack` — incident/repo/
+ * change payloads stay distinct. Metadata is also surfaced so callers
+ * can do weak-checks / section-counts without parsing the full
+ * artifact themselves.
+ */
+import { z } from "zod";
+import { buildEnvelope } from "../envelope.js";
+import { callEvent } from "../observability.js";
+import { InternError } from "../errors.js";
+import { KNOWN_PACKS, resolveArtifactByIdentity, readArtifactAtPath, metadataFromArtifact, } from "./artifacts/scan.js";
+export const artifactReadSchema = z.object({
+    pack: z
+        .enum(KNOWN_PACKS)
+        .optional()
+        .describe("Pack identity. Pass WITH slug for the primary identity-based read."),
+    slug: z.string().min(1).optional().describe("Artifact slug (filename stem). Pass WITH pack."),
+    json_path: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Absolute path to the artifact JSON file. Secondary escape hatch — must live under a recognized artifact dir; path-safety guarded."),
+    extra_artifact_dirs: z
+        .array(z.string().min(1))
+        .optional()
+        .describe("Extra read-only search dirs (same as artifact_list). Applied to both identity resolution and path safety."),
+});
+function assertExactlyOneEntry(input) {
+    const hasIdentity = Boolean(input.pack) && Boolean(input.slug);
+    const hasPath = Boolean(input.json_path);
+    const partialIdentity = Boolean(input.pack) !== Boolean(input.slug);
+    if (partialIdentity) {
+        throw new InternError("SCHEMA_INVALID", "artifact_read: pack and slug must be provided together.", "Use {pack, slug} as the primary identity-based entry, or {json_path} as the secondary escape hatch.", false);
+    }
+    const count = (hasIdentity ? 1 : 0) + (hasPath ? 1 : 0);
+    if (count !== 1) {
+        throw new InternError("SCHEMA_INVALID", `artifact_read: provide exactly one of {pack, slug} or {json_path} (given ${count}).`, "The {pack, slug} form is preferred — it keeps reads anchored to job identity. json_path is a secondary escape hatch.", false);
+    }
+}
+export async function handleArtifactRead(input, ctx) {
+    assertExactlyOneEntry(input);
+    const startedAt = Date.now();
+    const extraDirs = input.extra_artifact_dirs ?? [];
+    let metadata;
+    let artifact;
+    if (input.pack && input.slug) {
+        // Primary entry: identity-based.
+        metadata = await resolveArtifactByIdentity(input.pack, input.slug, { extra_artifact_dirs: extraDirs });
+        artifact = await readArtifactAtPath(metadata.json_path, { extra_artifact_dirs: extraDirs });
+    }
+    else {
+        // Secondary entry: path-based.
+        artifact = await readArtifactAtPath(input.json_path, { extra_artifact_dirs: extraDirs });
+        const meta = metadataFromArtifact(artifact, input.json_path);
+        if (!meta) {
+            throw new InternError("SCHEMA_INVALID", `Artifact at ${input.json_path} has an unrecognized shape.`, "Only pack-produced artifacts (incident_pack, repo_pack, change_pack) are readable through this tool.", false);
+        }
+        metadata = meta;
+    }
+    const result = { metadata, artifact };
+    const envelope = buildEnvelope({
+        result,
+        tier: "instant", // no model call; just file I/O
+        model: "",
+        hardwareProfile: ctx.hardwareProfile,
+        tokensIn: 0,
+        tokensOut: 0,
+        startedAt,
+        residency: null,
+    });
+    await ctx.logger.log(callEvent("ollama_artifact_read", envelope));
+    return envelope;
+}
+//# sourceMappingURL=artifactRead.js.map

package/dist/tools/artifactRead.js.map

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

package/dist/tools/artifactSnippets.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Pack-specific snippet tools.
+ *
+ * Three MCP handlers, one per pack, each rendering a compact
+ * markdown fragment from an existing artifact. No model calls,
+ * no re-packaging — pure derivation from stored JSON.
+ *
+ * Separate tools because the whole value is pack-shaped — a single
+ * generic snippet tool would flatten distinct useful fragments into
+ * lowest-common-denominator mush.
+ */
+import { z } from "zod";
+import type { Envelope } from "../envelope.js";
+import type { RunContext } from "../runContext.js";
+import { type ArtifactMetadata } from "./artifacts/scan.js";
+export interface SnippetResult {
+    rendered: string;
+    metadata: ArtifactMetadata;
+}
+export declare const artifactIncidentNoteSnippetSchema: z.ZodObject<{
+    readonly slug: z.ZodString;
+    readonly extra_artifact_dirs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    extra_artifact_dirs?: string[] | undefined;
+}, {
+    slug: string;
+    extra_artifact_dirs?: string[] | undefined;
+}>;
+export type ArtifactIncidentNoteSnippetInput = z.infer<typeof artifactIncidentNoteSnippetSchema>;
+export declare function handleArtifactIncidentNoteSnippet(input: ArtifactIncidentNoteSnippetInput, ctx: RunContext): Promise<Envelope<SnippetResult>>;
+export declare const artifactOnboardingSectionSnippetSchema: z.ZodObject<{
+    readonly slug: z.ZodString;
+    readonly extra_artifact_dirs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    extra_artifact_dirs?: string[] | undefined;
+}, {
+    slug: string;
+    extra_artifact_dirs?: string[] | undefined;
+}>;
+export type ArtifactOnboardingSectionSnippetInput = z.infer<typeof artifactOnboardingSectionSnippetSchema>;
+export declare function handleArtifactOnboardingSectionSnippet(input: ArtifactOnboardingSectionSnippetInput, ctx: RunContext): Promise<Envelope<SnippetResult>>;
+export declare const artifactReleaseNoteSnippetSchema: z.ZodObject<{
+    readonly slug: z.ZodString;
+    readonly extra_artifact_dirs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    extra_artifact_dirs?: string[] | undefined;
+}, {
+    slug: string;
+    extra_artifact_dirs?: string[] | undefined;
+}>;
+export type ArtifactReleaseNoteSnippetInput = z.infer<typeof artifactReleaseNoteSnippetSchema>;
+export declare function handleArtifactReleaseNoteSnippet(input: ArtifactReleaseNoteSnippetInput, ctx: RunContext): Promise<Envelope<SnippetResult>>;
+//# sourceMappingURL=artifactSnippets.d.ts.map

package/dist/tools/artifactSnippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactSnippets.d.ts","sourceRoot":"","sources":["../../src/tools/artifactSnippets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAY7B,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAYD,eAAO,MAAM,iCAAiC;;;;;;;;;EAA8B,CAAC;AAC7E,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAEjG,wBAAsB,iCAAiC,CACrD,KAAK,EAAE,gCAAgC,EACvC,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CA0BlC;AAID,eAAO,MAAM,sCAAsC;;;;;;;;;EAA8B,CAAC;AAClF,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAE3G,wBAAsB,sCAAsC,CAC1D,KAAK,EAAE,qCAAqC,EAC5C,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CA0BlC;AAID,eAAO,MAAM,gCAAgC;;;;;;;;;EAA8B,CAAC;AAC5E,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE/F,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,+BAA+B,EACtC,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CA0BlC"}