@agentforge-io/core 3.4.0 → 4.0.2

package/dist/domain/conversation.d.ts

@@ -1,6 +1,14 @@
 import type { ConversationStatus, MessageRole, ToolCallRecord, TokenUsage } from '../types/agent.types';
 export interface Conversation {
     id: string;
+    /** Short, URL-friendly public handle (nanoid). Preferred over `id`
+     *  for links, deep-link params (`?c=`/`?conv=`) and SDK resume — it's
+     *  shorter and doesn't leak the internal UUID. Generated on create.
+     *  Optional in the type so persistence adapters that predate the
+     *  column (older @agentforge-io/typeorm builds) still satisfy the
+     *  contract during the rollout — once every adapter ships the column
+     *  this can be tightened to required. */
+    code?: string;
     userId: string;
     agentId: string;
     title?: string;
@@ -50,6 +58,9 @@ export type NewMessage = Omit<Message, 'id' | 'createdAt'>;
  */
 export interface ConversationListItem {
     id: string;
+    /** Short public handle — see `Conversation.code`. Optional during the
+     *  rollout (older typeorm builds don't select it yet). */
+    code?: string;
     userId: string;
     agentId: string;
     status: ConversationStatus;

package/dist/repositories/in-memory.d.ts

@@ -5,6 +5,7 @@ export declare class InMemoryConversationRepository implements ConversationRepos
     private byId;
     create(c: NewConversation): Promise<Conversation>;
     findById(id: string): Promise<Conversation | null>;
+    findByCode(code: string): Promise<Conversation | null>;
     findByIdForUser(id: string, userId: string): Promise<Conversation | null>;
     listForUser(userId: string, opts?: {
         status?: ConversationStatus;

package/dist/repositories/in-memory.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.InMemoryMessageRepository = exports.InMemoryConversationRepository = void 0;
 exports.createInMemoryRepositories = createInMemoryRepositories;
 const crypto_1 = require("crypto");
+const conversation_service_1 = require("../services/conversation.service");
 class InMemoryConversationRepository {
     constructor() {
         this.byId = new Map();
@@ -14,6 +15,7 @@ class InMemoryConversationRepository {
         const now = new Date();
         const full = {
             id: (0, crypto_1.randomUUID)(),
+            code: (0, conversation_service_1.generateConversationCode)(),
             status: 'active',
             totalInputTokens: 0,
             totalOutputTokens: 0,
@@ -28,6 +30,13 @@ class InMemoryConversationRepository {
     async findById(id) {
         return this.byId.get(id) ?? null;
     }
+    async findByCode(code) {
+        for (const c of this.byId.values()) {
+            if (c.code === code)
+                return c;
+        }
+        return null;
+    }
     async findByIdForUser(id, userId) {
         const c = this.byId.get(id);
         return c && c.userId === userId ? c : null;
@@ -54,6 +63,7 @@ class InMemoryConversationRepository {
         return {
             items: all.slice(start, end).map((c) => ({
                 id: c.id,
+                code: c.code,
                 userId: c.userId,
                 agentId: c.agentId,
                 status: c.status,

package/dist/repositories/index.d.ts

@@ -11,6 +11,11 @@ export declare const CONNECTOR_AUTH_REPOSITORY = "AGENTFORGE_CONNECTOR_AUTH_REPO
 export interface ConversationRepository {
     create(conv: NewConversation): Promise<Conversation>;
     findById(id: string): Promise<Conversation | null>;
+    /** Look a conversation up by its short public `code` (nanoid).
+     *  Optional during rollout — adapters that predate the column don't
+     *  implement it yet; callers must feature-detect (see
+     *  `ConversationService.getByCode`). */
+    findByCode?(code: string): Promise<Conversation | null>;
     /** Same as findById but also enforces ownership — used in user-scoped routes. */
     findByIdForUser(id: string, userId: string): Promise<Conversation | null>;
     /**

package/dist/services/conversation.service.d.ts

@@ -6,6 +6,13 @@ export declare class ConversationNotFoundError extends Error {
     code: string;
     constructor(id: string);
 }
+/**
+ * Generate a short, URL-friendly conversation `code` (nanoid-style).
+ * 31^12 ≈ 7.6e17 combinations — collisions are negligible; the unique
+ * index on the column is the backstop. Uses `crypto.randomBytes` so we
+ * don't add a nanoid dependency to the shared packages.
+ */
+export declare function generateConversationCode(length?: number): string;
 export declare class ConversationService {
     private readonly convRepo;
     private readonly msgRepo;
@@ -16,6 +23,14 @@ export declare class ConversationService {
         title?: string;
         metadata?: Record<string, unknown>;
     }): Promise<Conversation>;
+    /** Resolve a conversation by its short public `code`. Returns `null`
+     *  when no conversation carries that code, or when the wired repo
+     *  adapter predates the column (no `findByCode`). */
+    findByCode(code: string): Promise<Conversation | null>;
+    /** Resolve a conversation by `code`, enforcing ownership. Throws
+     *  `ConversationNotFoundError` (ambiguous on purpose) when the code is
+     *  unknown OR belongs to another user — same contract as `loadOwned`. */
+    getByCode(code: string, userId: string): Promise<Conversation>;
     addMessage(params: {
         conversationId: string;
         userId: string;

package/dist/services/conversation.service.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConversationService = exports.ConversationNotFoundError = void 0;
+exports.generateConversationCode = generateConversationCode;
+const crypto_1 = require("crypto");
 class ConversationNotFoundError extends Error {
     constructor(id) {
         super(`Conversation "${id}" not found`);
@@ -9,6 +11,24 @@ class ConversationNotFoundError extends Error {
     }
 }
 exports.ConversationNotFoundError = ConversationNotFoundError;
+/** Alphabet for conversation codes. Lowercase + digits, minus the
+ *  ambiguous glyphs (0/o/1/l/i) so a code stays readable when shared. */
+const CODE_ALPHABET = 'abcdefghjkmnpqrstuvwxyz23456789';
+const CODE_LENGTH = 12;
+/**
+ * Generate a short, URL-friendly conversation `code` (nanoid-style).
+ * 31^12 ≈ 7.6e17 combinations — collisions are negligible; the unique
+ * index on the column is the backstop. Uses `crypto.randomBytes` so we
+ * don't add a nanoid dependency to the shared packages.
+ */
+function generateConversationCode(length = CODE_LENGTH) {
+    const bytes = (0, crypto_1.randomBytes)(length);
+    let out = '';
+    for (let i = 0; i < length; i++) {
+        out += CODE_ALPHABET[bytes[i] % CODE_ALPHABET.length];
+    }
+    return out;
+}
 class ConversationService {
     constructor(convRepo, msgRepo) {
         this.convRepo = convRepo;
@@ -20,12 +40,33 @@ class ConversationService {
             agentId: params.agentId,
             title: params.title,
             metadata: params.metadata,
+            code: generateConversationCode(),
             status: 'active',
             totalInputTokens: 0,
             totalOutputTokens: 0,
             messageCount: 0,
         });
     }
+    /** Resolve a conversation by its short public `code`. Returns `null`
+     *  when no conversation carries that code, or when the wired repo
+     *  adapter predates the column (no `findByCode`). */
+    async findByCode(code) {
+        if (!this.convRepo.findByCode)
+            return null;
+        return this.convRepo.findByCode(code);
+    }
+    /** Resolve a conversation by `code`, enforcing ownership. Throws
+     *  `ConversationNotFoundError` (ambiguous on purpose) when the code is
+     *  unknown OR belongs to another user — same contract as `loadOwned`. */
+    async getByCode(code, userId) {
+        const conv = this.convRepo.findByCode
+            ? await this.convRepo.findByCode(code)
+            : null;
+        if (!conv || conv.userId !== userId) {
+            throw new ConversationNotFoundError(code);
+        }
+        return conv;
+    }
     async addMessage(params) {
         // Coerce empty/whitespace-only content to a sentinel so we don't
         // poison the history with rows that getAnthropicMessages would

package/dist/services/index.d.ts

@@ -3,7 +3,7 @@ export { AgentRunnerService } from './agent-runner.service';
 export { ToolApprovalRequired, ToolBlockedError, isToolApprovalRequired, isToolBlockedError, type ToolApprovalGate, type ToolApprovalCheckArgs, type ToolApprovalDecision, } from './tool-approval-gate';
 export { PreparedStreamService, PreparedStreamError, } from './prepared-stream.service';
 export { InMemoryPreparedStreamStore } from './in-memory-prepared-stream.store';
-export { ConversationService, ConversationNotFoundError, } from './conversation.service';
+export { ConversationService, ConversationNotFoundError, generateConversationCode, } from './conversation.service';
 export { AgentService, AgentForbiddenError, type AgentNotFoundError, } from './agent.service';
 export { ApprovalCopywriterService, type ApprovalCopyBundle as ApprovalCopywriterBundle, type ApprovalCopywriterInput, } from './approval-copywriter.service';
 export { OrchestratorService, OrchestratorError, type OrchestratorServiceOptions, } from './orchestrator.service';

package/dist/services/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InMemoryAuthorizeStateStore = exports.ConnectorError = exports.ConnectorRegistryService = exports.OAuth2Service = exports.McpServerError = exports.McpServerService = exports.McpClientError = exports.McpClientService = exports.ChatTokenError = exports.ChatTokenService = exports.AgentJobWorker = exports.OrchestratorError = exports.OrchestratorService = exports.ApprovalCopywriterService = exports.AgentForbiddenError = exports.AgentService = exports.ConversationNotFoundError = exports.ConversationService = exports.InMemoryPreparedStreamStore = exports.PreparedStreamError = exports.PreparedStreamService = exports.isToolBlockedError = exports.isToolApprovalRequired = exports.ToolBlockedError = exports.ToolApprovalRequired = exports.AgentRunnerService = exports.ToolRegistryService = void 0;
+exports.InMemoryAuthorizeStateStore = exports.ConnectorError = exports.ConnectorRegistryService = exports.OAuth2Service = exports.McpServerError = exports.McpServerService = exports.McpClientError = exports.McpClientService = exports.ChatTokenError = exports.ChatTokenService = exports.AgentJobWorker = exports.OrchestratorError = exports.OrchestratorService = exports.ApprovalCopywriterService = exports.AgentForbiddenError = exports.AgentService = exports.generateConversationCode = exports.ConversationNotFoundError = exports.ConversationService = exports.InMemoryPreparedStreamStore = exports.PreparedStreamError = exports.PreparedStreamService = exports.isToolBlockedError = exports.isToolApprovalRequired = exports.ToolBlockedError = exports.ToolApprovalRequired = exports.AgentRunnerService = exports.ToolRegistryService = void 0;
 // Public service surface of @agentforge-io/core. AI runtime only — auth,
 // identity, billing, infra, etc. have all moved to the host server.
 var tool_registry_service_1 = require("./tool-registry.service");
@@ -24,6 +24,7 @@ Object.defineProperty(exports, "InMemoryPreparedStreamStore", { enumerable: true
 var conversation_service_1 = require("./conversation.service");
 Object.defineProperty(exports, "ConversationService", { enumerable: true, get: function () { return conversation_service_1.ConversationService; } });
 Object.defineProperty(exports, "ConversationNotFoundError", { enumerable: true, get: function () { return conversation_service_1.ConversationNotFoundError; } });
+Object.defineProperty(exports, "generateConversationCode", { enumerable: true, get: function () { return conversation_service_1.generateConversationCode; } });
 var agent_service_1 = require("./agent.service");
 Object.defineProperty(exports, "AgentService", { enumerable: true, get: function () { return agent_service_1.AgentService; } });
 Object.defineProperty(exports, "AgentForbiddenError", { enumerable: true, get: function () { return agent_service_1.AgentForbiddenError; } });

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@agentforge-io/core",
-  "version": "3.4.0",
+  "version": "4.0.2",
   "description": "Framework-free AI runtime SDK. Owns: agent loop (Anthropic), conversations, tools, streaming, agent-job queue, SdkHooks. Identity, billing, infra (email/uploads/secrets) live in the host's modules — not here.",
   "license": "MIT",
+  "type": "commonjs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {