@ai-ecoverse/slicc-agent 3.2.0 → 3.4.0

package/dist/licks/glob.js

@@ -0,0 +1,47 @@
+const SPECIAL = /[.+^$()|\\]/;
+function braces(pattern, at) {
+  const end = pattern.indexOf("}", at);
+  if (end < 0) return void 0;
+  const options = pattern.slice(at + 1, end).split(",");
+  if (options.length < 2) return void 0;
+  return [`(?:${options.map((option) => source(option)).join("|")})`, end];
+}
+function klass(pattern, at) {
+  const end = pattern.indexOf("]", at + 2);
+  if (end < 0) return void 0;
+  const inner = pattern.slice(at + 1, end);
+  const negated = inner.startsWith("!");
+  const body = (negated ? inner.slice(1) : inner).replace(/[\\\]^]/g, "\\$&");
+  return [`[${negated ? "^/" : ""}${body}]`, end];
+}
+function source(pattern) {
+  let out = "";
+  for (let at = 0; at < pattern.length; at++) {
+    const char = pattern[at];
+    if (char === "*" && pattern[at + 1] === "*") {
+      const slash = pattern[at + 2] === "/";
+      out += slash ? "(?:.*/)?" : ".*";
+      at += slash ? 2 : 1;
+    } else if (char === "*") out += "[^/]*";
+    else if (char === "?") out += "[^/]";
+    else if (char === "{" && braces(pattern, at)) {
+      const [group, end] = braces(pattern, at);
+      out += group;
+      at = end;
+    } else if (char === "[" && klass(pattern, at)) {
+      const [group, end] = klass(pattern, at);
+      out += group;
+      at = end;
+    } else
+      out += SPECIAL.test(char) || char === "{" || char === "}" || char === "[" || char === "]" ? `\\${char}` : char;
+  }
+  return out;
+}
+function glob(pattern) {
+  const expression = new RegExp(`^${source(pattern)}$`);
+  return (path) => expression.test(path);
+}
+export {
+  glob
+};
+//# sourceMappingURL=glob.js.map

package/dist/licks/glob.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/licks/glob.ts"],
+  "sourcesContent": ["const SPECIAL = /[.+^$()|\\\\]/;\n\nfunction braces(pattern: string, at: number): [string, number] | undefined {\n  const end = pattern.indexOf('}', at);\n  if (end < 0) return undefined;\n  const options = pattern.slice(at + 1, end).split(',');\n  if (options.length < 2) return undefined;\n  return [`(?:${options.map((option) => source(option)).join('|')})`, end];\n}\n\nfunction klass(pattern: string, at: number): [string, number] | undefined {\n  const end = pattern.indexOf(']', at + 2);\n  if (end < 0) return undefined;\n  const inner = pattern.slice(at + 1, end);\n  const negated = inner.startsWith('!');\n  const body = (negated ? inner.slice(1) : inner).replace(/[\\\\\\]^]/g, '\\\\$&');\n  return [`[${negated ? '^/' : ''}${body}]`, end];\n}\n\nfunction source(pattern: string): string {\n  let out = '';\n  for (let at = 0; at < pattern.length; at++) {\n    const char = pattern[at] as string;\n    if (char === '*' && pattern[at + 1] === '*') {\n      const slash = pattern[at + 2] === '/';\n      out += slash ? '(?:.*/)?' : '.*';\n      at += slash ? 2 : 1;\n    } else if (char === '*') out += '[^/]*';\n    else if (char === '?') out += '[^/]';\n    else if (char === '{' && braces(pattern, at)) {\n      const [group, end] = braces(pattern, at) as [string, number];\n      out += group;\n      at = end;\n    } else if (char === '[' && klass(pattern, at)) {\n      const [group, end] = klass(pattern, at) as [string, number];\n      out += group;\n      at = end;\n    } else\n      out +=\n        SPECIAL.test(char) || char === '{' || char === '}' || char === '[' || char === ']'\n          ? `\\\\${char}`\n          : char;\n  }\n  return out;\n}\n\nexport function glob(pattern: string): (path: string) => boolean {\n  const expression = new RegExp(`^${source(pattern)}$`);\n  return (path) => expression.test(path);\n}\n"],
+  "mappings": "AAAA,MAAM,UAAU;AAEhB,SAAS,OAAO,SAAiB,IAA0C;AACzE,QAAM,MAAM,QAAQ,QAAQ,KAAK,EAAE;AACnC,MAAI,MAAM,EAAG,QAAO;AACpB,QAAM,UAAU,QAAQ,MAAM,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG;AACpD,MAAI,QAAQ,SAAS,EAAG,QAAO;AAC/B,SAAO,CAAC,MAAM,QAAQ,IAAI,CAAC,WAAW,OAAO,MAAM,CAAC,EAAE,KAAK,GAAG,CAAC,KAAK,GAAG;AACzE;AAEA,SAAS,MAAM,SAAiB,IAA0C;AACxE,QAAM,MAAM,QAAQ,QAAQ,KAAK,KAAK,CAAC;AACvC,MAAI,MAAM,EAAG,QAAO;AACpB,QAAM,QAAQ,QAAQ,MAAM,KAAK,GAAG,GAAG;AACvC,QAAM,UAAU,MAAM,WAAW,GAAG;AACpC,QAAM,QAAQ,UAAU,MAAM,MAAM,CAAC,IAAI,OAAO,QAAQ,YAAY,MAAM;AAC1E,SAAO,CAAC,IAAI,UAAU,OAAO,EAAE,GAAG,IAAI,KAAK,GAAG;AAChD;AAEA,SAAS,OAAO,SAAyB;AACvC,MAAI,MAAM;AACV,WAAS,KAAK,GAAG,KAAK,QAAQ,QAAQ,MAAM;AAC1C,UAAM,OAAO,QAAQ,EAAE;AACvB,QAAI,SAAS,OAAO,QAAQ,KAAK,CAAC,MAAM,KAAK;AAC3C,YAAM,QAAQ,QAAQ,KAAK,CAAC,MAAM;AAClC,aAAO,QAAQ,aAAa;AAC5B,YAAM,QAAQ,IAAI;AAAA,IACpB,WAAW,SAAS,IAAK,QAAO;AAAA,aACvB,SAAS,IAAK,QAAO;AAAA,aACrB,SAAS,OAAO,OAAO,SAAS,EAAE,GAAG;AAC5C,YAAM,CAAC,OAAO,GAAG,IAAI,OAAO,SAAS,EAAE;AACvC,aAAO;AACP,WAAK;AAAA,IACP,WAAW,SAAS,OAAO,MAAM,SAAS,EAAE,GAAG;AAC7C,YAAM,CAAC,OAAO,GAAG,IAAI,MAAM,SAAS,EAAE;AACtC,aAAO;AACP,WAAK;AAAA,IACP;AACE,aACE,QAAQ,KAAK,IAAI,KAAK,SAAS,OAAO,SAAS,OAAO,SAAS,OAAO,SAAS,MAC3E,KAAK,IAAI,KACT;AAAA,EACV;AACA,SAAO;AACT;AAEO,SAAS,KAAK,SAA4C;AAC/D,QAAM,aAAa,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,GAAG;AACpD,SAAO,CAAC,SAAS,WAAW,KAAK,IAAI;AACvC;",
+  "names": []
+}

package/dist/licks/index.js

@@ -0,0 +1,36 @@
+import { cronTask, licksExtension } from "./extension.js";
+import { createLicks } from "./licks.js";
+import { createLickSources } from "./sources.js";
+function setupLicks(registry) {
+  let bind = () => void 0;
+  const host = new Promise((resolve) => {
+    bind = resolve;
+  });
+  const licks = createLicks(host);
+  const cron = cronTask(licks);
+  const lookup = async (id, context) => {
+    const found = await (await host).harness.conversation(id, context);
+    if (!found) throw new Error(`conversation ${id} is gone`);
+    return found;
+  };
+  registry.install(licksExtension(licks, lookup, cron));
+  return {
+    licks,
+    attach(agent, options) {
+      const { harness, root } = agent;
+      bind({ harness, resolve: async (_target) => agent.cone() });
+      return createLickSources({
+        ...options,
+        harness,
+        root,
+        cone: () => agent.cone(),
+        licks,
+        cron
+      });
+    }
+  };
+}
+export {
+  setupLicks
+};
+//# sourceMappingURL=index.js.map

package/dist/licks/index.js.map

@@ -0,0 +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;",
+  "names": []
+}

package/dist/licks/lick.js

@@ -0,0 +1,102 @@
+const LICK_CHANNELS = [
+  "webhook",
+  "cron",
+  "sprinkle",
+  "fswatch",
+  "session-reload",
+  "navigate",
+  "discovery",
+  "upgrade",
+  "workflow",
+  "bash",
+  "jshd",
+  "preview",
+  "cherry",
+  "scoop-notify",
+  "scoop-idle",
+  "scoop-wait",
+  "sudo-request"
+];
+const ENTITIES = {
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "\n": "&#10;",
+  "\r": "&#13;"
+};
+const DECODE = Object.fromEntries(
+  Object.entries(ENTITIES).map(([raw, entity]) => [entity, raw])
+);
+function escapeText(value) {
+  return value.replace(/[&<>]/g, (char) => ENTITIES[char]).replace(/\r/g, "&#13;");
+}
+function escapeAttribute(value) {
+  return value.replace(/[&<>"\n\r]/g, (char) => ENTITIES[char]);
+}
+function unescape(value) {
+  return value.replace(/&(?:amp|lt|gt|quot|#10|#13);/g, (entity) => DECODE[entity]);
+}
+function lickId() {
+  return `lk-${Date.now().toString(36)}-${crypto.randomUUID().slice(0, 8)}`;
+}
+function oneLine(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+function formatLick(lick) {
+  const attributes = [
+    ["id", lick.id],
+    ["channel", lick.channel],
+    ["source", lick.source],
+    ["title", oneLine(lick.title)],
+    ["count", String(lick.count)],
+    ["at", new Date(lick.at).toISOString()]
+  ];
+  if (lick.actions?.length) attributes.push(["actions", lick.actions.join(" ")]);
+  const head = attributes.map(([name, value]) => `${name}="${escapeAttribute(value)}"`).join(" ");
+  const lines = [escapeText(oneLine(lick.text))];
+  if (lick.body) lines.push(escapeText(lick.body));
+  return `<lick ${head}>
+${lines.join("\n")}
+</lick>`;
+}
+const LICK = /^<lick ((?:[a-z]+="[^"<>\n]*" ?)+)>\n([^\n]*)(?:\n([\s\S]*?))?\n<\/lick>$/;
+const ATTRIBUTE = /([a-z]+)="([^"]*)"/g;
+function isChannel(value) {
+  return LICK_CHANNELS.includes(value ?? "");
+}
+function parseLick(text) {
+  const match = LICK.exec(text);
+  if (!match) return void 0;
+  const attributes = /* @__PURE__ */ new Map();
+  for (const [, name, value] of match[1].matchAll(ATTRIBUTE))
+    attributes.set(name, unescape(value));
+  const channel = attributes.get("channel");
+  const id = attributes.get("id");
+  if (!id || !isChannel(channel)) return void 0;
+  const at = Date.parse(attributes.get("at") ?? "");
+  const count = Number(attributes.get("count"));
+  const actions = (attributes.get("actions") ?? "").split(" ").filter((action) => action === "confirm" || action === "dismiss");
+  const body = match[3] === void 0 ? void 0 : unescape(match[3]);
+  return {
+    id,
+    channel,
+    source: attributes.get("source") ?? "",
+    title: attributes.get("title") ?? "",
+    text: unescape(match[2]),
+    ...body ? { body } : {},
+    count: Number.isSafeInteger(count) && count > 0 ? count : 1,
+    at: Number.isNaN(at) ? 0 : at,
+    ...actions.length ? { actions } : {}
+  };
+}
+export {
+  LICK_CHANNELS,
+  escapeAttribute,
+  escapeText,
+  formatLick,
+  lickId,
+  parseLick,
+  unescape
+};
+//# sourceMappingURL=lick.js.map

package/dist/licks/lick.js.map

@@ -0,0 +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 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};\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  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\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  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/licks/licks.js

@@ -0,0 +1,181 @@
+import {
+  defineDoc
+} from "@earendil-works/pi-durable";
+import {
+  formatLick,
+  lickId
+} from "./lick.js";
+import { entryLick, LICK_STATE_KIND, lickDecisions } from "./state.js";
+const LicksOutbox = defineDoc({
+  kind: "slicc.licks",
+  version: 1,
+  scope: "session",
+  initial: () => ({ queues: {}, events: {} })
+});
+const MAX_ITEMS = 50;
+const MAX_EVENTS = 64;
+function render(pending) {
+  const shown = pending.items.slice(0, MAX_ITEMS);
+  const more = pending.items.length - shown.length;
+  const lines = [
+    ...pending.body ? [pending.body] : [],
+    ...shown,
+    ...more > 0 ? [`\u2026 and ${more} more`] : []
+  ];
+  const { body: _, ...lick } = pending.lick;
+  return lines.length ? { ...lick, body: lines.join("\n") } : lick;
+}
+function merge(pending, event, now) {
+  const items = [...pending.items];
+  for (const item of event.items ?? []) if (!items.includes(item)) items.push(item);
+  return {
+    lick: {
+      ...pending.lick,
+      title: event.title,
+      text: event.text,
+      count: pending.lick.count + (event.count ?? 1),
+      at: event.at ?? now
+    },
+    items,
+    body: event.body ?? pending.body
+  };
+}
+function keyOf(event) {
+  const base = `${event.target}|${event.channel}|${event.source}`;
+  return event.coalesce === false ? `${base}|${event.eventId ?? lickId()}` : base;
+}
+function createLicks(host) {
+  const handlers = /* @__PURE__ */ new Map();
+  let lock = Promise.resolve();
+  const serial = (operation) => {
+    const run = lock.then(operation, operation);
+    lock = run.catch(() => void 0);
+    return run;
+  };
+  const actions = (channel) => {
+    const handler = handlers.get(channel);
+    const list = [];
+    if (handler?.confirm) list.push("confirm");
+    if (handler?.dismiss) list.push("dismiss");
+    return list.length ? list : void 0;
+  };
+  async function previous(harness, id, context) {
+    if (id === null) return "gone";
+    const submission = await harness.submission(id, context);
+    const record = await submission?.status(context);
+    if (record?.status === "queued") return "queued";
+    return record?.status === "unanswered" && record.reason === "aborted" ? "withdrawn" : "gone";
+  }
+  async function settled(key, context) {
+    const { harness } = await host;
+    const queue = (await harness.snapshot(LicksOutbox, context))?.queues[key];
+    if (!queue) return void 0;
+    const before = await previous(harness, queue.submission, context);
+    if (before === "queued") return void 0;
+    if (queue.pending && before === "gone") return queue;
+    await harness.commit(async (tx) => {
+      const doc = await tx.doc(LicksOutbox);
+      if (doc.queues[key]?.submission === queue.submission) delete doc.queues[key];
+    }, context);
+    return void 0;
+  }
+  async function flushKey(key, context) {
+    const { harness, resolve } = await host;
+    const queue = await settled(key, context);
+    if (!queue?.pending) return;
+    const lick = render(queue.pending);
+    const target = key.split("|")[0];
+    const conversation = await resolve(target, context);
+    const submission = await conversation.submit(
+      {
+        type: "input",
+        content: formatLick(lick),
+        whenBusy: "steer",
+        requestId: `lick:${lick.id}`
+      },
+      context
+    );
+    await harness.commit(async (tx) => {
+      const doc = await tx.doc(LicksOutbox);
+      doc.queues[key] = { submission: submission.id, pending: null };
+    }, context);
+  }
+  async function flushAll(context) {
+    const { harness } = await host;
+    const keys = Object.keys((await harness.snapshot(LicksOutbox, context))?.queues ?? {});
+    for (const key of keys) await flushKey(key, context);
+  }
+  async function find(conversation, id, context) {
+    const { entries } = await conversation.context(context);
+    const lick = entries.map(entryLick).find((candidate) => candidate?.id === id);
+    if (!lick) return void 0;
+    return { lick, decision: lickDecisions(entries).get(id) };
+  }
+  return {
+    deliver(event, context) {
+      return serial(async () => {
+        const { harness } = await host;
+        const key = keyOf(event);
+        await settled(key, context);
+        const stream = `${event.channel}|${event.source}`;
+        const now = event.at ?? Date.now();
+        const accepted = await harness.commit(async (tx) => {
+          const doc = await tx.doc(LicksOutbox);
+          const seen = doc.events[stream] ?? [];
+          if (event.eventId !== void 0) {
+            if (seen.includes(event.eventId)) return false;
+            doc.events[stream] = [...seen, event.eventId].slice(-MAX_EVENTS);
+          }
+          const queue = doc.queues[key] ?? { submission: null, pending: null };
+          const listed = actions(event.channel);
+          queue.pending = queue.pending ? merge(queue.pending, event, now) : {
+            lick: {
+              id: lickId(),
+              channel: event.channel,
+              source: event.source,
+              title: event.title,
+              text: event.text,
+              count: event.count ?? 1,
+              at: now,
+              ...listed ? { actions: listed } : {}
+            },
+            items: [...new Set(event.items ?? [])],
+            body: event.body ?? null
+          };
+          doc.queues[key] = queue;
+          return true;
+        }, context);
+        if (accepted) await flushKey(key, context);
+      });
+    },
+    flush: (context) => serial(() => flushAll(context)),
+    find,
+    async decide(conversation, id, action, reason, context) {
+      const found = await find(conversation, id, context);
+      if (!found) throw new Error(`There is no lick ${id} in this conversation.`);
+      if (found.decision) throw new Error(`Lick ${id} is already ${found.decision}.`);
+      if (!found.lick.actions?.includes(action))
+        throw new Error(`Lick ${id} (${found.lick.channel}) has no ${action} action.`);
+      const run = handlers.get(found.lick.channel)?.[action];
+      if (!run) throw new Error(`Lick ${id} (${found.lick.channel}) has no ${action} action.`);
+      return await run(found.lick, reason, context) ?? `Lick ${id} ${action}ed.`;
+    },
+    handle(channel, handler) {
+      handlers.set(channel, handler);
+    },
+    async pending(context) {
+      const { harness } = await host;
+      const queues = (await harness.snapshot(LicksOutbox, context))?.queues ?? {};
+      return Object.values(queues).filter((queue) => queue.submission !== null || queue.pending).length;
+    }
+  };
+}
+export {
+  LICK_STATE_KIND,
+  LicksOutbox,
+  MAX_EVENTS,
+  MAX_ITEMS,
+  createLicks,
+  render
+};
+//# sourceMappingURL=licks.js.map

package/dist/licks/licks.js.map

@@ -0,0 +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 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  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\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  return {\n    lick: {\n      ...pending.lick,\n      title: event.title,\n      text: event.text,\n      count: pending.lick.count + (event.count ?? 1),\n      at: event.at ?? now,\n    },\n    items,\n    body: event.body ?? pending.body,\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          const listed = actions(event.channel);\n          queue.pending = queue.pending\n            ? merge(queue.pending, event, now)\n            : {\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                },\n                items: [...new Set(event.items ?? [])],\n                body: event.body ?? null,\n              };\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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",
+  "names": []
+}

package/dist/licks/schedules.js

@@ -0,0 +1,50 @@
+import {
+  defineDoc
+} from "@earendil-works/pi-durable";
+const LicksHostDoc = defineDoc({
+  kind: "slicc.licks.host",
+  version: 1,
+  scope: "session",
+  initial: () => ({ cron: {}, agent: null, boot: null, mark: 0, upgrades: 0 })
+});
+function same(entry, record) {
+  return entry !== void 0 && entry.schedule === record.schedule && entry.target === record.target && entry.message === record.message;
+}
+async function live(harness, task, context) {
+  const record = await harness.getTask(task, context);
+  return record !== void 0 && record.state.status !== "terminal";
+}
+async function reconcileCron(options, entries, context) {
+  const { harness } = options;
+  const wanted = new Map(entries.map((entry) => [entry.name, entry]));
+  const stored = (await harness.snapshot(LicksHostDoc, context))?.cron ?? {};
+  const stale = [];
+  const create = entries.filter((entry) => !stored[entry.name]);
+  for (const [name, record] of Object.entries(stored)) {
+    const entry = wanted.get(name);
+    const running = await live(harness, record.task, context);
+    if (same(entry, record) && running) continue;
+    stale.push(name);
+    if (running) await harness.abortTask(record.task, context);
+    if (entry) create.push(entry);
+  }
+  if (!stale.length && !create.length) return;
+  await harness.commit(async (tx) => {
+    const doc = await tx.doc(LicksHostDoc);
+    for (const name of stale) delete doc.cron[name];
+    for (const entry of create) {
+      const input = { ...entry, from: options.now() };
+      const task = await tx.createTask(options.cron, input, {
+        ownership: { kind: "conversation" },
+        conversationId: options.root.id,
+        background: true
+      });
+      doc.cron[entry.name] = { ...entry, task };
+    }
+  }, context);
+}
+export {
+  LicksHostDoc,
+  reconcileCron
+};
+//# sourceMappingURL=schedules.js.map

package/dist/licks/schedules.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/licks/schedules.ts"],
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport {\n  type Conversation,\n  defineDoc,\n  type Harness,\n  type TaskId,\n} from '@earendil-works/pi-durable';\nimport type { CronEntry } from './config.ts';\nimport type { CronInput, cronTask } from './extension.ts';\n\ntype CronRecord = {\n  schedule: string;\n  target: string;\n  message: string;\n  task: number;\n};\n\ntype HostState = {\n  cron: Record<string, CronRecord>;\n  agent: string | null;\n  boot: string | null;\n  mark: number;\n  upgrades: number;\n};\n\nexport const LicksHostDoc = defineDoc<HostState>({\n  kind: 'slicc.licks.host',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ cron: {}, agent: null, boot: null, mark: 0, upgrades: 0 }),\n});\n\nfunction same(entry: CronEntry | undefined, record: CronRecord): boolean {\n  return (\n    entry !== undefined &&\n    entry.schedule === record.schedule &&\n    entry.target === record.target &&\n    entry.message === record.message\n  );\n}\n\nasync function live(harness: Harness, task: number, context: Context): Promise<boolean> {\n  const record = await harness.getTask(task as TaskId, context);\n  return record !== undefined && record.state.status !== 'terminal';\n}\n\nexport async function reconcileCron(\n  options: {\n    harness: Harness;\n    root: Conversation;\n    cron: ReturnType<typeof cronTask>;\n    now: () => number;\n  },\n  entries: readonly CronEntry[],\n  context: Context\n): Promise<void> {\n  const { harness } = options;\n  const wanted = new Map(entries.map((entry) => [entry.name, entry]));\n  const stored: Readonly<Record<string, CronRecord>> =\n    (await harness.snapshot(LicksHostDoc, context))?.cron ?? {};\n  const stale: string[] = [];\n  const create: CronEntry[] = entries.filter((entry) => !stored[entry.name]);\n  for (const [name, record] of Object.entries(stored)) {\n    const entry = wanted.get(name);\n    const running = await live(harness, record.task, context);\n    if (same(entry, record) && running) continue;\n    stale.push(name);\n    if (running) await harness.abortTask(record.task as TaskId, context);\n    if (entry) create.push(entry);\n  }\n  if (!stale.length && !create.length) return;\n  await harness.commit(async (tx) => {\n    const doc = await tx.doc(LicksHostDoc);\n    for (const name of stale) delete doc.cron[name];\n    for (const entry of create) {\n      const input: CronInput = { ...entry, from: options.now() };\n      const task = await tx.createTask(options.cron, input, {\n        ownership: { kind: 'conversation' },\n        conversationId: options.root.id,\n        background: true,\n      });\n      doc.cron[entry.name] = { ...entry, task };\n    }\n  }, context);\n}\n"],
+  "mappings": "AACA;AAAA,EAEE;AAAA,OAGK;AAmBA,MAAM,eAAe,UAAqB;AAAA,EAC/C,MAAM;AAAA,EACN,SAAS;AAAA,EACT,OAAO;AAAA,EACP,SAAS,OAAO,EAAE,MAAM,CAAC,GAAG,OAAO,MAAM,MAAM,MAAM,MAAM,GAAG,UAAU,EAAE;AAC5E,CAAC;AAED,SAAS,KAAK,OAA8B,QAA6B;AACvE,SACE,UAAU,UACV,MAAM,aAAa,OAAO,YAC1B,MAAM,WAAW,OAAO,UACxB,MAAM,YAAY,OAAO;AAE7B;AAEA,eAAe,KAAK,SAAkB,MAAc,SAAoC;AACtF,QAAM,SAAS,MAAM,QAAQ,QAAQ,MAAgB,OAAO;AAC5D,SAAO,WAAW,UAAa,OAAO,MAAM,WAAW;AACzD;AAEA,eAAsB,cACpB,SAMA,SACA,SACe;AACf,QAAM,EAAE,QAAQ,IAAI;AACpB,QAAM,SAAS,IAAI,IAAI,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC;AAClE,QAAM,UACH,MAAM,QAAQ,SAAS,cAAc,OAAO,IAAI,QAAQ,CAAC;AAC5D,QAAM,QAAkB,CAAC;AACzB,QAAM,SAAsB,QAAQ,OAAO,CAAC,UAAU,CAAC,OAAO,MAAM,IAAI,CAAC;AACzE,aAAW,CAAC,MAAM,MAAM,KAAK,OAAO,QAAQ,MAAM,GAAG;AACnD,UAAM,QAAQ,OAAO,IAAI,IAAI;AAC7B,UAAM,UAAU,MAAM,KAAK,SAAS,OAAO,MAAM,OAAO;AACxD,QAAI,KAAK,OAAO,MAAM,KAAK,QAAS;AACpC,UAAM,KAAK,IAAI;AACf,QAAI,QAAS,OAAM,QAAQ,UAAU,OAAO,MAAgB,OAAO;AACnE,QAAI,MAAO,QAAO,KAAK,KAAK;AAAA,EAC9B;AACA,MAAI,CAAC,MAAM,UAAU,CAAC,OAAO,OAAQ;AACrC,QAAM,QAAQ,OAAO,OAAO,OAAO;AACjC,UAAM,MAAM,MAAM,GAAG,IAAI,YAAY;AACrC,eAAW,QAAQ,MAAO,QAAO,IAAI,KAAK,IAAI;AAC9C,eAAW,SAAS,QAAQ;AAC1B,YAAM,QAAmB,EAAE,GAAG,OAAO,MAAM,QAAQ,IAAI,EAAE;AACzD,YAAM,OAAO,MAAM,GAAG,WAAW,QAAQ,MAAM,OAAO;AAAA,QACpD,WAAW,EAAE,MAAM,eAAe;AAAA,QAClC,gBAAgB,QAAQ,KAAK;AAAA,QAC7B,YAAY;AAAA,MACd,CAAC;AACD,UAAI,KAAK,MAAM,IAAI,IAAI,EAAE,GAAG,OAAO,KAAK;AAAA,IAC1C;AAAA,EACF,GAAG,OAAO;AACZ;",
+  "names": []
+}

package/dist/licks/sources.js

@@ -0,0 +1,138 @@
+import { bootLicks } from "./boot.js";
+import { parseCrontab, parseWebhook } from "./config.js";
+import { configFiles, Watches } from "./fswatch.js";
+import { reconcileCron } from "./schedules.js";
+const SLICC_DIR = ".slicc";
+function hash(text) {
+  let value = 2166136261;
+  for (let at = 0; at < text.length; at++) value = Math.imul(value ^ text.charCodeAt(at), 16777619);
+  return (value >>> 0).toString(36);
+}
+function shortPath(path, home) {
+  return path === home || path.startsWith(`${home}/`) ? `~${path.slice(home.length)}` : path;
+}
+function configLick(error, home) {
+  const file = shortPath(error.file, home);
+  const channel = error.file.includes("/watches/") ? "fswatch" : error.file.includes("/webhooks/") ? "webhook" : "cron";
+  const text = `${error.line ? `line ${error.line}: ` : ""}${error.error}`;
+  return {
+    channel,
+    source: `config:${file}`,
+    title: `Invalid ${file}`,
+    text,
+    body: "Ignored until the file is fixed.\nThe formats are in the slicc-agent README.",
+    target: "cone",
+    eventId: hash(`${file}
+${text}`)
+  };
+}
+function webhookLick(name, entry, delivery) {
+  const payload = typeof delivery.body === "string" ? delivery.body : JSON.stringify(delivery.body, null, 2);
+  const headers = Object.entries(delivery.headers ?? {}).map(([key, value]) => `${key}: ${value}`).join("\n");
+  return {
+    channel: "webhook",
+    source: name,
+    title: name,
+    text: entry.message || `Webhook ${name} received a request`,
+    body: [headers, payload].filter(Boolean).join("\n\n"),
+    target: entry.target,
+    coalesce: false,
+    ...delivery.id ? { eventId: delivery.id } : {}
+  };
+}
+async function webhooksIn(files, dir, into, context) {
+  const errors = [];
+  into.clear();
+  for (const name of await files.list(dir, context)) {
+    const file = `${dir}/${name}`;
+    const json = await files.read(file, context);
+    if (json === void 0) continue;
+    try {
+      const entry = parseWebhook(file, json);
+      into.set(entry.name, entry);
+    } catch (error) {
+      errors.push({ file, error: error.message });
+    }
+  }
+  return errors;
+}
+function createLickSources(options) {
+  const { harness, env, licks, home } = options;
+  const dir = `${home}/${SLICC_DIR}`;
+  const now = options.now ?? Date.now;
+  const files = configFiles(env);
+  const deliver = (event, context) => licks.deliver(event, context);
+  const watches = new Watches(env, deliver, home, options.activity);
+  const webhooks = /* @__PURE__ */ new Map();
+  let control;
+  let reconcileTimer;
+  let flushTimer;
+  let closed = false;
+  let lock = Promise.resolve();
+  const serial = (operation) => {
+    const run = lock.then(operation, operation);
+    lock = run.catch(() => void 0);
+    return run;
+  };
+  async function reconcileNow(context) {
+    if (closed) return;
+    const crontabFile = `${dir}/crontab`;
+    const crontab = parseCrontab(crontabFile, await files.read(crontabFile, context) ?? "");
+    await reconcileCron({ ...options, now }, crontab.entries, context);
+    const errors = [
+      ...crontab.errors,
+      ...await watches.reconcile(`${dir}/watches`, context),
+      ...await webhooksIn(files, `${dir}/webhooks`, webhooks, context)
+    ];
+    for (const error of errors) await deliver(configLick(error, home), context);
+  }
+  const reconcile = (context) => serial(() => reconcileNow(context));
+  function scheduleReconcile(context) {
+    clearTimeout(reconcileTimer);
+    reconcileTimer = setTimeout(() => {
+      void reconcile(context).catch(() => void 0);
+    }, 300);
+  }
+  async function flushIfWaiting(context) {
+    if (await licks.pending(context)) await licks.flush(context);
+  }
+  return {
+    async start(context) {
+      await licks.flush(context);
+      await reconcile(context);
+      const result = await env.watch(
+        [{ path: dir, recursive: true }],
+        () => scheduleReconcile(context),
+        context
+      );
+      if (result.ok) control = result.value;
+      flushTimer = setInterval(() => {
+        void flushIfWaiting(context).catch(() => void 0);
+      }, options.flushEvery ?? 2e3);
+    },
+    reconcile,
+    boot: (facts, context) => bootLicks(harness, options.cone(), deliver, facts, context),
+    async webhook(name, delivery, context) {
+      const entry = webhooks.get(name);
+      if (!entry) return false;
+      await deliver(webhookLick(name, entry, delivery), context);
+      return true;
+    },
+    async close(context) {
+      closed = true;
+      clearTimeout(reconcileTimer);
+      clearInterval(flushTimer);
+      await control?.close(context);
+      await watches.close(context);
+    }
+  };
+}
+export {
+  SLICC_DIR,
+  configLick,
+  createLickSources,
+  hash,
+  shortPath,
+  webhookLick
+};
+//# sourceMappingURL=sources.js.map