@squadrules/mcp 4.8.6

package/dist/tools/search_output.js

@@ -0,0 +1,161 @@
+/**
+ * Output building for search: createResults, resolveHead, generateUnifiedOutput.
+ * Extracted to keep `search.ts` under the max-lines limit.
+ */
+import { resolveAdapterEntry } from '../services/adapter-navigation.js';
+import { getActivationPatterns, getAdapterInfo, getAdapterName, getAdapterSlugForSearchOutput, getChainRoot, getLayerCount } from '../services/memory/memory-accessors.js';
+import { buildAdapterUri } from './kairos-uri.js';
+import { spaceIdToDisplayName } from '../utils/space-display.js';
+import { getSpaceContextFromStorage } from '../utils/tenant-context.js';
+import { KAIROS_APP_SPACE_ID } from '../config.js';
+import { KAIROS_CREATION_PROTOCOL_SLUG, KAIROS_CREATION_FOOTER_LABEL, KAIROS_REFINING_PROTOCOL_SLUG, KAIROS_REFINING_FOOTER_LABEL } from '../constants/builtin-search-meta.js';
+import { structuredLogger } from '../utils/structured-logger.js';
+import { normalizeAuthorSlug, slugifyFromTitle } from '../utils/protocol-slug.js';
+/** Slug-form `kairos://adapter/{slug}` for search/activate wire (never UUID adapter segments). */
+function adapterWireUriFromMemory(memory) {
+    const stored = getAdapterSlugForSearchOutput(memory);
+    if (stored)
+        return buildAdapterUri(stored);
+    const title = (getAdapterName(memory) || memory.label || '').trim();
+    let s = normalizeAuthorSlug(title);
+    if (!s) {
+        const basis = title.length > 0 ? title : (memory.memory_uuid || 'adapter');
+        s = slugifyFromTitle(basis);
+    }
+    return buildAdapterUri(s);
+}
+const PUBLIC_SCORE_PIVOT = 0.5;
+export function normalizePublicSearchScore(score) {
+    if (typeof score !== 'number' || !Number.isFinite(score) || score <= 0) {
+        return 0;
+    }
+    return score / (score + PUBLIC_SCORE_PIVOT);
+}
+export function createResults(headCandidates, scoreThreshold) {
+    const normalizedThreshold = normalizePublicSearchScore(scoreThreshold);
+    return headCandidates
+        .map(({ memory, score }) => ({
+        memory,
+        score: normalizePublicSearchScore(score),
+        uri: adapterWireUriFromMemory(memory),
+        label: memory.label,
+        tags: memory.tags || [],
+        layer_count: getLayerCount(memory)
+    }))
+        .filter((result) => result.score >= normalizedThreshold);
+}
+export async function resolveHead(memory, qdrantService) {
+    const resolved = await resolveAdapterEntry(memory, qdrantService);
+    const uri = adapterWireUriFromMemory(memory);
+    if (resolved) {
+        return { uri, label: resolved.label };
+    }
+    return { uri, label: memory.label };
+}
+export async function generateUnifiedOutput(results, qdrantService, opts) {
+    const { refiningUri, refiningNextAction, createUri, createNextAction, refiningProtocolVersion = null, createProtocolVersion = null } = opts;
+    const choices = [];
+    const spaceNamesById = getSpaceContextFromStorage().spaceNamesById;
+    for (const result of results) {
+        const head = await resolveHead(result.memory, qdrantService);
+        const sid = result.memory.space_id ?? KAIROS_APP_SPACE_ID;
+        const slug = getAdapterSlugForSearchOutput(result.memory);
+        const chainRoot = getChainRoot(result.memory);
+        let choiceUri = head.uri;
+        let choiceLabel = head.label || result.label;
+        let choiceNextAction = `call forward with ${head.uri} and no solution to start this adapter`;
+        if (chainRoot && qdrantService) {
+            try {
+                const rootOutcome = await qdrantService.findFirstStepMemoryUuidBySlug(chainRoot);
+                if (rootOutcome.layerUuid) {
+                    const rootPoint = await qdrantService.getMemoryByUUID(rootOutcome.layerUuid);
+                    if (rootPoint) {
+                        const rootUri = adapterWireUriFromMemory(rootPoint);
+                        const rootLabel = typeof rootPoint.adapter?.name === 'string' ? rootPoint.adapter.name : (rootPoint.label || choiceLabel);
+                        choiceUri = rootUri;
+                        choiceLabel = rootLabel;
+                        choiceNextAction = `call forward with ${rootUri} and no solution to start this adapter`;
+                    }
+                }
+            }
+            catch (err) {
+                structuredLogger.warn(`[chain_root] Failed to resolve chain_root slug "${chainRoot}": ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        choices.push({
+            uri: choiceUri,
+            label: choiceLabel,
+            adapter_name: getAdapterName(result.memory) || null,
+            score: result.score,
+            role: 'match',
+            tags: result.tags,
+            next_action: choiceNextAction,
+            adapter_version: getAdapterInfo(result.memory)?.protocol_version ?? null,
+            activation_patterns: getActivationPatterns(result.memory),
+            space_name: spaceIdToDisplayName(sid, spaceNamesById),
+            slug: chainRoot ?? slug
+        });
+    }
+    // Deduplicate match choices that collapsed to the same chain root URI
+    const seenMatchUris = new Set();
+    const deduplicatedChoices = [];
+    for (const choice of choices) {
+        if (choice.role === 'match') {
+            if (seenMatchUris.has(choice.uri))
+                continue;
+            seenMatchUris.add(choice.uri);
+        }
+        deduplicatedChoices.push(choice);
+    }
+    choices.length = 0;
+    choices.push(...deduplicatedChoices);
+    const includeMetaFooter = true;
+    if (includeMetaFooter) {
+        choices.push({
+            uri: refiningUri,
+            label: KAIROS_REFINING_FOOTER_LABEL,
+            adapter_name: KAIROS_REFINING_FOOTER_LABEL,
+            score: null,
+            role: 'refine',
+            tags: ['meta', 'refine'],
+            next_action: refiningNextAction,
+            adapter_version: refiningProtocolVersion,
+            space_name: null,
+            slug: KAIROS_REFINING_PROTOCOL_SLUG
+        }, {
+            uri: createUri,
+            label: KAIROS_CREATION_FOOTER_LABEL,
+            adapter_name: KAIROS_CREATION_FOOTER_LABEL,
+            score: null,
+            role: 'create',
+            tags: ['meta', 'creation'],
+            next_action: createNextAction,
+            adapter_version: createProtocolVersion,
+            space_name: null,
+            slug: KAIROS_CREATION_PROTOCOL_SLUG
+        });
+    }
+    const matchCount = choices.filter(c => c.role === 'match').length;
+    let message;
+    let nextAction;
+    if (matchCount === 0) {
+        message = 'No existing adapter/protocol matched your query. Refine your search or create a new one.';
+        nextAction = "Pick one choice and follow that choice's next_action.";
+    }
+    else if (matchCount === 1 && includeMetaFooter) {
+        message = 'Found 1 match. You can run it, refine your search, or create a new adapter/protocol.';
+        nextAction = "Pick one choice and follow that choice's next_action.";
+    }
+    else if (matchCount === 1) {
+        message = 'Found 1 match.';
+        nextAction = "Follow the choice's next_action.";
+    }
+    else {
+        const topMatch = choices[0];
+        const confidencePercent = Math.round((topMatch.score || 0) * 100);
+        message = `Found ${matchCount} matches (top confidence: ${confidencePercent}%). Choose one, refine your search, or create a new adapter/protocol.`;
+        nextAction = "Pick one choice and follow that choice's next_action.";
+    }
+    return { must_obey: true, message, next_action: nextAction, choices };
+}
+//# sourceMappingURL=search_output.js.map

package/dist/tools/search_output.js.map

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

package/dist/tools/search_schema.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export declare const searchInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    space: z.ZodOptional<z.ZodString>;
+    space_id: z.ZodOptional<z.ZodString>;
+    max_choices: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const searchOutputSchema: z.ZodObject<{
+    must_obey: z.ZodBoolean;
+    message: z.ZodString;
+    next_action: z.ZodString;
+    choices: z.ZodArray<z.ZodObject<{
+        uri: z.ZodString;
+        label: z.ZodString;
+        adapter_name: z.ZodNullable<z.ZodString>;
+        score: z.ZodNullable<z.ZodNumber>;
+        role: z.ZodEnum<{
+            match: "match";
+            refine: "refine";
+            create: "create";
+        }>;
+        tags: z.ZodArray<z.ZodString>;
+        next_action: z.ZodString;
+        adapter_version: z.ZodNullable<z.ZodString>;
+        activation_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        space_name: z.ZodNullable<z.ZodString>;
+        slug: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type SearchInput = z.infer<typeof searchInputSchema>;
+export type SearchOutput = z.infer<typeof searchOutputSchema>;
+//# sourceMappingURL=search_schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search_schema.d.ts","sourceRoot":"","sources":["../../src/tools/search_schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,iBAAiB;;;;;iBAc5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;kBAyBpB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/tools/search_schema.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { KAIROS_SEARCH_LIMIT_CAP, KAIROS_SEARCH_LIMIT_MIN } from '../config.js';
+import { ADAPTER_SLUG_URI_INPUT_REGEX } from './kairos-uri.js';
+const adapterSlugUriSchema = z
+    .string()
+    .regex(ADAPTER_SLUG_URI_INPUT_REGEX, 'must match kairos://adapter/{slug}');
+const choiceUriSchema = adapterSlugUriSchema;
+export const searchInputSchema = z.object({
+    query: z.string().min(1).describe('Search query for adapter matches'),
+    space: z
+        .string()
+        .optional()
+        .describe('Scope results to this space: "personal", a group name, "Group: …", or your space id'),
+    space_id: z.string().optional().describe('Alias for space'),
+    max_choices: z
+        .number()
+        .int()
+        .min(KAIROS_SEARCH_LIMIT_MIN)
+        .max(KAIROS_SEARCH_LIMIT_CAP)
+        .optional()
+        .describe('Max match choices to return. Omit for server default; use higher for broad/vague queries.')
+});
+export const searchOutputSchema = z.object({
+    must_obey: z.boolean().describe('Always true. Follow next_action.'),
+    message: z.string().describe('Human-readable summary'),
+    next_action: z.string().describe("Global directive: pick one choice and follow that choice's next_action."),
+    choices: z.array(z.object({
+        uri: choiceUriSchema,
+        label: z.string(),
+        adapter_name: z.string().nullable(),
+        score: z.number().min(0).max(1).nullable().describe('Normalized 0.0-1.0 confidence for matches, null for refine/create'),
+        role: z.enum(['match', 'refine', 'create']).describe('match = search result, refine = search again, create = system action'),
+        tags: z.array(z.string()),
+        next_action: z.string().describe('Instruction for this choice.'),
+        adapter_version: z.string().nullable().describe('Stored adapter version (for example, semver) for match choices; null for refine/create. Compare with bundled adapter metadata to decide if re-training is needed.'),
+        activation_patterns: z.array(z.string()).optional().describe('Activation phrases associated with this adapter'),
+        space_name: z
+            .string()
+            .nullable()
+            .describe('Human-readable space for stored adapters (Personal, Group: …, Kairos app); null for refine/create'),
+        slug: z
+            .string()
+            .nullable()
+            .describe('Adapter routing slug when stored (use with kairos://adapter/{slug} in forward); null for refine/create or when absent')
+    })).describe('Options: match(es) first, then refine (if present), then create (if present).')
+}).strict();
+//# sourceMappingURL=search_schema.js.map

package/dist/tools/search_schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_schema.js","sourceRoot":"","sources":["../../src/tools/search_schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAE/D,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CAAC,4BAA4B,EAAE,oCAAoC,CAAC,CAAC;AAE7E,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAE7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACrE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,qFAAqF,CAAC;IAClG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAC3D,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,uBAAuB,CAAC;SAC5B,GAAG,CAAC,uBAAuB,CAAC;SAC5B,QAAQ,EAAE;SACV,QAAQ,CAAC,2FAA2F,CAAC;CACzG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACnE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACtD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yEAAyE,CAAC;IAC3G,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACxB,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;QACxH,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,sEAAsE,CAAC;QAC5H,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAChE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mKAAmK,CAAC;QACpN,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;QAC/G,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,mGAAmG,CAAC;QAChH,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,uHAAuH,CACxH;KACJ,CAAC,CAAC,CAAC,QAAQ,CAAC,+EAA+E,CAAC;CAC9F,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/tools/shell-challenge-invocation.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Build logical argv for shell challenges. Executors (agents/CLI) run this locally;
+ * the MCP server does not spawn processes for PoW.
+ */
+export type ShellChallengeFields = {
+    cmd?: string;
+    interpreter?: string;
+    flags?: string[];
+    args?: string[];
+    workdir?: string;
+};
+/**
+ * Normalize loose proof/UI fields into argv input without assigning `undefined`
+ * to optional keys (required when `exactOptionalPropertyTypes` is enabled).
+ */
+export declare function pickShellChallengeFields(shell: {
+    cmd: string;
+    interpreter?: string | undefined;
+    flags?: string[] | undefined;
+    args?: string[] | undefined;
+    workdir?: string | undefined;
+}): ShellChallengeFields;
+/**
+ * argv for the challenge. Default path: no interpreter or bash → bash -c cmd [-- args].
+ */
+export declare function buildShellChallengeArgv(shell: ShellChallengeFields): string[];
+/** Best-effort single-line invocation for descriptions/UI (POSIX-style quoting). */
+export declare function shellQuoteArg(arg: string): string;
+export declare function formatShellInvocationForDisplay(argv: string[]): string;
+/** One-line summary for error messages (missing proof, etc.). */
+export declare function formatShellChallengeInvocationSummary(shell: ShellChallengeFields): string;
+//# sourceMappingURL=shell-challenge-invocation.d.ts.map

package/dist/tools/shell-challenge-invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-challenge-invocation.d.ts","sourceRoot":"","sources":["../../src/tools/shell-challenge-invocation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,GAAG,oBAAoB,CASvB;AAoDD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAiC7E;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAEtE;AAED,iEAAiE;AACjE,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEzF"}

package/dist/tools/shell-challenge-invocation.js

@@ -0,0 +1,113 @@
+/**
+ * Build logical argv for shell challenges. Executors (agents/CLI) run this locally;
+ * the MCP server does not spawn processes for PoW.
+ */
+/**
+ * Normalize loose proof/UI fields into argv input without assigning `undefined`
+ * to optional keys (required when `exactOptionalPropertyTypes` is enabled).
+ */
+export function pickShellChallengeFields(shell) {
+    const out = { cmd: shell.cmd };
+    const interp = shell.interpreter?.trim();
+    if (interp)
+        out.interpreter = interp;
+    if (shell.flags !== undefined)
+        out.flags = shell.flags;
+    if (shell.args !== undefined)
+        out.args = shell.args;
+    const wd = shell.workdir?.trim();
+    if (wd)
+        out.workdir = wd;
+    return out;
+}
+function normalizedInterpreter(raw) {
+    const t = raw?.trim();
+    return t ? t : undefined;
+}
+/** Interpreters that use -c for inline script (auto-injected when absent). */
+const INJECT_C = new Set(['python3', 'python', 'sh']);
+/** Interpreters that use -e for inline script (auto-injected when absent). */
+const INJECT_E = new Set(['perl', 'node', 'nodejs', 'ruby']);
+/**
+ * Known "other" style: argv is interpreter + flags + cmd + args with no auto code flag
+ * (subcommands live in flags and/or cmd per author).
+ */
+const OTHER_STYLE = new Set([
+    'terraform',
+    'go',
+    'npx',
+    'npm',
+    'yarn',
+    'pnpm',
+    'cargo',
+    'rustc',
+    'make',
+    'docker',
+    'kubectl',
+    'ansible-playbook'
+]);
+function flagTokensLower(flags) {
+    const s = new Set();
+    for (const f of flags || []) {
+        const m = f.match(/^-+(.+)$/);
+        const cap = m?.[1];
+        s.add((cap ?? f).toLowerCase());
+    }
+    return s;
+}
+function hasExplicitCodeFlagC(flags) {
+    return (flags || []).some(f => /^-c$/i.test(f) || /^-c=/i.test(f));
+}
+/** Perl/node/ruby script modes that carry the program as the next argv segment. */
+function hasScriptCarrierE(flags) {
+    const t = flagTokensLower(flags);
+    return t.has('e') || t.has('E') || t.has('ne') || t.has('pe');
+}
+/**
+ * argv for the challenge. Default path: no interpreter or bash → bash -c cmd [-- args].
+ */
+export function buildShellChallengeArgv(shell) {
+    const cmd = shell.cmd ?? '';
+    const flags = shell.flags ?? [];
+    const args = shell.args ?? [];
+    const interp = normalizedInterpreter(shell.interpreter);
+    if (!interp || interp.toLowerCase() === 'bash') {
+        const out = ['bash', '-c', cmd.trim() || 'true'];
+        if (args.length)
+            out.push('--', ...args);
+        return out;
+    }
+    const low = interp.toLowerCase();
+    if (OTHER_STYLE.has(low)) {
+        return [interp, ...flags, ...(cmd.trim() ? [cmd] : []), ...args];
+    }
+    if (INJECT_C.has(low)) {
+        if (hasExplicitCodeFlagC(flags)) {
+            return [interp, ...flags, ...(cmd.trim() ? [cmd] : []), ...args];
+        }
+        return [interp, ...flags, '-c', cmd, ...args];
+    }
+    if (INJECT_E.has(low)) {
+        if (hasScriptCarrierE(flags)) {
+            return [interp, ...flags, ...(cmd.trim() ? [cmd] : []), ...args];
+        }
+        return [interp, ...flags, '-e', cmd, ...args];
+    }
+    return [interp, ...flags, ...(cmd.trim() ? [cmd] : []), ...args];
+}
+/** Best-effort single-line invocation for descriptions/UI (POSIX-style quoting). */
+export function shellQuoteArg(arg) {
+    if (arg === '')
+        return "''";
+    if (/^[\w@%+=:,./-]+$/i.test(arg))
+        return arg;
+    return "'" + arg.replace(/'/g, "'\\''") + "'";
+}
+export function formatShellInvocationForDisplay(argv) {
+    return argv.map(shellQuoteArg).join(' ');
+}
+/** One-line summary for error messages (missing proof, etc.). */
+export function formatShellChallengeInvocationSummary(shell) {
+    return formatShellInvocationForDisplay(buildShellChallengeArgv(shell));
+}
+//# sourceMappingURL=shell-challenge-invocation.js.map

package/dist/tools/shell-challenge-invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-challenge-invocation.js","sourceRoot":"","sources":["../../src/tools/shell-challenge-invocation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAMxC;IACC,MAAM,GAAG,GAAyB,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IACrD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACzC,IAAI,MAAM;QAAE,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC;IACrC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACvD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACpD,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACjC,IAAI,EAAE;QAAE,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC;IACzB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAuB;IACpD,MAAM,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;IACtB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3B,CAAC;AAED,8EAA8E;AAC9E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AAEtD,8EAA8E;AAC9E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,WAAW;IACX,IAAI;IACJ,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,QAAQ;IACR,SAAS;IACT,kBAAkB;CACnB,CAAC,CAAC;AAEH,SAAS,eAAe,CAAC,KAA2B;IAClD,MAAM,CAAC,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,oBAAoB,CAAC,KAA2B;IACvD,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,mFAAmF;AACnF,SAAS,iBAAiB,CAAC,KAA2B;IACpD,MAAM,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAA2B;IACjE,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAExD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAa,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAEjC,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AACnE,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC5B,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC9C,OAAO,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,IAAc;IAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,qCAAqC,CAAC,KAA2B;IAC/E,OAAO,+BAA+B,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/tools/skill-export/artifact-files.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Load attached artifact memories for an adapter into skill export file list.
+ */
+import type { MemoryQdrantStore } from '../../services/memory/store.js';
+import { type ArtifactSanitizationRule } from './artifact-sanitization/index.js';
+import type { SkillExportDiagnostic, SkillExportFile } from './types.js';
+export interface LoadArtifactFilesOptions {
+    /** Override default rules; omit to use {@link createDefaultArtifactSanitizationRules}. */
+    sanitizationRules?: readonly ArtifactSanitizationRule[];
+}
+/**
+ * Return files under `artifacts/` relative paths for ZIP layout, plus sanitization diagnostics.
+ */
+export declare function loadArtifactFilesForAdapter(memoryStore: MemoryQdrantStore, adapterId: string, options?: LoadArtifactFilesOptions): Promise<{
+    files: SkillExportFile[];
+    diagnostics: SkillExportDiagnostic[];
+}>;
+//# sourceMappingURL=artifact-files.d.ts.map

package/dist/tools/skill-export/artifact-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-files.d.ts","sourceRoot":"","sources":["../../../src/tools/skill-export/artifact-files.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAWzE,MAAM,WAAW,wBAAwB;IACvC,0FAA0F;IAC1F,iBAAiB,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACzD;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAAC,WAAW,EAAE,qBAAqB,EAAE,CAAA;CAAE,CAAC,CAqD7E"}

package/dist/tools/skill-export/artifact-files.js

@@ -0,0 +1,67 @@
+/**
+ * Load attached artifact memories for an adapter into skill export file list.
+ */
+import { createDefaultArtifactSanitizationRules, runArtifactSanitization } from './artifact-sanitization/index.js';
+import { normalizeArtifactRelativePath } from '../artifact-relative-path.js';
+import { sha256Hex } from './sha256.js';
+import { listAdapterArtifacts } from '../artifact-catalog.js';
+const SHA256_HEX_RE = /^[a-f0-9]{64}$/i;
+function isValidStoredArtifactSha256(value) {
+    return typeof value === 'string' && SHA256_HEX_RE.test(value);
+}
+/**
+ * Return files under `artifacts/` relative paths for ZIP layout, plus sanitization diagnostics.
+ */
+export async function loadArtifactFilesForAdapter(memoryStore, adapterId, options) {
+    const rules = options?.sanitizationRules ?? createDefaultArtifactSanitizationRules();
+    const out = [];
+    const diagnostics = [];
+    const artifacts = await listAdapterArtifacts(memoryStore, adapterId);
+    for (const artifact of artifacts) {
+        const name = artifact.name;
+        const text = artifact.text;
+        const ct = artifact.content_type;
+        const safeName = name.replace(/[/\\]/g, '_');
+        const storedRel = artifact.relative_path ?? '';
+        const normalizedStored = storedRel.length > 0 ? normalizeArtifactRelativePath(storedRel) : null;
+        let rel;
+        if (normalizedStored) {
+            rel = normalizedStored;
+        }
+        else {
+            if (storedRel.length > 0) {
+                diagnostics.push({
+                    severity: 'warning',
+                    code: 'artifact_relative_path_invalid',
+                    message: `Ignoring invalid artifact.relative_path for "${name}"; falling back to artifacts/${safeName}.`
+                });
+            }
+            rel = `artifacts/${safeName}`;
+        }
+        diagnostics.push(...runArtifactSanitization({ relativePath: rel, declaredContentType: ct }, rules));
+        const computedHex = sha256Hex(text);
+        const stored = artifact.sha256;
+        let fileSha = computedHex;
+        if (isValidStoredArtifactSha256(stored)) {
+            const normalized = stored.toLowerCase();
+            if (normalized !== computedHex) {
+                diagnostics.push({
+                    severity: 'warning',
+                    code: 'artifact_stored_sha_mismatch',
+                    message: `Stored artifact.sha256 does not match exported bytes for ${rel}; listing hash of current text.`
+                });
+            }
+            else {
+                fileSha = normalized;
+            }
+        }
+        out.push({
+            path: rel,
+            content: text,
+            contentType: ct,
+            sha256: fileSha
+        });
+    }
+    return { files: out, diagnostics };
+}
+//# sourceMappingURL=artifact-files.js.map

package/dist/tools/skill-export/artifact-files.js.map

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

package/dist/tools/skill-export/artifact-sanitization/default-rules.d.ts

@@ -0,0 +1,4 @@
+import type { ArtifactSanitizationRule } from './types.js';
+/** Default pipeline for skill export; callers may append or replace rules. */
+export declare function createDefaultArtifactSanitizationRules(): ArtifactSanitizationRule[];
+//# sourceMappingURL=default-rules.d.ts.map

package/dist/tools/skill-export/artifact-sanitization/default-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-rules.d.ts","sourceRoot":"","sources":["../../../../src/tools/skill-export/artifact-sanitization/default-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAG3D,8EAA8E;AAC9E,wBAAgB,sCAAsC,IAAI,wBAAwB,EAAE,CAEnF"}

package/dist/tools/skill-export/artifact-sanitization/default-rules.js

@@ -0,0 +1,6 @@
+import { createExtensionMimeConsistencyRule } from './rules/extension-mime-consistency.js';
+/** Default pipeline for skill export; callers may append or replace rules. */
+export function createDefaultArtifactSanitizationRules() {
+    return [createExtensionMimeConsistencyRule()];
+}
+//# sourceMappingURL=default-rules.js.map

package/dist/tools/skill-export/artifact-sanitization/default-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-rules.js","sourceRoot":"","sources":["../../../../src/tools/skill-export/artifact-sanitization/default-rules.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kCAAkC,EAAE,MAAM,uCAAuC,CAAC;AAE3F,8EAA8E;AAC9E,MAAM,UAAU,sCAAsC;IACpD,OAAO,CAAC,kCAAkC,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/tools/skill-export/artifact-sanitization/extension-mime-map.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Maps filename extension → MIME types that are considered consistent for export checks.
+ * Keep aligned with artifact allowlists (e.g. `artifact-files.ts` scroll filter).
+ */
+/**
+ * For each known extension, allowed normalized MIME types (lowercase).
+ * Unknown extensions are not validated by the extension–MIME rule (other rules may apply later).
+ */
+export declare const EXTENSION_TO_ALLOWED_MIMES: Readonly<Record<string, readonly string[]>>;
+/** MIME types allowed when the basename has no extension (basename has no dot). */
+export declare const NO_EXTENSION_ALLOWED_MIMES: readonly string[];
+//# sourceMappingURL=extension-mime-map.d.ts.map

package/dist/tools/skill-export/artifact-sanitization/extension-mime-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-mime-map.d.ts","sourceRoot":"","sources":["../../../../src/tools/skill-export/artifact-sanitization/extension-mime-map.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAalF,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAAmB,CAAC"}

package/dist/tools/skill-export/artifact-sanitization/extension-mime-map.js

@@ -0,0 +1,25 @@
+/**
+ * Maps filename extension → MIME types that are considered consistent for export checks.
+ * Keep aligned with artifact allowlists (e.g. `artifact-files.ts` scroll filter).
+ */
+/**
+ * For each known extension, allowed normalized MIME types (lowercase).
+ * Unknown extensions are not validated by the extension–MIME rule (other rules may apply later).
+ */
+export const EXTENSION_TO_ALLOWED_MIMES = {
+    '.py': ['text/x-python'],
+    '.sh': ['text/x-shellscript'],
+    '.bash': ['text/x-shellscript'],
+    '.js': ['text/javascript'],
+    '.mjs': ['text/javascript'],
+    '.cjs': ['text/javascript'],
+    '.pl': ['text/x-perl'],
+    '.pm': ['text/x-perl'],
+    '.toml': ['text/x-toml'],
+    '.yaml': ['text/yaml'],
+    '.yml': ['text/yaml'],
+    '.txt': ['text/plain']
+};
+/** MIME types allowed when the basename has no extension (basename has no dot). */
+export const NO_EXTENSION_ALLOWED_MIMES = ['text/plain'];
+//# sourceMappingURL=extension-mime-map.js.map

package/dist/tools/skill-export/artifact-sanitization/extension-mime-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-mime-map.js","sourceRoot":"","sources":["../../../../src/tools/skill-export/artifact-sanitization/extension-mime-map.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAgD;IACrF,KAAK,EAAE,CAAC,eAAe,CAAC;IACxB,KAAK,EAAE,CAAC,oBAAoB,CAAC;IAC7B,OAAO,EAAE,CAAC,oBAAoB,CAAC;IAC/B,KAAK,EAAE,CAAC,iBAAiB,CAAC;IAC1B,MAAM,EAAE,CAAC,iBAAiB,CAAC;IAC3B,MAAM,EAAE,CAAC,iBAAiB,CAAC;IAC3B,KAAK,EAAE,CAAC,aAAa,CAAC;IACtB,KAAK,EAAE,CAAC,aAAa,CAAC;IACtB,OAAO,EAAE,CAAC,aAAa,CAAC;IACxB,OAAO,EAAE,CAAC,WAAW,CAAC;IACtB,MAAM,EAAE,CAAC,WAAW,CAAC;IACrB,MAAM,EAAE,CAAC,YAAY,CAAC;CACvB,CAAC;AAEF,mFAAmF;AACnF,MAAM,CAAC,MAAM,0BAA0B,GAAsB,CAAC,YAAY,CAAC,CAAC"}

package/dist/tools/skill-export/artifact-sanitization/index.d.ts

@@ -0,0 +1,5 @@
+export type { ArtifactSanitizationRule } from './types.js';
+export { runArtifactSanitization } from './run-sanitization.js';
+export { createDefaultArtifactSanitizationRules } from './default-rules.js';
+export { createExtensionMimeConsistencyRule } from './rules/extension-mime-consistency.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/skill-export/artifact-sanitization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/skill-export/artifact-sanitization/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sCAAsC,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,kCAAkC,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/tools/skill-export/artifact-sanitization/index.js

@@ -0,0 +1,4 @@
+export { runArtifactSanitization } from './run-sanitization.js';
+export { createDefaultArtifactSanitizationRules } from './default-rules.js';
+export { createExtensionMimeConsistencyRule } from './rules/extension-mime-consistency.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/skill-export/artifact-sanitization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/skill-export/artifact-sanitization/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sCAAsC,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,kCAAkC,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/tools/skill-export/artifact-sanitization/normalize-mime.d.ts

@@ -0,0 +1,3 @@
+/** Normalize stored MIME for comparisons (lowercase, strip parameters). */
+export declare function normalizeMimeType(raw: string): string;
+//# sourceMappingURL=normalize-mime.d.ts.map

package/dist/tools/skill-export/artifact-sanitization/normalize-mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-mime.d.ts","sourceRoot":"","sources":["../../../../src/tools/skill-export/artifact-sanitization/normalize-mime.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD"}

package/dist/tools/skill-export/artifact-sanitization/normalize-mime.js

@@ -0,0 +1,9 @@
+/** Normalize stored MIME for comparisons (lowercase, strip parameters). */
+export function normalizeMimeType(raw) {
+    const s = (raw || '').trim().toLowerCase();
+    if (!s)
+        return '';
+    const semi = s.indexOf(';');
+    return semi === -1 ? s : s.slice(0, semi).trim();
+}
+//# sourceMappingURL=normalize-mime.js.map