@dot-agent/sdk 0.5.0-alpha.2 → 0.10.0

package/dist/index.cjs

@@ -53,7 +53,7 @@ async function loadAgent(input) {
   const behavFile = zip.file(filesJson.behavior);
   if (!descFile) throw new Error(`Missing ${filesJson.description} in bundle`);
   if (!behavFile) throw new Error(`Missing ${filesJson.behavior} in bundle`);
-  const soulFile = zip.file("SOUL.md");
+  const personaFile = filesJson.persona ? zip.file(filesJson.persona) : null;
   const allFiles = await (0, import_core.extractFiles)(zip);
   const guides = [];
   const knowledge = [];
@@ -73,7 +73,7 @@ async function loadAgent(input) {
     files: {
       description: await descFile.async("text"),
       behavior: await behavFile.async("text"),
-      soul: soulFile ? await soulFile.async("text") : void 0,
+      persona: personaFile ? await personaFile.async("text") : void 0,
       guides,
       knowledge,
       behaviors

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/load.ts","../src/session.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//\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\nexport { loadAgent } from './load.js'\nexport { AgentSession } from './session.js'\nexport type { AgentBundle, AgentFiles, Effect, EffectHandler, AboutMe } from './types.js'\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'\nimport { parseAboutme, extractFiles, validateMagicBytes, validateZipBomb } from '@dot-agent/compiler/core'\nimport type { AgentBundle } from './types.js'\n\nexport async function loadAgent(input: Uint8Array | ArrayBuffer): Promise<AgentBundle> {\n  const bytes = input instanceof Uint8Array ? input : new Uint8Array(input)\n\n  validateMagicBytes(bytes)\n\n  const zip = await JSZip.loadAsync(bytes)\n  validateZipBomb(zip, bytes.length)\n\n  const aboutmeFile = zip.file('.agent/aboutme.json')\n  if (!aboutmeFile) throw new Error('Missing .agent/aboutme.json in bundle')\n  const aboutme = parseAboutme(JSON.parse(await aboutmeFile.async('text')))\n\n  const filesJsonFile = zip.file('.agent/files.json')\n  if (!filesJsonFile) throw new Error('Missing .agent/files.json in bundle')\n  const filesJson = JSON.parse(await filesJsonFile.async('text')) as {\n    description: string\n    behavior: string\n    behaviors?: string[]\n    guides?: string[]\n    knowledge?: string[]\n  }\n\n  const descFile = zip.file(filesJson.description)\n  const behavFile = zip.file(filesJson.behavior)\n  if (!descFile) throw new Error(`Missing ${filesJson.description} in bundle`)\n  if (!behavFile) throw new Error(`Missing ${filesJson.behavior} in bundle`)\n\n  const soulFile = zip.file('SOUL.md')\n  const allFiles = await extractFiles(zip)\n\n  const guides: Array<{ path: string; content: string }> = []\n  const knowledge: Array<{ path: string; content: string }> = []\n  const behaviors: Array<{ path: string; content: string }> = []\n\n  for (const [path, content] of allFiles) {\n    if (path.startsWith('guides/') && path !== 'guides/.gitkeep') {\n      guides.push({ path, content })\n    } else if (path.startsWith('knowledge/') && path !== 'knowledge/.gitkeep') {\n      knowledge.push({ path, content })\n    } else if (path.startsWith('behaviors/') && path !== 'behaviors/.gitkeep') {\n      behaviors.push({ path, content })\n    }\n  }\n\n  return {\n    id: aboutme.id,\n    aboutme,\n    files: {\n      description: await descFile.async('text'),\n      behavior: await behavFile.async('text'),\n      soul: soulFile ? await soulFile.async('text') : undefined,\n      guides,\n      knowledge,\n      behaviors,\n    },\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 { AgentDSLKernel, init as initKernel } from '@dot-agent/kernel-dsl'\nimport type { AgentBundle, Effect, EffectHandler } from './types.js'\n\nexport class AgentSession {\n  private kernel: AgentDSLKernel\n  private handlers = new Map<string, EffectHandler>()\n  private effectListener?: (effect: Effect) => void\n  readonly bundle: AgentBundle\n\n  private constructor(kernel: AgentDSLKernel, bundle: AgentBundle) {\n    this.kernel = kernel\n    this.bundle = bundle\n  }\n\n  static async create(bundle: AgentBundle): Promise<AgentSession> {\n    await initKernel()\n    const kernel = new AgentDSLKernel()\n    return new AgentSession(kernel, bundle)\n  }\n\n  // Register a synchronous fallback called when a `merge \"…\"` path is not in the bundle.\n  // Must be called before start(). Return null/undefined if the path cannot be resolved.\n  setFileResolver(resolver: (path: string) => string | null | undefined): void {\n    this.kernel.set_file_resolver(resolver as unknown as Function)\n  }\n\n  // Call after registerHandler() — loads the behavior and fires initial effects.\n  // Passes all merged behavior files as a bundle so the kernel can resolve `merge \"…\"` paths.\n  start(): void {\n    const bundle: Record<string, string> = {}\n    for (const { path, content } of this.bundle.files.behaviors) {\n      bundle[path] = content\n    }\n    this.dispatchRaw(\n      this.kernel.load_behavior_with_bundle(\n        this.bundle.files.behavior,\n        JSON.stringify(bundle),\n      )\n    )\n  }\n\n  registerHandler(effectType: string, handler: EffectHandler): void {\n    this.handlers.set(effectType, handler)\n  }\n\n  setEffectListener(listener: ((effect: Effect) => void) | undefined): void {\n    this.effectListener = listener\n  }\n\n  private dispatchRaw(raw: string): void {\n    if (!raw) return\n    let effects: Effect[]\n    try {\n      effects = JSON.parse(raw)\n    } catch {\n      console.error('[AgentSession] failed to parse effects JSON:', raw)\n      return\n    }\n    if (!Array.isArray(effects)) return\n    for (const effect of effects) {\n      this.effectListener?.(effect)\n      const handler = this.handlers.get(effect.type)\n      if (handler) {\n        Promise.resolve(handler(effect)).catch(err => {\n          console.error(`[AgentSession] handler error for effect \"${effect.type}\":`, err)\n        })\n      }\n    }\n  }\n\n  sendIntent(intent: string): void  { this.dispatchRaw(this.kernel.send_intent(intent)) }\n  sendEvent(event: string): void    { this.dispatchRaw(this.kernel.send_event(event)) }\n  sendOfftopic(): void              { this.dispatchRaw(this.kernel.send_offtopic()) }\n  tickPrompt(): void                { this.dispatchRaw(this.kernel.tick_prompt()) }\n\n  getState(): string            { return this.kernel.get_current_state() }\n  getValidIntents(): Array<any> { return this.kernel.get_valid_intents() }\n  getGraph(): string            { return this.kernel.get_graph() }\n  getMemory(): Array<{ domain: string; key: string; value: unknown }> {\n    return JSON.parse(this.kernel.get_memory())\n  }\n\n  injectMemory(domain: string, key: string, value: string): void {\n    this.kernel.set_memory(domain, key, value)\n  }\n\n  dispose(): void { this.kernel.free() }\n}\n"],"mappings":"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","names":["JSZip","initKernel"]}
+{"version":3,"sources":["../src/index.ts","../src/load.ts","../src/session.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//\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\nexport { loadAgent } from './load.js'\nexport { AgentSession } from './session.js'\nexport type { AgentBundle, AgentFiles, Effect, EffectHandler, AboutMe } from './types.js'\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'\nimport { parseAboutme, extractFiles, validateMagicBytes, validateZipBomb } from '@dot-agent/compiler/core'\nimport type { AgentBundle } from './types.js'\n\nexport async function loadAgent(input: Uint8Array | ArrayBuffer): Promise<AgentBundle> {\n  const bytes = input instanceof Uint8Array ? input : new Uint8Array(input)\n\n  validateMagicBytes(bytes)\n\n  const zip = await JSZip.loadAsync(bytes)\n  validateZipBomb(zip, bytes.length)\n\n  const aboutmeFile = zip.file('.agent/aboutme.json')\n  if (!aboutmeFile) throw new Error('Missing .agent/aboutme.json in bundle')\n  const aboutme = parseAboutme(JSON.parse(await aboutmeFile.async('text')))\n\n  const filesJsonFile = zip.file('.agent/files.json')\n  if (!filesJsonFile) throw new Error('Missing .agent/files.json in bundle')\n  const filesJson = JSON.parse(await filesJsonFile.async('text')) as {\n    description: string\n    behavior: string\n    persona?: string\n    behaviors?: string[]\n    guides?: string[]\n    knowledge?: string[]\n  }\n\n  const descFile = zip.file(filesJson.description)\n  const behavFile = zip.file(filesJson.behavior)\n  if (!descFile) throw new Error(`Missing ${filesJson.description} in bundle`)\n  if (!behavFile) throw new Error(`Missing ${filesJson.behavior} in bundle`)\n\n  const personaFile = filesJson.persona ? zip.file(filesJson.persona) : null\n  const allFiles = await extractFiles(zip)\n\n  const guides: Array<{ path: string; content: string }> = []\n  const knowledge: Array<{ path: string; content: string }> = []\n  const behaviors: Array<{ path: string; content: string }> = []\n\n  for (const [path, content] of allFiles) {\n    if (path.startsWith('guides/') && path !== 'guides/.gitkeep') {\n      guides.push({ path, content })\n    } else if (path.startsWith('knowledge/') && path !== 'knowledge/.gitkeep') {\n      knowledge.push({ path, content })\n    } else if (path.startsWith('behaviors/') && path !== 'behaviors/.gitkeep') {\n      behaviors.push({ path, content })\n    }\n  }\n\n  return {\n    id: aboutme.id,\n    aboutme,\n    files: {\n      description: await descFile.async('text'),\n      behavior: await behavFile.async('text'),\n      persona: personaFile ? await personaFile.async('text') : undefined,\n      guides,\n      knowledge,\n      behaviors,\n    },\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 { AgentDSLKernel, init as initKernel } from '@dot-agent/kernel-dsl'\nimport type { AgentBundle, Effect, EffectHandler } from './types.js'\n\nexport class AgentSession {\n  private kernel: AgentDSLKernel\n  private handlers = new Map<string, EffectHandler>()\n  private effectListener?: (effect: Effect) => void\n  readonly bundle: AgentBundle\n\n  private constructor(kernel: AgentDSLKernel, bundle: AgentBundle) {\n    this.kernel = kernel\n    this.bundle = bundle\n  }\n\n  static async create(bundle: AgentBundle): Promise<AgentSession> {\n    await initKernel()\n    const kernel = new AgentDSLKernel()\n    return new AgentSession(kernel, bundle)\n  }\n\n  // Register a synchronous fallback called when a `merge \"…\"` path is not in the bundle.\n  // Must be called before start(). Return null/undefined if the path cannot be resolved.\n  setFileResolver(resolver: (path: string) => string | null | undefined): void {\n    this.kernel.set_file_resolver(resolver as unknown as Function)\n  }\n\n  // Call after registerHandler() — loads the behavior and fires initial effects.\n  // Passes all merged behavior files as a bundle so the kernel can resolve `merge \"…\"` paths.\n  start(): void {\n    const bundle: Record<string, string> = {}\n    for (const { path, content } of this.bundle.files.behaviors) {\n      bundle[path] = content\n    }\n    this.dispatchRaw(\n      this.kernel.load_behavior_with_bundle(\n        this.bundle.files.behavior,\n        JSON.stringify(bundle),\n      )\n    )\n  }\n\n  registerHandler(effectType: string, handler: EffectHandler): void {\n    this.handlers.set(effectType, handler)\n  }\n\n  setEffectListener(listener: ((effect: Effect) => void) | undefined): void {\n    this.effectListener = listener\n  }\n\n  private dispatchRaw(raw: string): void {\n    if (!raw) return\n    let effects: Effect[]\n    try {\n      effects = JSON.parse(raw)\n    } catch {\n      console.error('[AgentSession] failed to parse effects JSON:', raw)\n      return\n    }\n    if (!Array.isArray(effects)) return\n    for (const effect of effects) {\n      this.effectListener?.(effect)\n      const handler = this.handlers.get(effect.type)\n      if (handler) {\n        Promise.resolve(handler(effect)).catch(err => {\n          console.error(`[AgentSession] handler error for effect \"${effect.type}\":`, err)\n        })\n      }\n    }\n  }\n\n  sendIntent(intent: string): void  { this.dispatchRaw(this.kernel.send_intent(intent)) }\n  sendEvent(event: string): void    { this.dispatchRaw(this.kernel.send_event(event)) }\n  sendOfftopic(): void              { this.dispatchRaw(this.kernel.send_offtopic()) }\n  tickPrompt(): void                { this.dispatchRaw(this.kernel.tick_prompt()) }\n\n  getState(): string            { return this.kernel.get_current_state() }\n  getValidIntents(): Array<any> { return this.kernel.get_valid_intents() }\n  getGraph(): string            { return this.kernel.get_graph() }\n  getMemory(): Array<{ domain: string; key: string; value: unknown }> {\n    return JSON.parse(this.kernel.get_memory())\n  }\n\n  injectMemory(domain: string, key: string, value: string): void {\n    this.kernel.set_memory(domain, key, value)\n  }\n\n  dispose(): void { this.kernel.free() }\n}\n"],"mappings":"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","names":["JSZip","initKernel"]}

package/dist/index.js

@@ -16,7 +16,7 @@ async function loadAgent(input) {
   const behavFile = zip.file(filesJson.behavior);
   if (!descFile) throw new Error(`Missing ${filesJson.description} in bundle`);
   if (!behavFile) throw new Error(`Missing ${filesJson.behavior} in bundle`);
-  const soulFile = zip.file("SOUL.md");
+  const personaFile = filesJson.persona ? zip.file(filesJson.persona) : null;
   const allFiles = await extractFiles(zip);
   const guides = [];
   const knowledge = [];
@@ -36,7 +36,7 @@ async function loadAgent(input) {
     files: {
       description: await descFile.async("text"),
       behavior: await behavFile.async("text"),
-      soul: soulFile ? await soulFile.async("text") : void 0,
+      persona: personaFile ? await personaFile.async("text") : void 0,
       guides,
       knowledge,
       behaviors

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/load.ts","../src/session.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//\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'\nimport { parseAboutme, extractFiles, validateMagicBytes, validateZipBomb } from '@dot-agent/compiler/core'\nimport type { AgentBundle } from './types.js'\n\nexport async function loadAgent(input: Uint8Array | ArrayBuffer): Promise<AgentBundle> {\n  const bytes = input instanceof Uint8Array ? input : new Uint8Array(input)\n\n  validateMagicBytes(bytes)\n\n  const zip = await JSZip.loadAsync(bytes)\n  validateZipBomb(zip, bytes.length)\n\n  const aboutmeFile = zip.file('.agent/aboutme.json')\n  if (!aboutmeFile) throw new Error('Missing .agent/aboutme.json in bundle')\n  const aboutme = parseAboutme(JSON.parse(await aboutmeFile.async('text')))\n\n  const filesJsonFile = zip.file('.agent/files.json')\n  if (!filesJsonFile) throw new Error('Missing .agent/files.json in bundle')\n  const filesJson = JSON.parse(await filesJsonFile.async('text')) as {\n    description: string\n    behavior: string\n    behaviors?: string[]\n    guides?: string[]\n    knowledge?: string[]\n  }\n\n  const descFile = zip.file(filesJson.description)\n  const behavFile = zip.file(filesJson.behavior)\n  if (!descFile) throw new Error(`Missing ${filesJson.description} in bundle`)\n  if (!behavFile) throw new Error(`Missing ${filesJson.behavior} in bundle`)\n\n  const soulFile = zip.file('SOUL.md')\n  const allFiles = await extractFiles(zip)\n\n  const guides: Array<{ path: string; content: string }> = []\n  const knowledge: Array<{ path: string; content: string }> = []\n  const behaviors: Array<{ path: string; content: string }> = []\n\n  for (const [path, content] of allFiles) {\n    if (path.startsWith('guides/') && path !== 'guides/.gitkeep') {\n      guides.push({ path, content })\n    } else if (path.startsWith('knowledge/') && path !== 'knowledge/.gitkeep') {\n      knowledge.push({ path, content })\n    } else if (path.startsWith('behaviors/') && path !== 'behaviors/.gitkeep') {\n      behaviors.push({ path, content })\n    }\n  }\n\n  return {\n    id: aboutme.id,\n    aboutme,\n    files: {\n      description: await descFile.async('text'),\n      behavior: await behavFile.async('text'),\n      soul: soulFile ? await soulFile.async('text') : undefined,\n      guides,\n      knowledge,\n      behaviors,\n    },\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 { AgentDSLKernel, init as initKernel } from '@dot-agent/kernel-dsl'\nimport type { AgentBundle, Effect, EffectHandler } from './types.js'\n\nexport class AgentSession {\n  private kernel: AgentDSLKernel\n  private handlers = new Map<string, EffectHandler>()\n  private effectListener?: (effect: Effect) => void\n  readonly bundle: AgentBundle\n\n  private constructor(kernel: AgentDSLKernel, bundle: AgentBundle) {\n    this.kernel = kernel\n    this.bundle = bundle\n  }\n\n  static async create(bundle: AgentBundle): Promise<AgentSession> {\n    await initKernel()\n    const kernel = new AgentDSLKernel()\n    return new AgentSession(kernel, bundle)\n  }\n\n  // Register a synchronous fallback called when a `merge \"…\"` path is not in the bundle.\n  // Must be called before start(). Return null/undefined if the path cannot be resolved.\n  setFileResolver(resolver: (path: string) => string | null | undefined): void {\n    this.kernel.set_file_resolver(resolver as unknown as Function)\n  }\n\n  // Call after registerHandler() — loads the behavior and fires initial effects.\n  // Passes all merged behavior files as a bundle so the kernel can resolve `merge \"…\"` paths.\n  start(): void {\n    const bundle: Record<string, string> = {}\n    for (const { path, content } of this.bundle.files.behaviors) {\n      bundle[path] = content\n    }\n    this.dispatchRaw(\n      this.kernel.load_behavior_with_bundle(\n        this.bundle.files.behavior,\n        JSON.stringify(bundle),\n      )\n    )\n  }\n\n  registerHandler(effectType: string, handler: EffectHandler): void {\n    this.handlers.set(effectType, handler)\n  }\n\n  setEffectListener(listener: ((effect: Effect) => void) | undefined): void {\n    this.effectListener = listener\n  }\n\n  private dispatchRaw(raw: string): void {\n    if (!raw) return\n    let effects: Effect[]\n    try {\n      effects = JSON.parse(raw)\n    } catch {\n      console.error('[AgentSession] failed to parse effects JSON:', raw)\n      return\n    }\n    if (!Array.isArray(effects)) return\n    for (const effect of effects) {\n      this.effectListener?.(effect)\n      const handler = this.handlers.get(effect.type)\n      if (handler) {\n        Promise.resolve(handler(effect)).catch(err => {\n          console.error(`[AgentSession] handler error for effect \"${effect.type}\":`, err)\n        })\n      }\n    }\n  }\n\n  sendIntent(intent: string): void  { this.dispatchRaw(this.kernel.send_intent(intent)) }\n  sendEvent(event: string): void    { this.dispatchRaw(this.kernel.send_event(event)) }\n  sendOfftopic(): void              { this.dispatchRaw(this.kernel.send_offtopic()) }\n  tickPrompt(): void                { this.dispatchRaw(this.kernel.tick_prompt()) }\n\n  getState(): string            { return this.kernel.get_current_state() }\n  getValidIntents(): Array<any> { return this.kernel.get_valid_intents() }\n  getGraph(): string            { return this.kernel.get_graph() }\n  getMemory(): Array<{ domain: string; key: string; value: unknown }> {\n    return JSON.parse(this.kernel.get_memory())\n  }\n\n  injectMemory(domain: string, key: string, value: string): void {\n    this.kernel.set_memory(domain, key, value)\n  }\n\n  dispose(): void { this.kernel.free() }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/load.ts","../src/session.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//\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'\nimport { parseAboutme, extractFiles, validateMagicBytes, validateZipBomb } from '@dot-agent/compiler/core'\nimport type { AgentBundle } from './types.js'\n\nexport async function loadAgent(input: Uint8Array | ArrayBuffer): Promise<AgentBundle> {\n  const bytes = input instanceof Uint8Array ? input : new Uint8Array(input)\n\n  validateMagicBytes(bytes)\n\n  const zip = await JSZip.loadAsync(bytes)\n  validateZipBomb(zip, bytes.length)\n\n  const aboutmeFile = zip.file('.agent/aboutme.json')\n  if (!aboutmeFile) throw new Error('Missing .agent/aboutme.json in bundle')\n  const aboutme = parseAboutme(JSON.parse(await aboutmeFile.async('text')))\n\n  const filesJsonFile = zip.file('.agent/files.json')\n  if (!filesJsonFile) throw new Error('Missing .agent/files.json in bundle')\n  const filesJson = JSON.parse(await filesJsonFile.async('text')) as {\n    description: string\n    behavior: string\n    persona?: string\n    behaviors?: string[]\n    guides?: string[]\n    knowledge?: string[]\n  }\n\n  const descFile = zip.file(filesJson.description)\n  const behavFile = zip.file(filesJson.behavior)\n  if (!descFile) throw new Error(`Missing ${filesJson.description} in bundle`)\n  if (!behavFile) throw new Error(`Missing ${filesJson.behavior} in bundle`)\n\n  const personaFile = filesJson.persona ? zip.file(filesJson.persona) : null\n  const allFiles = await extractFiles(zip)\n\n  const guides: Array<{ path: string; content: string }> = []\n  const knowledge: Array<{ path: string; content: string }> = []\n  const behaviors: Array<{ path: string; content: string }> = []\n\n  for (const [path, content] of allFiles) {\n    if (path.startsWith('guides/') && path !== 'guides/.gitkeep') {\n      guides.push({ path, content })\n    } else if (path.startsWith('knowledge/') && path !== 'knowledge/.gitkeep') {\n      knowledge.push({ path, content })\n    } else if (path.startsWith('behaviors/') && path !== 'behaviors/.gitkeep') {\n      behaviors.push({ path, content })\n    }\n  }\n\n  return {\n    id: aboutme.id,\n    aboutme,\n    files: {\n      description: await descFile.async('text'),\n      behavior: await behavFile.async('text'),\n      persona: personaFile ? await personaFile.async('text') : undefined,\n      guides,\n      knowledge,\n      behaviors,\n    },\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 { AgentDSLKernel, init as initKernel } from '@dot-agent/kernel-dsl'\nimport type { AgentBundle, Effect, EffectHandler } from './types.js'\n\nexport class AgentSession {\n  private kernel: AgentDSLKernel\n  private handlers = new Map<string, EffectHandler>()\n  private effectListener?: (effect: Effect) => void\n  readonly bundle: AgentBundle\n\n  private constructor(kernel: AgentDSLKernel, bundle: AgentBundle) {\n    this.kernel = kernel\n    this.bundle = bundle\n  }\n\n  static async create(bundle: AgentBundle): Promise<AgentSession> {\n    await initKernel()\n    const kernel = new AgentDSLKernel()\n    return new AgentSession(kernel, bundle)\n  }\n\n  // Register a synchronous fallback called when a `merge \"…\"` path is not in the bundle.\n  // Must be called before start(). Return null/undefined if the path cannot be resolved.\n  setFileResolver(resolver: (path: string) => string | null | undefined): void {\n    this.kernel.set_file_resolver(resolver as unknown as Function)\n  }\n\n  // Call after registerHandler() — loads the behavior and fires initial effects.\n  // Passes all merged behavior files as a bundle so the kernel can resolve `merge \"…\"` paths.\n  start(): void {\n    const bundle: Record<string, string> = {}\n    for (const { path, content } of this.bundle.files.behaviors) {\n      bundle[path] = content\n    }\n    this.dispatchRaw(\n      this.kernel.load_behavior_with_bundle(\n        this.bundle.files.behavior,\n        JSON.stringify(bundle),\n      )\n    )\n  }\n\n  registerHandler(effectType: string, handler: EffectHandler): void {\n    this.handlers.set(effectType, handler)\n  }\n\n  setEffectListener(listener: ((effect: Effect) => void) | undefined): void {\n    this.effectListener = listener\n  }\n\n  private dispatchRaw(raw: string): void {\n    if (!raw) return\n    let effects: Effect[]\n    try {\n      effects = JSON.parse(raw)\n    } catch {\n      console.error('[AgentSession] failed to parse effects JSON:', raw)\n      return\n    }\n    if (!Array.isArray(effects)) return\n    for (const effect of effects) {\n      this.effectListener?.(effect)\n      const handler = this.handlers.get(effect.type)\n      if (handler) {\n        Promise.resolve(handler(effect)).catch(err => {\n          console.error(`[AgentSession] handler error for effect \"${effect.type}\":`, err)\n        })\n      }\n    }\n  }\n\n  sendIntent(intent: string): void  { this.dispatchRaw(this.kernel.send_intent(intent)) }\n  sendEvent(event: string): void    { this.dispatchRaw(this.kernel.send_event(event)) }\n  sendOfftopic(): void              { this.dispatchRaw(this.kernel.send_offtopic()) }\n  tickPrompt(): void                { this.dispatchRaw(this.kernel.tick_prompt()) }\n\n  getState(): string            { return this.kernel.get_current_state() }\n  getValidIntents(): Array<any> { return this.kernel.get_valid_intents() }\n  getGraph(): string            { return this.kernel.get_graph() }\n  getMemory(): Array<{ domain: string; key: string; value: unknown }> {\n    return JSON.parse(this.kernel.get_memory())\n  }\n\n  injectMemory(domain: string, key: string, value: string): void {\n    this.kernel.set_memory(domain, key, value)\n  }\n\n  dispose(): void { this.kernel.free() }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dot-agent/sdk",
-  "version": "0.5.0-alpha.2",
+  "version": "0.10.0",
   "description": "Browser-compatible SDK for loading and running dot-agent bundles",
   "license": "Apache-2.0",
   "author": {
@@ -56,8 +56,8 @@
     "test": "node --test tests/node.test.js"
   },
   "dependencies": {
-    "@dot-agent/compiler": "0.5.0-alpha.2",
-    "@dot-agent/kernel-dsl": "0.5.0-alpha.1",
+    "@dot-agent/compiler": "0.10.0",
+    "@dot-agent/kernel-dsl": "0.10.0",
     "jszip": "^3.10.1"
   },
   "devDependencies": {