@dot-agent/compiler 0.1.0

package/README.md

@@ -0,0 +1,91 @@
+# @dot-agent/compiler
+
+AST parser, linter, graph extractor, and `.agent` packager for the dot-agent DSL.
+
+This is **Level 1** of the dot-agent tooling hierarchy (see [`architecture_map.md`](../../architecture_map.md)): it sits between the raw WASM grammars and the higher-level SDK and LSP. Both the CLI and the language server import from this package to guarantee identical diagnostics everywhere.
+
+---
+
+## Install
+
+```bash
+npm install @dot-agent/compiler
+```
+
+---
+
+## Quick start
+
+```ts
+import { lintDescription, lintBehavior, pack } from '@dot-agent/compiler'
+
+// Lint a .description source
+const descMsgs = await lintDescription(source, 'agent.description')
+
+// Lint a .behavior source
+const behMsgs = await lintBehavior(source, 'agent.behavior')
+
+// Package a directory into a .agent ZIP
+const result = await pack({ dir: './my-agent', version: 'v1.0.0' })
+console.log(result.id)     // e.g. "health.example.com/Doctor:v1.0.0~a1b2c3d4"
+console.log(result.path)   // path to the written .agent file
+```
+
+Diagnostic messages follow the `LintMessage` shape:
+
+```ts
+{
+  file: string      // source file label
+  line: number      // 1-based line
+  col: number       // 1-based column
+  severity: 'error' | 'warning'
+  code: string      // e.g. 'E004', 'W002'
+  message: string   // human-readable description
+}
+```
+
+See [`docs/reference/lint-codes.md`](docs/reference/lint-codes.md) for the full code table.
+
+---
+
+## Public API
+
+| Export | Description |
+|--------|-------------|
+| `initParsers()` | Initialise the WASM tree-sitter parsers (called automatically on first `parse`) |
+| `parse(langId, text, prev?)` | Parse `.description` or `.behavior` source into a tree-sitter `Tree` |
+| `parseSync(langId, text, prev?)` | Synchronous parse — returns `null` if parsers are not yet initialised |
+| `nodesOfType(tree, type)` | Collect all descendant nodes of a given type |
+| `nodeAtOffset(tree, offset)` | Locate the deepest node at a byte offset |
+| `nodeToRange(node)` | Convert a node to an LSP-style `{start, end}` range |
+| `positionToOffset(text, line, char)` | Convert `(line, character)` to a byte offset |
+| `getContextNode(tree, offset)` | Return the best non-error context node at an offset |
+| `lintDescription(text, file?)` | Lint a `.description` source; returns `LintMessage[]` |
+| `lintBehavior(text, file?, docPath?)` | Lint a `.behavior` source; returns `LintMessage[]` |
+| `extractBehaviorGraph(tree)` | Extract states, transitions and entry points from a behavior tree |
+| `parseAboutme(json)` | Deserialise an `aboutme.json` object into `AboutMe` |
+| `buildAboutme(opts)` | Construct an `AboutMe` from build-time options |
+| `aboutmeToJson(aboutme)` | Serialise `AboutMe` back to a plain JSON object |
+| `parseId(id)` | Parse `namespace/name:version~digest` into `IdParts` |
+| `buildId(parts)` | Construct an agent ID string from `IdParts` |
+| `collectFiles(dir)` | Collect agent source files from a directory |
+| `pack(options)` | Full lint → hash → zip pipeline; produces a `.agent` file |
+| `readZip(path)` | Open a `.agent` ZIP from disk |
+| `writeZip(zip, path)` | Write a JSZip instance to disk |
+| `extractFiles(zip, prefixes?)` | Extract file contents from a ZIP as a `Map<string, string>` |
+| `validateZipBomb(zip)` | Guard against decompression bombs |
+
+Full type definitions are in `dist/index.d.ts` after building.
+
+---
+
+## Development
+
+```bash
+npm install
+npm test          # run 91 unit tests with vitest
+npm run build     # compile to dist/ with tsup
+npm run typecheck # tsc --noEmit
+```
+
+Tests live in `tests/`. Each module has a dedicated test file. WASM parsers require `pool: 'forks'` (configured in `vitest.config.ts`) to initialise correctly across test files.

package/dist/chunk-IT25ILTQ.js

@@ -0,0 +1,180 @@
+// src/manifest.ts
+function parseAboutme(json) {
+  if (!json.schemaVersion) throw new Error("Missing schemaVersion in aboutme.json");
+  if (!json.id) throw new Error("Missing id in aboutme.json");
+  if (!json.name) throw new Error("Missing name in aboutme.json");
+  if (!json.description) throw new Error("Missing description in aboutme.json");
+  if (!json.version) throw new Error("Missing version in aboutme.json");
+  if (!json.domain) throw new Error("Missing domain in aboutme.json");
+  if (!json.persona) throw new Error("Missing persona in aboutme.json");
+  if (!json.compiler) throw new Error("Missing compiler in aboutme.json");
+  if (!Array.isArray(json.capabilities)) throw new Error("Missing capabilities array in aboutme.json");
+  if (!Array.isArray(json.requires)) throw new Error("Missing requires array in aboutme.json");
+  if (!json.integrity) throw new Error("Missing integrity in aboutme.json");
+  return {
+    schemaVersion: json.schemaVersion,
+    id: json.id,
+    name: json.name,
+    description: json.description,
+    version: json.version,
+    domain: json.domain,
+    license: json.license ?? "",
+    persona: json.persona,
+    purpose: json.purpose ?? "unknown",
+    compiler: json.compiler,
+    commit: json.commit,
+    capabilities: json.capabilities,
+    requires: json.requires,
+    integrity: json.integrity
+  };
+}
+function buildAboutme(opts) {
+  return {
+    schemaVersion: "dot-agent/1.0",
+    id: opts.id,
+    name: opts.name,
+    description: opts.description,
+    version: opts.version,
+    domain: opts.domain,
+    license: opts.license ?? "",
+    persona: opts.persona,
+    purpose: opts.purpose ?? "unknown",
+    compiler: opts.compiler,
+    commit: opts.commit,
+    capabilities: opts.capabilities ?? [],
+    requires: opts.requires ?? [],
+    integrity: opts.integrity
+  };
+}
+function aboutmeToJson(aboutme) {
+  return JSON.stringify(aboutme, null, 2);
+}
+
+// src/id.ts
+var KNOWN_PLATFORMS = ["github.com", "gitlab.com", "codeberg.org", "sr.ht"];
+function parseNamespaceName(identifier) {
+  const atIdx = identifier.indexOf("@");
+  if (atIdx !== -1 && (identifier.indexOf("/") === -1 || atIdx < identifier.indexOf("/"))) {
+    const slashIdx = identifier.indexOf("/");
+    if (slashIdx === -1) {
+      throw new Error(`Invalid agent ID: email namespace requires a name after '/' (got '${identifier}')`);
+    }
+    return {
+      namespace: identifier.slice(0, slashIdx),
+      name: identifier.slice(slashIdx + 1)
+    };
+  }
+  for (const platform of KNOWN_PLATFORMS) {
+    if (identifier.startsWith(platform + "/")) {
+      const afterPlatform = identifier.slice(platform.length + 1);
+      const slashIdx = afterPlatform.indexOf("/");
+      if (slashIdx === -1) {
+        throw new Error(
+          `Invalid agent ID: '${platform}' namespace requires a user segment and a name (got '${identifier}')`
+        );
+      }
+      return {
+        namespace: platform + "/" + afterPlatform.slice(0, slashIdx),
+        name: afterPlatform.slice(slashIdx + 1)
+      };
+    }
+  }
+  const lastSlash = identifier.lastIndexOf("/");
+  if (lastSlash === -1) {
+    throw new Error(`Invalid agent ID: missing '/' separator in '${identifier}'`);
+  }
+  return {
+    namespace: identifier.slice(0, lastSlash),
+    name: identifier.slice(lastSlash + 1)
+  };
+}
+function parseId(id) {
+  if (!id) throw new Error("Invalid agent ID: empty string");
+  const colonIdx = id.indexOf(":");
+  let identifier;
+  let version;
+  let digest;
+  if (colonIdx === -1) {
+    identifier = id;
+  } else {
+    identifier = id.slice(0, colonIdx);
+    const rest = id.slice(colonIdx + 1);
+    if (!rest) throw new Error(`Invalid agent ID: empty version after ':' in '${id}'`);
+    const tildeIdx = rest.indexOf("~");
+    if (tildeIdx === -1) {
+      version = rest;
+    } else {
+      version = rest.slice(0, tildeIdx);
+      digest = rest.slice(tildeIdx + 1);
+      if (!version) throw new Error(`Invalid agent ID: empty version before '~' in '${id}'`);
+      if (!digest) throw new Error(`Invalid agent ID: empty digest after '~' in '${id}'`);
+    }
+  }
+  const { namespace, name } = parseNamespaceName(identifier);
+  if (!namespace) throw new Error(`Invalid agent ID: empty namespace in '${id}'`);
+  if (!name) throw new Error(`Invalid agent ID: empty name in '${id}'`);
+  return { namespace, name, version, digest };
+}
+function buildId(parts) {
+  const { namespace, name, version, digest } = parts;
+  if (!namespace || !name) {
+    throw new Error("Missing required ID parts: namespace and name");
+  }
+  if (digest && !version) {
+    throw new Error("Invalid ID parts: digest requires version");
+  }
+  let result = `${namespace}/${name}`;
+  if (version) {
+    result += `:${version}`;
+    if (digest) result += `~${digest}`;
+  }
+  return result;
+}
+function extractDigest(id) {
+  try {
+    return parseId(id).digest ?? "";
+  } catch {
+    return "";
+  }
+}
+function extractName(id) {
+  try {
+    return parseId(id).name;
+  } catch {
+    return "";
+  }
+}
+
+// src/zip-core.ts
+import JSZip from "jszip";
+function createZip() {
+  return new JSZip();
+}
+async function extractFiles(zip, filter) {
+  const files = /* @__PURE__ */ new Map();
+  const promises = [];
+  zip.forEach((relativePath, file) => {
+    if (file.dir) return;
+    if (filter && !filter.some((f) => relativePath.startsWith(f))) return;
+    promises.push(
+      file.async("text").then((content) => {
+        files.set(relativePath, content);
+      })
+    );
+  });
+  await Promise.all(promises);
+  return files;
+}
+
+export {
+  parseAboutme,
+  buildAboutme,
+  aboutmeToJson,
+  parseId,
+  buildId,
+  extractDigest,
+  extractName,
+  createZip,
+  extractFiles
+};
+//# sourceMappingURL=chunk-IT25ILTQ.js.map

package/dist/chunk-IT25ILTQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifest.ts","../src/id.ts","../src/zip-core.ts"],"sourcesContent":["// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n\nimport type { AboutMe, BuildAboutmeOptions } from './types.js'\n\nexport function parseAboutme(json: any): AboutMe {\n  if (!json.schemaVersion) throw new Error('Missing schemaVersion in aboutme.json')\n  if (!json.id) throw new Error('Missing id in aboutme.json')\n  if (!json.name) throw new Error('Missing name in aboutme.json')\n  if (!json.description) throw new Error('Missing description in aboutme.json')\n  if (!json.version) throw new Error('Missing version in aboutme.json')\n  if (!json.domain) throw new Error('Missing domain in aboutme.json')\n  if (!json.persona) throw new Error('Missing persona in aboutme.json')\n  if (!json.compiler) throw new Error('Missing compiler in aboutme.json')\n  if (!Array.isArray(json.capabilities)) throw new Error('Missing capabilities array in aboutme.json')\n  if (!Array.isArray(json.requires)) throw new Error('Missing requires array in aboutme.json')\n  if (!json.integrity) throw new Error('Missing integrity in aboutme.json')\n\n  return {\n    schemaVersion: json.schemaVersion,\n    id: json.id,\n    name: json.name,\n    description: json.description,\n    version: json.version,\n    domain: json.domain,\n    license: json.license ?? '',\n    persona: json.persona,\n    purpose: json.purpose ?? 'unknown',\n    compiler: json.compiler,\n    commit: json.commit,\n    capabilities: json.capabilities,\n    requires: json.requires,\n    integrity: json.integrity,\n  }\n}\n\nexport function buildAboutme(opts: BuildAboutmeOptions): AboutMe {\n  return {\n    schemaVersion: 'dot-agent/1.0',\n    id: opts.id,\n    name: opts.name,\n    description: opts.description,\n    version: opts.version,\n    domain: opts.domain,\n    license: opts.license ?? '',\n    persona: opts.persona,\n    purpose: opts.purpose ?? 'unknown',\n    compiler: opts.compiler,\n    commit: opts.commit,\n    capabilities: opts.capabilities ?? [],\n    requires: opts.requires ?? [],\n    integrity: opts.integrity,\n  }\n}\n\nexport function aboutmeToJson(aboutme: AboutMe): string {\n  return JSON.stringify(aboutme, null, 2)\n}\n","// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport type { IdParts } from './types.js'\n\n// Code hosting platforms whose namespace format is platform/user rather than plain domain.\n// The list is maintained by the compiler and updated via CLI releases.\nexport const KNOWN_PLATFORMS = ['github.com', 'gitlab.com', 'codeberg.org', 'sr.ht'] as const\n\nfunction parseNamespaceName(identifier: string): { namespace: string; name: string } {\n  // Email namespace: @ appears before any /\n  const atIdx = identifier.indexOf('@')\n  if (atIdx !== -1 && (identifier.indexOf('/') === -1 || atIdx < identifier.indexOf('/'))) {\n    const slashIdx = identifier.indexOf('/')\n    if (slashIdx === -1) {\n      throw new Error(`Invalid agent ID: email namespace requires a name after '/' (got '${identifier}')`)\n    }\n    return {\n      namespace: identifier.slice(0, slashIdx),\n      name: identifier.slice(slashIdx + 1),\n    }\n  }\n\n  // Known code-hosting platforms: namespace is platform/user, name is the next segment.\n  for (const platform of KNOWN_PLATFORMS) {\n    if (identifier.startsWith(platform + '/')) {\n      const afterPlatform = identifier.slice(platform.length + 1)\n      const slashIdx = afterPlatform.indexOf('/')\n      if (slashIdx === -1) {\n        throw new Error(\n          `Invalid agent ID: '${platform}' namespace requires a user segment and a name (got '${identifier}')`,\n        )\n      }\n      return {\n        namespace: platform + '/' + afterPlatform.slice(0, slashIdx),\n        name: afterPlatform.slice(slashIdx + 1),\n      }\n    }\n  }\n\n  // Domain or reserved keyword (e.g. 'unknown'): last '/' separates namespace from name.\n  const lastSlash = identifier.lastIndexOf('/')\n  if (lastSlash === -1) {\n    throw new Error(`Invalid agent ID: missing '/' separator in '${identifier}'`)\n  }\n  return {\n    namespace: identifier.slice(0, lastSlash),\n    name: identifier.slice(lastSlash + 1),\n  }\n}\n\nexport function parseId(id: string): IdParts {\n  if (!id) throw new Error('Invalid agent ID: empty string')\n\n  // Phase 1: split on the first ':' to isolate the identifier from version~digest.\n  const colonIdx = id.indexOf(':')\n\n  let identifier: string\n  let version: string | undefined\n  let digest: string | undefined\n\n  if (colonIdx === -1) {\n    // Form A: namespace/name\n    identifier = id\n  } else {\n    identifier = id.slice(0, colonIdx)\n    const rest = id.slice(colonIdx + 1)\n    if (!rest) throw new Error(`Invalid agent ID: empty version after ':' in '${id}'`)\n\n    // Phase 2: split version~digest\n    const tildeIdx = rest.indexOf('~')\n    if (tildeIdx === -1) {\n      // Form B: namespace/name:version\n      version = rest\n    } else {\n      // Form D: namespace/name:version~digest\n      version = rest.slice(0, tildeIdx)\n      digest = rest.slice(tildeIdx + 1)\n      if (!version) throw new Error(`Invalid agent ID: empty version before '~' in '${id}'`)\n      if (!digest) throw new Error(`Invalid agent ID: empty digest after '~' in '${id}'`)\n    }\n  }\n\n  // Phase 3: extract namespace and name from the identifier\n  const { namespace, name } = parseNamespaceName(identifier)\n\n  if (!namespace) throw new Error(`Invalid agent ID: empty namespace in '${id}'`)\n  if (!name) throw new Error(`Invalid agent ID: empty name in '${id}'`)\n\n  return { namespace, name, version, digest }\n}\n\nexport function buildId(parts: IdParts): string {\n  const { namespace, name, version, digest } = parts\n  if (!namespace || !name) {\n    throw new Error('Missing required ID parts: namespace and name')\n  }\n  if (digest && !version) {\n    throw new Error('Invalid ID parts: digest requires version')\n  }\n  let result = `${namespace}/${name}`\n  if (version) {\n    result += `:${version}`\n    if (digest) result += `~${digest}`\n  }\n  return result\n}\n\nexport function extractDigest(id: string): string {\n  try {\n    return parseId(id).digest ?? ''\n  } catch {\n    return ''\n  }\n}\n\nexport function extractName(id: string): string {\n  try {\n    return parseId(id).name\n  } catch {\n    return ''\n  }\n}\n","// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport JSZip from 'jszip'\n\nexport function createZip(): JSZip {\n  return new JSZip()\n}\n\nexport async function extractFiles(zip: JSZip, filter?: string[]): Promise<Map<string, string>> {\n  const files = new Map<string, string>()\n  const promises: Promise<void>[] = []\n\n  zip.forEach((relativePath, file) => {\n    if (file.dir) return\n    if (filter && !filter.some(f => relativePath.startsWith(f))) return\n    promises.push(\n      file.async('text').then(content => {\n        files.set(relativePath, content)\n      })\n    )\n  })\n\n  await Promise.all(promises)\n  return files\n}\n"],"mappings":";AAUO,SAAS,aAAa,MAAoB;AAC/C,MAAI,CAAC,KAAK,cAAe,OAAM,IAAI,MAAM,uCAAuC;AAChF,MAAI,CAAC,KAAK,GAAI,OAAM,IAAI,MAAM,4BAA4B;AAC1D,MAAI,CAAC,KAAK,KAAM,OAAM,IAAI,MAAM,8BAA8B;AAC9D,MAAI,CAAC,KAAK,YAAa,OAAM,IAAI,MAAM,qCAAqC;AAC5E,MAAI,CAAC,KAAK,QAAS,OAAM,IAAI,MAAM,iCAAiC;AACpE,MAAI,CAAC,KAAK,OAAQ,OAAM,IAAI,MAAM,gCAAgC;AAClE,MAAI,CAAC,KAAK,QAAS,OAAM,IAAI,MAAM,iCAAiC;AACpE,MAAI,CAAC,KAAK,SAAU,OAAM,IAAI,MAAM,kCAAkC;AACtE,MAAI,CAAC,MAAM,QAAQ,KAAK,YAAY,EAAG,OAAM,IAAI,MAAM,4CAA4C;AACnG,MAAI,CAAC,MAAM,QAAQ,KAAK,QAAQ,EAAG,OAAM,IAAI,MAAM,wCAAwC;AAC3F,MAAI,CAAC,KAAK,UAAW,OAAM,IAAI,MAAM,mCAAmC;AAExE,SAAO;AAAA,IACL,eAAe,KAAK;AAAA,IACpB,IAAI,KAAK;AAAA,IACT,MAAM,KAAK;AAAA,IACX,aAAa,KAAK;AAAA,IAClB,SAAS,KAAK;AAAA,IACd,QAAQ,KAAK;AAAA,IACb,SAAS,KAAK,WAAW;AAAA,IACzB,SAAS,KAAK;AAAA,IACd,SAAS,KAAK,WAAW;AAAA,IACzB,UAAU,KAAK;AAAA,IACf,QAAQ,KAAK;AAAA,IACb,cAAc,KAAK;AAAA,IACnB,UAAU,KAAK;AAAA,IACf,WAAW,KAAK;AAAA,EAClB;AACF;AAEO,SAAS,aAAa,MAAoC;AAC/D,SAAO;AAAA,IACL,eAAe;AAAA,IACf,IAAI,KAAK;AAAA,IACT,MAAM,KAAK;AAAA,IACX,aAAa,KAAK;AAAA,IAClB,SAAS,KAAK;AAAA,IACd,QAAQ,KAAK;AAAA,IACb,SAAS,KAAK,WAAW;AAAA,IACzB,SAAS,KAAK;AAAA,IACd,SAAS,KAAK,WAAW;AAAA,IACzB,UAAU,KAAK;AAAA,IACf,QAAQ,KAAK;AAAA,IACb,cAAc,KAAK,gBAAgB,CAAC;AAAA,IACpC,UAAU,KAAK,YAAY,CAAC;AAAA,IAC5B,WAAW,KAAK;AAAA,EAClB;AACF;AAEO,SAAS,cAAc,SAA0B;AACtD,SAAO,KAAK,UAAU,SAAS,MAAM,CAAC;AACxC;;;AC5CO,IAAM,kBAAkB,CAAC,cAAc,cAAc,gBAAgB,OAAO;AAEnF,SAAS,mBAAmB,YAAyD;AAEnF,QAAM,QAAQ,WAAW,QAAQ,GAAG;AACpC,MAAI,UAAU,OAAO,WAAW,QAAQ,GAAG,MAAM,MAAM,QAAQ,WAAW,QAAQ,GAAG,IAAI;AACvF,UAAM,WAAW,WAAW,QAAQ,GAAG;AACvC,QAAI,aAAa,IAAI;AACnB,YAAM,IAAI,MAAM,qEAAqE,UAAU,IAAI;AAAA,IACrG;AACA,WAAO;AAAA,MACL,WAAW,WAAW,MAAM,GAAG,QAAQ;AAAA,MACvC,MAAM,WAAW,MAAM,WAAW,CAAC;AAAA,IACrC;AAAA,EACF;AAGA,aAAW,YAAY,iBAAiB;AACtC,QAAI,WAAW,WAAW,WAAW,GAAG,GAAG;AACzC,YAAM,gBAAgB,WAAW,MAAM,SAAS,SAAS,CAAC;AAC1D,YAAM,WAAW,cAAc,QAAQ,GAAG;AAC1C,UAAI,aAAa,IAAI;AACnB,cAAM,IAAI;AAAA,UACR,sBAAsB,QAAQ,wDAAwD,UAAU;AAAA,QAClG;AAAA,MACF;AACA,aAAO;AAAA,QACL,WAAW,WAAW,MAAM,cAAc,MAAM,GAAG,QAAQ;AAAA,QAC3D,MAAM,cAAc,MAAM,WAAW,CAAC;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AAGA,QAAM,YAAY,WAAW,YAAY,GAAG;AAC5C,MAAI,cAAc,IAAI;AACpB,UAAM,IAAI,MAAM,+CAA+C,UAAU,GAAG;AAAA,EAC9E;AACA,SAAO;AAAA,IACL,WAAW,WAAW,MAAM,GAAG,SAAS;AAAA,IACxC,MAAM,WAAW,MAAM,YAAY,CAAC;AAAA,EACtC;AACF;AAEO,SAAS,QAAQ,IAAqB;AAC3C,MAAI,CAAC,GAAI,OAAM,IAAI,MAAM,gCAAgC;AAGzD,QAAM,WAAW,GAAG,QAAQ,GAAG;AAE/B,MAAI;AACJ,MAAI;AACJ,MAAI;AAEJ,MAAI,aAAa,IAAI;AAEnB,iBAAa;AAAA,EACf,OAAO;AACL,iBAAa,GAAG,MAAM,GAAG,QAAQ;AACjC,UAAM,OAAO,GAAG,MAAM,WAAW,CAAC;AAClC,QAAI,CAAC,KAAM,OAAM,IAAI,MAAM,iDAAiD,EAAE,GAAG;AAGjF,UAAM,WAAW,KAAK,QAAQ,GAAG;AACjC,QAAI,aAAa,IAAI;AAEnB,gBAAU;AAAA,IACZ,OAAO;AAEL,gBAAU,KAAK,MAAM,GAAG,QAAQ;AAChC,eAAS,KAAK,MAAM,WAAW,CAAC;AAChC,UAAI,CAAC,QAAS,OAAM,IAAI,MAAM,kDAAkD,EAAE,GAAG;AACrF,UAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,gDAAgD,EAAE,GAAG;AAAA,IACpF;AAAA,EACF;AAGA,QAAM,EAAE,WAAW,KAAK,IAAI,mBAAmB,UAAU;AAEzD,MAAI,CAAC,UAAW,OAAM,IAAI,MAAM,yCAAyC,EAAE,GAAG;AAC9E,MAAI,CAAC,KAAM,OAAM,IAAI,MAAM,oCAAoC,EAAE,GAAG;AAEpE,SAAO,EAAE,WAAW,MAAM,SAAS,OAAO;AAC5C;AAEO,SAAS,QAAQ,OAAwB;AAC9C,QAAM,EAAE,WAAW,MAAM,SAAS,OAAO,IAAI;AAC7C,MAAI,CAAC,aAAa,CAAC,MAAM;AACvB,UAAM,IAAI,MAAM,+CAA+C;AAAA,EACjE;AACA,MAAI,UAAU,CAAC,SAAS;AACtB,UAAM,IAAI,MAAM,2CAA2C;AAAA,EAC7D;AACA,MAAI,SAAS,GAAG,SAAS,IAAI,IAAI;AACjC,MAAI,SAAS;AACX,cAAU,IAAI,OAAO;AACrB,QAAI,OAAQ,WAAU,IAAI,MAAM;AAAA,EAClC;AACA,SAAO;AACT;AAEO,SAAS,cAAc,IAAoB;AAChD,MAAI;AACF,WAAO,QAAQ,EAAE,EAAE,UAAU;AAAA,EAC/B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,YAAY,IAAoB;AAC9C,MAAI;AACF,WAAO,QAAQ,EAAE,EAAE;AAAA,EACrB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;ACvHA,OAAO,WAAW;AAEX,SAAS,YAAmB;AACjC,SAAO,IAAI,MAAM;AACnB;AAEA,eAAsB,aAAa,KAAY,QAAiD;AAC9F,QAAM,QAAQ,oBAAI,IAAoB;AACtC,QAAM,WAA4B,CAAC;AAEnC,MAAI,QAAQ,CAAC,cAAc,SAAS;AAClC,QAAI,KAAK,IAAK;AACd,QAAI,UAAU,CAAC,OAAO,KAAK,OAAK,aAAa,WAAW,CAAC,CAAC,EAAG;AAC7D,aAAS;AAAA,MACP,KAAK,MAAM,MAAM,EAAE,KAAK,aAAW;AACjC,cAAM,IAAI,cAAc,OAAO;AAAA,MACjC,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAED,QAAM,QAAQ,IAAI,QAAQ;AAC1B,SAAO;AACT;","names":[]}

package/dist/core-DLZGpzev.d.cts

@@ -0,0 +1,161 @@
+import JSZip from 'jszip';
+
+type LangId = 'description' | 'behavior';
+interface BehaviorStatement {
+    type: string;
+    [key: string]: unknown;
+}
+interface StateDef {
+    name: string;
+    body: BehaviorStatement[];
+}
+interface TriggerDecl {
+    event: string;
+    body: BehaviorStatement[];
+}
+interface BehaviorFile {
+    merges: string[];
+    global_triggers: TriggerDecl[];
+    states: StateDef[];
+}
+interface OntologyRef {
+    uri: string;
+    label?: string;
+}
+interface AgentDecl {
+    name: string;
+    domain?: string;
+    license?: string;
+    terms?: string;
+    privacy?: string;
+}
+interface AnnotatedRef {
+    name: string;
+    description?: string;
+}
+type PropertyType = {
+    kind: 'primitive';
+    value: string;
+} | {
+    kind: 'reference';
+    value: string;
+} | {
+    kind: 'array';
+    value: PropertyType;
+} | {
+    kind: 'enum';
+    value: string[];
+};
+interface PropertyDecl {
+    name: string;
+    type: PropertyType;
+    is_optional: boolean;
+    description?: string;
+}
+interface TypeDefinition {
+    name: string;
+    category: OntologyRef;
+    concept?: OntologyRef;
+    properties: PropertyDecl[];
+}
+interface DescriptionFile {
+    agent: AgentDecl;
+    description?: string;
+    persona?: string;
+    behavior?: string;
+    requires: AnnotatedRef[];
+    input: AnnotatedRef[];
+    capabilities: AnnotatedRef[];
+    output: AnnotatedRef[];
+    types: TypeDefinition[];
+}
+/** Structured diagnostic from the Rust WASM parser. */
+interface ParseDiagnostic {
+    severity: 'error' | 'warning' | 'info' | 'hint';
+    code: string;
+    message: string;
+    hint?: string;
+    /** [line, col] 1-based, absent when position is unavailable (e.g. serde errors). */
+    start?: [number, number];
+    end?: [number, number];
+}
+interface LintMessage {
+    file: string;
+    line: number;
+    col: number;
+    severity: 'error' | 'warning' | 'info' | 'hint';
+    code: string;
+    message: string;
+    hint?: string;
+}
+interface IdParts {
+    namespace: string;
+    name: string;
+    version?: string;
+    digest?: string;
+}
+interface Capability {
+    id: string;
+    description: string;
+}
+interface Integrity {
+    sha256: string;
+    types?: string;
+    files?: string;
+}
+interface AboutMe {
+    schemaVersion: string;
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    domain: string;
+    license: string;
+    persona: string;
+    purpose: string;
+    compiler: string;
+    commit?: string;
+    capabilities: Capability[];
+    requires: AnnotatedRef[];
+    integrity: Integrity;
+}
+interface PackOptions {
+    dir?: string;
+    out?: string;
+    commit?: string;
+    version?: string;
+}
+interface PackResult {
+    path: string;
+    id: string;
+    warnings: LintMessage[];
+}
+interface BuildAboutmeOptions {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    domain: string;
+    license?: string;
+    persona: string;
+    purpose?: string;
+    compiler: string;
+    commit?: string;
+    capabilities?: Capability[];
+    requires?: AnnotatedRef[];
+    integrity: Integrity;
+}
+
+declare function parseAboutme(json: any): AboutMe;
+declare function buildAboutme(opts: BuildAboutmeOptions): AboutMe;
+declare function aboutmeToJson(aboutme: AboutMe): string;
+
+declare function parseId(id: string): IdParts;
+declare function buildId(parts: IdParts): string;
+declare function extractDigest(id: string): string;
+declare function extractName(id: string): string;
+
+declare function createZip(): JSZip;
+declare function extractFiles(zip: JSZip, filter?: string[]): Promise<Map<string, string>>;
+
+export { type AboutMe as A, type BehaviorFile as B, type Capability as C, type DescriptionFile as D, type IdParts as I, type LangId as L, type OntologyRef as O, type ParseDiagnostic as P, type StateDef as S, type TriggerDecl as T, type LintMessage as a, type PackOptions as b, type PackResult as c, type AgentDecl as d, type AnnotatedRef as e, type BehaviorStatement as f, type BuildAboutmeOptions as g, type Integrity as h, type PropertyDecl as i, type PropertyType as j, type TypeDefinition as k, aboutmeToJson as l, buildAboutme as m, buildId as n, createZip as o, extractDigest as p, extractFiles as q, extractName as r, parseAboutme as s, parseId as t };

package/dist/core-DLZGpzev.d.ts

@@ -0,0 +1,161 @@
+import JSZip from 'jszip';
+
+type LangId = 'description' | 'behavior';
+interface BehaviorStatement {
+    type: string;
+    [key: string]: unknown;
+}
+interface StateDef {
+    name: string;
+    body: BehaviorStatement[];
+}
+interface TriggerDecl {
+    event: string;
+    body: BehaviorStatement[];
+}
+interface BehaviorFile {
+    merges: string[];
+    global_triggers: TriggerDecl[];
+    states: StateDef[];
+}
+interface OntologyRef {
+    uri: string;
+    label?: string;
+}
+interface AgentDecl {
+    name: string;
+    domain?: string;
+    license?: string;
+    terms?: string;
+    privacy?: string;
+}
+interface AnnotatedRef {
+    name: string;
+    description?: string;
+}
+type PropertyType = {
+    kind: 'primitive';
+    value: string;
+} | {
+    kind: 'reference';
+    value: string;
+} | {
+    kind: 'array';
+    value: PropertyType;
+} | {
+    kind: 'enum';
+    value: string[];
+};
+interface PropertyDecl {
+    name: string;
+    type: PropertyType;
+    is_optional: boolean;
+    description?: string;
+}
+interface TypeDefinition {
+    name: string;
+    category: OntologyRef;
+    concept?: OntologyRef;
+    properties: PropertyDecl[];
+}
+interface DescriptionFile {
+    agent: AgentDecl;
+    description?: string;
+    persona?: string;
+    behavior?: string;
+    requires: AnnotatedRef[];
+    input: AnnotatedRef[];
+    capabilities: AnnotatedRef[];
+    output: AnnotatedRef[];
+    types: TypeDefinition[];
+}
+/** Structured diagnostic from the Rust WASM parser. */
+interface ParseDiagnostic {
+    severity: 'error' | 'warning' | 'info' | 'hint';
+    code: string;
+    message: string;
+    hint?: string;
+    /** [line, col] 1-based, absent when position is unavailable (e.g. serde errors). */
+    start?: [number, number];
+    end?: [number, number];
+}
+interface LintMessage {
+    file: string;
+    line: number;
+    col: number;
+    severity: 'error' | 'warning' | 'info' | 'hint';
+    code: string;
+    message: string;
+    hint?: string;
+}
+interface IdParts {
+    namespace: string;
+    name: string;
+    version?: string;
+    digest?: string;
+}
+interface Capability {
+    id: string;
+    description: string;
+}
+interface Integrity {
+    sha256: string;
+    types?: string;
+    files?: string;
+}
+interface AboutMe {
+    schemaVersion: string;
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    domain: string;
+    license: string;
+    persona: string;
+    purpose: string;
+    compiler: string;
+    commit?: string;
+    capabilities: Capability[];
+    requires: AnnotatedRef[];
+    integrity: Integrity;
+}
+interface PackOptions {
+    dir?: string;
+    out?: string;
+    commit?: string;
+    version?: string;
+}
+interface PackResult {
+    path: string;
+    id: string;
+    warnings: LintMessage[];
+}
+interface BuildAboutmeOptions {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    domain: string;
+    license?: string;
+    persona: string;
+    purpose?: string;
+    compiler: string;
+    commit?: string;
+    capabilities?: Capability[];
+    requires?: AnnotatedRef[];
+    integrity: Integrity;
+}
+
+declare function parseAboutme(json: any): AboutMe;
+declare function buildAboutme(opts: BuildAboutmeOptions): AboutMe;
+declare function aboutmeToJson(aboutme: AboutMe): string;
+
+declare function parseId(id: string): IdParts;
+declare function buildId(parts: IdParts): string;
+declare function extractDigest(id: string): string;
+declare function extractName(id: string): string;
+
+declare function createZip(): JSZip;
+declare function extractFiles(zip: JSZip, filter?: string[]): Promise<Map<string, string>>;
+
+export { type AboutMe as A, type BehaviorFile as B, type Capability as C, type DescriptionFile as D, type IdParts as I, type LangId as L, type OntologyRef as O, type ParseDiagnostic as P, type StateDef as S, type TriggerDecl as T, type LintMessage as a, type PackOptions as b, type PackResult as c, type AgentDecl as d, type AnnotatedRef as e, type BehaviorStatement as f, type BuildAboutmeOptions as g, type Integrity as h, type PropertyDecl as i, type PropertyType as j, type TypeDefinition as k, aboutmeToJson as l, buildAboutme as m, buildId as n, createZip as o, extractDigest as p, extractFiles as q, extractName as r, parseAboutme as s, parseId as t };