@rubytech/create-siteoffice-code 0.1.256

package/payload/platform/plugins/admin/skills/update-knowledge/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: update-knowledge
+description: "Refresh a public agent's KNOWLEDGE.md from the current graph, scoped to that agent's knowledge configuration. Use when asked to update, refresh, or regenerate a public agent's knowledge."
+---
+
+# Update Knowledge
+
+Refresh a public agent's KNOWLEDGE.md from the current graph, scoped to that agent's knowledge configuration.
+
+## When to Use
+
+The admin asks to update, refresh, or regenerate a public agent's knowledge. Examples: "update the knowledge for the sales agent", "refresh the advisor's KNOWLEDGE.md", "rebuild knowledge for all public agents".
+
+## Knowledge Scope
+
+Each public agent's knowledge comes from two complementary sources, both configured in the agent's `config.json`:
+
+**Direct tags** — graph nodes with the agent's slug in their `agents` array.
+
+**Keyword subscriptions** — the agent's `knowledgeKeywords` array. Nodes matching these keywords are included regardless of whether they are directly tagged.
+
+The union of both result sets (deduplicated) forms the agent's knowledge scope.
+
+## Admin vs Runtime Search
+
+This skill runs at admin time, not at runtime. All `memory-search` queries must use admin permissions — do NOT pass `agentSlug` as a parameter. The `agentSlug` parameter applies runtime enforcement logic (restricts graph traversal to tagged nodes only), which is appropriate for the public agent's MCP server but not for admin-time knowledge discovery.
+
+To find directly-tagged nodes: search with the agent's role or topic as the query term (no `agentSlug`), then identify results where the `agents` property contains the target slug.
+
+To find keyword matches: search with each keyword as the query term (no `agentSlug`). Keyword subscriptions exist to capture content beyond the directly-tagged set.
+
+## Constraints
+
+- If the agent has neither direct tags nor keyword subscriptions configured, there is nothing to refresh. Inform the admin: "This agent has no knowledge scope configured. Tag nodes for the agent or add keyword subscriptions in config.json first."
+- If all queries return empty results, do NOT write an empty KNOWLEDGE.md. Warn the admin: "No matching content found for this agent's knowledge scope. KNOWLEDGE.md was not modified." Preserve any existing KNOWLEDGE.md.
+- After writing KNOWLEDGE.md, check the context budget. If the total system prompt (IDENTITY.md + SOUL.md + plugins + KNOWLEDGE.md) exceeds 50% of the model's context window, auto-generate KNOWLEDGE-SUMMARY.md and present it via `document-editor` with `filePath: "agents/{slug}/KNOWLEDGE-SUMMARY.md"` for review.
+- Present the generated KNOWLEDGE.md via `document-editor` with `filePath: "agents/{slug}/KNOWLEDGE.md"` for admin review before finalising.
+- Log the refresh: write a note at the top of KNOWLEDGE.md with the refresh timestamp.
+
+## Querying
+
+Run `memory-search` multiple times with targeted queries to build comprehensive coverage. Do not pass `agentSlug` on any query — all searches use admin permissions.
+
+1. Search with the agent's role or topic as the query term. In the results, identify nodes whose `agents` property contains the target agent's slug — these are the directly-tagged nodes.
+2. For each keyword in the agent's `knowledgeKeywords`, search with that keyword as the query term. These capture content by topic regardless of tagging.
+3. Merge all results, deduplicate by node content, and organise under clear markdown headings by topic.
+
+Categories to cover (where relevant to the agent's role): services, pricing, FAQs, team, policies, products, location/hours, contact info. Skip categories where no matching content exists.
+
+## Bulk Refresh
+
+When asked to refresh all agents, iterate over each public agent directory under `agents/`, read its `config.json`, and run the refresh for each. Present a summary of results.

package/payload/platform/plugins/admin/skills/upgrade/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: upgrade
+description: "Upgrade Maxy to the latest published version by re-running the brand's installer when the operator asks."
+---
+
+# Upgrade
+
+The operator wants to upgrade Maxy. Re-run the installer for the active brand; it is idempotent, brings the install to the latest published version, and restarts the brand service when it finishes.
+
+## Resolve the brand package
+
+The package to install is `npm.packageName` in `$PLATFORM_ROOT/config/brand.json`. Read that field with `Read`. Never hard-code a default — operators install branded variants and the field is the source of truth.
+
+## Run the upgrade
+
+```
+npx -y <npm.packageName>@latest
+```
+
+Stream the installer's stdout to the operator as it runs. The installer prints its own progress; pass it through, do not narrate around it.
+
+The brand service restarts as the installer's last step, which terminates this Bash invocation before the installer's final line prints. That is the expected contract, not a failure. Tell the operator the connection will drop and to reconnect.
+
+## Confirm on the next session
+
+The next session's reconnaissance reads `$PLATFORM_ROOT/config/.${hostname}-version` (with `hostname` from `brand.json`) and finds the new value. Lead the next session with one short sentence: "Upgraded to vX.Y.Z." If that file is unchanged after a fresh reconnaissance, the installer failed; show the last stdout lines captured before the restart and stop.
+
+## Surface failures verbatim
+
+- npx fetch from `registry.npmjs.org` fails (network, DNS, registry outage): show the error to the operator.
+- Installer exits non-zero before the restart: show the tail of stdout and stop.
+- `Permission denied` on `npx`: Bash scope is misconfigured for this install; tell the operator.
+
+Never claim success on a failed run.

package/payload/platform/plugins/aeo/.claude-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "aeo",
+  "description": "Answer Engine Optimisation. Emits schema.org JSON-LD for typed graph entities, generates llms.txt + llms-full.txt for the site, and audits pages against eight AEO heuristics with one rewrite suggestion per fail. Writes :AEOAudit history nodes when audits are persisted.",
+  "version": "0.1.0",
+  "author": {
+    "name": "Rubytech LLC"
+  },
+  "mcpServers": {
+    "aeo": {
+      "type": "stdio",
+      "command": "node",
+      "args": [
+        "${CLAUDE_PLUGIN_ROOT}/mcp/dist/index.js"
+      ]
+    }
+  }
+}

package/payload/platform/plugins/aeo/PLUGIN.md

@@ -0,0 +1,80 @@
+---
+name: aeo
+description: "Answer Engine Optimisation. Emits schema.org JSON-LD for typed graph entities, generates llms.txt + llms-full.txt for the site, and audits pages against eight AEO heuristics with one rewrite suggestion per fail. Writes :AEOAudit history nodes when audits are persisted."
+tools:
+  - name: aeo-emit-jsonld
+    publicAllowlist: false
+    adminAllowlist: true
+  - name: aeo-write-llms-txt
+    publicAllowlist: false
+    adminAllowlist: true
+  - name: aeo-audit-page
+    publicAllowlist: false
+    adminAllowlist: true
+skills:
+  - skills/structured-answer/SKILL.md
+always: false
+embed: false
+metadata: {"platform":{}}
+mcp:
+  command: node
+  args:
+    - ${PLATFORM_ROOT}/lib/mcp-spawn-tee/dist/index.js
+    - ${PLATFORM_ROOT}/plugins/aeo/mcp/dist/index.js
+  env:
+    MCP_SPAWN_TEE_NAME: aeo
+    LOG_DIR: ${LOG_DIR}
+    PLATFORM_ROOT: ${PLATFORM_ROOT}
+    ACCOUNT_ID: ${ACCOUNT_ID}
+    SESSION_ID: ${SESSION_ID}
+    AGENT_SLUG: ${AGENT_SLUG}
+mcp-manifest: auto
+---
+
+# AEO (Answer Engine Optimisation)
+
+This plugin makes the platform's content legible to answer engines — Claude, ChatGPT, Perplexity, Google AI Overviews, Bing Copilot. Classical SEO ranks links; AEO shapes the page so the answer-engine extractor lifts the right answer.
+
+## The three surfaces
+
+1. **JSON-LD** (`aeo-emit-jsonld`). Every typed graph entity that backs a page can be projected to a `<script type="application/ld+json">` block. The mapper covers `Organization`, `LocalBusiness`, `Person`, `Service`, `Product`, `Article`, `FAQPage`, `RealEstateListing`, `Event`. Other labels fall through to `schema:Thing` and are flagged as a doc gap.
+
+2. **llms.txt** (`aeo-write-llms-txt`). The site emits `/llms.txt` (index of pages, one link per line) and `/llms-full.txt` (concatenated full text). Format follows the current draft at `https://llmstxt.org/`. Source is `KnowledgeDocument` nodes with a `url` property. Pages without a `url` are skipped and counted in the response. Called with `siteDir` (an absolute path to an existing site root), the tool writes both files to disk and the response carries `writtenPaths`; called without it, the tool returns the file bodies inline for on-demand callers. The publish-site skill calls this with `siteDir` set to the freshly-published `<accountDir>/sites/<slug>/` on every publish, so the pair stays fresh as `KnowledgeDocument` nodes change.
+
+3. **Audit** (`aeo-audit-page`). Run the eight-heuristic scorecard against a URL or raw HTML. Each heuristic returns pass / warn / fail with one rewrite suggestion per fail. Score is `100 * (passes + 0.5 * warns) / 8`. Pass `persist: true` with a `targetKnowledgeDocumentId` to record an `:AEOAudit` node linked back to the document.
+
+## The eight heuristics
+
+| Heuristic | Pass | Warn | Fail |
+|---|---|---|---|
+| `h1-present` | one `<h1>` | more than one | none |
+| `jsonld-present` | one or more JSON-LD blocks, all parse | some parse | none, or all unparseable |
+| `structured-answer` | first `<p>` after `<h1>` is ≤280 chars | first `<p>` is over 280 chars | no `<p>` after `<h1>` |
+| `faq-section` | `FAQPage` JSON-LD on page | FAQ text but no JSON-LD | nothing FAQ-like |
+| `meta-description` | 80–160 chars | present but outside range | absent |
+| `canonical-url` | `<link rel="canonical">` present | — | absent |
+| `og-tags` | `og:title` and `og:description` both set | — | one or both missing |
+| `heading-hierarchy` | no level skips | — | h1→h3 or similar jump |
+
+`structured-answer` is the highest-impact: answer engines lift the structured-answer span verbatim. A page can fail every other heuristic and still get cited if the first paragraph cleanly answers the question.
+
+## Persistence model
+
+The plugin only writes `:AEOAudit` nodes (when `persist: true`). It does not own the entities it reads — `KnowledgeDocument`, `Organization`, `Person`, etc. belong to the memory plugin. Edges written:
+
+- `(:KnowledgeDocument)-[:HAS_AEO_AUDIT]->(:AEOAudit)`
+
+The audit nodes carry `accountId`, `target` (URL or `(inline html)`), `score`, `heuristicsJson` (full result), `runAt`, `createdByAgent`, `createdBySession`. They form an append-only audit history; aggregate trend queries (score-over-time) walk this set.
+
+## What this plugin does not do
+
+- No LLM API calls. No citation monitor — out of scope. Multi-engine answer harvesting doesn't fit maxy-code's no-API-key architecture, and the monitor was archived without sprinting (Task 363). The audit plus the structured-answer template are the surface; check citation manually when needed.
+- No automatic emission. `aeo-emit-jsonld` returns a script block; wiring it into the platform's page render path is per-renderer work, also filed as a follow-up.
+- No prose authoring. AEO audits structure; it does not rewrite content. Writer-craft owns voice.
+
+## See also
+
+- User guide: `platform/plugins/docs/references/aeo.md`
+- Structured-answer template: `platform/plugins/aeo/skills/structured-answer/SKILL.md`
+- Schema declaration: `platform/neo4j/schema.cypher` (search `AEOAudit`)
+- Schema reference: `platform/plugins/memory/schema-base.md` (search `AEOAudit`)

package/payload/platform/plugins/aeo/mcp/dist/__tests__/audit-heuristics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audit-heuristics.test.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/__tests__/audit-heuristics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-heuristics.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/audit-heuristics.test.ts"],"names":[],"mappings":""}

package/payload/platform/plugins/aeo/mcp/dist/__tests__/audit-heuristics.test.js

@@ -0,0 +1,121 @@
+import { describe, it, expect } from "vitest";
+import { auditHtml } from "../lib/audit-heuristics.js";
+function pick(result, name) {
+    const r = result.heuristics.find((h) => h.name === name);
+    if (!r)
+        throw new Error(`heuristic ${name} not found`);
+    return r;
+}
+const GOOD_PAGE = `<!doctype html>
+<html><head>
+  <title>How much does a boiler service cost? — Acme</title>
+  <meta name="description" content="A standard boiler service in Brighton costs £85 to £120, takes about one hour, and includes a written safety report.">
+  <link rel="canonical" href="https://acme.test/boiler-service-cost">
+  <meta property="og:title" content="How much does a boiler service cost?">
+  <meta property="og:description" content="A standard boiler service in Brighton costs £85 to £120, takes about one hour, and includes a written safety report.">
+  <script type="application/ld+json">{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Cost?","acceptedAnswer":{"@type":"Answer","text":"£85–£120."}}]}</script>
+</head><body>
+  <h1>How much does a boiler service cost?</h1>
+  <p>A standard boiler service in Brighton costs £85 to £120 and takes about one hour.</p>
+  <h2>What's included</h2>
+  <p>Safety checks, flue gas analysis, pressure adjustment, written report.</p>
+  <h2>Frequently asked questions</h2>
+  <p>Common questions are answered above.</p>
+</body></html>`;
+const BAD_PAGE = `<!doctype html>
+<html><head><title>Acme</title></head>
+<body>
+  <div>Some words.</div>
+</body></html>`;
+describe("auditHtml — golden good page", () => {
+    const result = auditHtml(GOOD_PAGE);
+    it("scores 100", () => {
+        expect(result.score).toBe(100);
+    });
+    it("passes every heuristic", () => {
+        for (const h of result.heuristics) {
+            expect(h.status, `${h.name}: ${h.detail}`).toBe("pass");
+        }
+    });
+});
+describe("auditHtml — bad page exercises every fail path", () => {
+    const result = auditHtml(BAD_PAGE);
+    it("scores 0 or near-zero", () => {
+        expect(result.score).toBeLessThanOrEqual(10);
+    });
+    it("fails h1-present", () => {
+        expect(pick(result, "h1-present").status).toBe("fail");
+    });
+    it("fails jsonld-present", () => {
+        expect(pick(result, "jsonld-present").status).toBe("fail");
+    });
+    it("fails meta-description", () => {
+        expect(pick(result, "meta-description").status).toBe("fail");
+    });
+    it("fails canonical-url", () => {
+        expect(pick(result, "canonical-url").status).toBe("fail");
+    });
+    it("fails og-tags with both missing", () => {
+        const r = pick(result, "og-tags");
+        expect(r.status).toBe("fail");
+        expect(r.detail).toContain("og:title");
+        expect(r.detail).toContain("og:description");
+    });
+    it("emits a rewrite suggestion for every failure", () => {
+        for (const h of result.heuristics) {
+            if (h.status === "fail") {
+                expect(h.suggestion, `${h.name} missing suggestion`).toBeTruthy();
+            }
+        }
+    });
+});
+describe("auditHtml — warn paths", () => {
+    it("warns when first <p> after <h1> exceeds 280 chars", () => {
+        const long = "X".repeat(300);
+        const html = `<html><head>
+      <title>t</title>
+      <meta name="description" content="${"d".repeat(120)}">
+      <link rel="canonical" href="https://a.test">
+      <meta property="og:title" content="t">
+      <meta property="og:description" content="t">
+      <script type="application/ld+json">{"@type":"FAQPage"}</script>
+    </head><body>
+      <h1>Topic</h1><p>${long}</p>
+      <h2>More</h2><p>x</p>
+    </body></html>`;
+        const result = auditHtml(html);
+        expect(pick(result, "structured-answer").status).toBe("warn");
+    });
+    it("warns when meta-description length is outside 80–160", () => {
+        const html = `<html><head>
+      <title>t</title>
+      <meta name="description" content="too short">
+      <link rel="canonical" href="https://a.test">
+      <meta property="og:title" content="t">
+      <meta property="og:description" content="t">
+      <script type="application/ld+json">{"@type":"FAQPage"}</script>
+    </head><body>
+      <h1>Topic</h1><p>short answer</p>
+    </body></html>`;
+        expect(pick(auditHtml(html), "meta-description").status).toBe("warn");
+    });
+    it("warns when there are multiple <h1> elements", () => {
+        const html = `<html><body><h1>A</h1><h1>B</h1><p>x</p></body></html>`;
+        expect(pick(auditHtml(html), "h1-present").status).toBe("warn");
+    });
+    it("fails heading-hierarchy on h1→h3 skip", () => {
+        const html = `<html><body><h1>A</h1><p>x</p><h3>Skipped</h3></body></html>`;
+        const r = pick(auditHtml(html), "heading-hierarchy");
+        expect(r.status).toBe("fail");
+        expect(r.detail).toContain("h1");
+        expect(r.detail).toContain("h3");
+    });
+    it("warns on unparseable JSON-LD when other blocks parse", () => {
+        const html = `<html><head>
+      <script type="application/ld+json">{"@type":"FAQPage"}</script>
+      <script type="application/ld+json">not json</script>
+    </head><body><h1>T</h1><p>a</p></body></html>`;
+        expect(pick(auditHtml(html), "jsonld-present").status).toBe("warn");
+    });
+});
+//# sourceMappingURL=audit-heuristics.test.js.map

package/payload/platform/plugins/aeo/mcp/dist/__tests__/audit-heuristics.test.js.map

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

package/payload/platform/plugins/aeo/mcp/dist/__tests__/schema-mapping.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-mapping.test.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/__tests__/schema-mapping.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-mapping.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schema-mapping.test.ts"],"names":[],"mappings":""}

package/payload/platform/plugins/aeo/mcp/dist/__tests__/schema-mapping.test.js

@@ -0,0 +1,129 @@
+import { describe, it, expect } from "vitest";
+import { buildJsonLd, renderJsonLdScript, resolveSchemaType, MissingPropertyError, } from "../lib/schema-mapping.js";
+describe("resolveSchemaType", () => {
+    it("maps known graph labels to schema.org types", () => {
+        expect(resolveSchemaType("LocalBusiness")).toBe("LocalBusiness");
+        expect(resolveSchemaType("Organization")).toBe("Organization");
+        expect(resolveSchemaType("Person")).toBe("Person");
+        expect(resolveSchemaType("Service")).toBe("Service");
+        expect(resolveSchemaType("Product")).toBe("Product");
+        expect(resolveSchemaType("CreativeWork")).toBe("Article");
+        expect(resolveSchemaType("Article")).toBe("Article");
+        expect(resolveSchemaType("FAQPage")).toBe("FAQPage");
+        expect(resolveSchemaType("Listing")).toBe("RealEstateListing");
+        expect(resolveSchemaType("RealEstateListing")).toBe("RealEstateListing");
+        expect(resolveSchemaType("Event")).toBe("Event");
+    });
+    it("falls back to Thing for unknown labels", () => {
+        expect(resolveSchemaType("UnknownLabel")).toBe("Thing");
+    });
+});
+describe("buildJsonLd", () => {
+    it("renders an Organization with required name", () => {
+        const obj = buildJsonLd({
+            label: "Organization",
+            properties: { name: "Acme", website: "https://acme.test" },
+        });
+        expect(obj["@context"]).toBe("https://schema.org");
+        expect(obj["@type"]).toBe("Organization");
+        expect(obj.name).toBe("Acme");
+        expect(obj.url).toBe("https://acme.test");
+    });
+    it("renders a LocalBusiness with nested PostalAddress", () => {
+        const obj = buildJsonLd({
+            label: "LocalBusiness",
+            elementId: "4:abc:1",
+            properties: {
+                name: "Acme Plumbing",
+                streetAddress: "1 High St",
+                addressLocality: "Brighton",
+                postalCode: "BN1 1AA",
+            },
+        });
+        expect(obj["@id"]).toBe("4:abc:1");
+        expect(obj.address).toEqual({
+            "@type": "PostalAddress",
+            streetAddress: "1 High St",
+            addressLocality: "Brighton",
+            postalCode: "BN1 1AA",
+        });
+    });
+    it("renders a Person and synthesises name from givenName + familyName", () => {
+        const obj = buildJsonLd({
+            label: "Person",
+            properties: {
+                givenName: "Joel",
+                familyName: "Smalley",
+                email: "j@example.com",
+            },
+        });
+        expect(obj["@type"]).toBe("Person");
+        expect(obj.name).toBe("Joel Smalley");
+        expect(obj.email).toBe("j@example.com");
+    });
+    it("renders a Service with an Offer when price is set", () => {
+        const obj = buildJsonLd({
+            label: "Service",
+            properties: { name: "Boiler service", price: 120, priceCurrency: "GBP" },
+        });
+        expect(obj.offers).toEqual({
+            "@type": "Offer",
+            price: 120,
+            priceCurrency: "GBP",
+        });
+    });
+    it("renders an Article remapping title→headline and abstract→description", () => {
+        const obj = buildJsonLd({
+            label: "Article",
+            properties: { title: "How boilers work", abstract: "Short summary" },
+        });
+        expect(obj.headline).toBe("How boilers work");
+        expect(obj.description).toBe("Short summary");
+    });
+    it("renders an FAQPage with mainEntity Question/Answer pairs", () => {
+        const obj = buildJsonLd({
+            label: "FAQPage",
+            properties: {
+                name: "Boiler FAQ",
+                questions: [
+                    { name: "How long does it take?", acceptedAnswer: "About an hour." },
+                    { name: "Do you charge call-out?", acceptedAnswer: "No." },
+                ],
+            },
+        });
+        expect(Array.isArray(obj.mainEntity)).toBe(true);
+        const main = obj.mainEntity;
+        expect(main).toHaveLength(2);
+    });
+    it("renders an Event with required name + startDate", () => {
+        const obj = buildJsonLd({
+            label: "Event",
+            properties: { name: "Open day", startDate: "2026-06-01T10:00:00Z" },
+        });
+        expect(obj.startDate).toBe("2026-06-01T10:00:00Z");
+    });
+    it("throws MissingPropertyError when required property is absent", () => {
+        expect(() => buildJsonLd({ label: "Event", properties: { name: "Open day" } })).toThrow(MissingPropertyError);
+    });
+    it("renders unknown labels as schema:Thing without throwing", () => {
+        const obj = buildJsonLd({
+            label: "Mystery",
+            properties: { name: "Anonymous", description: "Unknown" },
+        });
+        expect(obj["@type"]).toBe("Thing");
+        expect(obj.name).toBe("Anonymous");
+    });
+});
+describe("renderJsonLdScript", () => {
+    it("wraps the JSON in a script block", () => {
+        const obj = buildJsonLd({
+            label: "Organization",
+            properties: { name: "Acme" },
+        });
+        const block = renderJsonLdScript(obj);
+        expect(block).toMatch(/^<script type="application\/ld\+json">/);
+        expect(block).toMatch(/<\/script>$/);
+        expect(block).toContain('"Acme"');
+    });
+});
+//# sourceMappingURL=schema-mapping.test.js.map

package/payload/platform/plugins/aeo/mcp/dist/__tests__/schema-mapping.test.js.map

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

package/payload/platform/plugins/aeo/mcp/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/payload/platform/plugins/aeo/mcp/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}