@ai-ecoverse/slicc-agent 3.5.0 → 3.7.0

package/dist/licks/index.js

@@ -1,6 +1,20 @@
+import { live } from "../agents.js";
 import { cronTask, licksExtension } from "./extension.js";
 import { createLicks } from "./licks.js";
 import { createLickSources } from "./sources.js";
+const UNTRUSTED = /* @__PURE__ */ new Set(["webhook"]);
+function lickResolver(agent) {
+  return async (target, channel, context) => {
+    const cone = agent.cone();
+    if (target === "cone") return cone;
+    if (target.startsWith("cone:"))
+      return await agent.agents.conversation(target.slice("cone:".length), context) ?? cone;
+    if (UNTRUSTED.has(channel)) return cone;
+    const scoop = agent.agents.state().scoops[target];
+    if (!scoop || !live(scoop)) return cone;
+    return await agent.agents.conversation(target, context) ?? cone;
+  };
+}
 function setupLicks(registry) {
   let bind = () => void 0;
   const host = new Promise((resolve) => {
@@ -18,7 +32,7 @@ function setupLicks(registry) {
     licks,
     attach(agent, options) {
       const { harness, root } = agent;
-      bind({ harness, resolve: async (_target) => agent.cone() });
+      bind({ harness, resolve: lickResolver(agent) });
       return createLickSources({
         ...options,
         harness,
@@ -31,6 +45,7 @@ function setupLicks(registry) {
   };
 }
 export {
+  lickResolver,
   setupLicks
 };
 //# sourceMappingURL=index.js.map

package/dist/licks/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/licks/index.ts"],
-  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { Conversation, ConversationId, Harness, Registry } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport type { Activity } from '../kernel/activity.ts';\nimport { cronTask, licksExtension } from './extension.ts';\nimport type { LickTarget } from './lick.ts';\nimport { createLicks, type Licks, type LicksHost } from './licks.ts';\nimport { createLickSources, type LickSources } from './sources.ts';\n\nexport interface LicksAgent {\n  harness: Harness;\n  root: Conversation;\n  cone(): Conversation;\n}\n\nexport interface LicksSetup {\n  licks: Licks;\n  attach(\n    agent: LicksAgent,\n    options: {\n      env: ExecutionEnv;\n      home: string;\n      now?: () => number;\n      flushEvery?: number;\n      activity?: Activity;\n    }\n  ): LickSources;\n}\n\nexport function setupLicks(registry: Registry): LicksSetup {\n  let bind: (host: LicksHost) => void = () => undefined;\n  const host = new Promise<LicksHost>((resolve) => {\n    bind = resolve;\n  });\n  const licks = createLicks(host);\n  const cron = cronTask(licks);\n  const lookup = async (id: ConversationId, context: Context) => {\n    const found = await (await host).harness.conversation(id, context);\n    if (!found) throw new Error(`conversation ${id} is gone`);\n    return found;\n  };\n  registry.install(licksExtension(licks, lookup, cron));\n  return {\n    licks,\n    attach(agent, options) {\n      const { harness, root } = agent;\n      bind({ harness, resolve: async (_target: LickTarget) => agent.cone() });\n      return createLickSources({\n        ...options,\n        harness,\n        root,\n        cone: () => agent.cone(),\n        licks,\n        cron,\n      });\n    },\n  };\n}\n\nexport type { Lick, LickChannel } from './lick.ts';\nexport type { LickEvent, Licks } from './licks.ts';\nexport type { LickSources, WebhookDelivery } from './sources.ts';\n"],
-  "mappings": "AAIA,SAAS,UAAU,sBAAsB;AAEzC,SAAS,mBAA+C;AACxD,SAAS,yBAA2C;AAsB7C,SAAS,WAAW,UAAgC;AACzD,MAAI,OAAkC,MAAM;AAC5C,QAAM,OAAO,IAAI,QAAmB,CAAC,YAAY;AAC/C,WAAO;AAAA,EACT,CAAC;AACD,QAAM,QAAQ,YAAY,IAAI;AAC9B,QAAM,OAAO,SAAS,KAAK;AAC3B,QAAM,SAAS,OAAO,IAAoB,YAAqB;AAC7D,UAAM,QAAQ,OAAO,MAAM,MAAM,QAAQ,aAAa,IAAI,OAAO;AACjE,QAAI,CAAC,MAAO,OAAM,IAAI,MAAM,gBAAgB,EAAE,UAAU;AACxD,WAAO;AAAA,EACT;AACA,WAAS,QAAQ,eAAe,OAAO,QAAQ,IAAI,CAAC;AACpD,SAAO;AAAA,IACL;AAAA,IACA,OAAO,OAAO,SAAS;AACrB,YAAM,EAAE,SAAS,KAAK,IAAI;AAC1B,WAAK,EAAE,SAAS,SAAS,OAAO,YAAwB,MAAM,KAAK,EAAE,CAAC;AACtE,aAAO,kBAAkB;AAAA,QACvB,GAAG;AAAA,QACH;AAAA,QACA;AAAA,QACA,MAAM,MAAM,MAAM,KAAK;AAAA,QACvB;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { Conversation, ConversationId, Harness, Registry } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { type Agents, live } from '../agents.ts';\nimport type { Activity } from '../kernel/activity.ts';\nimport { cronTask, licksExtension } from './extension.ts';\nimport type { LickChannel, LickTarget } from './lick.ts';\nimport { createLicks, type Licks, type LicksHost } from './licks.ts';\nimport { createLickSources, type LickSources } from './sources.ts';\n\nexport interface LicksAgent {\n  harness: Harness;\n  root: Conversation;\n  agents: Agents;\n  cone(): Conversation;\n}\n\nconst UNTRUSTED = new Set<LickChannel>(['webhook']);\n\nexport function lickResolver(agent: LicksAgent) {\n  return async (target: LickTarget, channel: LickChannel, context: Context) => {\n    const cone = agent.cone();\n    if (target === 'cone') return cone;\n    if (target.startsWith('cone:'))\n      return (await agent.agents.conversation(target.slice('cone:'.length), context)) ?? cone;\n    if (UNTRUSTED.has(channel)) return cone;\n    const scoop = agent.agents.state().scoops[target];\n    if (!scoop || !live(scoop)) return cone;\n    return (await agent.agents.conversation(target, context)) ?? cone;\n  };\n}\n\nexport interface LicksSetup {\n  licks: Licks;\n  attach(\n    agent: LicksAgent,\n    options: {\n      env: ExecutionEnv;\n      home: string;\n      now?: () => number;\n      flushEvery?: number;\n      activity?: Activity;\n    }\n  ): LickSources;\n}\n\nexport function setupLicks(registry: Registry): LicksSetup {\n  let bind: (host: LicksHost) => void = () => undefined;\n  const host = new Promise<LicksHost>((resolve) => {\n    bind = resolve;\n  });\n  const licks = createLicks(host);\n  const cron = cronTask(licks);\n  const lookup = async (id: ConversationId, context: Context) => {\n    const found = await (await host).harness.conversation(id, context);\n    if (!found) throw new Error(`conversation ${id} is gone`);\n    return found;\n  };\n  registry.install(licksExtension(licks, lookup, cron));\n  return {\n    licks,\n    attach(agent, options) {\n      const { harness, root } = agent;\n      bind({ harness, resolve: lickResolver(agent) });\n      return createLickSources({\n        ...options,\n        harness,\n        root,\n        cone: () => agent.cone(),\n        licks,\n        cron,\n      });\n    },\n  };\n}\n\nexport type { Lick, LickChannel } from './lick.ts';\nexport type { LickEvent, Licks } from './licks.ts';\nexport type { LickSources, WebhookDelivery } from './sources.ts';\n"],
+  "mappings": "AAGA,SAAsB,YAAY;AAElC,SAAS,UAAU,sBAAsB;AAEzC,SAAS,mBAA+C;AACxD,SAAS,yBAA2C;AASpD,MAAM,YAAY,oBAAI,IAAiB,CAAC,SAAS,CAAC;AAE3C,SAAS,aAAa,OAAmB;AAC9C,SAAO,OAAO,QAAoB,SAAsB,YAAqB;AAC3E,UAAM,OAAO,MAAM,KAAK;AACxB,QAAI,WAAW,OAAQ,QAAO;AAC9B,QAAI,OAAO,WAAW,OAAO;AAC3B,aAAQ,MAAM,MAAM,OAAO,aAAa,OAAO,MAAM,QAAQ,MAAM,GAAG,OAAO,KAAM;AACrF,QAAI,UAAU,IAAI,OAAO,EAAG,QAAO;AACnC,UAAM,QAAQ,MAAM,OAAO,MAAM,EAAE,OAAO,MAAM;AAChD,QAAI,CAAC,SAAS,CAAC,KAAK,KAAK,EAAG,QAAO;AACnC,WAAQ,MAAM,MAAM,OAAO,aAAa,QAAQ,OAAO,KAAM;AAAA,EAC/D;AACF;AAgBO,SAAS,WAAW,UAAgC;AACzD,MAAI,OAAkC,MAAM;AAC5C,QAAM,OAAO,IAAI,QAAmB,CAAC,YAAY;AAC/C,WAAO;AAAA,EACT,CAAC;AACD,QAAM,QAAQ,YAAY,IAAI;AAC9B,QAAM,OAAO,SAAS,KAAK;AAC3B,QAAM,SAAS,OAAO,IAAoB,YAAqB;AAC7D,UAAM,QAAQ,OAAO,MAAM,MAAM,QAAQ,aAAa,IAAI,OAAO;AACjE,QAAI,CAAC,MAAO,OAAM,IAAI,MAAM,gBAAgB,EAAE,UAAU;AACxD,WAAO;AAAA,EACT;AACA,WAAS,QAAQ,eAAe,OAAO,QAAQ,IAAI,CAAC;AACpD,SAAO;AAAA,IACL;AAAA,IACA,OAAO,OAAO,SAAS;AACrB,YAAM,EAAE,SAAS,KAAK,IAAI;AAC1B,WAAK,EAAE,SAAS,SAAS,aAAa,KAAK,EAAE,CAAC;AAC9C,aAAO,kBAAkB;AAAA,QACvB,GAAG;AAAA,QACH;AAAA,QACA;AAAA,QACA,MAAM,MAAM,MAAM,KAAK;AAAA,QACvB;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/licks/lick.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/licks/lick.ts"],
-  "sourcesContent": ["export const LICK_CHANNELS = [\n  'webhook',\n  'cron',\n  'sprinkle',\n  'fswatch',\n  'session-reload',\n  'navigate',\n  'discovery',\n  'upgrade',\n  'workflow',\n  'bash',\n  'jshd',\n  'preview',\n  'cherry',\n  'scoop-notify',\n  'scoop-idle',\n  'scoop-wait',\n  'sudo-request',\n] as const;\n\nexport type LickChannel = (typeof LICK_CHANNELS)[number];\n\nexport type LickAction = 'confirm' | 'dismiss';\n\nexport type LickSeverity = 'warn' | 'error';\n\nexport type LickTarget = 'cone' | `scoop:${string}`;\n\nexport type Lick = {\n  id: string;\n  channel: LickChannel;\n  source: string;\n  title: string;\n  text: string;\n  body?: string;\n  count: number;\n  at: number;\n  actions?: LickAction[];\n  severity?: LickSeverity;\n};\n\nconst ENTITIES: Record<string, string> = {\n  '&': '&amp;',\n  '<': '&lt;',\n  '>': '&gt;',\n  '\"': '&quot;',\n  '\\n': '&#10;',\n  '\\r': '&#13;',\n};\n\nconst DECODE: Record<string, string> = Object.fromEntries(\n  Object.entries(ENTITIES).map(([raw, entity]) => [entity, raw])\n);\n\nexport function escapeText(value: string): string {\n  return value.replace(/[&<>]/g, (char) => ENTITIES[char] as string).replace(/\\r/g, '&#13;');\n}\n\nexport function escapeAttribute(value: string): string {\n  return value.replace(/[&<>\"\\n\\r]/g, (char) => ENTITIES[char] as string);\n}\n\nexport function unescape(value: string): string {\n  return value.replace(/&(?:amp|lt|gt|quot|#10|#13);/g, (entity) => DECODE[entity] as string);\n}\n\nexport function lickId(): string {\n  return `lk-${Date.now().toString(36)}-${crypto.randomUUID().slice(0, 8)}`;\n}\n\nfunction oneLine(value: string): string {\n  return value.replace(/\\s+/g, ' ').trim();\n}\n\nexport function formatLick(lick: Lick): string {\n  const attributes: [string, string][] = [\n    ['id', lick.id],\n    ['channel', lick.channel],\n    ['source', lick.source],\n    ['title', oneLine(lick.title)],\n    ['count', String(lick.count)],\n    ['at', new Date(lick.at).toISOString()],\n  ];\n  if (lick.actions?.length) attributes.push(['actions', lick.actions.join(' ')]);\n  if (lick.severity) attributes.push(['severity', lick.severity]);\n  const head = attributes.map(([name, value]) => `${name}=\"${escapeAttribute(value)}\"`).join(' ');\n  const lines = [escapeText(oneLine(lick.text))];\n  if (lick.body) lines.push(escapeText(lick.body));\n  return `<lick ${head}>\\n${lines.join('\\n')}\\n</lick>`;\n}\n\nconst LICK = /^<lick ((?:[a-z]+=\"[^\"<>\\n]*\" ?)+)>\\n([^\\n]*)(?:\\n([\\s\\S]*?))?\\n<\\/lick>$/;\nconst ATTRIBUTE = /([a-z]+)=\"([^\"]*)\"/g;\n\nfunction isChannel(value: string | undefined): value is LickChannel {\n  return (LICK_CHANNELS as readonly string[]).includes(value ?? '');\n}\n\nfunction severityOf(value: string | undefined): { severity?: LickSeverity } {\n  return value === 'warn' || value === 'error' ? { severity: value } : {};\n}\n\nexport function parseLick(text: string): Lick | undefined {\n  const match = LICK.exec(text);\n  if (!match) return undefined;\n  const attributes = new Map<string, string>();\n  for (const [, name, value] of (match[1] as string).matchAll(ATTRIBUTE))\n    attributes.set(name as string, unescape(value as string));\n  const channel = attributes.get('channel');\n  const id = attributes.get('id');\n  if (!id || !isChannel(channel)) return undefined;\n  const at = Date.parse(attributes.get('at') ?? '');\n  const count = Number(attributes.get('count'));\n  const actions = (attributes.get('actions') ?? '')\n    .split(' ')\n    .filter((action): action is LickAction => action === 'confirm' || action === 'dismiss');\n  const body = match[3] === undefined ? undefined : unescape(match[3]);\n  return {\n    id,\n    channel,\n    source: attributes.get('source') ?? '',\n    title: attributes.get('title') ?? '',\n    text: unescape(match[2] as string),\n    ...(body ? { body } : {}),\n    count: Number.isSafeInteger(count) && count > 0 ? count : 1,\n    at: Number.isNaN(at) ? 0 : at,\n    ...(actions.length ? { actions } : {}),\n    ...severityOf(attributes.get('severity')),\n  };\n}\n"],
+  "sourcesContent": ["export const LICK_CHANNELS = [\n  'webhook',\n  'cron',\n  'sprinkle',\n  'fswatch',\n  'session-reload',\n  'navigate',\n  'discovery',\n  'upgrade',\n  'workflow',\n  'bash',\n  'jshd',\n  'preview',\n  'cherry',\n  'scoop-notify',\n  'scoop-idle',\n  'scoop-wait',\n  'sudo-request',\n] as const;\n\nexport type LickChannel = (typeof LICK_CHANNELS)[number];\n\nexport type LickAction = 'confirm' | 'dismiss';\n\nexport type LickSeverity = 'warn' | 'error';\n\nexport type LickTarget = 'cone' | `cone:${string}` | `scoop:${string}`;\n\nexport type Lick = {\n  id: string;\n  channel: LickChannel;\n  source: string;\n  title: string;\n  text: string;\n  body?: string;\n  count: number;\n  at: number;\n  actions?: LickAction[];\n  severity?: LickSeverity;\n};\n\nconst ENTITIES: Record<string, string> = {\n  '&': '&amp;',\n  '<': '&lt;',\n  '>': '&gt;',\n  '\"': '&quot;',\n  '\\n': '&#10;',\n  '\\r': '&#13;',\n};\n\nconst DECODE: Record<string, string> = Object.fromEntries(\n  Object.entries(ENTITIES).map(([raw, entity]) => [entity, raw])\n);\n\nexport function escapeText(value: string): string {\n  return value.replace(/[&<>]/g, (char) => ENTITIES[char] as string).replace(/\\r/g, '&#13;');\n}\n\nexport function escapeAttribute(value: string): string {\n  return value.replace(/[&<>\"\\n\\r]/g, (char) => ENTITIES[char] as string);\n}\n\nexport function unescape(value: string): string {\n  return value.replace(/&(?:amp|lt|gt|quot|#10|#13);/g, (entity) => DECODE[entity] as string);\n}\n\nexport function lickId(): string {\n  return `lk-${Date.now().toString(36)}-${crypto.randomUUID().slice(0, 8)}`;\n}\n\nfunction oneLine(value: string): string {\n  return value.replace(/\\s+/g, ' ').trim();\n}\n\nexport function formatLick(lick: Lick): string {\n  const attributes: [string, string][] = [\n    ['id', lick.id],\n    ['channel', lick.channel],\n    ['source', lick.source],\n    ['title', oneLine(lick.title)],\n    ['count', String(lick.count)],\n    ['at', new Date(lick.at).toISOString()],\n  ];\n  if (lick.actions?.length) attributes.push(['actions', lick.actions.join(' ')]);\n  if (lick.severity) attributes.push(['severity', lick.severity]);\n  const head = attributes.map(([name, value]) => `${name}=\"${escapeAttribute(value)}\"`).join(' ');\n  const lines = [escapeText(oneLine(lick.text))];\n  if (lick.body) lines.push(escapeText(lick.body));\n  return `<lick ${head}>\\n${lines.join('\\n')}\\n</lick>`;\n}\n\nconst LICK = /^<lick ((?:[a-z]+=\"[^\"<>\\n]*\" ?)+)>\\n([^\\n]*)(?:\\n([\\s\\S]*?))?\\n<\\/lick>$/;\nconst ATTRIBUTE = /([a-z]+)=\"([^\"]*)\"/g;\n\nfunction isChannel(value: string | undefined): value is LickChannel {\n  return (LICK_CHANNELS as readonly string[]).includes(value ?? '');\n}\n\nfunction severityOf(value: string | undefined): { severity?: LickSeverity } {\n  return value === 'warn' || value === 'error' ? { severity: value } : {};\n}\n\nexport function parseLick(text: string): Lick | undefined {\n  const match = LICK.exec(text);\n  if (!match) return undefined;\n  const attributes = new Map<string, string>();\n  for (const [, name, value] of (match[1] as string).matchAll(ATTRIBUTE))\n    attributes.set(name as string, unescape(value as string));\n  const channel = attributes.get('channel');\n  const id = attributes.get('id');\n  if (!id || !isChannel(channel)) return undefined;\n  const at = Date.parse(attributes.get('at') ?? '');\n  const count = Number(attributes.get('count'));\n  const actions = (attributes.get('actions') ?? '')\n    .split(' ')\n    .filter((action): action is LickAction => action === 'confirm' || action === 'dismiss');\n  const body = match[3] === undefined ? undefined : unescape(match[3]);\n  return {\n    id,\n    channel,\n    source: attributes.get('source') ?? '',\n    title: attributes.get('title') ?? '',\n    text: unescape(match[2] as string),\n    ...(body ? { body } : {}),\n    count: Number.isSafeInteger(count) && count > 0 ? count : 1,\n    at: Number.isNaN(at) ? 0 : at,\n    ...(actions.length ? { actions } : {}),\n    ...severityOf(attributes.get('severity')),\n  };\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/licks/licks.js

@@ -111,7 +111,7 @@ function createLicks(host) {
     if (!queue?.pending) return;
     const lick = render(queue.pending);
     const target = key.split("|")[0];
-    const conversation = await resolve(target, context);
+    const conversation = await resolve(target, queue.pending.lick.channel, context);
     const submission = await conversation.submit(
       {
         type: "input",
@@ -175,6 +175,17 @@ function createLicks(host) {
     handle(channel, handler) {
       handlers.set(channel, handler);
     },
+    forget(target, channel, source, context) {
+      return serial(async () => {
+        const { harness } = await host;
+        const key = `${target}|${channel}|${source}`;
+        await harness.commit(async (tx) => {
+          const doc = await tx.doc(LicksOutbox);
+          const queue = doc.queues[key];
+          if (queue?.pending) queue.pending = null;
+        }, context);
+      });
+    },
     async pending(context) {
       const { harness } = await host;
       const queues = (await harness.snapshot(LicksOutbox, context))?.queues ?? {};

package/dist/licks/licks.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/licks/licks.ts"],
-  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport {\n  type Conversation,\n  defineDoc,\n  type Harness,\n  type SubmissionId,\n} from '@earendil-works/pi-durable';\nimport {\n  formatLick,\n  type Lick,\n  type LickAction,\n  type LickChannel,\n  type LickSeverity,\n  type LickTarget,\n  lickId,\n} from './lick.ts';\nimport { entryLick, LICK_STATE_KIND, type LickDecision, lickDecisions } from './state.ts';\n\nexport interface LickEvent {\n  channel: LickChannel;\n  source: string;\n  title: string;\n  text: string;\n  body?: string;\n  items?: string[];\n  count?: number;\n  target: LickTarget;\n  coalesce?: boolean;\n  severity?: LickSeverity;\n  eventId?: string;\n  at?: number;\n}\n\ntype Pending = {\n  lick: Lick;\n  items: string[];\n  body: string | null;\n};\n\ntype Queue = {\n  submission: number | null;\n  pending: Pending | null;\n};\n\ntype OutboxState = {\n  queues: Record<string, Queue>;\n  events: Record<string, string[]>;\n};\n\nexport const LicksOutbox = defineDoc<OutboxState>({\n  kind: 'slicc.licks',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ queues: {}, events: {} }),\n});\n\nexport interface LickHandler {\n  confirm?(lick: Lick, reason: string | undefined, context: Context): Promise<string | undefined>;\n  dismiss?(lick: Lick, reason: string | undefined, context: Context): Promise<string | undefined>;\n}\n\nexport interface LickFound {\n  lick: Lick;\n  decision: LickDecision | undefined;\n}\n\nexport interface Licks {\n  deliver(event: LickEvent, context: Context): Promise<void>;\n  flush(context: Context): Promise<void>;\n  find(conversation: Conversation, id: string, context: Context): Promise<LickFound | undefined>;\n  decide(\n    conversation: Conversation,\n    id: string,\n    action: LickAction,\n    reason: string | undefined,\n    context: Context\n  ): Promise<string>;\n  handle(channel: LickChannel, handler: LickHandler): void;\n  pending(context: Context): Promise<number>;\n}\n\nexport interface LicksHost {\n  harness: Harness;\n  resolve(target: LickTarget, context: Context): Promise<Conversation>;\n}\n\nexport const MAX_ITEMS = 50;\nexport const MAX_EVENTS = 64;\n\nexport function render(pending: Pending): Lick {\n  const shown = pending.items.slice(0, MAX_ITEMS);\n  const more = pending.items.length - shown.length;\n  const lines = [\n    ...(pending.body ? [pending.body] : []),\n    ...shown,\n    ...(more > 0 ? [`\u2026 and ${more} more`] : []),\n  ];\n  const { body: _, ...lick } = pending.lick;\n  return lines.length ? { ...lick, body: lines.join('\\n') } : lick;\n}\n\nconst RANK: Record<LickSeverity, number> = { warn: 1, error: 2 };\n\nexport function strongest(\n  a: LickSeverity | undefined,\n  b: LickSeverity | undefined\n): LickSeverity | undefined {\n  if (!a) return b;\n  if (!b) return a;\n  return RANK[b] > RANK[a] ? b : a;\n}\n\nfunction merge(pending: Pending, event: LickEvent, now: number): Pending {\n  const items = [...pending.items];\n  for (const item of event.items ?? []) if (!items.includes(item)) items.push(item);\n  const { severity: _, ...lick } = pending.lick;\n  const severity = strongest(pending.lick.severity, event.severity);\n  return {\n    lick: {\n      ...lick,\n      title: event.title,\n      text: event.text,\n      count: pending.lick.count + (event.count ?? 1),\n      at: event.at ?? now,\n      ...(severity ? { severity } : {}),\n    },\n    items,\n    body: event.body ?? pending.body,\n  };\n}\n\nfunction fresh(event: LickEvent, now: number, listed: LickAction[] | undefined): Pending {\n  return {\n    lick: {\n      id: lickId(),\n      channel: event.channel,\n      source: event.source,\n      title: event.title,\n      text: event.text,\n      count: event.count ?? 1,\n      at: now,\n      ...(listed ? { actions: listed } : {}),\n      ...(event.severity ? { severity: event.severity } : {}),\n    },\n    items: [...new Set(event.items ?? [])],\n    body: event.body ?? null,\n  };\n}\n\nfunction keyOf(event: LickEvent): string {\n  const base = `${event.target}|${event.channel}|${event.source}`;\n  return event.coalesce === false ? `${base}|${event.eventId ?? lickId()}` : base;\n}\n\nexport function createLicks(host: Promise<LicksHost>): Licks {\n  const handlers = new Map<LickChannel, LickHandler>();\n  let lock: Promise<unknown> = Promise.resolve();\n  const serial = <T>(operation: () => Promise<T>): Promise<T> => {\n    const run = lock.then(operation, operation);\n    lock = run.catch(() => undefined);\n    return run;\n  };\n\n  const actions = (channel: LickChannel): LickAction[] | undefined => {\n    const handler = handlers.get(channel);\n    const list: LickAction[] = [];\n    if (handler?.confirm) list.push('confirm');\n    if (handler?.dismiss) list.push('dismiss');\n    return list.length ? list : undefined;\n  };\n\n  async function previous(\n    harness: Harness,\n    id: number | null,\n    context: Context\n  ): Promise<'queued' | 'withdrawn' | 'gone'> {\n    if (id === null) return 'gone';\n    const submission = await harness.submission(id as SubmissionId, context);\n    const record = await submission?.status(context);\n    if (record?.status === 'queued') return 'queued';\n    return record?.status === 'unanswered' && record.reason === 'aborted' ? 'withdrawn' : 'gone';\n  }\n\n  async function settled(key: string, context: Context): Promise<Queue | undefined> {\n    const { harness } = await host;\n    const queue = (await harness.snapshot(LicksOutbox, context))?.queues[key];\n    if (!queue) return undefined;\n    const before = await previous(harness, queue.submission, context);\n    if (before === 'queued') return undefined;\n    if (queue.pending && before === 'gone') return queue;\n    await harness.commit(async (tx) => {\n      const doc = await tx.doc(LicksOutbox);\n      if (doc.queues[key]?.submission === queue.submission) delete doc.queues[key];\n    }, context);\n    return undefined;\n  }\n\n  async function flushKey(key: string, context: Context): Promise<void> {\n    const { harness, resolve } = await host;\n    const queue = await settled(key, context);\n    if (!queue?.pending) return;\n    const lick = render(queue.pending);\n    const target = key.split('|')[0] as LickTarget;\n    const conversation = await resolve(target, context);\n    const submission = await conversation.submit(\n      {\n        type: 'input',\n        content: formatLick(lick),\n        whenBusy: 'steer',\n        requestId: `lick:${lick.id}`,\n      },\n      context\n    );\n    await harness.commit(async (tx) => {\n      const doc = await tx.doc(LicksOutbox);\n      doc.queues[key] = { submission: submission.id, pending: null };\n    }, context);\n  }\n\n  async function flushAll(context: Context): Promise<void> {\n    const { harness } = await host;\n    const keys = Object.keys((await harness.snapshot(LicksOutbox, context))?.queues ?? {});\n    for (const key of keys) await flushKey(key, context);\n  }\n\n  async function find(\n    conversation: Conversation,\n    id: string,\n    context: Context\n  ): Promise<LickFound | undefined> {\n    const { entries } = await conversation.context(context);\n    const lick = entries.map(entryLick).find((candidate) => candidate?.id === id);\n    if (!lick) return undefined;\n    return { lick, decision: lickDecisions(entries).get(id) };\n  }\n\n  return {\n    deliver(event, context) {\n      return serial(async () => {\n        const { harness } = await host;\n        const key = keyOf(event);\n        await settled(key, context);\n        const stream = `${event.channel}|${event.source}`;\n        const now = event.at ?? Date.now();\n        const accepted = await harness.commit(async (tx) => {\n          const doc = await tx.doc(LicksOutbox);\n          const seen = doc.events[stream] ?? [];\n          if (event.eventId !== undefined) {\n            if (seen.includes(event.eventId)) return false;\n            doc.events[stream] = [...seen, event.eventId].slice(-MAX_EVENTS);\n          }\n          const queue = doc.queues[key] ?? { submission: null, pending: null };\n          queue.pending = queue.pending\n            ? merge(queue.pending, event, now)\n            : fresh(event, now, actions(event.channel));\n          doc.queues[key] = queue;\n          return true;\n        }, context);\n        if (accepted) await flushKey(key, context);\n      });\n    },\n    flush: (context) => serial(() => flushAll(context)),\n    find,\n    async decide(conversation, id, action, reason, context) {\n      const found = await find(conversation, id, context);\n      if (!found) throw new Error(`There is no lick ${id} in this conversation.`);\n      if (found.decision) throw new Error(`Lick ${id} is already ${found.decision}.`);\n      if (!found.lick.actions?.includes(action))\n        throw new Error(`Lick ${id} (${found.lick.channel}) has no ${action} action.`);\n      const run = handlers.get(found.lick.channel)?.[action];\n      if (!run) throw new Error(`Lick ${id} (${found.lick.channel}) has no ${action} action.`);\n      return (await run(found.lick, reason, context)) ?? `Lick ${id} ${action}ed.`;\n    },\n    handle(channel, handler) {\n      handlers.set(channel, handler);\n    },\n    async pending(context) {\n      const { harness } = await host;\n      const queues = (await harness.snapshot(LicksOutbox, context))?.queues ?? {};\n      return Object.values(queues).filter((queue) => queue.submission !== null || queue.pending)\n        .length;\n    },\n  };\n}\n\nexport { LICK_STATE_KIND };\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport {\n  type Conversation,\n  defineDoc,\n  type Harness,\n  type SubmissionId,\n} from '@earendil-works/pi-durable';\nimport {\n  formatLick,\n  type Lick,\n  type LickAction,\n  type LickChannel,\n  type LickSeverity,\n  type LickTarget,\n  lickId,\n} from './lick.ts';\nimport { entryLick, LICK_STATE_KIND, type LickDecision, lickDecisions } from './state.ts';\n\nexport interface LickEvent {\n  channel: LickChannel;\n  source: string;\n  title: string;\n  text: string;\n  body?: string;\n  items?: string[];\n  count?: number;\n  target: LickTarget;\n  coalesce?: boolean;\n  severity?: LickSeverity;\n  eventId?: string;\n  at?: number;\n}\n\ntype Pending = {\n  lick: Lick;\n  items: string[];\n  body: string | null;\n};\n\ntype Queue = {\n  submission: number | null;\n  pending: Pending | null;\n};\n\ntype OutboxState = {\n  queues: Record<string, Queue>;\n  events: Record<string, string[]>;\n};\n\nexport const LicksOutbox = defineDoc<OutboxState>({\n  kind: 'slicc.licks',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ queues: {}, events: {} }),\n});\n\nexport interface LickHandler {\n  confirm?(lick: Lick, reason: string | undefined, context: Context): Promise<string | undefined>;\n  dismiss?(lick: Lick, reason: string | undefined, context: Context): Promise<string | undefined>;\n}\n\nexport interface LickFound {\n  lick: Lick;\n  decision: LickDecision | undefined;\n}\n\nexport interface Licks {\n  deliver(event: LickEvent, context: Context): Promise<void>;\n  flush(context: Context): Promise<void>;\n  find(conversation: Conversation, id: string, context: Context): Promise<LickFound | undefined>;\n  decide(\n    conversation: Conversation,\n    id: string,\n    action: LickAction,\n    reason: string | undefined,\n    context: Context\n  ): Promise<string>;\n  handle(channel: LickChannel, handler: LickHandler): void;\n  pending(context: Context): Promise<number>;\n  forget(target: LickTarget, channel: LickChannel, source: string, context: Context): Promise<void>;\n}\n\nexport interface LicksHost {\n  harness: Harness;\n  resolve(target: LickTarget, channel: LickChannel, context: Context): Promise<Conversation>;\n}\n\nexport const MAX_ITEMS = 50;\nexport const MAX_EVENTS = 64;\n\nexport function render(pending: Pending): Lick {\n  const shown = pending.items.slice(0, MAX_ITEMS);\n  const more = pending.items.length - shown.length;\n  const lines = [\n    ...(pending.body ? [pending.body] : []),\n    ...shown,\n    ...(more > 0 ? [`\u2026 and ${more} more`] : []),\n  ];\n  const { body: _, ...lick } = pending.lick;\n  return lines.length ? { ...lick, body: lines.join('\\n') } : lick;\n}\n\nconst RANK: Record<LickSeverity, number> = { warn: 1, error: 2 };\n\nexport function strongest(\n  a: LickSeverity | undefined,\n  b: LickSeverity | undefined\n): LickSeverity | undefined {\n  if (!a) return b;\n  if (!b) return a;\n  return RANK[b] > RANK[a] ? b : a;\n}\n\nfunction merge(pending: Pending, event: LickEvent, now: number): Pending {\n  const items = [...pending.items];\n  for (const item of event.items ?? []) if (!items.includes(item)) items.push(item);\n  const { severity: _, ...lick } = pending.lick;\n  const severity = strongest(pending.lick.severity, event.severity);\n  return {\n    lick: {\n      ...lick,\n      title: event.title,\n      text: event.text,\n      count: pending.lick.count + (event.count ?? 1),\n      at: event.at ?? now,\n      ...(severity ? { severity } : {}),\n    },\n    items,\n    body: event.body ?? pending.body,\n  };\n}\n\nfunction fresh(event: LickEvent, now: number, listed: LickAction[] | undefined): Pending {\n  return {\n    lick: {\n      id: lickId(),\n      channel: event.channel,\n      source: event.source,\n      title: event.title,\n      text: event.text,\n      count: event.count ?? 1,\n      at: now,\n      ...(listed ? { actions: listed } : {}),\n      ...(event.severity ? { severity: event.severity } : {}),\n    },\n    items: [...new Set(event.items ?? [])],\n    body: event.body ?? null,\n  };\n}\n\nfunction keyOf(event: LickEvent): string {\n  const base = `${event.target}|${event.channel}|${event.source}`;\n  return event.coalesce === false ? `${base}|${event.eventId ?? lickId()}` : base;\n}\n\nexport function createLicks(host: Promise<LicksHost>): Licks {\n  const handlers = new Map<LickChannel, LickHandler>();\n  let lock: Promise<unknown> = Promise.resolve();\n  const serial = <T>(operation: () => Promise<T>): Promise<T> => {\n    const run = lock.then(operation, operation);\n    lock = run.catch(() => undefined);\n    return run;\n  };\n\n  const actions = (channel: LickChannel): LickAction[] | undefined => {\n    const handler = handlers.get(channel);\n    const list: LickAction[] = [];\n    if (handler?.confirm) list.push('confirm');\n    if (handler?.dismiss) list.push('dismiss');\n    return list.length ? list : undefined;\n  };\n\n  async function previous(\n    harness: Harness,\n    id: number | null,\n    context: Context\n  ): Promise<'queued' | 'withdrawn' | 'gone'> {\n    if (id === null) return 'gone';\n    const submission = await harness.submission(id as SubmissionId, context);\n    const record = await submission?.status(context);\n    if (record?.status === 'queued') return 'queued';\n    return record?.status === 'unanswered' && record.reason === 'aborted' ? 'withdrawn' : 'gone';\n  }\n\n  async function settled(key: string, context: Context): Promise<Queue | undefined> {\n    const { harness } = await host;\n    const queue = (await harness.snapshot(LicksOutbox, context))?.queues[key];\n    if (!queue) return undefined;\n    const before = await previous(harness, queue.submission, context);\n    if (before === 'queued') return undefined;\n    if (queue.pending && before === 'gone') return queue;\n    await harness.commit(async (tx) => {\n      const doc = await tx.doc(LicksOutbox);\n      if (doc.queues[key]?.submission === queue.submission) delete doc.queues[key];\n    }, context);\n    return undefined;\n  }\n\n  async function flushKey(key: string, context: Context): Promise<void> {\n    const { harness, resolve } = await host;\n    const queue = await settled(key, context);\n    if (!queue?.pending) return;\n    const lick = render(queue.pending);\n    const target = key.split('|')[0] as LickTarget;\n    const conversation = await resolve(target, queue.pending.lick.channel, context);\n    const submission = await conversation.submit(\n      {\n        type: 'input',\n        content: formatLick(lick),\n        whenBusy: 'steer',\n        requestId: `lick:${lick.id}`,\n      },\n      context\n    );\n    await harness.commit(async (tx) => {\n      const doc = await tx.doc(LicksOutbox);\n      doc.queues[key] = { submission: submission.id, pending: null };\n    }, context);\n  }\n\n  async function flushAll(context: Context): Promise<void> {\n    const { harness } = await host;\n    const keys = Object.keys((await harness.snapshot(LicksOutbox, context))?.queues ?? {});\n    for (const key of keys) await flushKey(key, context);\n  }\n\n  async function find(\n    conversation: Conversation,\n    id: string,\n    context: Context\n  ): Promise<LickFound | undefined> {\n    const { entries } = await conversation.context(context);\n    const lick = entries.map(entryLick).find((candidate) => candidate?.id === id);\n    if (!lick) return undefined;\n    return { lick, decision: lickDecisions(entries).get(id) };\n  }\n\n  return {\n    deliver(event, context) {\n      return serial(async () => {\n        const { harness } = await host;\n        const key = keyOf(event);\n        await settled(key, context);\n        const stream = `${event.channel}|${event.source}`;\n        const now = event.at ?? Date.now();\n        const accepted = await harness.commit(async (tx) => {\n          const doc = await tx.doc(LicksOutbox);\n          const seen = doc.events[stream] ?? [];\n          if (event.eventId !== undefined) {\n            if (seen.includes(event.eventId)) return false;\n            doc.events[stream] = [...seen, event.eventId].slice(-MAX_EVENTS);\n          }\n          const queue = doc.queues[key] ?? { submission: null, pending: null };\n          queue.pending = queue.pending\n            ? merge(queue.pending, event, now)\n            : fresh(event, now, actions(event.channel));\n          doc.queues[key] = queue;\n          return true;\n        }, context);\n        if (accepted) await flushKey(key, context);\n      });\n    },\n    flush: (context) => serial(() => flushAll(context)),\n    find,\n    async decide(conversation, id, action, reason, context) {\n      const found = await find(conversation, id, context);\n      if (!found) throw new Error(`There is no lick ${id} in this conversation.`);\n      if (found.decision) throw new Error(`Lick ${id} is already ${found.decision}.`);\n      if (!found.lick.actions?.includes(action))\n        throw new Error(`Lick ${id} (${found.lick.channel}) has no ${action} action.`);\n      const run = handlers.get(found.lick.channel)?.[action];\n      if (!run) throw new Error(`Lick ${id} (${found.lick.channel}) has no ${action} action.`);\n      return (await run(found.lick, reason, context)) ?? `Lick ${id} ${action}ed.`;\n    },\n    handle(channel, handler) {\n      handlers.set(channel, handler);\n    },\n    forget(target, channel, source, context) {\n      return serial(async () => {\n        const { harness } = await host;\n        const key = `${target}|${channel}|${source}`;\n        await harness.commit(async (tx) => {\n          const doc = await tx.doc(LicksOutbox);\n          const queue = doc.queues[key];\n          if (queue?.pending) queue.pending = null;\n        }, context);\n      });\n    },\n    async pending(context) {\n      const { harness } = await host;\n      const queues = (await harness.snapshot(LicksOutbox, context))?.queues ?? {};\n      return Object.values(queues).filter((queue) => queue.submission !== null || queue.pending)\n        .length;\n    },\n  };\n}\n\nexport { LICK_STATE_KIND };\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/main.js

@@ -6,10 +6,13 @@ import { openAgent } from "./agent.js";
 import { EncryptedCredentialStore } from "./credentials.js";
 import { hostAgent } from "./host.js";
 import { createActivity } from "./kernel/activity.js";
-import { HOME, kernelEnvironment } from "./kernel/env.js";
+import { HOME, kernelEnvironment, SliccKernelEnv } from "./kernel/env.js";
+import { processGroups } from "./kernel/groups.js";
 import { setupLicks } from "./licks/index.js";
 import { transportFetch } from "./net.js";
 import { sliccPrompt } from "./prompt.js";
+import { identity } from "./scoops/identity.js";
+import { setupScoops } from "./scoops/index.js";
 import {
   createAgentSettings,
   createSliccModels,
@@ -36,30 +39,55 @@ async function start(scope, port, options) {
   registry.install(CodingTools);
   registry.install(sliccPrompt(facts));
   const licks = setupLicks(registry);
+  const scoops = setupScoops(registry, licks.licks, CodingTools.tools);
   const activity = createActivity();
-  const environment = kernelEnvironment(client, { activity });
+  const groups = processGroups(client);
+  const model = options.model ?? DEFAULT_MODEL;
+  let opened;
+  const environment = kernelEnvironment(client, {
+    activity,
+    groups,
+    identify: identity(() => opened?.agents, model)
+  });
   const agent = await openAgent({
     models,
-    model: options.model ?? DEFAULT_MODEL,
+    model,
     storage: await (options.storage ?? (() => openOpfsSqliteStorage()))(),
     registry,
     env: environment
   });
-  const sources = licks.attach(agent, {
-    env: kernelEnvironment(client)({ cwd: HOME }),
-    home: HOME,
-    activity
-  });
+  opened = agent;
+  const home = new SliccKernelEnv(client, { cwd: HOME });
+  const sources = licks.attach(agent, { env: home, home: HOME, activity });
   await sources.start(BACKGROUND_CONTEXT);
   await sources.boot(
     { version: facts.version, boot: await kernelBoot(client) },
     BACKGROUND_CONTEXT
   );
+  const runtime = await scoops.attach(
+    {
+      harness: agent.harness,
+      agents: agent.agents,
+      groups,
+      env: home,
+      home: HOME,
+      alive: alive(client),
+      ...options.assets ? { assets: options.assets } : {}
+    },
+    BACKGROUND_CONTEXT
+  );
   return hostAgent(agent, {
     settings: await createAgentSettings(models, credentials, providers),
-    licks: { licks: licks.licks, sources }
+    licks: { licks: licks.licks, sources },
+    scoops: { scoops: scoops.scoops, runtime }
   });
 }
+function alive(client) {
+  return async (pid) => {
+    if (!client.ps) return true;
+    return (await client.ps()).some((process) => process.pid === pid);
+  };
+}
 function runAgentWorker(scope, options = {}) {
   const host = start(scope, kernelPort(scope), options);
   host.catch(() => void 0);
@@ -67,6 +95,7 @@ function runAgentWorker(scope, options = {}) {
   return host;
 }
 export {
+  alive,
   runAgentWorker
 };
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts"],
-  "sourcesContent": ["import { attachKernel } from '@ai-ecoverse/slicc-kernel';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { CredentialStore, Provider } from '@earendil-works/pi-ai';\nimport { createRegistry, type ModelRef, type Storage } from '@earendil-works/pi-durable';\nimport { CodingTools } from '@earendil-works/pi-durable/tools';\nimport { openAgent } from './agent.ts';\nimport { EncryptedCredentialStore } from './credentials.ts';\nimport { type AgentHost, hostAgent } from './host.ts';\nimport { createActivity } from './kernel/activity.ts';\nimport type { KernelClient } from './kernel/client.ts';\nimport { HOME, kernelEnvironment } from './kernel/env.ts';\nimport { setupLicks } from './licks/index.ts';\nimport { type Transport, transportFetch } from './net.ts';\nimport { sliccPrompt } from './prompt.ts';\nimport {\n  createAgentSettings,\n  createSliccModels,\n  DEFAULT_MODEL,\n  sliccProviders,\n} from './settings.ts';\nimport { openOpfsSqliteStorage } from './sqlite.ts';\nimport { agentVersion, commandsOnPath, kernelBoot, transportName } from './system.ts';\nimport { kernelPort, serveConnections, type WorkerScope } from './worker.ts';\n\nexport interface AgentWorkerScope extends WorkerScope {\n  fetch: typeof fetch;\n  location: { origin: string };\n}\n\nexport type KernelAttach = (port: MessagePort) => Promise<KernelClient & { transport: Transport }>;\n\nexport interface AgentWorkerOptions {\n  model?: ModelRef;\n  providers?: Provider[];\n  attach?: KernelAttach;\n  credentials?: () => Promise<CredentialStore>;\n  storage?: () => Promise<Storage>;\n}\n\nasync function start(\n  scope: AgentWorkerScope,\n  port: Promise<MessagePort>,\n  options: AgentWorkerOptions\n): Promise<AgentHost> {\n  const attach: KernelAttach = options.attach ?? attachKernel;\n  const client = await attach(await port);\n  const native = scope.fetch.bind(scope);\n  scope.fetch = transportFetch(client.transport, scope.location.origin, native);\n  const facts = {\n    version: await agentVersion((url) => native(url)),\n    commands: await commandsOnPath(client),\n    transport: transportName(client.transport),\n  };\n  const credentials = await (options.credentials ?? (() => EncryptedCredentialStore.open()))();\n  const providers = options.providers ?? sliccProviders();\n  const models = createSliccModels(credentials, providers);\n  const registry = createRegistry();\n  registry.install(CodingTools);\n  registry.install(sliccPrompt(facts));\n  const licks = setupLicks(registry);\n  const activity = createActivity();\n  const environment = kernelEnvironment(client, { activity });\n  const agent = await openAgent({\n    models,\n    model: options.model ?? DEFAULT_MODEL,\n    storage: await (options.storage ?? (() => openOpfsSqliteStorage()))(),\n    registry,\n    env: environment,\n  });\n  const sources = licks.attach(agent, {\n    env: kernelEnvironment(client)({ cwd: HOME }),\n    home: HOME,\n    activity,\n  });\n  await sources.start(BACKGROUND_CONTEXT);\n  await sources.boot(\n    { version: facts.version, boot: await kernelBoot(client) },\n    BACKGROUND_CONTEXT\n  );\n  return hostAgent(agent, {\n    settings: await createAgentSettings(models, credentials, providers),\n    licks: { licks: licks.licks, sources },\n  });\n}\n\nexport function runAgentWorker(\n  scope: AgentWorkerScope,\n  options: AgentWorkerOptions = {}\n): Promise<AgentHost> {\n  const host = start(scope, kernelPort(scope), options);\n  host.catch(() => undefined);\n  serveConnections(scope, host);\n  return host;\n}\n"],
-  "mappings": "AAAA,SAAS,oBAAoB;AAC7B,SAAS,0BAA0B;AAEnC,SAAS,sBAAmD;AAC5D,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB;AAC1B,SAAS,gCAAgC;AACzC,SAAyB,iBAAiB;AAC1C,SAAS,sBAAsB;AAE/B,SAAS,MAAM,yBAAyB;AACxC,SAAS,kBAAkB;AAC3B,SAAyB,sBAAsB;AAC/C,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,6BAA6B;AACtC,SAAS,cAAc,gBAAgB,YAAY,qBAAqB;AACxE,SAAS,YAAY,wBAA0C;AAiB/D,eAAe,MACb,OACA,MACA,SACoB;AACpB,QAAM,SAAuB,QAAQ,UAAU;AAC/C,QAAM,SAAS,MAAM,OAAO,MAAM,IAAI;AACtC,QAAM,SAAS,MAAM,MAAM,KAAK,KAAK;AACrC,QAAM,QAAQ,eAAe,OAAO,WAAW,MAAM,SAAS,QAAQ,MAAM;AAC5E,QAAM,QAAQ;AAAA,IACZ,SAAS,MAAM,aAAa,CAAC,QAAQ,OAAO,GAAG,CAAC;AAAA,IAChD,UAAU,MAAM,eAAe,MAAM;AAAA,IACrC,WAAW,cAAc,OAAO,SAAS;AAAA,EAC3C;AACA,QAAM,cAAc,OAAO,QAAQ,gBAAgB,MAAM,yBAAyB,KAAK,IAAI;AAC3F,QAAM,YAAY,QAAQ,aAAa,eAAe;AACtD,QAAM,SAAS,kBAAkB,aAAa,SAAS;AACvD,QAAM,WAAW,eAAe;AAChC,WAAS,QAAQ,WAAW;AAC5B,WAAS,QAAQ,YAAY,KAAK,CAAC;AACnC,QAAM,QAAQ,WAAW,QAAQ;AACjC,QAAM,WAAW,eAAe;AAChC,QAAM,cAAc,kBAAkB,QAAQ,EAAE,SAAS,CAAC;AAC1D,QAAM,QAAQ,MAAM,UAAU;AAAA,IAC5B;AAAA,IACA,OAAO,QAAQ,SAAS;AAAA,IACxB,SAAS,OAAO,QAAQ,YAAY,MAAM,sBAAsB,IAAI;AAAA,IACpE;AAAA,IACA,KAAK;AAAA,EACP,CAAC;AACD,QAAM,UAAU,MAAM,OAAO,OAAO;AAAA,IAClC,KAAK,kBAAkB,MAAM,EAAE,EAAE,KAAK,KAAK,CAAC;AAAA,IAC5C,MAAM;AAAA,IACN;AAAA,EACF,CAAC;AACD,QAAM,QAAQ,MAAM,kBAAkB;AACtC,QAAM,QAAQ;AAAA,IACZ,EAAE,SAAS,MAAM,SAAS,MAAM,MAAM,WAAW,MAAM,EAAE;AAAA,IACzD;AAAA,EACF;AACA,SAAO,UAAU,OAAO;AAAA,IACtB,UAAU,MAAM,oBAAoB,QAAQ,aAAa,SAAS;AAAA,IAClE,OAAO,EAAE,OAAO,MAAM,OAAO,QAAQ;AAAA,EACvC,CAAC;AACH;AAEO,SAAS,eACd,OACA,UAA8B,CAAC,GACX;AACpB,QAAM,OAAO,MAAM,OAAO,WAAW,KAAK,GAAG,OAAO;AACpD,OAAK,MAAM,MAAM,MAAS;AAC1B,mBAAiB,OAAO,IAAI;AAC5B,SAAO;AACT;",
+  "sourcesContent": ["import { attachKernel } from '@ai-ecoverse/slicc-kernel';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { CredentialStore, Provider } from '@earendil-works/pi-ai';\nimport { createRegistry, type ModelRef, type Storage } from '@earendil-works/pi-durable';\nimport { CodingTools } from '@earendil-works/pi-durable/tools';\nimport { type Agent, openAgent } from './agent.ts';\nimport { EncryptedCredentialStore } from './credentials.ts';\nimport { type AgentHost, hostAgent } from './host.ts';\nimport { createActivity } from './kernel/activity.ts';\nimport type { KernelClient } from './kernel/client.ts';\nimport { HOME, kernelEnvironment, SliccKernelEnv } from './kernel/env.ts';\nimport { processGroups } from './kernel/groups.ts';\nimport { setupLicks } from './licks/index.ts';\nimport { type Transport, transportFetch } from './net.ts';\nimport { sliccPrompt } from './prompt.ts';\nimport { identity } from './scoops/identity.ts';\nimport { type Assets, setupScoops } from './scoops/index.ts';\nimport {\n  createAgentSettings,\n  createSliccModels,\n  DEFAULT_MODEL,\n  sliccProviders,\n} from './settings.ts';\nimport { openOpfsSqliteStorage } from './sqlite.ts';\nimport { agentVersion, commandsOnPath, kernelBoot, transportName } from './system.ts';\nimport { kernelPort, serveConnections, type WorkerScope } from './worker.ts';\n\nexport interface AgentWorkerScope extends WorkerScope {\n  fetch: typeof fetch;\n  location: { origin: string };\n}\n\nexport type KernelAttach = (port: MessagePort) => Promise<KernelClient & { transport: Transport }>;\n\nexport interface AgentWorkerOptions {\n  model?: ModelRef;\n  providers?: Provider[];\n  attach?: KernelAttach;\n  credentials?: () => Promise<CredentialStore>;\n  storage?: () => Promise<Storage>;\n  assets?: Assets;\n}\n\nasync function start(\n  scope: AgentWorkerScope,\n  port: Promise<MessagePort>,\n  options: AgentWorkerOptions\n): Promise<AgentHost> {\n  const attach: KernelAttach = options.attach ?? attachKernel;\n  const client = await attach(await port);\n  const native = scope.fetch.bind(scope);\n  scope.fetch = transportFetch(client.transport, scope.location.origin, native);\n  const facts = {\n    version: await agentVersion((url) => native(url)),\n    commands: await commandsOnPath(client),\n    transport: transportName(client.transport),\n  };\n  const credentials = await (options.credentials ?? (() => EncryptedCredentialStore.open()))();\n  const providers = options.providers ?? sliccProviders();\n  const models = createSliccModels(credentials, providers);\n  const registry = createRegistry();\n  registry.install(CodingTools);\n  registry.install(sliccPrompt(facts));\n  const licks = setupLicks(registry);\n  const scoops = setupScoops(registry, licks.licks, CodingTools.tools);\n  const activity = createActivity();\n  const groups = processGroups(client);\n  const model = options.model ?? DEFAULT_MODEL;\n  let opened: Agent | undefined;\n  const environment = kernelEnvironment(client, {\n    activity,\n    groups,\n    identify: identity(() => opened?.agents, model),\n  });\n  const agent = await openAgent({\n    models,\n    model,\n    storage: await (options.storage ?? (() => openOpfsSqliteStorage()))(),\n    registry,\n    env: environment,\n  });\n  opened = agent;\n  const home = new SliccKernelEnv(client, { cwd: HOME });\n  const sources = licks.attach(agent, { env: home, home: HOME, activity });\n  await sources.start(BACKGROUND_CONTEXT);\n  await sources.boot(\n    { version: facts.version, boot: await kernelBoot(client) },\n    BACKGROUND_CONTEXT\n  );\n  const runtime = await scoops.attach(\n    {\n      harness: agent.harness,\n      agents: agent.agents,\n      groups,\n      env: home,\n      home: HOME,\n      alive: alive(client),\n      ...(options.assets ? { assets: options.assets } : {}),\n    },\n    BACKGROUND_CONTEXT\n  );\n  return hostAgent(agent, {\n    settings: await createAgentSettings(models, credentials, providers),\n    licks: { licks: licks.licks, sources },\n    scoops: { scoops: scoops.scoops, runtime },\n  });\n}\n\nexport function alive(client: KernelClient) {\n  return async (pid: number): Promise<boolean> => {\n    if (!client.ps) return true;\n    return (await client.ps()).some((process) => process.pid === pid);\n  };\n}\n\nexport function runAgentWorker(\n  scope: AgentWorkerScope,\n  options: AgentWorkerOptions = {}\n): Promise<AgentHost> {\n  const host = start(scope, kernelPort(scope), options);\n  host.catch(() => undefined);\n  serveConnections(scope, host);\n  return host;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/roles/frontmatter.js

@@ -0,0 +1,59 @@
+function unquote(value) {
+  const quoted = /^(["'])(.*)\1$/s.exec(value);
+  if (!quoted) return value;
+  return quoted[1] === '"' ? quoted[2].replace(/\\(["\\])/g, "$1") : quoted[2].replace(/''/g, "'");
+}
+function scalar(raw) {
+  const value = raw.trim();
+  if (/^\[.*\]$/s.test(value))
+    return value.slice(1, -1).split(",").map((item) => unquote(item.trim())).filter(Boolean);
+  if (value === "true" || value === "false") return value === "true";
+  if (/^-?\d+(\.\d+)?$/.test(value)) return Number(value);
+  return unquote(value);
+}
+function parseFrontmatter(text) {
+  const normalized = text.replace(/\r\n/g, "\n");
+  const match = /^---\n([\s\S]*?)\n---(?:\n|$)/.exec(normalized);
+  if (!match)
+    return { fields: {}, body: normalized.trim(), problems: ["no frontmatter between --- lines"] };
+  const fields = {};
+  const problems = [];
+  let list;
+  const nested = /* @__PURE__ */ new Set();
+  for (const line of match[1].split("\n")) {
+    if (!line.trim() || line.trimStart().startsWith("#")) continue;
+    const item = /^\s+-\s+(.*)$/.exec(line);
+    if (item && list) {
+      fields[list].push(unquote(item[1].trim()));
+      continue;
+    }
+    if (/^\s/.test(line) && list) {
+      nested.add(list);
+      continue;
+    }
+    const pair = /^([A-Za-z][\w-]*):(?:\s+(.*))?$/.exec(line);
+    if (!pair) {
+      problems.push(`can't read the line "${line.trim()}"`);
+      list = void 0;
+      continue;
+    }
+    const key = pair[1];
+    const value = pair[2]?.trim() ?? "";
+    if (value === "") {
+      fields[key] = [];
+      list = key;
+    } else {
+      fields[key] = scalar(value);
+      list = void 0;
+    }
+  }
+  for (const key of nested) {
+    delete fields[key];
+    problems.push(`"${key}" has nested values, which SLICC doesn't read`);
+  }
+  return { fields, body: normalized.slice(match[0].length).trim(), problems };
+}
+export {
+  parseFrontmatter
+};
+//# sourceMappingURL=frontmatter.js.map

package/dist/roles/frontmatter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/roles/frontmatter.ts"],
+  "sourcesContent": ["export type FrontmatterValue = string | number | boolean | string[];\n\nexport interface Frontmatter {\n  fields: Record<string, FrontmatterValue>;\n  body: string;\n  problems: string[];\n}\n\nfunction unquote(value: string): string {\n  const quoted = /^([\"'])(.*)\\1$/s.exec(value);\n  if (!quoted) return value;\n  return quoted[1] === '\"'\n    ? (quoted[2] as string).replace(/\\\\([\"\\\\])/g, '$1')\n    : (quoted[2] as string).replace(/''/g, \"'\");\n}\n\nfunction scalar(raw: string): FrontmatterValue {\n  const value = raw.trim();\n  if (/^\\[.*\\]$/s.test(value))\n    return value\n      .slice(1, -1)\n      .split(',')\n      .map((item) => unquote(item.trim()))\n      .filter(Boolean);\n  if (value === 'true' || value === 'false') return value === 'true';\n  if (/^-?\\d+(\\.\\d+)?$/.test(value)) return Number(value);\n  return unquote(value);\n}\n\nexport function parseFrontmatter(text: string): Frontmatter {\n  const normalized = text.replace(/\\r\\n/g, '\\n');\n  const match = /^---\\n([\\s\\S]*?)\\n---(?:\\n|$)/.exec(normalized);\n  if (!match)\n    return { fields: {}, body: normalized.trim(), problems: ['no frontmatter between --- lines'] };\n  const fields: Record<string, FrontmatterValue> = {};\n  const problems: string[] = [];\n  let list: string | undefined;\n  const nested = new Set<string>();\n  for (const line of (match[1] as string).split('\\n')) {\n    if (!line.trim() || line.trimStart().startsWith('#')) continue;\n    const item = /^\\s+-\\s+(.*)$/.exec(line);\n    if (item && list) {\n      (fields[list] as string[]).push(unquote((item[1] as string).trim()));\n      continue;\n    }\n    if (/^\\s/.test(line) && list) {\n      nested.add(list);\n      continue;\n    }\n    const pair = /^([A-Za-z][\\w-]*):(?:\\s+(.*))?$/.exec(line);\n    if (!pair) {\n      problems.push(`can't read the line \"${line.trim()}\"`);\n      list = undefined;\n      continue;\n    }\n    const key = pair[1] as string;\n    const value = pair[2]?.trim() ?? '';\n    if (value === '') {\n      fields[key] = [];\n      list = key;\n    } else {\n      fields[key] = scalar(value);\n      list = undefined;\n    }\n  }\n  for (const key of nested) {\n    delete fields[key];\n    problems.push(`\"${key}\" has nested values, which SLICC doesn't read`);\n  }\n  return { fields, body: normalized.slice(match[0].length).trim(), problems };\n}\n"],
+  "mappings": "AAQA,SAAS,QAAQ,OAAuB;AACtC,QAAM,SAAS,kBAAkB,KAAK,KAAK;AAC3C,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,OAAO,CAAC,MAAM,MAChB,OAAO,CAAC,EAAa,QAAQ,cAAc,IAAI,IAC/C,OAAO,CAAC,EAAa,QAAQ,OAAO,GAAG;AAC9C;AAEA,SAAS,OAAO,KAA+B;AAC7C,QAAM,QAAQ,IAAI,KAAK;AACvB,MAAI,YAAY,KAAK,KAAK;AACxB,WAAO,MACJ,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EACT,IAAI,CAAC,SAAS,QAAQ,KAAK,KAAK,CAAC,CAAC,EAClC,OAAO,OAAO;AACnB,MAAI,UAAU,UAAU,UAAU,QAAS,QAAO,UAAU;AAC5D,MAAI,kBAAkB,KAAK,KAAK,EAAG,QAAO,OAAO,KAAK;AACtD,SAAO,QAAQ,KAAK;AACtB;AAEO,SAAS,iBAAiB,MAA2B;AAC1D,QAAM,aAAa,KAAK,QAAQ,SAAS,IAAI;AAC7C,QAAM,QAAQ,gCAAgC,KAAK,UAAU;AAC7D,MAAI,CAAC;AACH,WAAO,EAAE,QAAQ,CAAC,GAAG,MAAM,WAAW,KAAK,GAAG,UAAU,CAAC,kCAAkC,EAAE;AAC/F,QAAM,SAA2C,CAAC;AAClD,QAAM,WAAqB,CAAC;AAC5B,MAAI;AACJ,QAAM,SAAS,oBAAI,IAAY;AAC/B,aAAW,QAAS,MAAM,CAAC,EAAa,MAAM,IAAI,GAAG;AACnD,QAAI,CAAC,KAAK,KAAK,KAAK,KAAK,UAAU,EAAE,WAAW,GAAG,EAAG;AACtD,UAAM,OAAO,gBAAgB,KAAK,IAAI;AACtC,QAAI,QAAQ,MAAM;AAChB,MAAC,OAAO,IAAI,EAAe,KAAK,QAAS,KAAK,CAAC,EAAa,KAAK,CAAC,CAAC;AACnE;AAAA,IACF;AACA,QAAI,MAAM,KAAK,IAAI,KAAK,MAAM;AAC5B,aAAO,IAAI,IAAI;AACf;AAAA,IACF;AACA,UAAM,OAAO,kCAAkC,KAAK,IAAI;AACxD,QAAI,CAAC,MAAM;AACT,eAAS,KAAK,wBAAwB,KAAK,KAAK,CAAC,GAAG;AACpD,aAAO;AACP;AAAA,IACF;AACA,UAAM,MAAM,KAAK,CAAC;AAClB,UAAM,QAAQ,KAAK,CAAC,GAAG,KAAK,KAAK;AACjC,QAAI,UAAU,IAAI;AAChB,aAAO,GAAG,IAAI,CAAC;AACf,aAAO;AAAA,IACT,OAAO;AACL,aAAO,GAAG,IAAI,OAAO,KAAK;AAC1B,aAAO;AAAA,IACT;AAAA,EACF;AACA,aAAW,OAAO,QAAQ;AACxB,WAAO,OAAO,GAAG;AACjB,aAAS,KAAK,IAAI,GAAG,+CAA+C;AAAA,EACtE;AACA,SAAO,EAAE,QAAQ,MAAM,WAAW,MAAM,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,SAAS;AAC5E;",
+  "names": []
+}

package/dist/roles/roles.js

@@ -0,0 +1,204 @@
+import { parseFrontmatter } from "./frontmatter.js";
+const DEFAULT_LIMITS = { maxLiveScoops: 16, maxPerTurn: 64 };
+const TOOLS = {
+  read: "read",
+  write: "write",
+  edit: "edit",
+  bash: "bash",
+  grep: "bash",
+  find: "bash",
+  ls: "bash"
+};
+const THINKING = /* @__PURE__ */ new Set(["off", "minimal", "low", "medium", "high", "xhigh"]);
+const APPLIED = /* @__PURE__ */ new Set([
+  "name",
+  "description",
+  "tools",
+  "model",
+  "thinking",
+  "systemPromptMode",
+  "aliases",
+  "output",
+  "package",
+  "advertise",
+  "inheritProjectContext",
+  "inheritSkills",
+  "skills",
+  "defaultReads"
+]);
+const LATER = {
+  memory: "per-agent memory comes with SLICC\u2019s memory panel"
+};
+function list(value) {
+  if (Array.isArray(value)) return value;
+  if (typeof value === "string")
+    return value.split(",").map((item) => item.trim()).filter(Boolean);
+  return [];
+}
+function tools(names, where, warnings) {
+  const mapped = [];
+  for (const name of names) {
+    const tool = TOOLS[name];
+    if (tool) {
+      if (!mapped.includes(tool)) mapped.push(tool);
+    } else warnings.push(`${where}: tool "${name}" isn't available in SLICC; it's left out`);
+  }
+  return mapped;
+}
+function parseRole(text, source, path, warnings) {
+  const { fields, body, problems } = parseFrontmatter(text);
+  for (const problem of problems) warnings.push(`${path}: ${problem}`);
+  const name = fields.name;
+  const description = fields.description;
+  if (typeof name !== "string" || typeof description !== "string") {
+    warnings.push(`${path}: an agent file needs a name and a description; skipped`);
+    return void 0;
+  }
+  for (const key of Object.keys(fields))
+    if (!APPLIED.has(key))
+      warnings.push(
+        `${path}: "${key}" ${LATER[key] ? `is not read yet (${LATER[key]})` : "isn't supported in SLICC; it's ignored"}`
+      );
+  const thinking = typeof fields.thinking === "string" && THINKING.has(fields.thinking) ? fields.thinking : void 0;
+  if (fields.thinking !== void 0 && !thinking)
+    warnings.push(`${path}: thinking "${String(fields.thinking)}" is unknown; ignored`);
+  const pkg = typeof fields.package === "string" && fields.package ? `${fields.package}.` : "";
+  return {
+    name: `${pkg}${name}`,
+    description,
+    prompt: body,
+    mode: fields.systemPromptMode === "append" ? "append" : "replace",
+    ...fields.tools !== void 0 ? { tools: tools(list(fields.tools), path, warnings) } : {},
+    ...typeof fields.model === "string" ? { model: fields.model } : {},
+    ...thinking ? { thinking } : {},
+    aliases: list(fields.aliases),
+    ...typeof fields.output === "string" ? { output: fields.output } : {},
+    source,
+    path
+  };
+}
+async function markdown(files, dir, context, depth = 0) {
+  if (dir.endsWith(".md")) return [dir];
+  const listed = await files.listDir(dir, context);
+  if (!listed.ok || depth > 4) return [];
+  const out = [];
+  for (const info of listed.value) {
+    const path = `${dir}/${info.name}`;
+    if (info.kind === "directory") out.push(...await markdown(files, path, context, depth + 1));
+    else if (info.name.endsWith(".md") && !info.name.endsWith(".chain.md")) out.push(path);
+  }
+  return out.sort();
+}
+function positive(value, fallback) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : fallback;
+}
+async function settings(files, path, context, warnings) {
+  const read = await files.readTextFile(path, context);
+  const empty = { overrides: {}, limits: { ...DEFAULT_LIMITS } };
+  if (!read.ok) return empty;
+  let parsed;
+  try {
+    parsed = JSON.parse(read.value);
+  } catch (error) {
+    warnings.push(`${path}: not valid JSON (${error.message}); overrides ignored`);
+    return empty;
+  }
+  const subagents = parsed.subagents ?? {};
+  return {
+    overrides: subagents.agentOverrides ?? {},
+    limits: {
+      maxLiveScoops: positive(subagents.maxLiveScoops, DEFAULT_LIMITS.maxLiveScoops),
+      maxPerTurn: positive(subagents.maxPerTurn, DEFAULT_LIMITS.maxPerTurn)
+    }
+  };
+}
+function apply(role, override, warnings) {
+  if (!override) return role;
+  if (override.disabled === true) return void 0;
+  const next = { ...role };
+  if (typeof override.model === "string") next.model = override.model;
+  if (typeof override.thinking === "string" && THINKING.has(override.thinking))
+    next.thinking = override.thinking;
+  if (typeof override.description === "string") next.description = override.description;
+  if (typeof override.systemPrompt === "string") next.prompt = override.systemPrompt;
+  if (Array.isArray(override.tools))
+    next.tools = tools(override.tools.map(String), `override for ${role.name}`, warnings);
+  return next;
+}
+const ORDER = ["builtin", "package", "user", "project"];
+async function loadRoles(options, context) {
+  const warnings = [];
+  const byName = /* @__PURE__ */ new Map();
+  const add = (role) => {
+    if (role) byName.set(role.name, role);
+  };
+  for (const { path, text } of await options.builtin())
+    add(parseRole(text, "builtin", path, warnings));
+  const dirs = [...options.dirs].sort((a, b) => ORDER.indexOf(a.source) - ORDER.indexOf(b.source));
+  for (const { source, dir } of dirs)
+    for (const path of await markdown(options.files, dir, context)) {
+      const read = await options.files.readTextFile(path, context);
+      if (read.ok) add(parseRole(read.value, source, path, warnings));
+    }
+  const { overrides, limits } = await settings(
+    options.files,
+    options.settingsPath,
+    context,
+    warnings
+  );
+  const roles = [];
+  for (const role of byName.values()) {
+    const applied = apply(role, overrides[role.name], warnings);
+    if (applied) roles.push(applied);
+  }
+  return { roles, warnings, limits };
+}
+function findRole(roles, name) {
+  return roles.find((role) => role.name === name) ?? roles.find((role) => role.aliases.includes(name));
+}
+async function manifestDirs(files, root, context) {
+  const top = await files.listDir(root, context);
+  if (!top.ok) return [];
+  const out = [];
+  for (const entry of top.value) {
+    if (entry.kind !== "directory" || entry.name.startsWith(".")) continue;
+    if (!entry.name.startsWith("@")) {
+      out.push(`${root}/${entry.name}`);
+      continue;
+    }
+    const scoped = await files.listDir(`${root}/${entry.name}`, context);
+    if (scoped.ok) {
+      for (const inner of scoped.value)
+        if (inner.kind === "directory") out.push(`${root}/${entry.name}/${inner.name}`);
+    }
+  }
+  return out;
+}
+function agentPaths(dir, text) {
+  let manifest;
+  try {
+    manifest = JSON.parse(text);
+  } catch {
+    return [];
+  }
+  const agents = manifest["pi-subagents"]?.agents ?? manifest.pi?.subagents?.agents;
+  const listed = Array.isArray(agents) ? agents : typeof agents === "string" ? [agents] : [];
+  return listed.filter((path) => typeof path === "string").map((path) => `${dir}/${path.replace(/^\.\//, "").replace(/\/$/, "")}`);
+}
+async function packageDirs(files, root, context) {
+  const out = [];
+  for (const dir of await manifestDirs(files, root, context)) {
+    const read = await files.readTextFile(`${dir}/package.json`, context);
+    if (read.ok) out.push(...agentPaths(dir, read.value));
+  }
+  return out;
+}
+export {
+  DEFAULT_LIMITS,
+  agentPaths,
+  findRole,
+  loadRoles,
+  packageDirs,
+  parseRole
+};
+//# sourceMappingURL=roles.js.map