daemora 1.0.0-alpha.0

package/dist/skills/SkillSnapshot.d.ts

@@ -0,0 +1,37 @@
+/**
+ * SkillSnapshot — disk-backed manifest cache for skill loading.
+ *
+ * Hermes pattern: walk the skills tree once, snapshot each SKILL.md's
+ * (path, mtime, size) into `data/.skills-snapshot.json`. Next process
+ * start, compare the snapshot manifest against the live tree; if every
+ * path + mtime + size matches, the in-memory registry is rebuildable
+ * from the cached frontmatter without re-parsing file contents.
+ *
+ * Invalidation: any SKILL.md mtime change anywhere in the tree forces
+ * a full rescan — there's no partial update, since category layout can
+ * move skills around.
+ */
+export interface ManifestEntry {
+    readonly path: string;
+    readonly mtimeMs: number;
+    readonly size: number;
+}
+export interface SkillSnapshotData {
+    readonly version: 1;
+    readonly root: string;
+    readonly builtAt: number;
+    readonly manifest: readonly ManifestEntry[];
+}
+export declare class SkillSnapshot {
+    private readonly skillsRoot;
+    private readonly snapshotPath;
+    constructor(skillsRoot: string, snapshotPath: string);
+    /** Walk the tree, collect SKILL.md-equivalent file paths + mtimes. */
+    buildManifest(): Promise<readonly ManifestEntry[]>;
+    readSnapshot(): Promise<SkillSnapshotData | null>;
+    writeSnapshot(manifest: readonly ManifestEntry[]): Promise<void>;
+    /** True iff every path in `manifest` still matches mtime + size on disk. */
+    isFresh(manifest: readonly ManifestEntry[]): Promise<boolean>;
+    private walk;
+}
+//# sourceMappingURL=SkillSnapshot.d.ts.map

package/dist/skills/SkillSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillSnapshot.d.ts","sourceRoot":"","sources":["../../src/skills/SkillSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,MAAM,WAAW,aAAa;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAEzG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM;IAGvC,sEAAsE;IAChE,aAAa,IAAI,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;IAOlD,YAAY,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAWjD,aAAa,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAetE,4EAA4E;IACtE,OAAO,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;YAWrD,IAAI;CAkBnB"}

package/dist/skills/SkillSnapshot.js

@@ -0,0 +1,106 @@
+/**
+ * SkillSnapshot — disk-backed manifest cache for skill loading.
+ *
+ * Hermes pattern: walk the skills tree once, snapshot each SKILL.md's
+ * (path, mtime, size) into `data/.skills-snapshot.json`. Next process
+ * start, compare the snapshot manifest against the live tree; if every
+ * path + mtime + size matches, the in-memory registry is rebuildable
+ * from the cached frontmatter without re-parsing file contents.
+ *
+ * Invalidation: any SKILL.md mtime change anywhere in the tree forces
+ * a full rescan — there's no partial update, since category layout can
+ * move skills around.
+ */
+import { readFile, readdir, stat, writeFile, mkdir } from "node:fs/promises";
+import { dirname, join, relative, resolve } from "node:path";
+import { createLogger } from "../util/logger.js";
+const log = createLogger("skills.snapshot");
+const WALK_SKIP = new Set([".git", ".github", ".hub", "node_modules", "_template"]);
+export class SkillSnapshot {
+    skillsRoot;
+    snapshotPath;
+    constructor(skillsRoot, snapshotPath) {
+        this.skillsRoot = skillsRoot;
+        this.snapshotPath = snapshotPath;
+    }
+    /** Walk the tree, collect SKILL.md-equivalent file paths + mtimes. */
+    async buildManifest() {
+        const entries = [];
+        await this.walk(resolve(this.skillsRoot), entries);
+        entries.sort((a, b) => a.path.localeCompare(b.path));
+        return entries;
+    }
+    async readSnapshot() {
+        try {
+            const raw = await readFile(this.snapshotPath, "utf-8");
+            const data = JSON.parse(raw);
+            if (data.version !== 1)
+                return null;
+            return data;
+        }
+        catch {
+            return null;
+        }
+    }
+    async writeSnapshot(manifest) {
+        const data = {
+            version: 1,
+            root: resolve(this.skillsRoot),
+            builtAt: Date.now(),
+            manifest,
+        };
+        try {
+            await mkdir(dirname(this.snapshotPath), { recursive: true });
+            await writeFile(this.snapshotPath, JSON.stringify(data), "utf-8");
+        }
+        catch (e) {
+            log.warn({ err: e.message }, "snapshot write failed");
+        }
+    }
+    /** True iff every path in `manifest` still matches mtime + size on disk. */
+    async isFresh(manifest) {
+        // Quick path: count files in tree, must match manifest length.
+        const live = await this.buildManifest();
+        if (live.length !== manifest.length)
+            return false;
+        for (let i = 0; i < live.length; i++) {
+            const a = live[i];
+            const b = manifest[i];
+            if (a.path !== b.path || a.mtimeMs !== b.mtimeMs || a.size !== b.size)
+                return false;
+        }
+        return true;
+    }
+    async walk(dir, out) {
+        let entries;
+        try {
+            entries = await readdir(dir);
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (e.startsWith(".") || e.startsWith("_"))
+                continue;
+            if (WALK_SKIP.has(e))
+                continue;
+            const full = join(dir, e);
+            let s;
+            try {
+                s = await stat(full);
+            }
+            catch {
+                continue;
+            }
+            if (s.isFile() && (e === "SKILL.md" || e === "skill.md" || e === "skill.yaml" || e.endsWith(".md"))) {
+                // Only skill-defining files; body/reference files tracked via parent dir
+                const rel = relative(resolve(this.skillsRoot), full);
+                out.push({ path: rel, mtimeMs: s.mtimeMs, size: s.size });
+            }
+            else if (s.isDirectory()) {
+                await this.walk(full, out);
+            }
+        }
+    }
+}
+//# sourceMappingURL=SkillSnapshot.js.map

package/dist/skills/SkillSnapshot.js.map

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

package/dist/skills/types.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Skill — a directory holding a SKILL.md file with frontmatter metadata
+ * and a body of instructions, plus optional supporting assets.
+ *
+ * Lazy by design: `Skill` carries only the parsed frontmatter at
+ * registry time. The body is read from disk on first match (`loadBody`)
+ * to keep startup fast and the system prompt small.
+ */
+import { z } from "zod";
+/** Env-var declaration the skill needs to be operable. */
+export declare const skillEnvVarSchema: z.ZodObject<{
+    name: z.ZodString;
+    prompt: z.ZodOptional<z.ZodString>;
+    help: z.ZodOptional<z.ZodString>;
+    optional: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    optional: boolean;
+    prompt?: string | undefined;
+    help?: string | undefined;
+}, {
+    name: string;
+    prompt?: string | undefined;
+    help?: string | undefined;
+    optional?: boolean | undefined;
+}>;
+export type SkillEnvVar = z.infer<typeof skillEnvVarSchema>;
+/** Declarative skill-local config, resolved from settings store at load time. */
+export declare const skillConfigDeclSchema: z.ZodObject<{
+    key: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    default: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    default?: string | undefined;
+    description?: string | undefined;
+    prompt?: string | undefined;
+}, {
+    key: string;
+    default?: string | undefined;
+    description?: string | undefined;
+    prompt?: string | undefined;
+}>;
+export type SkillConfigDecl = z.infer<typeof skillConfigDeclSchema>;
+/**
+ * Schema for the YAML frontmatter at the top of every SKILL.md.
+ * Keep this small and stable — adding optional fields is fine,
+ * renaming/removing them isn't.
+ */
+export declare const skillFrontmatterSchema: z.ZodObject<{
+    /** Stable slug. Set from frontmatter `id` or `name`, or directory name. */
+    id: z.ZodDefault<z.ZodString>;
+    /** Human title / slug. JS skills use `name` as the primary key. */
+    name: z.ZodString;
+    /** Summary the agent reads to decide relevance. */
+    description: z.ZodString;
+    /** Free-form keywords — string (comma-separated) or array. */
+    triggers: z.ZodDefault<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodEffects<z.ZodString, string[], string>]>>;
+    /** Tools the skill expects to be available. Skill is hidden if any tool is missing. */
+    requires_tools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Integrations the skill expects to be enabled. Skill is hidden if any integration is missing. */
+    requires_integrations: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Platforms the skill runs on (e.g. ["darwin", "linux"]). Empty = all. */
+    platforms: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Skill is hidden when any of these primary tools IS available. */
+    fallback_for_tools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Env vars the skill needs before it's fully operable. */
+    required_environment_variables: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+        help: z.ZodOptional<z.ZodString>;
+        optional: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        optional: boolean;
+        prompt?: string | undefined;
+        help?: string | undefined;
+    }, {
+        name: string;
+        prompt?: string | undefined;
+        help?: string | undefined;
+        optional?: boolean | undefined;
+    }>, "many">>;
+    /** Declarative skill-local config. Resolved from settings. */
+    config: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        default?: string | undefined;
+        description?: string | undefined;
+        prompt?: string | undefined;
+    }, {
+        key: string;
+        default?: string | undefined;
+        description?: string | undefined;
+        prompt?: string | undefined;
+    }>, "many">>;
+    /** Optional version stamp for cache invalidation. */
+    version: z.ZodDefault<z.ZodString>;
+    /** Optional flag to disable a skill without deleting it. */
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    description: string;
+    config: {
+        key: string;
+        default?: string | undefined;
+        description?: string | undefined;
+        prompt?: string | undefined;
+    }[];
+    id: string;
+    name: string;
+    triggers: string[];
+    requires_tools: string[];
+    requires_integrations: string[];
+    platforms: string[];
+    fallback_for_tools: string[];
+    required_environment_variables: {
+        name: string;
+        optional: boolean;
+        prompt?: string | undefined;
+        help?: string | undefined;
+    }[];
+    enabled: boolean;
+}, {
+    description: string;
+    name: string;
+    version?: string | undefined;
+    config?: {
+        key: string;
+        default?: string | undefined;
+        description?: string | undefined;
+        prompt?: string | undefined;
+    }[] | undefined;
+    id?: string | undefined;
+    triggers?: string | string[] | undefined;
+    requires_tools?: string[] | undefined;
+    requires_integrations?: string[] | undefined;
+    platforms?: string[] | undefined;
+    fallback_for_tools?: string[] | undefined;
+    required_environment_variables?: {
+        name: string;
+        prompt?: string | undefined;
+        help?: string | undefined;
+        optional?: boolean | undefined;
+    }[] | undefined;
+    enabled?: boolean | undefined;
+}>;
+export type SkillFrontmatter = z.infer<typeof skillFrontmatterSchema>;
+/** Supporting files discovered under a skill directory. */
+export interface SkillLinkedFiles {
+    readonly references: readonly string[];
+    readonly templates: readonly string[];
+    readonly scripts: readonly string[];
+    readonly assets: readonly string[];
+}
+export interface Skill {
+    /** Resolved frontmatter (validated). */
+    readonly meta: SkillFrontmatter;
+    /** Absolute path to the skill directory (or the .md file's parent). */
+    readonly dir: string;
+    /** Absolute path to SKILL.md. */
+    readonly file: string;
+    /** sha256 of the raw SKILL.md content — for embedding-cache invalidation. */
+    readonly contentHash: string;
+    /** Linked supporting files under references/, templates/, scripts/, assets/. */
+    readonly linkedFiles: SkillLinkedFiles;
+    /** Lazy body loader. Reads + caches per-process. */
+    loadBody(): Promise<string>;
+}
+export interface SkillLoadIssue {
+    readonly dir: string;
+    readonly reason: string;
+    readonly cause?: unknown;
+}
+export interface SkillLoadReport {
+    readonly loaded: readonly Skill[];
+    readonly skipped: readonly SkillLoadIssue[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,iFAAiF;AACjF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;IACjC,2EAA2E;;IAE3E,mEAAmE;;IAEnE,mDAAmD;;IAEnD,8DAA8D;;IAK9D,uFAAuF;;IAEvF,mGAAmG;;IAEnG,2EAA2E;;IAE3E,oEAAoE;;IAEpE,2DAA2D;;;;;;;;;;;;;;;;;IAE3D,8DAA8D;;;;;;;;;;;;;;;;;IAE9D,qDAAqD;;IAErD,4DAA4D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5D,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,KAAK;IACpB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,oDAAoD;IACpD,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;CAC7C"}

package/dist/skills/types.js

@@ -0,0 +1,58 @@
+/**
+ * Skill — a directory holding a SKILL.md file with frontmatter metadata
+ * and a body of instructions, plus optional supporting assets.
+ *
+ * Lazy by design: `Skill` carries only the parsed frontmatter at
+ * registry time. The body is read from disk on first match (`loadBody`)
+ * to keep startup fast and the system prompt small.
+ */
+import { z } from "zod";
+/** Env-var declaration the skill needs to be operable. */
+export const skillEnvVarSchema = z.object({
+    name: z.string().min(1).max(128),
+    prompt: z.string().max(200).optional(),
+    help: z.string().max(500).optional(),
+    optional: z.boolean().default(false),
+});
+/** Declarative skill-local config, resolved from settings store at load time. */
+export const skillConfigDeclSchema = z.object({
+    key: z.string().min(1).max(128),
+    description: z.string().max(500).optional(),
+    default: z.string().optional(),
+    prompt: z.string().max(200).optional(),
+});
+/**
+ * Schema for the YAML frontmatter at the top of every SKILL.md.
+ * Keep this small and stable — adding optional fields is fine,
+ * renaming/removing them isn't.
+ */
+export const skillFrontmatterSchema = z.object({
+    /** Stable slug. Set from frontmatter `id` or `name`, or directory name. */
+    id: z.string().min(1).default("unknown"),
+    /** Human title / slug. JS skills use `name` as the primary key. */
+    name: z.string().min(1).max(120),
+    /** Summary the agent reads to decide relevance. */
+    description: z.string().min(1).max(2000),
+    /** Free-form keywords — string (comma-separated) or array. */
+    triggers: z.union([
+        z.array(z.string()),
+        z.string().transform((s) => s.split(/,\s*/).filter(Boolean)),
+    ]).default([]),
+    /** Tools the skill expects to be available. Skill is hidden if any tool is missing. */
+    requires_tools: z.array(z.string()).default([]),
+    /** Integrations the skill expects to be enabled. Skill is hidden if any integration is missing. */
+    requires_integrations: z.array(z.string()).default([]),
+    /** Platforms the skill runs on (e.g. ["darwin", "linux"]). Empty = all. */
+    platforms: z.array(z.string()).default([]),
+    /** Skill is hidden when any of these primary tools IS available. */
+    fallback_for_tools: z.array(z.string()).default([]),
+    /** Env vars the skill needs before it's fully operable. */
+    required_environment_variables: z.array(skillEnvVarSchema).default([]),
+    /** Declarative skill-local config. Resolved from settings. */
+    config: z.array(skillConfigDeclSchema).default([]),
+    /** Optional version stamp for cache invalidation. */
+    version: z.string().default("1.0.0"),
+    /** Optional flag to disable a skill without deleting it. */
+    enabled: z.boolean().default(true),
+});
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

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

package/dist/tasks/TaskStore.d.ts

@@ -0,0 +1,70 @@
+/**
+ * TaskStore — persists agent task execution history for the Logs page.
+ *
+ * Every POST /api/chat creates a task. When the task completes or
+ * fails, it's recorded here with timing, model, token usage, and
+ * the final result summary.
+ */
+import type Database from "better-sqlite3";
+export interface TaskRow {
+    readonly id: string;
+    readonly sessionId: string;
+    readonly input: string;
+    readonly model: string | null;
+    readonly status: "pending" | "running" | "completed" | "failed";
+    readonly result: string | null;
+    readonly error: string | null;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly toolCalls: number;
+    readonly steps: number;
+    readonly durationMs: number | null;
+    readonly createdAt: number;
+    readonly completedAt: number | null;
+    readonly channel: string | null;
+    readonly channelMeta: Record<string, unknown> | null;
+}
+export interface ToolCallRecord {
+    readonly id: number;
+    readonly taskId: string;
+    readonly toolName: string;
+    readonly args: unknown;
+    readonly result: unknown;
+    readonly error: string | null;
+    readonly durationMs: number | null;
+    readonly createdAt: number;
+}
+export declare class TaskStore {
+    private readonly db;
+    private readonly insertStmt;
+    private readonly updateStmt;
+    private readonly selectAll;
+    private readonly selectOne;
+    private readonly deleteStmt;
+    private readonly insertToolCall;
+    private readonly selectToolCalls;
+    constructor(db: Database.Database);
+    create(id: string, sessionId: string, input: string, model?: string, channel?: string, channelMeta?: Record<string, unknown>): void;
+    complete(id: string, opts: {
+        result?: string;
+        inputTokens?: number;
+        outputTokens?: number;
+        toolCalls?: number;
+        steps?: number;
+        durationMs?: number;
+    }): void;
+    fail(id: string, error: string, durationMs?: number): void;
+    list(limit?: number): readonly TaskRow[];
+    /**
+     * Failed tasks created after `sinceMs`, newest first, capped at `limit`.
+     * Used by Heartbeat to surface recent failures worth retrying/surfacing.
+     */
+    recentFailed(sinceMs: number, limit?: number): readonly TaskRow[];
+    get(id: string): TaskRow | null;
+    delete(id: string): boolean;
+    /** Record a tool call with its args and result. */
+    recordToolCall(taskId: string, toolName: string, args?: unknown, result?: unknown, error?: string, durationMs?: number): void;
+    /** Get all tool calls for a task. */
+    getToolCalls(taskId: string): readonly ToolCallRecord[];
+}
+//# sourceMappingURL=TaskStore.d.ts.map

package/dist/tasks/TaskStore.d.ts.map

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