agent-world 0.11.0 → 0.12.0

package/dist/core/utils.js

@@ -0,0 +1,478 @@
+/**
+ * Manager Utilities - Helper functions for managers and agent processing
+ *
+ * Features:
+ * - Unique ID generation for events and messages using crypto.randomUUID()
+ * - Chat ID generation using nanoid for human-readable IDs
+ * - Manager-specific utility functions for string manipulation and processing
+ * - String manipulation utilities (kebab-case conversion for IDs and names)
+ * - Agent and message processing utilities with world-aware operations
+ * - LLM message preparation with conversation history and system prompts
+ * - Mention extraction with first-mention-only logic and case-insensitive matching
+ * - Sender type detection for humans, agents, and system messages
+ * - Agent memory filtering for LLM context (prevents irrelevant message pollution)
+ *
+ * Core Utilities:
+ * - generateId: Crypto-based unique ID generation for messages and events
+ * - generateChatId: Nanoid-based short ID generation for chat history
+ * - toKebabCase: String conversion for consistent naming conventions
+ * - getWorldTurnLimit: World-specific turn limit retrieval with fallback defaults
+ * - extractMentions: Case-insensitive mention extraction with first-mention-only logic
+ * - determineSenderType: Sender classification for message filtering and processing
+ * - prepareMessagesForLLM: Message formatting for LLM calls with history and system prompts
+ * - wouldAgentHaveRespondedToHistoricalMessage: Filters irrelevant messages from LLM context
+ *
+ * Implementation Details:
+ * - Uses native crypto.randomUUID() for ID generation ensuring uniqueness
+ * - Uses nanoid for human-readable chat IDs (8 characters, URL-safe)
+ * - Self-contained utility functions with no external dependencies
+ * - Ready for manager module integration with consistent interfaces
+ * - All types imported from types.ts for better organization and reusability
+ * - World-aware functions that respect world-specific configurations
+ * - Message processing utilities that handle AI SDK compatibility
+ * - Agent memory filtering prevents LLM context pollution from irrelevant messages
+ *
+ * Recent Changes:
+ * - 2026-02-19: Replaced raw `working directory: <value>` system-prompt suffix with explicit `shell_cmd` scope instructions and a no-echo directive.
+ * - 2026-02-16: Added env-driven global/project skill-scope filtering for the `## Agent Skills` system prompt section.
+ * - 2026-02-15: prepareMessagesForLLM now appends a concise, strict cross-agent addressing rule requiring `@<agent_id>, <message>` when targeting a specific agent.
+ * - 2026-02-14: prepareMessagesForLLM now injects an `## Agent Skills` section with registry-backed `<available_skills>` entries and `load_skill` guidance.
+ * - 2026-02-14: Added shared default working-directory resolver (env override -> user home -> `./`) and switched missing world `working_directory` fallback from `./` to user home.
+ * - 2026-02-13: prepareMessagesForLLM began appending execution-directory context from world `working_directory`.
+ * - 2026-02-08: Fixed wouldAgentHaveRespondedToHistoricalMessage to include assistant messages with tool_calls
+ *   (prevents OpenAI error: "messages with role 'tool' must be a response to a preceeding message with 'tool_calls'")
+ * - Enhanced comment documentation with detailed feature descriptions
+ * - Improved function descriptions with implementation details
+ * - Added details about world-aware operations and LLM integration
+ * - Added nanoid support for chat ID generation
+ * - Added wouldAgentHaveRespondedToHistoricalMessage for LLM context filtering
+ * - Updated prepareMessagesForLLM to filter irrelevant conversation history
+ * - Consolidated with message-prep.ts filtering for client-side tool calls
+ */
+import { nanoid } from 'nanoid';
+import { homedir } from 'os';
+import { getSkillSourceScope, getSkillsForSystemPrompt, waitForInitialSkillSync } from './skill-registry.js';
+import { parseSkillIdListFromEnv } from './skill-settings.js';
+import { createCategoryLogger } from './logger.js';
+const logger = createCategoryLogger('core.utils');
+/**
+ * Resolve default working directory when world variable is not configured.
+ * Priority:
+ * 1) AGENT_WORLD_DEFAULT_WORKING_DIRECTORY (runtime override)
+ * 2) OS user home directory
+ * 3) "./" hard fallback
+ */
+export function getDefaultWorkingDirectory() {
+    const envValue = typeof process !== 'undefined'
+        ? process.env?.AGENT_WORLD_DEFAULT_WORKING_DIRECTORY
+        : undefined;
+    const trimmedEnvValue = typeof envValue === 'string' ? envValue.trim() : '';
+    if (trimmedEnvValue) {
+        return trimmedEnvValue;
+    }
+    try {
+        const homePath = homedir();
+        const trimmedHomePath = typeof homePath === 'string' ? homePath.trim() : '';
+        if (trimmedHomePath) {
+            return trimmedHomePath;
+        }
+    }
+    catch {
+        // Fall through to final static fallback.
+    }
+    return './';
+}
+/**
+ * Generate unique ID for messages and events
+ */
+export function generateId() {
+    try {
+        return nanoid();
+    }
+    catch (error) {
+        // Fallback for environments where nanoid import fails
+        console.warn('[generateId] nanoid not available, using fallback');
+        return 'id-' + Math.random().toString(36).substr(2, 9) + '-' + Date.now().toString(36);
+    }
+}
+/**
+ * Generate short, human-readable ID for chat history
+ */
+export function generateChatId() {
+    return nanoid(8); // 8 characters, URL-safe
+}
+/**
+ * Simple runtime environment detection
+ * Returns true for Node.js, false for browser
+ */
+export function isNodeEnvironment() {
+    // Robust Node.js detection: process.versions.node is always present in Node
+    return typeof process !== 'undefined' && !!process.versions && !!process.versions.node;
+}
+/**
+ * Convert a string to kebab-case
+ * @param str - The string to convert
+ * @returns The kebab-case version of the string
+ */
+export function toKebabCase(str) {
+    if (!str)
+        return '';
+    return str
+        .replace(/\s+/g, '-') // Replace spaces with hyphens
+        .replace(/([a-z])([A-Z])/g, '$1-$2') // Insert hyphen between camelCase
+        .replace(/[^a-zA-Z0-9-]/g, '-') // Replace special characters with hyphens
+        .replace(/-+/g, '-') // Replace multiple hyphens with single
+        .replace(/^-|-$/g, '') // Remove leading/trailing hyphens
+        .toLowerCase(); // Convert to lowercase
+}
+/**
+ * Parse .env-style text into key-value map.
+ * Supported:
+ * - Comments: # comment
+ * - Blank lines
+ * - KEY=value entries (optional whitespace around '=')
+ * Invalid lines are ignored.
+ */
+export function parseEnvText(variablesText) {
+    const envMap = {};
+    if (!variablesText || typeof variablesText !== 'string') {
+        return envMap;
+    }
+    const lines = variablesText.split(/\r?\n/);
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#')) {
+            continue;
+        }
+        const separatorIndex = line.indexOf('=');
+        if (separatorIndex <= 0) {
+            logger.debug('Ignoring invalid env line', { line: rawLine });
+            continue;
+        }
+        const key = line.slice(0, separatorIndex).trim();
+        const value = line.slice(separatorIndex + 1).trim();
+        if (!key) {
+            logger.debug('Ignoring env line with empty key', { line: rawLine });
+            continue;
+        }
+        envMap[key] = value;
+    }
+    return envMap;
+}
+/**
+ * Get a single env value from .env-style text
+ */
+export function getEnvValueFromText(variablesText, key) {
+    if (!key) {
+        return undefined;
+    }
+    const envMap = parseEnvText(variablesText);
+    if (Object.prototype.hasOwnProperty.call(envMap, key)) {
+        return envMap[key];
+    }
+    if (key === 'working_directory') {
+        return getDefaultWorkingDirectory();
+    }
+    return undefined;
+}
+function buildAgentMentionFormatRule() {
+    return [
+        'Always use this format when addressing a specific agent: @<agent>, <message>.',
+        'Put @<agent> at the very start of the reply.',
+        'Do not use other addressing styles (e.g. To @<agent>, Hi @<agent>, Hey @<agent>, Hello @<agent>, or mid-sentence mentions).'
+    ].join('\n');
+}
+/**
+ * Interpolate template variables in form {{ variable }} from env map.
+ * Missing variables are replaced with empty string.
+ */
+export function interpolateTemplateVariables(template, envMap) {
+    if (!template) {
+        return '';
+    }
+    return template.replace(/\{\{\s*([A-Za-z0-9_\-]+)\s*\}\}/g, (_match, variableName) => {
+        if (Object.prototype.hasOwnProperty.call(envMap, variableName)) {
+            return envMap[variableName] ?? '';
+        }
+        return '';
+    });
+}
+function escapeXmlText(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+async function buildAgentSkillsPromptSection() {
+    await waitForInitialSkillSync();
+    const includeGlobalSkills = String(process.env.AGENT_WORLD_ENABLE_GLOBAL_SKILLS ?? 'true').toLowerCase() !== 'false';
+    const includeProjectSkills = String(process.env.AGENT_WORLD_ENABLE_PROJECT_SKILLS ?? 'true').toLowerCase() !== 'false';
+    const availableSkills = getSkillsForSystemPrompt({
+        includeGlobal: includeGlobalSkills,
+        includeProject: includeProjectSkills,
+    });
+    const disabledGlobalSkillIds = parseSkillIdListFromEnv(process.env.AGENT_WORLD_DISABLED_GLOBAL_SKILLS);
+    const disabledProjectSkillIds = parseSkillIdListFromEnv(process.env.AGENT_WORLD_DISABLED_PROJECT_SKILLS);
+    const filteredAvailableSkills = availableSkills.filter((skill) => {
+        const skillId = String(skill?.skill_id || '').trim();
+        if (!skillId) {
+            return false;
+        }
+        const sourceScope = getSkillSourceScope(skillId);
+        if (sourceScope === 'project') {
+            return !disabledProjectSkillIds.has(skillId);
+        }
+        return !disabledGlobalSkillIds.has(skillId);
+    });
+    const lines = [
+        '## Agent Skills',
+        'You have access to a library of agent skills. Find skill by:',
+        '1. Review the <available_skills> list below.',
+        "2. If the user's request matches a skill's purpose, use the load_skill with skill id tool",
+        '   to fetch the full instructions.',
+        '',
+        '<available_skills>',
+    ];
+    for (const skill of filteredAvailableSkills) {
+        lines.push('  <skill>');
+        lines.push(`    <id>${escapeXmlText(skill.skill_id)}</id>`);
+        lines.push(`    <description>${escapeXmlText(skill.description)}</description>`);
+        lines.push('  </skill>');
+    }
+    lines.push('</available_skills>');
+    return lines.join('\n');
+}
+// Import types for utility functions
+import { SenderType } from './types.js';
+/**
+ * Get world-specific turn limit or default value
+ */
+export function getWorldTurnLimit(world) {
+    return world.turnLimit || 5; // Default to 5 if not configured
+}
+/**
+ * Extract @mentions from message content - returns only first valid mention
+ * Implements first-mention-only logic to prevent multiple agent responses
+ */
+export function extractMentions(content) {
+    if (!content)
+        return [];
+    const mentionRegex = /@(\w+(?:[-_]\w+)*)/g;
+    const allMentions = [];
+    let firstValidMention = null;
+    let match;
+    while ((match = mentionRegex.exec(content)) !== null) {
+        const mention = match[1];
+        if (mention && mention.length > 0) {
+            const lowerMention = mention.toLowerCase();
+            allMentions.push(lowerMention);
+            // Only keep the first valid mention
+            if (firstValidMention === null) {
+                firstValidMention = lowerMention;
+            }
+        }
+    }
+    // Return array with first mention only
+    return firstValidMention ? [firstValidMention] : [];
+}
+/**
+ * Extract @mentions that appear at the beginning of paragraphs
+ * Implements paragraph-beginning-only logic for agent response triggering
+ *
+ * @param content - The message content to search for mentions
+ * @returns Array of mention names (lowercase) that appear at paragraph beginnings
+ */
+export function extractParagraphBeginningMentions(content) {
+    if (!content)
+        return [];
+    const validMentions = [];
+    const mentionPattern = /^(?:hey|hi|hello|to)\s+@(\w+(?:[-_]\w+)*)\b|^@(\w+(?:[-_]\w+)*)\b/i;
+    const lines = content.split(/\n/);
+    for (const line of lines) {
+        const trimmed = line.trimStart();
+        const match = mentionPattern.exec(trimmed);
+        if (match) {
+            const mention = match[1] || match[2];
+            if (mention) {
+                validMentions.push(mention.toLowerCase());
+            }
+        }
+    }
+    return validMentions;
+}
+/**
+ * Determine sender type based on sender name (matches src/agent.ts logic)
+ */
+export function determineSenderType(sender) {
+    if (!sender)
+        return SenderType.SYSTEM;
+    const lowerSender = sender.toLowerCase();
+    if (lowerSender === 'human' || lowerSender === 'user' || lowerSender === 'you') {
+        return SenderType.HUMAN;
+    }
+    if (lowerSender === 'system') {
+        return SenderType.SYSTEM;
+    }
+    if (lowerSender === 'world') {
+        return SenderType.WORLD;
+    }
+    return SenderType.AGENT;
+}
+/**
+ * Check if agent would have responded to a historical message
+ * Replicates shouldAgentRespond logic for saved messages to filter LLM context
+ *
+ * @param agent - The agent to check response logic for
+ * @param message - The historical message to evaluate
+ * @returns true if agent would have responded to this message
+ */
+export function wouldAgentHaveRespondedToHistoricalMessage(agent, message) {
+    // Always include own messages (by agentId or sender)
+    if (message.agentId === agent.id || message.sender?.toLowerCase() === agent.id.toLowerCase()) {
+        return true;
+    }
+    const content = message.content || '';
+    // Never respond to turn limit messages (prevents endless loops)
+    if (content.includes('Turn limit reached')) {
+        return false;
+    }
+    // Never respond to system messages
+    if (message.sender === 'system') {
+        return false;
+    }
+    // Always include tool messages (they are results from previous interactions)
+    if (message.role === 'tool' || message.sender === 'tool') {
+        return true;
+    }
+    // Always include assistant messages with tool_calls (required for tool result context)
+    if (message.role === 'assistant' && message.tool_calls?.length) {
+        return true;
+    }
+    // Always respond to world messages
+    if (message.sender === 'world') {
+        return true;
+    }
+    const anyMentions = extractMentions(content);
+    const mentions = extractParagraphBeginningMentions(content);
+    // Determine sender type
+    const senderType = determineSenderType(message.sender);
+    // For HUMAN messages
+    if (senderType === SenderType.HUMAN) {
+        if (mentions.length === 0) {
+            // If there are ANY mentions anywhere but none at paragraph beginnings, don't respond
+            if (anyMentions.length > 0) {
+                return false;
+            }
+            else {
+                return true; // No mentions = public message
+            }
+        }
+        else {
+            return mentions.includes(agent.id.toLowerCase());
+        }
+    }
+    // For agent messages, only respond if this agent has a paragraph-beginning mention
+    return mentions.includes(agent.id.toLowerCase());
+}
+/**
+ * Convert MessageData to AgentMessage for memory storage
+ */
+export function messageDataToAgentMessage(messageData) {
+    return {
+        role: 'user',
+        content: messageData.content || messageData.payload?.content || '',
+        sender: messageData.sender,
+        createdAt: new Date()
+    };
+}
+/**
+ * Prepare messages array for LLM using standard chat message format
+ * Filters conversation history by chatId if provided and excludes messages
+ * the agent would not have responded to (prevents irrelevant context pollution)
+ */
+export async function prepareMessagesForLLM(worldId, agent, chatId, includeCurrentMessage) {
+    const messages = [];
+    let worldEnvMap = {};
+    let worldVariablesText = '';
+    // Load FRESH agent from storage to get original system prompt (not patched)
+    // This ensures we always use the clean system prompt from storage
+    let freshSystemPrompt;
+    try {
+        const { createStorageWithWrappers } = await import('./storage/storage-factory.js');
+        const storage = await createStorageWithWrappers();
+        const freshAgent = await storage.loadAgent(worldId, agent.id);
+        freshSystemPrompt = freshAgent?.systemPrompt;
+        const world = await storage.loadWorld(worldId);
+        worldVariablesText = world?.variables || '';
+        worldEnvMap = parseEnvText(worldVariablesText);
+    }
+    catch (error) {
+        const { logger } = await import('./logger.js');
+        logger.error('Could not load agent from storage for system prompt', {
+            agentId: agent.id,
+            worldId,
+            error: error instanceof Error ? error.message : error
+        });
+        // Fallback to in-memory agent's system prompt
+        freshSystemPrompt = agent.systemPrompt;
+    }
+    // IDEMPOTENCE: Always add a system message first.
+    // System messages are NEVER saved to storage.
+    const interpolatedPrompt = interpolateTemplateVariables(freshSystemPrompt || '', worldEnvMap);
+    const workingDirectory = getEnvValueFromText(worldVariablesText, 'working_directory') || getDefaultWorkingDirectory();
+    const shellExecutionRule = 'When using `shell_cmd`, execute commands only within this trusted working directory scope: ' + workingDirectory;
+    const promptWithShellExecutionRule = interpolatedPrompt.trim().length > 0
+        ? (interpolatedPrompt.endsWith('\n')
+            ? `${interpolatedPrompt}${shellExecutionRule}`
+            : `${interpolatedPrompt}\n${shellExecutionRule}`)
+        : shellExecutionRule;
+    const agentSkillsPromptSection = await buildAgentSkillsPromptSection();
+    const promptWithSkills = promptWithShellExecutionRule.endsWith('\n')
+        ? `${promptWithShellExecutionRule}\n${agentSkillsPromptSection}`
+        : `${promptWithShellExecutionRule}\n\n${agentSkillsPromptSection}`;
+    const mentionFormatRule = buildAgentMentionFormatRule();
+    const promptWithMentionRule = promptWithSkills.endsWith('\n')
+        ? `${promptWithSkills}\n${mentionFormatRule}`
+        : `${promptWithSkills}\n\n${mentionFormatRule}`;
+    messages.push({
+        role: 'system',
+        content: promptWithMentionRule,
+        createdAt: new Date()
+    });
+    // Load FRESH conversation history from storage (not from in-memory agent)
+    // This ensures we always have the latest messages
+    let conversationHistory = [];
+    try {
+        const { createStorageWithWrappers } = await import('./storage/storage-factory.js');
+        const storage = await createStorageWithWrappers();
+        conversationHistory = await storage.getMemory(worldId, chatId);
+    }
+    catch (error) {
+        const { logger } = await import('./logger.js');
+        logger.error('Could not load conversation history from storage', {
+            agentId: agent.id,
+            worldId,
+            chatId,
+            error: error instanceof Error ? error.message : error
+        });
+    }
+    // Filter to only include messages from THIS specific agent
+    // getMemory returns messages from ALL agents, but we only want this agent's memory
+    const agentMessages = conversationHistory.filter(msg => msg.agentId === agent.id);
+    // IDEMPOTENCE: Always filter out system messages from history
+    // System message should only come from agent.systemPrompt above, never from storage
+    const filteredHistory = agentMessages.filter(msg => msg.role !== 'system');
+    // Filter to only include messages this agent would have responded to
+    // This prevents irrelevant "not mentioned" messages from polluting LLM context
+    const relevantHistory = filteredHistory.filter(msg => wouldAgentHaveRespondedToHistoricalMessage(agent, msg));
+    // Add filtered conversation history
+    messages.push(...relevantHistory);
+    // Add current message if provided
+    if (includeCurrentMessage) {
+        messages.push(messageDataToAgentMessage(includeCurrentMessage));
+    }
+    // Filter out client-side tool calls and orphaned tool results.
+    const { filterClientSideMessages } = await import('./message-prep.js');
+    return filterClientSideMessages(messages);
+}
+//# sourceMappingURL=utils.js.map

package/dist/core/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../core/utils.ts"],"names":[],"mappings":"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"}

package/dist/core/world-class.d.ts

@@ -0,0 +1,43 @@
+/**
+ * World Class - Object-Oriented Wrapper for Core World Functions
+ *
+ * Provides a clean OOP interface wrapping core function-based API with automatic worldId management.
+ * Stateless design - each method delegates to core functions and fetches fresh data.
+ *
+ * Usage:
+ * ```typescript
+ * const world = new WorldClass(worldId);
+ * await world.delete();
+ * const agent = await world.createAgent({...});
+ * await world.clearAgentMemory('agent-name');
+ * ```
+ */
+import { type World, type Agent, type Chat, type AgentMessage } from './index.js';
+import type { CreateAgentParams, UpdateAgentParams, UpdateWorldParams } from './types.js';
+/** Object-oriented wrapper for World management functions */
+export declare class WorldClass {
+    private readonly worldId;
+    constructor(worldId: string);
+    delete(): Promise<boolean>;
+    update(updates: UpdateWorldParams): Promise<World | null>;
+    reload(): Promise<World | null>;
+    exportToMarkdown(): Promise<string>;
+    save(): Promise<void>;
+    createAgent(params: CreateAgentParams): Promise<Agent>;
+    getAgent(agentName: string): Promise<Agent | null>;
+    updateAgent(agentName: string, updates: UpdateAgentParams): Promise<Agent | null>;
+    deleteAgent(agentName: string): Promise<boolean>;
+    listAgents(): Promise<Agent[]>;
+    clearAgentMemory(agentName: string): Promise<Agent | null>;
+    listChats(): Promise<Chat[]>;
+    newChat(setAsCurrent?: boolean): Promise<World | null>;
+    restoreChat(chatId: string, setAsCurrent?: boolean): Promise<World | null>;
+    deleteChat(chatId: string): Promise<boolean>;
+    getMemory(chatId?: string | null): Promise<AgentMessage[] | null>;
+    get id(): string;
+    toString(): string;
+    toJSON(): {
+        id: string;
+    };
+}
+export default WorldClass;

package/dist/core/world-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-class.d.ts","sourceRoot":"","sources":["../../core/world-class.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAIL,KAAK,KAAK,EAAE,KAAK,KAAK,EAAE,KAAK,IAAI,EAAE,KAAK,YAAY,EACrD,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG1F,6DAA6D;AAC7D,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAKtC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAIzD,MAAM,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAI/B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC;IAItD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAIlD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAIjF,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAI9B,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAK1D,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAI5B,OAAO,CAAC,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAI5D,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAQhF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5C,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC;IAKvE,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;CAGzB;AAED,eAAe,UAAU,CAAC"}

package/dist/core/world-class.js

@@ -0,0 +1,90 @@
+/**
+ * World Class - Object-Oriented Wrapper for Core World Functions
+ *
+ * Provides a clean OOP interface wrapping core function-based API with automatic worldId management.
+ * Stateless design - each method delegates to core functions and fetches fresh data.
+ *
+ * Usage:
+ * ```typescript
+ * const world = new WorldClass(worldId);
+ * await world.delete();
+ * const agent = await world.createAgent({...});
+ * await world.clearAgentMemory('agent-name');
+ * ```
+ */
+import { getWorld, updateWorld, deleteWorld, exportWorldToMarkdown, getMemory, createAgent, getAgent, updateAgent, deleteAgent, listAgents, clearAgentMemory, listChats, deleteChat, newChat, restoreChat, } from './index.js';
+import { toKebabCase } from './utils.js';
+/** Object-oriented wrapper for World management functions */
+export class WorldClass {
+    worldId;
+    constructor(worldId) {
+        this.worldId = worldId;
+        this.worldId = toKebabCase(this.worldId);
+    }
+    // WORLD OPERATIONS
+    async delete() {
+        return await deleteWorld(this.worldId);
+    }
+    async update(updates) {
+        return await updateWorld(this.worldId, updates);
+    }
+    async reload() {
+        return await getWorld(this.worldId);
+    }
+    async exportToMarkdown() {
+        return await exportWorldToMarkdown(this.worldId);
+    }
+    async save() {
+        // Stateless design - use update() with specific changes
+    }
+    // AGENT OPERATIONS
+    async createAgent(params) {
+        return await createAgent(this.worldId, params);
+    }
+    async getAgent(agentName) {
+        return await getAgent(this.worldId, agentName);
+    }
+    async updateAgent(agentName, updates) {
+        return await updateAgent(this.worldId, agentName, updates);
+    }
+    async deleteAgent(agentName) {
+        return await deleteAgent(this.worldId, agentName);
+    }
+    async listAgents() {
+        return await listAgents(this.worldId);
+    }
+    async clearAgentMemory(agentName) {
+        return await clearAgentMemory(this.worldId, agentName);
+    }
+    // CHAT OPERATIONS
+    async listChats() {
+        return await listChats(this.worldId);
+    }
+    async newChat(setAsCurrent = true) {
+        return await newChat(this.worldId);
+    }
+    async restoreChat(chatId, setAsCurrent = true) {
+        if (setAsCurrent) {
+            return await restoreChat(this.worldId, chatId);
+        }
+        const chats = await listChats(this.worldId);
+        return chats.some(c => c.id === chatId) ? await getWorld(this.worldId) : null;
+    }
+    async deleteChat(chatId) {
+        return await deleteChat(this.worldId, chatId);
+    }
+    async getMemory(chatId) {
+        return await getMemory(this.worldId, chatId);
+    }
+    // UTILITY METHODS
+    get id() {
+        return this.worldId;
+    }
+    toString() {
+        return `WorldClass(${this.worldId})`;
+    }
+    toJSON() {
+        return { id: this.worldId };
+    }
+}
+export default WorldClass;

package/dist/core/world-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-class.js","sourceRoot":"","sources":["../../core/world-class.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Agent World - Main Package Entry Point
+ *
+ * Features:
+ * - World-centric agent management system
+ * - LLM provider abstraction layer
+ * - Event-driven architecture
+ * - TypeScript-native execution
+ * - Command-line and server interfaces
+ *
+ * This module re-exports the core functionality of Agent World for npm package usage.
+ */
+export * from './core/index';
+export declare const PACKAGE_INFO: {
+    readonly name: "agent-world";
+    readonly version: "0.5.0";
+    readonly description: "A agent management system for building AI agent teams with just words.";
+};