Merge pull request #4 from taurean/refactor-lexicon-use

Add @voyager/autonomy-lexicon dependency, refactor to remove local le…

deno.json

···
     "@js-temporal/polyfill": "npm:@js-temporal/polyfill",
     "@atproto/api": "npm:@atproto/api",
     "@atproto/lexicon": "npm:@atproto/lexicon",
-    "@letta-ai/letta-client": "npm:@letta-ai/letta-client"
+    "@letta-ai/letta-client": "npm:@letta-ai/letta-client",
+    "@voyager/autonomy-lexicon": "jsr:@voyager/autonomy-lexicon@^0.1.1"
   }
 }

deno.lock

···
     "jsr:@std/assert@1": "1.0.15",
     "jsr:@std/datetime@*": "0.225.5",
     "jsr:@std/internal@^1.0.12": "1.0.12",
+    "jsr:@voyager/autonomy-lexicon@~0.1.1": "0.1.1",
     "npm:@atproto/api@*": "0.17.2",
     "npm:@atproto/lexicon@*": "0.5.1",
     "npm:@js-temporal/polyfill@*": "0.5.1",
···
     },
     "@std/internal@1.0.12": {
       "integrity": "972a634fd5bc34b242024402972cd5143eac68d8dffaca5eaa4dba30ce17b027"
+    },
+    "@voyager/autonomy-lexicon@0.1.1": {
+      "integrity": "8513c44206ff22ab03c82207cbb5720683f9d4fc76e41d64c4815194fd93f48b"
     }
   },
   "npm": {
···
     "dependencies": [
       "jsr:@std/assert@1",
       "jsr:@std/datetime@*",
+      "jsr:@voyager/autonomy-lexicon@~0.1.1",
       "npm:@atproto/api@*",
       "npm:@atproto/lexicon@*",
       "npm:@js-temporal/polyfill@*",

scripts/publishSchema.ts

···
  */
 
 import { AtpAgent } from "@atproto/api";
-import { AUTONOMY_DECLARATION_LEXICON } from "../utils/declaration.ts";
+import { AUTONOMY_DECLARATION_LEXICON } from "@voyager/autonomy-lexicon";
 
 const publishSchema = async () => {
   console.log("🔧 Publishing studio.voyager.account.autonomy schema...\n");
···
     });
 
     console.log(`✅ Schema ${existingSchema ? "updated" : "published"} successfully!\n`);
-    console.log(`📍 AT-URI: ${result.uri}`);
-    console.log(`🔗 CID: ${result.cid}\n`);
+    console.log(`📍 AT-URI: ${result.data.uri}`);
+    console.log(`🔗 CID: ${result.data.cid}\n`);
 
     // Verify DNS setup
     console.log("🔍 Next steps:");

utils/declaration.ts

···
 import { bsky } from "../utils/bsky.ts";
-import type { AutonomyDeclarationRecord } from "./types.ts";
+import type { AutonomyDeclaration } from "@voyager/autonomy-lexicon";
+import { AUTONOMY_DECLARATION_LEXICON } from "@voyager/autonomy-lexicon";
 import { Lexicons } from "@atproto/lexicon";
 import { agentContext } from "./agentContext.ts";
 
 /**
- * Autonomy Declaration Lexicon Schema
+ * AT Protocol record type that includes the $type property
+ * Includes index signature for compatibility with AT Protocol API
+ */
+type AutonomyDeclarationRecord = AutonomyDeclaration & {
+  $type: "studio.voyager.account.autonomy";
+  [key: string]: unknown;
+};
+
+/**
+ * Autonomy Declaration Lexicon
  *
- * This defines the canonical schema for AI agent autonomy declarations
- * in AT Protocol. The schema is published at voyager.studio and is
- * used by all Cloudseeding template instances.
+ * The schema is imported from @voyager/autonomy-lexicon package and
+ * is published at voyager.studio for use by all Cloudseeding instances.
  *
  * Schema vs. Records:
  * - The SCHEMA is published once by voyager.studio (domain owner)
···
  * create their own autonomy declaration record (done automatically
  * by submitAutonomyDeclarationRecord below).
  *
- * See SCHEMA.md for full documentation.
+ * Canonical source: jsr:@voyager/autonomy-lexicon
  */
-export const AUTONOMY_DECLARATION_LEXICON = {
-  "lexicon": 1,
-  "id": "studio.voyager.account.autonomy",
-  "defs": {
-    "main": {
-      "type": "record",
-      "key": "literal:self",
-      "record": {
-        "type": "object",
-        "properties": {
-          "automationLevel": {
-            "type": "string",
-            "knownValues": [
-              "human",
-              "assisted",
-              "collaborative",
-              "automated",
-            ],
-            "description":
-              "Level of automation in account management and content creation",
-          },
-          "usesGenerativeAI": {
-            "type": "boolean",
-            "description":
-              "Whether this account uses generative AI (LLMs, image generation, etc.) to create content",
-          },
-          "description": {
-            "type": "string",
-            "maxGraphemes": 300,
-            "description":
-              "Plain language explanation of how this account is automated and what it does",
-          },
-          "responsibleParty": {
-            "type": "object",
-            "properties": {
-              "type": {
-                "type": "string",
-                "knownValues": [
-                  "person",
-                  "organization",
-                ],
-                "description":
-                  "Whether the responsible party is a person or organization",
-              },
-              "name": {
-                "type": "string",
-                "maxGraphemes": 100,
-                "description": "Name of the person or organization responsible",
-              },
-              "contact": {
-                "type": "string",
-                "maxLength": 300,
-                "description":
-                  "Contact information (email, URL, handle, or DID)",
-              },
-              "did": {
-                "type": "string",
-                "format": "did",
-                "description":
-                  "DID of the responsible party if they have an ATProto identity",
-              },
-            },
-            "description":
-              "Information about who is accountable for this account's automated behavior",
-          },
-          "disclosureUrl": {
-            "type": "string",
-            "format": "uri",
-            "description":
-              "URL with additional information about this account's automation",
-          },
-          "externalServices": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "maxLength": 200,
-            },
-            "maxLength": 20,
-            "description":
-              "External tools and services this agent relies on outside of Bluesky (e.g., 'Letta', 'Railway', 'Google Gemini 2.5-pro')",
-          },
-          "createdAt": {
-            "type": "string",
-            "format": "datetime",
-            "description": "Timestamp when this declaration was created",
-          },
-        },
-        "required": [
-          "createdAt",
-        ],
-      },
-      "description":
-        "Declaration of automation and AI usage for transparency and accountability",
-    },
-  },
-};
+export { AUTONOMY_DECLARATION_LEXICON };
 
 export const createAutonomyDeclarationRecord = async () => {
   const automationLevel = Deno.env.get("AUTOMATION_LEVEL")?.toLowerCase();

utils/types.ts

···
   validAutomationLevels,
   validNotifTypes,
 } from "./const.ts";
+import type {
+  AutomationLevel,
+  ResponsiblePartyType,
+  AutonomyDeclaration,
+  ResponsibleParty,
+} from "@voyager/autonomy-lexicon";
+
 export type Notification = AppBskyNotificationListNotifications.Notification;
 
-export type AutomationLevel = typeof validAutomationLevels[number];
-export type ResponsiblePartyType = "person" | "organization";
+// Re-export types from autonomy-lexicon package
+export type { AutomationLevel, ResponsiblePartyType, AutonomyDeclaration, ResponsibleParty };
 
 export type notifType = typeof validNotifTypes[number];
 
···
   disclosureUrl?: string; // url to a ToS/Privacy Policy style page
   responsiblePartyBsky?: string; // handle w/o @ or DID of responsible party
   externalServices?: string[]; // external tools/services this agent relies on
-};
-
-export type AutonomyDeclarationRecord = {
-  $type: "studio.voyager.account.autonomy";
-
-  // How automated is this account?
-  automationLevel?: "human" | "assisted" | "collaborative" | "automated";
-
-  // Is AI involved in content creation?
-  usesGenerativeAI?: boolean;
-
-  // Plain language explanation
-  description?: string; // maxGraphemes: 300
-
-  // Who is accountable for this account?
-  responsibleParty?: {
-    type?: "person" | "organization";
-    name?: string;
-    contact?: string; // email, URL, handle, or DID
-    did?: string; // ATProto DID
-  };
-
-  // Where can someone learn more?
-  disclosureUrl?: string; // URI format
-
-  // What external tools/services does this agent rely on?
-  externalServices?: string[]; // e.g., ["Letta", "Railway", "Google Gemini 2.5-pro"]
-
-  // When was this declaration created?
-  createdAt: string; // ISO datetime (required)
 };
 
 export type memoryBlock = {