@kodelyth/tlon 2026.5.39 → 2026.5.42

package/klaw.plugin.json

@@ -3,214 +3,14 @@
   "activation": {
     "onStartup": false
   },
-  "channels": [
-    "tlon"
-  ],
+  "channels": ["tlon"],
   "contracts": {
-    "tools": [
-      "tlon"
-    ]
+    "tools": ["tlon"]
   },
-  "skills": [
-    "./bundled-skills/@tloncorp/tlon-skill"
-  ],
+  "skills": ["node_modules/@tloncorp/tlon-skill"],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {}
-  },
-  "channelConfigs": {
-    "tlon": {
-      "schema": {
-        "$schema": "http://json-schema.org/draft-07/schema#",
-        "type": "object",
-        "properties": {
-          "name": {
-            "type": "string"
-          },
-          "enabled": {
-            "type": "boolean"
-          },
-          "ship": {
-            "type": "string",
-            "minLength": 1
-          },
-          "url": {
-            "type": "string"
-          },
-          "code": {
-            "type": "string"
-          },
-          "network": {
-            "type": "object",
-            "properties": {
-              "dangerouslyAllowPrivateNetwork": {
-                "type": "boolean"
-              }
-            },
-            "additionalProperties": false
-          },
-          "groupChannels": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            }
-          },
-          "dmAllowlist": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            }
-          },
-          "groupInviteAllowlist": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            }
-          },
-          "autoDiscoverChannels": {
-            "type": "boolean"
-          },
-          "showModelSignature": {
-            "type": "boolean"
-          },
-          "responsePrefix": {
-            "type": "string"
-          },
-          "autoAcceptDmInvites": {
-            "type": "boolean"
-          },
-          "autoAcceptGroupInvites": {
-            "type": "boolean"
-          },
-          "ownerShip": {
-            "type": "string",
-            "minLength": 1
-          },
-          "authorization": {
-            "type": "object",
-            "properties": {
-              "channelRules": {
-                "type": "object",
-                "propertyNames": {
-                  "type": "string"
-                },
-                "additionalProperties": {
-                  "type": "object",
-                  "properties": {
-                    "mode": {
-                      "type": "string",
-                      "enum": [
-                        "restricted",
-                        "open"
-                      ]
-                    },
-                    "allowedShips": {
-                      "type": "array",
-                      "items": {
-                        "type": "string",
-                        "minLength": 1
-                      }
-                    }
-                  },
-                  "additionalProperties": false
-                }
-              }
-            },
-            "additionalProperties": false
-          },
-          "defaultAuthorizedShips": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            }
-          },
-          "accounts": {
-            "type": "object",
-            "propertyNames": {
-              "type": "string"
-            },
-            "additionalProperties": {
-              "type": "object",
-              "properties": {
-                "name": {
-                  "type": "string"
-                },
-                "enabled": {
-                  "type": "boolean"
-                },
-                "ship": {
-                  "type": "string",
-                  "minLength": 1
-                },
-                "url": {
-                  "type": "string"
-                },
-                "code": {
-                  "type": "string"
-                },
-                "network": {
-                  "type": "object",
-                  "properties": {
-                    "dangerouslyAllowPrivateNetwork": {
-                      "type": "boolean"
-                    }
-                  },
-                  "additionalProperties": false
-                },
-                "groupChannels": {
-                  "type": "array",
-                  "items": {
-                    "type": "string",
-                    "minLength": 1
-                  }
-                },
-                "dmAllowlist": {
-                  "type": "array",
-                  "items": {
-                    "type": "string",
-                    "minLength": 1
-                  }
-                },
-                "groupInviteAllowlist": {
-                  "type": "array",
-                  "items": {
-                    "type": "string",
-                    "minLength": 1
-                  }
-                },
-                "autoDiscoverChannels": {
-                  "type": "boolean"
-                },
-                "showModelSignature": {
-                  "type": "boolean"
-                },
-                "responsePrefix": {
-                  "type": "string"
-                },
-                "autoAcceptDmInvites": {
-                  "type": "boolean"
-                },
-                "autoAcceptGroupInvites": {
-                  "type": "boolean"
-                },
-                "ownerShip": {
-                  "type": "string",
-                  "minLength": 1
-                }
-              },
-              "additionalProperties": false
-            }
-          }
-        },
-        "additionalProperties": false
-      },
-      "label": "Tlon",
-      "description": "decentralized messaging on Urbit; install the plugin to enable."
-    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodelyth/tlon",
-  "version": "2026.5.39",
+  "version": "2026.5.42",
   "description": "Klaw Tlon/Urbit channel plugin",
   "repository": {
     "type": "git",
@@ -16,7 +16,7 @@
   },
   "devDependencies": {
     "@kodelyth/plugin-sdk": "1.0.1",
-    "@kodelyth/klaw": "2026.5.41"
+    "@kodelyth/klaw": "2026.5.42"
   },
   "peerDependencies": {
     "@kodelyth/klaw": ">=2026.5.19"
@@ -28,9 +28,9 @@
   },
   "klaw": {
     "extensions": [
-      "./index.js"
+      "./index.ts"
     ],
-    "setupEntry": "./setup-entry.js",
+    "setupEntry": "./setup-entry.ts",
     "channel": {
       "id": "tlon",
       "label": "Tlon",

package/runtime-api.ts

@@ -0,0 +1,17 @@
+// Private runtime barrel for the bundled Tlon extension.
+// Keep this barrel thin and aligned with the local extension surface.
+
+export type { ReplyPayload } from "klaw/plugin-sdk/reply-runtime";
+export type { KlawConfig } from "klaw/plugin-sdk/config-contracts";
+export type { RuntimeEnv } from "klaw/plugin-sdk/runtime";
+export { createDedupeCache } from "klaw/plugin-sdk/core";
+export { createLoggerBackedRuntime } from "./src/logger-runtime.js";
+export {
+  fetchWithSsrFGuard,
+  isBlockedHostnameOrIp,
+  ssrfPolicyFromAllowPrivateNetwork,
+  ssrfPolicyFromDangerouslyAllowPrivateNetwork,
+  type LookupFn,
+  type SsrFPolicy,
+} from "klaw/plugin-sdk/ssrf-runtime";
+export { SsrFBlockedError } from "klaw/plugin-sdk/ssrf-runtime";

package/setup-api.ts

@@ -0,0 +1,2 @@
+export { tlonSetupAdapter } from "./src/setup-core.js";
+export { tlonSetupWizard } from "./src/setup-surface.js";

package/setup-entry.ts

@@ -0,0 +1,9 @@
+import { defineBundledChannelSetupEntry } from "klaw/plugin-sdk/channel-entry-contract";
+
+export default defineBundledChannelSetupEntry({
+  importMetaUrl: import.meta.url,
+  plugin: {
+    specifier: "./api.js",
+    exportName: "tlonPlugin",
+  },
+});

package/src/account-fields.ts

@@ -0,0 +1,31 @@
+export type TlonAccountFieldsInput = {
+  ship?: string;
+  url?: string;
+  code?: string;
+  dangerouslyAllowPrivateNetwork?: boolean;
+  groupChannels?: string[];
+  dmAllowlist?: string[];
+  autoDiscoverChannels?: boolean;
+  ownerShip?: string;
+};
+
+export function buildTlonAccountFields(input: TlonAccountFieldsInput) {
+  return {
+    ...(input.ship ? { ship: input.ship } : {}),
+    ...(input.url ? { url: input.url } : {}),
+    ...(input.code ? { code: input.code } : {}),
+    ...(typeof input.dangerouslyAllowPrivateNetwork === "boolean"
+      ? {
+          network: {
+            dangerouslyAllowPrivateNetwork: input.dangerouslyAllowPrivateNetwork,
+          },
+        }
+      : {}),
+    ...(input.groupChannels ? { groupChannels: input.groupChannels } : {}),
+    ...(input.dmAllowlist ? { dmAllowlist: input.dmAllowlist } : {}),
+    ...(typeof input.autoDiscoverChannels === "boolean"
+      ? { autoDiscoverChannels: input.autoDiscoverChannels }
+      : {}),
+    ...(input.ownerShip ? { ownerShip: input.ownerShip } : {}),
+  };
+}

package/src/channel.message-adapter.test.ts

@@ -0,0 +1,145 @@
+import { verifyChannelMessageAdapterCapabilityProofs } from "klaw/plugin-sdk/channel-message";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import type { KlawConfig } from "../runtime-api.js";
+
+const mocks = vi.hoisted(() => ({
+  sendText: vi.fn(),
+  sendMedia: vi.fn(),
+}));
+
+vi.mock("./channel.runtime.js", () => ({
+  tlonRuntimeOutbound: {
+    sendText: mocks.sendText,
+    sendMedia: mocks.sendMedia,
+  },
+}));
+
+import { tlonPlugin } from "./channel.js";
+
+const cfg = {
+  channels: {
+    tlon: {
+      ship: "~zod",
+      url: "https://zod.example",
+      code: "lidlut-tabwed-pillex-ridrup",
+    },
+  },
+} as KlawConfig;
+
+describe("tlon channel message adapter", () => {
+  beforeEach(() => {
+    mocks.sendText.mockReset();
+    mocks.sendMedia.mockReset();
+    mocks.sendText.mockResolvedValue({
+      channel: "tlon",
+      messageId: "~zod/1700000000000",
+      conversationId: "~nec/general",
+    });
+    mocks.sendMedia.mockResolvedValue({
+      channel: "tlon",
+      messageId: "~zod/1700000000001",
+      conversationId: "~nec/general",
+    });
+  });
+
+  it("backs declared durable-final capabilities with outbound send proofs", async () => {
+    const adapter = tlonPlugin.message;
+    if (!adapter?.send?.text || !adapter.send.media) {
+      throw new Error("expected tlon channel message adapter with text and media senders");
+    }
+    const sendText = adapter.send.text;
+    const sendMedia = adapter.send.media;
+
+    const proveText = async () => {
+      mocks.sendText.mockClear();
+      const result = await sendText({
+        cfg,
+        to: "chat/~nec/general",
+        text: "hello",
+        accountId: "default",
+      });
+      expect(mocks.sendText).toHaveBeenLastCalledWith({
+        cfg,
+        to: "chat/~nec/general",
+        text: "hello",
+        accountId: "default",
+        replyToId: undefined,
+        threadId: undefined,
+      });
+      expect(result.receipt.platformMessageIds).toEqual(["~zod/1700000000000"]);
+      expect(result.receipt.parts[0]?.kind).toBe("text");
+    };
+
+    const proveMedia = async () => {
+      mocks.sendMedia.mockClear();
+      const result = await sendMedia({
+        cfg,
+        to: "chat/~nec/general",
+        text: "image",
+        mediaUrl: "https://example.com/image.png",
+        accountId: "default",
+      });
+      expect(mocks.sendMedia).toHaveBeenLastCalledWith({
+        cfg,
+        to: "chat/~nec/general",
+        text: "image",
+        mediaUrl: "https://example.com/image.png",
+        accountId: "default",
+        replyToId: undefined,
+        threadId: undefined,
+      });
+      expect(result.receipt.platformMessageIds).toEqual(["~zod/1700000000001"]);
+      expect(result.receipt.parts[0]?.kind).toBe("media");
+    };
+
+    const proveReplyThread = async () => {
+      mocks.sendText.mockClear();
+      const result = await sendText({
+        cfg,
+        to: "chat/~nec/general",
+        text: "threaded",
+        accountId: "default",
+        replyToId: "1700000000000",
+        threadId: "1700000000000",
+      });
+      expect(mocks.sendText).toHaveBeenLastCalledWith({
+        cfg,
+        to: "chat/~nec/general",
+        text: "threaded",
+        accountId: "default",
+        replyToId: "1700000000000",
+        threadId: "1700000000000",
+      });
+      expect(result.receipt.replyToId).toBe("1700000000000");
+      expect(result.receipt.threadId).toBe("1700000000000");
+    };
+
+    const proofs = await verifyChannelMessageAdapterCapabilityProofs({
+      adapterName: "tlonMessageAdapter",
+      adapter,
+      proofs: {
+        text: proveText,
+        media: proveMedia,
+        replyTo: proveReplyThread,
+        thread: proveReplyThread,
+        messageSendingHooks: () => {
+          expect(sendText).toBeTypeOf("function");
+        },
+      },
+    });
+    expect(proofs).toStrictEqual([
+      { capability: "text", status: "verified" },
+      { capability: "media", status: "verified" },
+      { capability: "payload", status: "not_declared" },
+      { capability: "silent", status: "not_declared" },
+      { capability: "replyTo", status: "verified" },
+      { capability: "thread", status: "verified" },
+      { capability: "nativeQuote", status: "not_declared" },
+      { capability: "messageSendingHooks", status: "verified" },
+      { capability: "batch", status: "not_declared" },
+      { capability: "reconcileUnknownSend", status: "not_declared" },
+      { capability: "afterSendSuccess", status: "not_declared" },
+      { capability: "afterCommit", status: "not_declared" },
+    ]);
+  });
+});