skills-manager-cli 2026.8.26-1

package/dist/core/model/catalog.js

@@ -0,0 +1,7 @@
+/**
+ * Catalog snapshot types. The snapshot is the vercel-labs/skills agent table
+ * extracted as data (see ADR-0004): agent ids, runtime paths, and detection
+ * rules all travel inside it; code never hard-codes agent lists.
+ */
+export {};
+//# sourceMappingURL=catalog.js.map

package/dist/core/model/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/core/model/catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/core/model/index.js

@@ -0,0 +1,7 @@
+/**
+ * Legacy consumer words (pre-catalog). Kept as a local constant only where
+ * the one-shot migration bridge and leftover-view cleanup need to recognize
+ * them; they are no longer a model-level closed set.
+ */
+export const LEGACY_CONSUMERS = ['agents', 'claude'];
+//# sourceMappingURL=index.js.map

package/dist/core/model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/model/index.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC"}

package/dist/core/ports/filesystem.js

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

package/dist/core/ports/filesystem.js.map

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

package/dist/core/ports/git.js

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

package/dist/core/ports/git.js.map

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

package/dist/core/ports/process-runner.js

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

package/dist/core/ports/process-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-runner.js","sourceRoot":"","sources":["../../../src/core/ports/process-runner.ts"],"names":[],"mappings":""}

package/dist/core/services/activity-service.js

@@ -0,0 +1,36 @@
+import { randomUUID } from 'node:crypto';
+import path from 'node:path';
+export class ActivityService {
+    fs;
+    git;
+    home;
+    constructor(fs, git, home) {
+        this.fs = fs;
+        this.git = git;
+        this.home = home;
+    }
+    record(input) {
+        const record = {
+            id: input.id || randomUUID(),
+            timestamp: input.timestamp || new Date().toISOString(),
+            action: input.action,
+            summary: input.summary,
+            actor: input.actor,
+            details: input.details,
+        };
+        this.fs.makeDirectory(path.dirname(this.home.activityFile));
+        this.fs.appendText(this.home.activityFile, `${JSON.stringify(record)}\n`);
+        return record;
+    }
+    list(options = {}) {
+        if (!this.fs.exists(this.home.activityFile))
+            return [];
+        const lines = this.fs.readText(this.home.activityFile).split('\n').filter(Boolean);
+        const records = lines.map((line) => JSON.parse(line)).sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+        return typeof options.limit === 'number' ? records.slice(0, options.limit) : records;
+    }
+    gitHistory(options = {}) {
+        return this.git.log(this.home.root, options.limit || 20);
+    }
+}
+//# sourceMappingURL=activity-service.js.map

package/dist/core/services/activity-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-service.js","sourceRoot":"","sources":["../../../src/core/services/activity-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,MAAM,OAAO,eAAe;IACG,EAAE;IAAmC,GAAG;IAA4B,IAAI;IAArG,YAA6B,EAAkB,EAAmB,GAAY,EAAmB,IAAe;kBAAnF,EAAE;mBAAmC,GAAG;oBAA4B,IAAI;IAAc,CAAC;IAEpH,MAAM,CAAC,KAAqF;QAC1F,MAAM,MAAM,GAAmB;YAC7B,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,UAAU,EAAE;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtD,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;QACF,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,OAAO,GAAuB,EAAE;QACnC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;YAAE,OAAO,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/H,OAAO,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACvF,CAAC;IAED,UAAU,CAAC,OAAO,GAAuB,EAAE;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/core/services/adopt-service.js

@@ -0,0 +1,7 @@
+import { SkillsManagerError } from '../../shared/errors.js';
+export class AdoptService {
+    adopt(_view, _skill, _alsoConsumers = []) {
+        throw new SkillsManagerError('adopt_removed', 'Adopt from hub views/ is removed. Place the skill under hub skills/ then distribute.');
+    }
+}
+//# sourceMappingURL=adopt-service.js.map

package/dist/core/services/adopt-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt-service.js","sourceRoot":"","sources":["../../../src/core/services/adopt-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,OAAO,YAAY;IACvB,KAAK,CAAC,KAAa,EAAE,MAAc,EAAE,cAAc,GAAsB,EAAE;QACzE,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,sFAAsF,CAAC,CAAC;IACxI,CAAC;CACF"}

package/dist/core/services/archive-service.js

@@ -0,0 +1,35 @@
+import path from 'node:path';
+import { SkillsManagerError } from '../../shared/errors.js';
+import { assertPathInside } from '../../shared/validation.js';
+export class ArchiveService {
+    fs;
+    home;
+    registry;
+    views;
+    constructor(fs, home, registry, views) {
+        this.fs = fs;
+        this.home = home;
+        this.registry = registry;
+        this.views = views;
+    }
+    archiveSkills(skills) {
+        const archived = [];
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const archiveRoot = path.join(this.home.root, '.skills', 'archive', timestamp);
+        this.fs.makeDirectory(archiveRoot);
+        for (const skill of skills) {
+            if (!this.registry.skillExists(skill))
+                throw new SkillsManagerError('skill_missing', `Skill not found: ${skill}`);
+            const source = this.registry.skillDir(skill);
+            const destination = path.join(archiveRoot, skill);
+            assertPathInside(destination, archiveRoot);
+            this.fs.move(source, destination);
+            const existing = this.registry.getEntry(skill) || this.registry.defaultEntry(skill);
+            this.registry.ensureEntry(skill, { ...existing, archived: true, consumers: [], archived_at: new Date().toISOString(), archive_path: path.relative(this.home.root, destination) });
+            archived.push(skill);
+        }
+        this.views.rebuildCollections();
+        return { archived, archiveRoot };
+    }
+}
+//# sourceMappingURL=archive-service.js.map

package/dist/core/services/archive-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-service.js","sourceRoot":"","sources":["../../../src/core/services/archive-service.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,MAAM,OAAO,cAAc;IACI,EAAE;IAAmC,IAAI;IAA8B,QAAQ;IAAoC,KAAK;IAArJ,YAA6B,EAAkB,EAAmB,IAAe,EAAmB,QAAyB,EAAmB,KAAkB;kBAArI,EAAE;oBAAmC,IAAI;wBAA8B,QAAQ;qBAAoC,KAAK;IAAgB,CAAC;IAEtK,aAAa,CAAC,MAAyB;QACrC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACjE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC/E,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,oBAAoB,KAAK,EAAE,CAAC,CAAC;YAClH,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAClD,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YAC3C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpF,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;YAClL,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAChC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACnC,CAAC;CACF"}

package/dist/core/services/backup-service.js

@@ -0,0 +1,94 @@
+import path from 'node:path';
+import { SkillsManagerError } from '../../shared/errors.js';
+const RETENTION_MS = 30 * 24 * 60 * 60 * 1000;
+/**
+ * Recovery aid for `init` (ADR-0006): the displaced original recorded before a
+ * runtime path became a back-symlink. Never a second skill store.
+ */
+export class BackupService {
+    fs;
+    home;
+    registry;
+    distribute;
+    constructor(fs, home, registry, distribute) {
+        this.fs = fs;
+        this.home = home;
+        this.registry = registry;
+        this.distribute = distribute;
+    }
+    root() {
+        return path.join(this.home.root, '.backups');
+    }
+    list() {
+        if (this.fs.kind(this.root()) !== 'directory')
+            return [];
+        return this.fs.readDirectory(this.root())
+            .filter((entry) => entry.kind === 'directory')
+            .flatMap((entry) => {
+            const parsed = parseBackupName(entry.name);
+            return parsed ? [{ ...parsed, dir: path.join(this.root(), entry.name) }] : [];
+        })
+            .sort((a, b) => a.skill.localeCompare(b.skill) || a.timestamp.localeCompare(b.timestamp));
+    }
+    /** Roll one skill fully back: remove managed symlinks, delete the hub entity and registry entry, return each origin its original. */
+    restore(skill) {
+        const available = this.list().filter((item) => item.skill === skill);
+        if (available.length === 0) {
+            throw new SkillsManagerError('backup_not_found', `No backup found for skill "${skill}". Run \`skills-manager backup list\` to see what exists.`);
+        }
+        const runtimePaths = this.managedRuntimePaths(skill);
+        if (runtimePaths.length > 0) {
+            const agents = [...new Set(this.userIndexEntries(skill).flatMap((entry) => entry.agents))];
+            this.distribute.undistribute({ to: 'user', skills: [skill], agents });
+        }
+        const hubDir = path.join(this.home.skillsDir, skill);
+        if (this.fs.kind(hubDir) !== 'missing')
+            this.fs.removeTree(hubDir);
+        this.registry.removeEntry(skill);
+        // Consume the newest remaining backup per origin; older ones stay until pruned.
+        const restoredPaths = [];
+        const pending = [...available].reverse(); // newest first
+        for (const runtimePath of runtimePaths) {
+            const backup = pending.shift();
+            if (!backup)
+                break;
+            this.fs.makeDirectory(path.dirname(runtimePath));
+            this.fs.move(backup.dir, runtimePath);
+            restoredPaths.push(runtimePath);
+        }
+        return { restored: true, skill, runtimePaths: restoredPaths };
+    }
+    /** Drop backups older than the 30-day retention window; init runs this alongside a real import. */
+    prune(now = new Date()) {
+        const cutoff = now.getTime() - RETENTION_MS;
+        let removed = 0;
+        for (const item of this.list()) {
+            if (backupTime(item.timestamp) < cutoff) {
+                this.fs.removeTree(item.dir);
+                removed += 1;
+            }
+        }
+        return removed;
+    }
+    userIndexEntries(skill) {
+        return this.distribute.listIndex()
+            .filter((record) => record.kind === 'user')
+            .flatMap((record) => record.entries.filter((entry) => entry.skill === skill));
+    }
+    managedRuntimePaths(skill) {
+        return this.userIndexEntries(skill).map((entry) => entry.runtimePath);
+    }
+}
+/** Backup dirs are `<skill>-<iso-timestamp>` (with an optional -N uniqueness suffix); the skill name may itself contain dashes. */
+export function parseBackupName(name) {
+    const match = /^(.+)-(\d{4}-\d{2}-\d{2}T[\d-]+Z?)(?:-\d+)?$/.exec(name);
+    return match ? { skill: match[1], timestamp: match[2] } : null;
+}
+/** Timestamps are ISO with `:`/`.` dash-encoded for filesystem safety; decode back to a real time. */
+function backupTime(timestamp) {
+    const iso = timestamp
+        .replace(/T(\d{2})-(\d{2})-(\d{2})-(\d{3})Z$/, 'T$1:$2:$3.$4Z')
+        .replace(/T(\d{2})-(\d{2})-(\d{2})Z$/, 'T$1:$2:$3Z');
+    return new Date(iso).getTime();
+}
+//# sourceMappingURL=backup-service.js.map

package/dist/core/services/backup-service.js.map

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

package/dist/core/services/catalog-service.js

@@ -0,0 +1,123 @@
+import os from 'node:os';
+import path from 'node:path';
+import { SkillsManagerError } from '../../shared/errors.js';
+import { detectAgents } from '../catalog/evaluate-detection.js';
+import { extractCatalogSnapshot } from '../catalog/extract.js';
+import { resolveCatalogTemplate } from '../catalog/resolve-path.js';
+import { validateCatalogSnapshot } from '../catalog/validate-snapshot.js';
+const RAW_BASE = 'https://raw.githubusercontent.com/vercel-labs/skills/main';
+const COMMIT_API = 'https://api.github.com/repos/vercel-labs/skills/commits?path=src/agents.ts&per_page=1';
+const BUNDLED_SNAPSHOT_URL = new URL('../catalog/agent-catalog.json', import.meta.url);
+async function defaultFetchText(url) {
+    const response = await fetch(url);
+    if (!response.ok)
+        throw new SkillsManagerError('catalog_refresh_failed', `Failed to fetch ${url}: ${response.status} ${response.statusText}`);
+    return response.text();
+}
+export class CatalogService {
+    fs;
+    home;
+    options;
+    loaded = null;
+    loadedFrom = null;
+    constructor(fs, home, options = {}) {
+        this.fs = fs;
+        this.home = home;
+        this.options = options;
+    }
+    /** Effective snapshot: injected fixture > hub refresh override > bundled file. */
+    load() {
+        if (this.loaded)
+            return this.loaded;
+        if (this.options.snapshot) {
+            this.loaded = validateCatalogSnapshot(this.options.snapshot);
+            this.loadedFrom = 'injected';
+            return this.loaded;
+        }
+        const overridePath = this.overridePath();
+        if (this.fs.kind(overridePath) === 'file') {
+            this.loaded = validateCatalogSnapshot(this.parseJson(this.fs.readText(overridePath), overridePath));
+            this.loadedFrom = 'hub';
+            return this.loaded;
+        }
+        this.loaded = validateCatalogSnapshot(this.parseJson(this.fs.readText(BUNDLED_SNAPSHOT_URL.pathname), 'bundled snapshot'));
+        this.loadedFrom = 'bundled';
+        return this.loaded;
+    }
+    /** The detected agent set on this machine — same rules, same data as `npx skills` with no -a. */
+    detected() {
+        const snapshot = this.load();
+        const homeDir = this.options.userHomeDir ?? os.homedir();
+        const env = this.options.env ?? process.env;
+        return detectAgents(snapshot, {
+            variables: snapshot.pathVariables,
+            env,
+            homeDir,
+            cwd: process.cwd(),
+            pathExists: (absolute) => this.fs.exists(absolute),
+            cwdPathExists: (relative) => this.fs.exists(path.resolve(process.cwd(), relative)),
+            packageHasDependency: (name) => this.packageJsonInCwdDeclares(name),
+            isTty: process.stdout.isTTY === true,
+        });
+    }
+    snapshotInfo() {
+        const snapshot = this.load();
+        const now = this.options.now ? this.options.now() : new Date();
+        const ageDays = Math.floor((now.getTime() - new Date(snapshot.source.date).getTime()) / (24 * 60 * 60 * 1000));
+        return { source: this.loadedFrom ?? 'bundled', commit: snapshot.source.commit, date: snapshot.source.date, ageDays };
+    }
+    /** Pull upstream and overwrite the hub-local snapshot; doctor age follows on next read. */
+    async refresh() {
+        const fetchText = this.options.fetchText ?? defaultFetchText;
+        const [agentsTs, detectAgentTs, commitJson] = await Promise.all([
+            fetchText(`${RAW_BASE}/src/agents.ts`),
+            fetchText(`${RAW_BASE}/src/detect-agent.ts`),
+            fetchText(COMMIT_API),
+        ]);
+        const [entry] = JSON.parse(commitJson);
+        if (!entry)
+            throw new SkillsManagerError('catalog_refresh_failed', 'Upstream commit endpoint returned no entries');
+        const snapshot = extractCatalogSnapshot({ agentsTs, detectAgentTs, commit: entry.sha, date: entry.commit.committer.date });
+        const wroteTo = this.overridePath();
+        this.fs.makeDirectory(path.dirname(wroteTo));
+        this.fs.writeText(wroteTo, `${JSON.stringify(snapshot, null, 2)}\n`);
+        this.loaded = snapshot;
+        this.loadedFrom = 'hub';
+        return { commit: entry.sha, date: entry.commit.committer.date, agentCount: snapshot.agents.length, wroteTo };
+    }
+    overridePath() {
+        return path.join(this.home.root, '.skills', 'agent-catalog.json');
+    }
+    /** Resolve an agent's global runtime dir against this machine's env/user home; null when it cannot resolve here. */
+    resolveGlobalDir(agentId) {
+        const agent = this.load().agents.find((item) => item.id === agentId);
+        if (!agent || !agent.globalSkillsDir)
+            return null;
+        return resolveCatalogTemplate(agent.globalSkillsDir, {
+            variables: this.load().pathVariables,
+            homeDir: this.options.userHomeDir ?? os.homedir(),
+            env: this.options.env ?? process.env,
+        });
+    }
+    parseJson(text, origin) {
+        try {
+            return JSON.parse(text);
+        }
+        catch (error) {
+            throw new SkillsManagerError('catalog_invalid', `Cannot parse ${origin}: ${error.message}. Run \`skills-manager catalog refresh\` to rebuild it.`);
+        }
+    }
+    packageJsonInCwdDeclares(name) {
+        const file = path.resolve(process.cwd(), 'package.json');
+        if (!this.fs.exists(file))
+            return false;
+        try {
+            const parsed = JSON.parse(this.fs.readText(file));
+            return Boolean(parsed.dependencies?.[name] || parsed.devDependencies?.[name]);
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=catalog-service.js.map

package/dist/core/services/catalog-service.js.map

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