@kodelyth/tlon 2026.5.42 → 2026.6.1

package/klaw.plugin.json

@@ -3,14 +3,214 @@
   "activation": {
     "onStartup": false
   },
-  "channels": ["tlon"],
+  "channels": [
+    "tlon"
+  ],
   "contracts": {
-    "tools": ["tlon"]
+    "tools": [
+      "tlon"
+    ]
   },
-  "skills": ["node_modules/@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.42",
+  "version": "2026.6.1",
   "description": "Klaw Tlon/Urbit channel plugin",
   "repository": {
     "type": "git",
@@ -19,11 +19,15 @@
     "@kodelyth/klaw": "2026.5.42"
   },
   "peerDependencies": {
-    "@kodelyth/klaw": ">=2026.5.19"
+    "@kodelyth/klaw": ">=2026.5.19",
+    "klaw": ">=2026.5.39"
   },
   "peerDependenciesMeta": {
     "@kodelyth/klaw": {
       "optional": true
+    },
+    "klaw": {
+      "optional": true
     }
   },
   "klaw": {
@@ -81,6 +85,15 @@
     "release": {
       "publishToClawHub": true,
       "publishToNpm": true
-    }
-  }
+    },
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ],
+    "runtimeSetupEntry": "./dist/setup-entry.js"
+  },
+  "files": [
+    "dist/**",
+    "klaw.plugin.json",
+    "README.md"
+  ]
 }

package/api.ts

@@ -1,16 +0,0 @@
-export {
-  createDedupeCache,
-  createLoggerBackedRuntime,
-  fetchWithSsrFGuard,
-  isBlockedHostnameOrIp,
-  type LookupFn,
-  type KlawConfig,
-  type ReplyPayload,
-  type RuntimeEnv,
-  SsrFBlockedError,
-  type SsrFPolicy,
-  ssrfPolicyFromAllowPrivateNetwork,
-  ssrfPolicyFromDangerouslyAllowPrivateNetwork,
-} from "./runtime-api.js";
-export { tlonPlugin } from "./src/channel.js";
-export { setTlonRuntime } from "./src/runtime.js";

package/channel-plugin-api.ts

@@ -1 +0,0 @@
-export { tlonPlugin } from "./src/channel.js";

package/doctor-contract-api.ts

@@ -1 +0,0 @@
-export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";

package/index.ts

@@ -1,16 +0,0 @@
-import { defineBundledChannelEntry } from "klaw/plugin-sdk/channel-entry-contract";
-
-export default defineBundledChannelEntry({
-  id: "tlon",
-  name: "Tlon",
-  description: "Tlon/Urbit channel plugin",
-  importMetaUrl: import.meta.url,
-  plugin: {
-    specifier: "./channel-plugin-api.js",
-    exportName: "tlonPlugin",
-  },
-  runtime: {
-    specifier: "./api.js",
-    exportName: "setTlonRuntime",
-  },
-});

package/runtime-api.ts

@@ -1,17 +0,0 @@
-// 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

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

package/setup-entry.ts

@@ -1,9 +0,0 @@
-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

@@ -1,31 +0,0 @@
-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

@@ -1,145 +0,0 @@
-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" },
-    ]);
-  });
-});