@lyupro/skillforge-mcp 1.1.0

package/dist/core/skill-metadata-cache.js

@@ -0,0 +1,31 @@
+export class SkillMetadataCache {
+    #ttlMs;
+    #now;
+    #freshAt = null;
+    constructor(options) {
+        const ttlMs = options?.ttlMs ?? 300_000;
+        if (ttlMs <= 0) {
+            throw new Error('ttlMs must be a positive number');
+        }
+        this.#ttlMs = ttlMs;
+        this.#now = options?.now ?? Date.now;
+    }
+    isValid() {
+        return this.#freshAt !== null && this.#now() - this.#freshAt < this.#ttlMs;
+    }
+    markFresh() {
+        this.#freshAt = this.#now();
+    }
+    invalidate() {
+        this.#freshAt = null;
+    }
+    expiresAt() {
+        if (this.#freshAt === null)
+            return null;
+        return this.#freshAt + this.#ttlMs;
+    }
+    get ttlMs() {
+        return this.#ttlMs;
+    }
+}
+//# sourceMappingURL=skill-metadata-cache.js.map

package/dist/core/skill-metadata-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-metadata-cache.js","sourceRoot":"","sources":["../../src/core/skill-metadata-cache.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,kBAAkB;IACpB,MAAM,CAAS;IACf,IAAI,CAAe;IAC5B,QAAQ,GAAkB,IAAI,CAAC;IAE/B,YAAY,OAA8B;QACxC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,OAAO,CAAC;QACxC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACvC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;IAC7E,CAAC;IAED,SAAS;QACP,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,UAAU;QACR,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,SAAS;QACP,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACxC,OAAO,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/core/skill-registry.d.ts

@@ -0,0 +1,12 @@
+import type { SkillMetadata } from './types.js';
+export declare class SkillRegistry {
+    #private;
+    register(metadata: SkillMetadata): void;
+    get(name: string): SkillMetadata | undefined;
+    has(name: string): boolean;
+    unregister(name: string): boolean;
+    clear(): void;
+    getAll(): SkillMetadata[];
+    get size(): number;
+}
+//# sourceMappingURL=skill-registry.d.ts.map

package/dist/core/skill-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.d.ts","sourceRoot":"","sources":["../../src/core/skill-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,aAAa;;IAGxB,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAOvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI5C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,aAAa,EAAE;IAIzB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/core/skill-registry.js

@@ -0,0 +1,28 @@
+export class SkillRegistry {
+    #store = new Map();
+    register(metadata) {
+        if (!metadata.name) {
+            throw new Error('Skill name must be a non-empty string');
+        }
+        this.#store.set(metadata.name, metadata);
+    }
+    get(name) {
+        return this.#store.get(name);
+    }
+    has(name) {
+        return this.#store.has(name);
+    }
+    unregister(name) {
+        return this.#store.delete(name);
+    }
+    clear() {
+        this.#store.clear();
+    }
+    getAll() {
+        return [...this.#store.values()].sort((a, b) => a.name.localeCompare(b.name));
+    }
+    get size() {
+        return this.#store.size;
+    }
+}
+//# sourceMappingURL=skill-registry.js.map

package/dist/core/skill-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.js","sourceRoot":"","sources":["../../src/core/skill-registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACf,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEnD,QAAQ,CAAC,QAAuB;QAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF"}

package/dist/core/skill-resolver.d.ts

@@ -0,0 +1,6 @@
+import type { SkillMetadata } from './types.js';
+export declare class SkillResolver {
+    #private;
+    resolve(candidates: SkillMetadata[], folderPriority: string[]): SkillMetadata;
+}
+//# sourceMappingURL=skill-resolver.d.ts.map

package/dist/core/skill-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-resolver.d.ts","sourceRoot":"","sources":["../../src/core/skill-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,aAAa;;IACxB,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,aAAa;CAkC9E"}

package/dist/core/skill-resolver.js

@@ -0,0 +1,32 @@
+export class SkillResolver {
+    resolve(candidates, folderPriority) {
+        if (candidates.length === 0) {
+            throw new Error('SkillResolver.resolve: candidates must not be empty');
+        }
+        if (candidates.length === 1) {
+            return candidates[0];
+        }
+        const priorityIndex = new Map();
+        for (let i = 0; i < folderPriority.length; i++) {
+            const folder = folderPriority[i];
+            if (!priorityIndex.has(folder)) {
+                priorityIndex.set(folder, i);
+            }
+        }
+        let best = candidates[0];
+        let bestRank = this.#rankOf(best.folder, priorityIndex);
+        for (let i = 1; i < candidates.length; i++) {
+            const candidate = candidates[i];
+            const rank = this.#rankOf(candidate.folder, priorityIndex);
+            if (rank < bestRank) {
+                best = candidate;
+                bestRank = rank;
+            }
+        }
+        return best;
+    }
+    #rankOf(folder, priorityIndex) {
+        return priorityIndex.get(folder) ?? Number.MAX_SAFE_INTEGER;
+    }
+}
+//# sourceMappingURL=skill-resolver.js.map

package/dist/core/skill-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-resolver.js","sourceRoot":"","sources":["../../src/core/skill-resolver.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACxB,OAAO,CAAC,UAA2B,EAAE,cAAwB;QAC3D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,UAAU,CAAC,CAAC,CAAE,CAAC;QACxB,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;QAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAE,CAAC;YAClC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,IAAI,IAAI,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QAC1B,IAAI,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAExD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YAC3D,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;gBACpB,IAAI,GAAG,SAAS,CAAC;gBACjB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,MAAc,EAAE,aAA0C;QAChE,OAAO,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,gBAAgB,CAAC;IAC9D,CAAC;CACF"}

package/dist/core/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Shared core types for SkillForge MCP.
+ *
+ * SkillSummary  — lightweight metadata returned by `skills__list`.
+ * SkillMetadata — normalized frontmatter (Adapter target for FrontmatterParser).
+ * SkillContent  — metadata + full SKILL.md body (returned by `skills__get`).
+ * InvocationContext / InvocationResult — IInvocationStrategy.invoke() I/O.
+ */
+export type SkillFormat = 'claude' | 'codex' | 'persona' | 'custom';
+export type StrategyKind = 'prompt' | 'script' | 'hybrid';
+export interface SkillSummary {
+    /** Unique identifier — primary key in SkillRegistry. */
+    name: string;
+    /** One-line description (frontmatter `description`), optional. */
+    description?: string;
+    /** Absolute path to the SKILL.md (or equivalent) file on disk. */
+    sourcePath: string;
+    /** Absolute path to the configured root folder this skill was discovered under. */
+    folder: string;
+    /** Free-form tags from frontmatter `tags`. */
+    tags?: string[];
+    /** Detected frontmatter dialect — drives the Adapter selection in FrontmatterParser. */
+    format: SkillFormat;
+}
+export interface SkillMetadata extends SkillSummary {
+    /** Explicit strategy hint from frontmatter; otherwise inferred by StrategyFactory. */
+    strategy?: StrategyKind;
+    /** Opt-in flag: allow ScriptStrategy to spawn subprocesses for this skill. */
+    allowScripts?: boolean;
+    /** Opt-in flag: allow ScriptStrategy network access in sandbox. */
+    allowNetwork?: boolean;
+    /** Composite skill — names of skills to invoke before/around this one. */
+    skills?: string[];
+    /** Per-skill invocation timeout in ms; falls back to TimeoutDecorator default. */
+    timeoutMs?: number;
+    /** Opt-in: cache InvocationResult per (skillName + input) hash, TTL-based. */
+    cacheable?: boolean;
+    /** Per-skill TTL override (ms). Falls back to global cache config if absent. */
+    cacheTtlMs?: number;
+    /** Frontmatter passthrough for fields SkillForge does not interpret. */
+    extra?: Record<string, unknown>;
+    /** Filenames within sibling scripts/ directory, in interpreter-resolvable form
+     *  (`main.py`, `entry.sh`, `app.mjs`). Current implementation supports single-entry only —
+     *  index 0 is used by ScriptStrategy; multi-entry semantics deferred. */
+    scripts?: string[];
+}
+export interface SkillContent extends SkillMetadata {
+    /** SKILL.md body (everything after the frontmatter block). */
+    body: string;
+    /** Full SKILL.md file content including frontmatter. */
+    raw: string;
+    /** Absolute path to the sibling `scripts/` directory next to SKILL.md,
+     *  populated by ScriptsDirDetector when present. Undefined when no scripts/
+     *  directory exists. */
+    scriptsDir?: string;
+}
+export interface InvocationContext {
+    /** Which MCP tool initiated the invocation. */
+    callerTool: 'invoke';
+    /** User-supplied input forwarded to the skill. */
+    input: string;
+    /** AbortSignal injected by TimeoutDecorator. Strategies that spawn subprocess
+     *  or perform long I/O should propagate this signal to honor cancellation. */
+    signal?: AbortSignal;
+    /** Optional per-call overrides (e.g. timeoutMs). */
+    options?: {
+        timeoutMs?: number;
+    };
+}
+export interface InvocationResult {
+    /** True on success, false on caught error. */
+    ok: boolean;
+    /** Skill output (prompt body for PromptStrategy, stdout for ScriptStrategy). */
+    output: string;
+    /** Populated when `ok` is false. */
+    error?: string;
+    /** Wall-clock duration of the invocation in ms. */
+    durationMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpE,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,wFAAwF;IACxF,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,sFAAsF;IACtF,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mEAAmE;IACnE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;6EAEyE;IACzE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ;;4BAEwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,UAAU,EAAE,QAAQ,CAAC;IACrB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd;kFAC8E;IAC9E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oDAAoD;IACpD,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,EAAE,EAAE,OAAO,CAAC;IACZ,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/core/types.js

@@ -0,0 +1,10 @@
+/**
+ * Shared core types for SkillForge MCP.
+ *
+ * SkillSummary  — lightweight metadata returned by `skills__list`.
+ * SkillMetadata — normalized frontmatter (Adapter target for FrontmatterParser).
+ * SkillContent  — metadata + full SKILL.md body (returned by `skills__get`).
+ * InvocationContext / InvocationResult — IInvocationStrategy.invoke() I/O.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

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

package/dist/decorators/base-decorator.d.ts

@@ -0,0 +1,10 @@
+import type { InvocationStrategy } from '../handlers/invocation-strategy.js';
+import type { InvocationContext, InvocationResult, StrategyKind, SkillContent } from '../core/types.js';
+export declare abstract class BaseDecorator implements InvocationStrategy {
+    protected readonly inner: InvocationStrategy;
+    constructor(inner: InvocationStrategy);
+    get kind(): StrategyKind;
+    canHandle(skill: SkillContent): boolean;
+    abstract invoke(skill: SkillContent, context: InvocationContext): Promise<InvocationResult>;
+}
+//# sourceMappingURL=base-decorator.d.ts.map

package/dist/decorators/base-decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/base-decorator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAExG,8BAAsB,aAAc,YAAW,kBAAkB;IAC/D,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;gBAEjC,KAAK,EAAE,kBAAkB;IAIrC,IAAI,IAAI,IAAI,YAAY,CAEvB;IAED,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAIvC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAC5F"}

package/dist/decorators/base-decorator.js

@@ -0,0 +1,13 @@
+export class BaseDecorator {
+    inner;
+    constructor(inner) {
+        this.inner = inner;
+    }
+    get kind() {
+        return this.inner.kind;
+    }
+    canHandle(skill) {
+        return this.inner.canHandle(skill);
+    }
+}
+//# sourceMappingURL=base-decorator.js.map

package/dist/decorators/base-decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-decorator.js","sourceRoot":"","sources":["../../src/decorators/base-decorator.ts"],"names":[],"mappings":"AAGA,MAAM,OAAgB,aAAa;IACd,KAAK,CAAqB;IAE7C,YAAY,KAAyB;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,SAAS,CAAC,KAAmB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;CAGF"}

package/dist/decorators/cache-decorator.d.ts

@@ -0,0 +1,33 @@
+import { BaseDecorator } from './base-decorator.js';
+import type { InvocationContext, InvocationResult, SkillContent } from '../core/types.js';
+import type { InvocationStrategy } from '../handlers/invocation-strategy.js';
+export interface CacheDecoratorDeps {
+    /** Default TTL in ms applied when skill.metadata.cacheTtlMs absent. */
+    ttlMs: number;
+    /** Max cached entries; oldest evicted (LRU via Map insertion order). */
+    maxEntries: number;
+    /** Injectable clock for deterministic tests. Defaults to Date.now(). */
+    clock?: () => number;
+}
+/**
+ * Decorator that caches successful InvocationResults per (skillName, input) pair.
+ *
+ * Caching is opt-in: enabled only when `skill.cacheable === true` or
+ * `skill.cacheTtlMs > 0`. Disabled skills pass through with zero overhead.
+ *
+ * Only `ok: true` results are cached. Caching failures would pin bad outputs
+ * for the entire TTL window — better to let the inner strategy retry each time.
+ *
+ * LRU eviction uses Map insertion-order: on a cache hit the entry is
+ * deleted and re-inserted so it becomes the most-recently-used position.
+ */
+export declare class CacheDecorator extends BaseDecorator {
+    #private;
+    constructor(inner: InvocationStrategy, deps: CacheDecoratorDeps);
+    invoke(skill: SkillContent, context: InvocationContext): Promise<InvocationResult>;
+    /** Number of entries currently in the cache (including potentially stale). */
+    size(): number;
+    /** Remove all cached entries. */
+    clear(): void;
+}
+//# sourceMappingURL=cache-decorator.d.ts.map

package/dist/decorators/cache-decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/cache-decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAeD;;;;;;;;;;;GAWG;AACH,qBAAa,cAAe,SAAQ,aAAa;;gBAMnC,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB;IAOzD,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgCxF,8EAA8E;IAC9E,IAAI,IAAI,MAAM;IAId,iCAAiC;IACjC,KAAK,IAAI,IAAI;CAwBd"}

package/dist/decorators/cache-decorator.js

@@ -0,0 +1,89 @@
+import { createHash } from 'node:crypto';
+import { BaseDecorator } from './base-decorator.js';
+function hashKey(name, input) {
+    const h = createHash('sha256');
+    h.update(name);
+    h.update('\x00');
+    h.update(input);
+    return h.digest('hex').slice(0, 16);
+}
+/**
+ * Decorator that caches successful InvocationResults per (skillName, input) pair.
+ *
+ * Caching is opt-in: enabled only when `skill.cacheable === true` or
+ * `skill.cacheTtlMs > 0`. Disabled skills pass through with zero overhead.
+ *
+ * Only `ok: true` results are cached. Caching failures would pin bad outputs
+ * for the entire TTL window — better to let the inner strategy retry each time.
+ *
+ * LRU eviction uses Map insertion-order: on a cache hit the entry is
+ * deleted and re-inserted so it becomes the most-recently-used position.
+ */
+export class CacheDecorator extends BaseDecorator {
+    #ttlMs;
+    #maxEntries;
+    #clock;
+    #store = new Map();
+    constructor(inner, deps) {
+        super(inner);
+        this.#ttlMs = deps.ttlMs;
+        this.#maxEntries = deps.maxEntries;
+        this.#clock = deps.clock ?? (() => Date.now());
+    }
+    async invoke(skill, context) {
+        if (!this.#isCacheable(skill)) {
+            return await this.inner.invoke(skill, context);
+        }
+        const key = hashKey(skill.name ?? '<unknown>', context.input);
+        const now = this.#clock();
+        const hit = this.#store.get(key);
+        if (hit !== undefined) {
+            if (hit.expiresAt > now) {
+                // Refresh LRU position: delete + reinsert moves key to newest slot.
+                this.#store.delete(key);
+                this.#store.set(key, hit);
+                return hit.result;
+            }
+            // Expired — evict stale entry before delegating.
+            this.#store.delete(key);
+        }
+        const result = await this.inner.invoke(skill, context);
+        // Only cache successful results to avoid pinning bad outputs across TTL.
+        if (result.ok) {
+            const ttl = this.#resolveTtl(skill);
+            this.#store.set(key, { result, expiresAt: now + ttl });
+            this.#evictIfFull();
+        }
+        return result;
+    }
+    /** Number of entries currently in the cache (including potentially stale). */
+    size() {
+        return this.#store.size;
+    }
+    /** Remove all cached entries. */
+    clear() {
+        this.#store.clear();
+    }
+    #isCacheable(skill) {
+        if (skill.cacheable === true)
+            return true;
+        if (typeof skill.cacheTtlMs === 'number' && skill.cacheTtlMs > 0)
+            return true;
+        return false;
+    }
+    #resolveTtl(skill) {
+        if (typeof skill.cacheTtlMs === 'number' && skill.cacheTtlMs > 0) {
+            return skill.cacheTtlMs;
+        }
+        return this.#ttlMs;
+    }
+    #evictIfFull() {
+        while (this.#store.size > this.#maxEntries) {
+            const oldestKey = this.#store.keys().next().value;
+            if (oldestKey === undefined)
+                break;
+            this.#store.delete(oldestKey);
+        }
+    }
+}
+//# sourceMappingURL=cache-decorator.js.map

package/dist/decorators/cache-decorator.js.map

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

package/dist/decorators/decorator-chain.d.ts

@@ -0,0 +1,16 @@
+import type { Logger } from './logging-decorator.js';
+import type { InvocationStrategy } from '../handlers/invocation-strategy.js';
+export interface DecoratorChainDeps {
+    logger: Logger;
+    defaultTimeoutMs: number;
+    cacheTtlMs: number;
+    cacheMaxEntries: number;
+    clock?: () => number;
+}
+/** Composes Logging → Timeout → Cache → strategy (outermost-in). */
+export declare class DecoratorChain {
+    #private;
+    constructor(deps: DecoratorChainDeps);
+    wrap(strategy: InvocationStrategy): InvocationStrategy;
+}
+//# sourceMappingURL=decorator-chain.d.ts.map

package/dist/decorators/decorator-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-chain.d.ts","sourceRoot":"","sources":["../../src/decorators/decorator-chain.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,oEAAoE;AACpE,qBAAa,cAAc;;gBAOb,IAAI,EAAE,kBAAkB;IAQpC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,GAAG,kBAAkB;CAYvD"}

package/dist/decorators/decorator-chain.js

@@ -0,0 +1,31 @@
+import { LoggingDecorator } from './logging-decorator.js';
+import { TimeoutDecorator } from './timeout-decorator.js';
+import { CacheDecorator } from './cache-decorator.js';
+/** Composes Logging → Timeout → Cache → strategy (outermost-in). */
+export class DecoratorChain {
+    #logger;
+    #defaultTimeoutMs;
+    #cacheTtlMs;
+    #cacheMaxEntries;
+    #clock;
+    constructor(deps) {
+        this.#logger = deps.logger;
+        this.#defaultTimeoutMs = deps.defaultTimeoutMs;
+        this.#cacheTtlMs = deps.cacheTtlMs;
+        this.#cacheMaxEntries = deps.cacheMaxEntries;
+        this.#clock = deps.clock;
+    }
+    wrap(strategy) {
+        const cached = new CacheDecorator(strategy, {
+            ttlMs: this.#cacheTtlMs,
+            maxEntries: this.#cacheMaxEntries,
+            clock: this.#clock,
+        });
+        const timed = new TimeoutDecorator(cached, {
+            defaultMs: this.#defaultTimeoutMs,
+            clock: this.#clock,
+        });
+        return new LoggingDecorator(timed, this.#logger, this.#clock);
+    }
+}
+//# sourceMappingURL=decorator-chain.js.map

package/dist/decorators/decorator-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-chain.js","sourceRoot":"","sources":["../../src/decorators/decorator-chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAYtD,oEAAoE;AACpE,MAAM,OAAO,cAAc;IAChB,OAAO,CAAS;IAChB,iBAAiB,CAAS;IAC1B,WAAW,CAAS;IACpB,gBAAgB,CAAS;IACzB,MAAM,CAAgB;IAE/B,YAAY,IAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC/C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,eAAe,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC,QAA4B;QAC/B,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,QAAQ,EAAE;YAC1C,KAAK,EAAE,IAAI,CAAC,WAAW;YACvB,UAAU,EAAE,IAAI,CAAC,gBAAgB;YACjC,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE;YACzC,SAAS,EAAE,IAAI,CAAC,iBAAiB;YACjC,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,OAAO,IAAI,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,10 @@
+export { BaseDecorator } from './base-decorator.js';
+export { LoggingDecorator, stderrLogger } from './logging-decorator.js';
+export type { Logger } from './logging-decorator.js';
+export { TimeoutDecorator } from './timeout-decorator.js';
+export type { TimeoutDecoratorDeps } from './timeout-decorator.js';
+export { CacheDecorator } from './cache-decorator.js';
+export type { CacheDecoratorDeps } from './cache-decorator.js';
+export { DecoratorChain } from './decorator-chain.js';
+export type { DecoratorChainDeps } from './decorator-chain.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACxE,YAAY,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/decorators/index.js

@@ -0,0 +1,6 @@
+export { BaseDecorator } from './base-decorator.js';
+export { LoggingDecorator, stderrLogger } from './logging-decorator.js';
+export { TimeoutDecorator } from './timeout-decorator.js';
+export { CacheDecorator } from './cache-decorator.js';
+export { DecoratorChain } from './decorator-chain.js';
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/decorators/logging-decorator.d.ts

@@ -0,0 +1,15 @@
+import { BaseDecorator } from './base-decorator.js';
+import type { InvocationStrategy } from '../handlers/invocation-strategy.js';
+import type { InvocationContext, InvocationResult, SkillContent } from '../core/types.js';
+export interface Logger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+export declare const stderrLogger: Logger;
+export declare class LoggingDecorator extends BaseDecorator {
+    #private;
+    constructor(inner: InvocationStrategy, logger?: Logger, clock?: () => number);
+    invoke(skill: SkillContent, context: InvocationContext): Promise<InvocationResult>;
+}
+//# sourceMappingURL=logging-decorator.d.ts.map

package/dist/decorators/logging-decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/logging-decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE1F,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,YAAY,EAAE,MAI1B,CAAC;AAEF,qBAAa,gBAAiB,SAAQ,aAAa;;gBAIrC,KAAK,EAAE,kBAAkB,EAAE,MAAM,GAAE,MAAqB,EAAE,KAAK,GAAE,MAAM,MAAgC;IAM7G,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAiBzF"}

package/dist/decorators/logging-decorator.js

@@ -0,0 +1,34 @@
+import { BaseDecorator } from './base-decorator.js';
+export const stderrLogger = {
+    info: (m) => process.stderr.write(m + '\n'),
+    warn: (m) => process.stderr.write(m + '\n'),
+    error: (m) => process.stderr.write(m + '\n'),
+};
+export class LoggingDecorator extends BaseDecorator {
+    #logger;
+    #clock;
+    constructor(inner, logger = stderrLogger, clock = () => performance.now()) {
+        super(inner);
+        this.#logger = logger;
+        this.#clock = clock;
+    }
+    async invoke(skill, context) {
+        const name = skill.name ?? '<unknown>';
+        const kind = this.inner.kind;
+        this.#logger.info(`[skillforge] invoke skill=${name} kind=${kind}`);
+        const start = this.#clock();
+        try {
+            const result = await this.inner.invoke(skill, context);
+            const ms = Math.round(this.#clock() - start);
+            this.#logger.info(`[skillforge] result skill=${name} ok=${result.ok} ms=${ms}`);
+            return result;
+        }
+        catch (err) {
+            const ms = Math.round(this.#clock() - start);
+            const errMsg = err instanceof Error ? err.message : String(err);
+            this.#logger.error(`[skillforge] error skill=${name} ms=${ms} reason=${errMsg}`);
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=logging-decorator.js.map

package/dist/decorators/logging-decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-decorator.js","sourceRoot":"","sources":["../../src/decorators/logging-decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUpD,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACxC,OAAO,CAAS;IAChB,MAAM,CAAe;IAE9B,YAAY,KAAyB,EAAE,SAAiB,YAAY,EAAE,QAAsB,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACjH,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAmB,EAAE,OAA0B;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,WAAW,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,IAAI,SAAS,IAAI,EAAE,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,6BAA6B,IAAI,OAAO,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YAChF,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,4BAA4B,IAAI,OAAO,EAAE,WAAW,MAAM,EAAE,CAAC,CAAC;YACjF,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/decorators/timeout-decorator.d.ts

@@ -0,0 +1,19 @@
+import { BaseDecorator } from './base-decorator.js';
+import type { InvocationStrategy } from '../handlers/invocation-strategy.js';
+import type { InvocationContext, InvocationResult, SkillContent } from '../core/types.js';
+export interface TimeoutDecoratorDeps {
+    /** Default timeout ms applied when skill.metadata.timeoutMs absent. */
+    defaultMs: number;
+    /** Injectable setTimeout for deterministic tests. */
+    setTimeoutFn?: typeof setTimeout;
+    /** Injectable clearTimeout for deterministic tests. */
+    clearTimeoutFn?: typeof clearTimeout;
+    /** Injectable clock for durationMs measurement. */
+    clock?: () => number;
+}
+export declare class TimeoutDecorator extends BaseDecorator {
+    #private;
+    constructor(inner: InvocationStrategy, deps: TimeoutDecoratorDeps);
+    invoke(skill: SkillContent, context: InvocationContext): Promise<InvocationResult>;
+}
+//# sourceMappingURL=timeout-decorator.d.ts.map

package/dist/decorators/timeout-decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/timeout-decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE1F,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,YAAY,CAAC,EAAE,OAAO,UAAU,CAAC;IACjC,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,YAAY,CAAC;IACrC,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,qBAAa,gBAAiB,SAAQ,aAAa;;gBAMrC,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,oBAAoB;IAQ3D,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA+CzF"}