@stoneforge/smithy 0.1.0

package/dist/services/agent-registry.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Agent Registry Service
+ *
+ * This service provides agent registration and management functionality.
+ * It allows registering agents with roles (director, worker, steward) and
+ * querying agents by various criteria.
+ *
+ * Key features:
+ * - Register agents with specific roles
+ * - Query agents by role, status, and other filters
+ * - Track agent session status
+ * - Manage agent metadata
+ * - Create dedicated channels for agent messaging (TB-O7a)
+ *
+ * @module
+ */
+import type { EntityId, Channel, ChannelId } from '@stoneforge/core';
+import type { QuarryAPI } from '@stoneforge/quarry';
+import type { AgentRole, AgentMetadata, AgentFilter, RegisterDirectorInput, RegisterWorkerInput, RegisterStewardInput } from '../types/index.js';
+import { type AgentEntity, isAgentEntity, getAgentMetadata } from '../api/orchestrator-api.js';
+export type { AgentEntity };
+export { isAgentEntity, getAgentMetadata };
+/**
+ * Generates the channel name for an agent based on agent name
+ * Channel names follow the pattern: agent-{agentName}
+ */
+export declare function generateAgentChannelName(agentName: string): string;
+/**
+ * Parses an agent name from a channel name
+ * Returns null if the name doesn't match the agent channel pattern
+ */
+export declare function parseAgentChannelName(channelName: string): string | null;
+/**
+ * Generic agent registration input
+ */
+export type RegisterAgentInput = (RegisterDirectorInput & {
+    role: 'director';
+}) | (RegisterWorkerInput & {
+    role: 'worker';
+}) | (RegisterStewardInput & {
+    role: 'steward';
+});
+/**
+ * Agent Registry interface for managing agents in the orchestration system.
+ *
+ * The registry provides methods for:
+ * - Registering agents with specific roles
+ * - Querying agents by various criteria
+ * - Managing agent session status
+ */
+export interface AgentRegistry {
+    /**
+     * Registers a new agent with the given parameters.
+     * This is a convenience method that dispatches to the appropriate
+     * role-specific registration method.
+     */
+    registerAgent(input: RegisterAgentInput): Promise<AgentEntity>;
+    /**
+     * Registers a Director agent.
+     * There should typically be only one Director per workspace.
+     */
+    registerDirector(input: RegisterDirectorInput): Promise<AgentEntity>;
+    /**
+     * Registers a Worker agent.
+     * Workers can be ephemeral (short-lived, task-specific) or persistent (long-lived).
+     */
+    registerWorker(input: RegisterWorkerInput): Promise<AgentEntity>;
+    /**
+     * Registers a Steward agent.
+     * Stewards perform support tasks like merging, health checks, etc.
+     */
+    registerSteward(input: RegisterStewardInput): Promise<AgentEntity>;
+    /**
+     * Gets an agent by ID
+     */
+    getAgent(entityId: EntityId): Promise<AgentEntity | undefined>;
+    /**
+     * Gets an agent by name
+     */
+    getAgentByName(name: string): Promise<AgentEntity | undefined>;
+    /**
+     * Lists agents matching the filter
+     */
+    listAgents(filter?: AgentFilter): Promise<AgentEntity[]>;
+    /**
+     * Gets all agents with a specific role
+     */
+    getAgentsByRole(role: AgentRole): Promise<AgentEntity[]>;
+    /**
+     * Gets available workers (idle or with capacity for more tasks)
+     */
+    getAvailableWorkers(): Promise<AgentEntity[]>;
+    /**
+     * Gets all stewards
+     */
+    getStewards(): Promise<AgentEntity[]>;
+    /**
+     * Gets the Director agent (there should be only one per workspace)
+     */
+    getDirector(): Promise<AgentEntity | undefined>;
+    /**
+     * Updates an agent's session status
+     */
+    updateAgentSession(entityId: EntityId, sessionId: string | undefined, status: 'idle' | 'running' | 'suspended' | 'terminated'): Promise<AgentEntity>;
+    /**
+     * Updates an agent's metadata
+     */
+    updateAgentMetadata(entityId: EntityId, updates: Partial<AgentMetadata>): Promise<AgentEntity>;
+    /**
+     * Updates an agent's properties (e.g., name)
+     */
+    updateAgent(entityId: EntityId, updates: {
+        name?: string;
+    }): Promise<AgentEntity>;
+    /**
+     * Deletes an agent and its associated channel
+     */
+    deleteAgent(entityId: EntityId): Promise<void>;
+    /**
+     * Gets the dedicated channel for an agent.
+     * Each agent has a channel named `agent-{agentId}` for receiving messages.
+     *
+     * @param agentId - The entity ID of the agent
+     * @returns The agent's channel, or undefined if not found
+     */
+    getAgentChannel(agentId: EntityId): Promise<Channel | undefined>;
+    /**
+     * Gets the channel ID for an agent from its metadata.
+     * This is faster than getAgentChannel() when you only need the ID.
+     *
+     * @param agentId - The entity ID of the agent
+     * @returns The channel ID, or undefined if the agent has no channel
+     */
+    getAgentChannelId(agentId: EntityId): Promise<ChannelId | undefined>;
+}
+/**
+ * Implementation of the Agent Registry service.
+ *
+ * This implementation uses the QuarryAPI for storage operations,
+ * storing agent information as Entity elements with specialized metadata.
+ */
+export declare class AgentRegistryImpl implements AgentRegistry {
+    private readonly api;
+    constructor(api: QuarryAPI);
+    registerAgent(input: RegisterAgentInput): Promise<AgentEntity>;
+    registerDirector(input: RegisterDirectorInput): Promise<AgentEntity>;
+    registerWorker(input: RegisterWorkerInput): Promise<AgentEntity>;
+    registerSteward(input: RegisterStewardInput): Promise<AgentEntity>;
+    getAgent(entityId: EntityId): Promise<AgentEntity | undefined>;
+    getAgentByName(name: string): Promise<AgentEntity | undefined>;
+    listAgents(filter?: AgentFilter): Promise<AgentEntity[]>;
+    getAgentsByRole(role: AgentRole): Promise<AgentEntity[]>;
+    getAvailableWorkers(): Promise<AgentEntity[]>;
+    getStewards(): Promise<AgentEntity[]>;
+    getDirector(): Promise<AgentEntity | undefined>;
+    updateAgentSession(entityId: EntityId, sessionId: string | undefined, status: 'idle' | 'running' | 'suspended' | 'terminated'): Promise<AgentEntity>;
+    updateAgentMetadata(entityId: EntityId, updates: Partial<AgentMetadata>): Promise<AgentEntity>;
+    updateAgent(entityId: EntityId, updates: {
+        name?: string;
+    }): Promise<AgentEntity>;
+    deleteAgent(entityId: EntityId): Promise<void>;
+    getAgentChannel(agentId: EntityId): Promise<Channel | undefined>;
+    getAgentChannelId(agentId: EntityId): Promise<ChannelId | undefined>;
+    /**
+     * Creates an agent entity, its channel, and links them via metadata.
+     * Rolls back on partial failure to prevent orphaned resources.
+     */
+    private registerAgentWithRollback;
+    /**
+     * Creates a dedicated channel for an agent and updates the agent's metadata
+     * with the channel ID.
+     *
+     * @param agentName - The name of the agent (used for channel naming)
+     * @param agentId - The ID of the agent entity (used for membership)
+     * @param createdBy - The entity that created the agent (will be a channel member)
+     * @returns The created channel
+     */
+    private createAgentChannel;
+    private applyFilters;
+}
+/**
+ * Creates an AgentRegistry instance
+ */
+export declare function createAgentRegistry(api: QuarryAPI): AgentRegistry;
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/services/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../../src/services/agent-registry.ts"],"names":[],"mappings":"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"}

package/dist/services/agent-registry.js

@@ -0,0 +1,432 @@
+/**
+ * Agent Registry Service
+ *
+ * This service provides agent registration and management functionality.
+ * It allows registering agents with roles (director, worker, steward) and
+ * querying agents by various criteria.
+ *
+ * Key features:
+ * - Register agents with specific roles
+ * - Query agents by role, status, and other filters
+ * - Track agent session status
+ * - Manage agent metadata
+ * - Create dedicated channels for agent messaging (TB-O7a)
+ *
+ * @module
+ */
+import { EntityTypeValue, createEntity, createTimestamp, createDirectChannel, generateDirectChannelName, duplicateName, asEntityId, asElementId } from '@stoneforge/core';
+// Import shared agent entity types from the API module to avoid duplication
+import { isAgentEntity, getAgentMetadata, } from '../api/orchestrator-api.js';
+export { isAgentEntity, getAgentMetadata };
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Key used to store agent metadata in Entity.metadata
+ */
+const AGENT_META_KEY = 'agent';
+/**
+ * Prefix for agent channel names
+ */
+const AGENT_CHANNEL_PREFIX = 'agent-';
+/**
+ * Generates the channel name for an agent based on agent name
+ * Channel names follow the pattern: agent-{agentName}
+ */
+export function generateAgentChannelName(agentName) {
+    return `${AGENT_CHANNEL_PREFIX}${agentName}`;
+}
+/**
+ * Parses an agent name from a channel name
+ * Returns null if the name doesn't match the agent channel pattern
+ */
+export function parseAgentChannelName(channelName) {
+    if (!channelName.startsWith(AGENT_CHANNEL_PREFIX)) {
+        return null;
+    }
+    const agentName = channelName.slice(AGENT_CHANNEL_PREFIX.length);
+    // Basic validation - must have a non-empty name
+    if (!agentName || agentName.length === 0) {
+        return null;
+    }
+    return agentName;
+}
+// ============================================================================
+// Agent Registry Implementation
+// ============================================================================
+/**
+ * Implementation of the Agent Registry service.
+ *
+ * This implementation uses the QuarryAPI for storage operations,
+ * storing agent information as Entity elements with specialized metadata.
+ */
+export class AgentRegistryImpl {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    // ----------------------------------------
+    // Agent Registration
+    // ----------------------------------------
+    async registerAgent(input) {
+        switch (input.role) {
+            case 'director':
+                return this.registerDirector(input);
+            case 'worker':
+                return this.registerWorker(input);
+            case 'steward':
+                return this.registerSteward(input);
+            default:
+                throw new Error(`Unknown agent role: ${input.role}`);
+        }
+    }
+    async registerDirector(input) {
+        const existing = await this.getAgentByName(input.name);
+        if (existing) {
+            throw duplicateName(input.name, 'agent', { existingId: existing.id });
+        }
+        const agentMetadata = {
+            agentRole: 'director',
+            sessionStatus: 'idle',
+            maxConcurrentTasks: input.maxConcurrentTasks,
+            roleDefinitionRef: input.roleDefinitionRef,
+            provider: input.provider,
+            model: input.model,
+        };
+        const entity = await createEntity({
+            name: input.name,
+            entityType: EntityTypeValue.AGENT,
+            createdBy: input.createdBy,
+            tags: input.tags,
+            metadata: { [AGENT_META_KEY]: agentMetadata },
+        });
+        return this.registerAgentWithRollback(entity, input.name, input.createdBy);
+    }
+    async registerWorker(input) {
+        const existing = await this.getAgentByName(input.name);
+        if (existing) {
+            throw duplicateName(input.name, 'agent', { existingId: existing.id });
+        }
+        const agentMetadata = {
+            agentRole: 'worker',
+            workerMode: input.workerMode,
+            sessionStatus: 'idle',
+            maxConcurrentTasks: input.maxConcurrentTasks,
+            roleDefinitionRef: input.roleDefinitionRef,
+            provider: input.provider,
+            model: input.model,
+        };
+        const entity = await createEntity({
+            name: input.name,
+            entityType: EntityTypeValue.AGENT,
+            createdBy: input.createdBy,
+            tags: input.tags,
+            metadata: { [AGENT_META_KEY]: agentMetadata },
+            reportsTo: input.reportsTo,
+        });
+        return this.registerAgentWithRollback(entity, input.name, input.createdBy);
+    }
+    async registerSteward(input) {
+        const existing = await this.getAgentByName(input.name);
+        if (existing) {
+            throw duplicateName(input.name, 'agent', { existingId: existing.id });
+        }
+        const agentMetadata = {
+            agentRole: 'steward',
+            stewardFocus: input.stewardFocus,
+            triggers: input.triggers,
+            sessionStatus: 'idle',
+            maxConcurrentTasks: input.maxConcurrentTasks,
+            roleDefinitionRef: input.roleDefinitionRef,
+            provider: input.provider,
+            model: input.model,
+        };
+        const entity = await createEntity({
+            name: input.name,
+            entityType: EntityTypeValue.AGENT,
+            createdBy: input.createdBy,
+            tags: input.tags,
+            metadata: { [AGENT_META_KEY]: agentMetadata },
+            reportsTo: input.reportsTo,
+        });
+        return this.registerAgentWithRollback(entity, input.name, input.createdBy);
+    }
+    // ----------------------------------------
+    // Agent Queries
+    // ----------------------------------------
+    async getAgent(entityId) {
+        // Cast EntityId to ElementId - they are both branded string types
+        const entity = await this.api.get(asElementId(entityId));
+        if (!entity || entity.type !== 'entity' || !isAgentEntity(entity)) {
+            return undefined;
+        }
+        return entity;
+    }
+    async getAgentByName(name) {
+        const entity = await this.api.lookupEntityByName(name);
+        if (!entity || !isAgentEntity(entity)) {
+            return undefined;
+        }
+        return entity;
+    }
+    async listAgents(filter) {
+        // Get all entities
+        const entities = await this.api.list({ type: 'entity' });
+        // Filter to only agent-type entities with valid agent metadata
+        let agents = entities.filter((e) => e.entityType === EntityTypeValue.AGENT && isAgentEntity(e));
+        // Apply additional filters
+        if (filter) {
+            agents = this.applyFilters(agents, filter);
+        }
+        return agents;
+    }
+    async getAgentsByRole(role) {
+        return this.listAgents({ role });
+    }
+    async getAvailableWorkers() {
+        const workers = await this.listAgents({ role: 'worker' });
+        return workers.filter((w) => {
+            const meta = getAgentMetadata(w);
+            const status = meta?.sessionStatus;
+            // Consider idle or undefined (never started) as available
+            return status === 'idle' || status === undefined;
+        });
+    }
+    async getStewards() {
+        return this.listAgents({ role: 'steward' });
+    }
+    async getDirector() {
+        const directors = await this.listAgents({ role: 'director' });
+        return directors[0];
+    }
+    // ----------------------------------------
+    // Agent Session Management
+    // ----------------------------------------
+    async updateAgentSession(entityId, sessionId, status) {
+        const agent = await this.getAgent(entityId);
+        if (!agent) {
+            throw new Error(`Agent not found: ${entityId}`);
+        }
+        const currentMeta = getAgentMetadata(agent);
+        if (!currentMeta) {
+            throw new Error(`Entity is not an agent: ${entityId}`);
+        }
+        const updatedAgentMeta = {
+            ...currentMeta,
+            sessionId,
+            sessionStatus: status,
+            lastActivityAt: createTimestamp(),
+        };
+        // Cast EntityId to ElementId for update
+        const updated = await this.api.update(asElementId(entityId), {
+            metadata: { ...agent.metadata, [AGENT_META_KEY]: updatedAgentMeta },
+        });
+        return updated;
+    }
+    async updateAgentMetadata(entityId, updates) {
+        const agent = await this.getAgent(entityId);
+        if (!agent) {
+            throw new Error(`Agent not found: ${entityId}`);
+        }
+        const currentMeta = getAgentMetadata(agent);
+        if (!currentMeta) {
+            throw new Error(`Entity is not an agent: ${entityId}`);
+        }
+        const updatedAgentMeta = {
+            ...currentMeta,
+            ...updates,
+        };
+        // Cast EntityId to ElementId for update
+        const updated = await this.api.update(asElementId(entityId), {
+            metadata: { ...agent.metadata, [AGENT_META_KEY]: updatedAgentMeta },
+        });
+        return updated;
+    }
+    async updateAgent(entityId, updates) {
+        const agent = await this.getAgent(entityId);
+        if (!agent) {
+            throw new Error(`Agent not found: ${entityId}`);
+        }
+        // Build update object with only provided fields
+        const updateData = {};
+        if (updates.name !== undefined) {
+            updateData.name = updates.name;
+        }
+        // Cast EntityId to ElementId for update, explicitly type as Entity
+        const updated = await this.api.update(asElementId(entityId), updateData);
+        return updated;
+    }
+    async deleteAgent(entityId) {
+        const agent = await this.getAgent(entityId);
+        if (!agent) {
+            throw new Error(`Agent not found: ${entityId}`);
+        }
+        // Get the agent's channel ID from metadata
+        const meta = getAgentMetadata(agent);
+        const channelId = meta?.channelId;
+        // Delete the agent's channel if it exists
+        if (channelId) {
+            try {
+                await this.api.delete(asElementId(channelId));
+            }
+            catch {
+                // Best-effort channel deletion - continue even if it fails
+            }
+        }
+        // Delete the agent entity
+        await this.api.delete(asElementId(entityId));
+    }
+    // ----------------------------------------
+    // Agent Channel Operations (TB-O7a)
+    // ----------------------------------------
+    async getAgentChannel(agentId) {
+        // First try to get the channel ID from the agent's metadata (fast path)
+        const channelId = await this.getAgentChannelId(agentId);
+        if (channelId) {
+            const channel = await this.api.get(asElementId(channelId));
+            if (channel && channel.type === 'channel') {
+                return channel;
+            }
+        }
+        // Fallback: look up agent to get createdBy, then search for the direct channel
+        const agent = await this.getAgent(agentId);
+        if (!agent) {
+            return undefined;
+        }
+        // Direct channel name is based on sorted entity IDs
+        const channelName = generateDirectChannelName(agent.createdBy, agentId);
+        const channels = await this.api.searchChannels(channelName, {
+            channelType: 'direct',
+        });
+        // Find exact match (searchChannels does pattern matching)
+        const agentChannel = channels.find((c) => c.name === channelName);
+        return agentChannel;
+    }
+    async getAgentChannelId(agentId) {
+        const agent = await this.getAgent(agentId);
+        if (!agent) {
+            return undefined;
+        }
+        const meta = getAgentMetadata(agent);
+        return meta?.channelId;
+    }
+    // ----------------------------------------
+    // Private Helpers
+    // ----------------------------------------
+    /**
+     * Creates an agent entity, its channel, and links them via metadata.
+     * Rolls back on partial failure to prevent orphaned resources.
+     */
+    async registerAgentWithRollback(entityData, agentName, createdBy) {
+        const saved = await this.api.create(entityData);
+        const agentEntity = saved;
+        const agentEntityId = asEntityId(agentEntity.id);
+        let channel;
+        try {
+            channel = await this.createAgentChannel(agentName, agentEntityId, createdBy);
+        }
+        catch (channelError) {
+            try {
+                await this.api.delete(agentEntity.id);
+            }
+            catch { /* best-effort rollback */ }
+            throw channelError;
+        }
+        try {
+            return await this.updateAgentMetadata(agentEntityId, {
+                channelId: channel.id,
+            });
+        }
+        catch (metadataError) {
+            try {
+                await this.api.delete(channel.id);
+            }
+            catch { /* best-effort */ }
+            try {
+                await this.api.delete(agentEntity.id);
+            }
+            catch { /* best-effort */ }
+            throw metadataError;
+        }
+    }
+    /**
+     * Creates a dedicated channel for an agent and updates the agent's metadata
+     * with the channel ID.
+     *
+     * @param agentName - The name of the agent (used for channel naming)
+     * @param agentId - The ID of the agent entity (used for membership)
+     * @param createdBy - The entity that created the agent (will be a channel member)
+     * @returns The created channel
+     */
+    async createAgentChannel(agentName, agentId, createdBy) {
+        // Look up the creator entity name for the channel display name
+        const creatorEntity = await this.api.get(asElementId(createdBy));
+        const creatorName = creatorEntity?.name ?? 'operator';
+        // Create a direct channel between the agent and the operator
+        const channel = await createDirectChannel({
+            entityA: createdBy, // Operator (el-0000)
+            entityB: agentId, // The new agent
+            entityAName: creatorName,
+            entityBName: agentName,
+            createdBy: createdBy,
+            tags: ['agent-channel'],
+            metadata: {
+                agentId,
+                agentName,
+                purpose: 'Agent direct messaging channel',
+            },
+        });
+        // Save the channel
+        const savedChannel = await this.api.create(channel);
+        return savedChannel;
+    }
+    applyFilters(agents, filter) {
+        let result = agents;
+        if (filter.role !== undefined) {
+            result = result.filter((a) => {
+                const meta = getAgentMetadata(a);
+                return meta?.agentRole === filter.role;
+            });
+        }
+        if (filter.workerMode !== undefined) {
+            result = result.filter((a) => {
+                const meta = getAgentMetadata(a);
+                return (meta?.agentRole === 'worker' &&
+                    meta.workerMode === filter.workerMode);
+            });
+        }
+        if (filter.stewardFocus !== undefined) {
+            result = result.filter((a) => {
+                const meta = getAgentMetadata(a);
+                return (meta?.agentRole === 'steward' &&
+                    meta.stewardFocus === filter.stewardFocus);
+            });
+        }
+        if (filter.sessionStatus !== undefined) {
+            result = result.filter((a) => {
+                const meta = getAgentMetadata(a);
+                return meta?.sessionStatus === filter.sessionStatus;
+            });
+        }
+        if (filter.reportsTo !== undefined) {
+            result = result.filter((a) => a.reportsTo === filter.reportsTo);
+        }
+        if (filter.hasSession !== undefined) {
+            result = result.filter((a) => {
+                const meta = getAgentMetadata(a);
+                return (meta?.sessionId !== undefined) === filter.hasSession;
+            });
+        }
+        return result;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Creates an AgentRegistry instance
+ */
+export function createAgentRegistry(api) {
+    return new AgentRegistryImpl(api);
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/services/agent-registry.js.map

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