cyrus-core 0.2.5 → 0.2.7

package/dist/issue-tracker/adapters/CLIIssueTrackerService.d.ts

@@ -0,0 +1,239 @@
+/**
+ * CLI/in-memory implementation of IIssueTrackerService.
+ *
+ * This adapter provides an in-memory mock of Linear's issue tracking platform
+ * for testing purposes. It implements all methods from IIssueTrackerService
+ * while storing data in memory using Maps for O(1) lookups.
+ *
+ * Unlike Linear's async properties, this implementation uses synchronous properties
+ * for immediate access to related entities.
+ *
+ * @module issue-tracker/adapters/CLIIssueTrackerService
+ */
+import { EventEmitter } from "node:events";
+import type { AgentEventTransportConfig, IAgentEventTransport } from "../IAgentEventTransport.js";
+import type { IIssueTrackerService } from "../IIssueTrackerService.js";
+import { type AgentActivityCreateInput, type AgentActivityPayload, type AgentSessionCreateOnCommentInput, type AgentSessionCreateOnIssueInput, AgentSessionStatus, type Comment, type CommentCreateInput, type CommentWithAttachments, type Connection, type FetchChildrenOptions, type FileUploadRequest, type FileUploadResponse, type Issue, type IssueCreateInput, type IssueTrackerAgentSession, type IssueTrackerAgentSessionPayload, type IssueUpdateInput, type IssueWithChildren, type Label, type PaginationOptions, type Team, type User, type WorkflowState } from "../types.js";
+import { type CLIAgentActivityData, type CLIAgentSessionData, type CLICommentData, type CLIIssueData, type CLILabelData, type CLITeamData, type CLIUserData, type CLIWorkflowStateData } from "./CLITypes.js";
+/**
+ * In-memory state for the CLI issue tracker.
+ */
+export interface CLIIssueTrackerState {
+    issues: Map<string, CLIIssueData>;
+    comments: Map<string, CLICommentData>;
+    teams: Map<string, CLITeamData>;
+    labels: Map<string, CLILabelData>;
+    workflowStates: Map<string, CLIWorkflowStateData>;
+    users: Map<string, CLIUserData>;
+    agentSessions: Map<string, CLIAgentSessionData>;
+    agentActivities: Map<string, CLIAgentActivityData>;
+    currentUserId: string;
+    issueCounter: number;
+    commentCounter: number;
+    sessionCounter: number;
+    activityCounter: number;
+}
+/**
+ * CLI implementation of IIssueTrackerService.
+ *
+ * This class provides an in-memory implementation of the issue tracker service
+ * for testing purposes. All data is stored in Maps with synchronous property access.
+ *
+ * @example
+ * ```typescript
+ * const service = new CLIIssueTrackerService();
+ *
+ * // Fetch an issue
+ * const issue = await service.fetchIssue('issue-1');
+ *
+ * // Create a comment
+ * const comment = await service.createComment(issue.id, {
+ *   body: 'This is a comment'
+ * });
+ * ```
+ */
+export declare class CLIIssueTrackerService extends EventEmitter implements IIssueTrackerService {
+    private state;
+    private eventTransport;
+    /**
+     * Create a new CLIIssueTrackerService.
+     *
+     * @param initialState - Optional initial state (useful for testing)
+     */
+    constructor(initialState?: Partial<CLIIssueTrackerState>);
+    /**
+     * Fetch a single issue by ID or identifier.
+     */
+    fetchIssue(idOrIdentifier: string): Promise<Issue>;
+    /**
+     * Create a new issue in a team.
+     *
+     * @param input - Issue creation parameters
+     * @returns Promise resolving to the created issue
+     */
+    createIssue(input: IssueCreateInput): Promise<Issue>;
+    /**
+     * Get priority label from priority number.
+     */
+    private getPriorityLabel;
+    /**
+     * Fetch child issues (sub-issues) for a parent issue.
+     */
+    fetchIssueChildren(issueId: string, options?: FetchChildrenOptions): Promise<IssueWithChildren>;
+    /**
+     * Update an issue's properties.
+     */
+    updateIssue(issueId: string, updates: IssueUpdateInput): Promise<Issue>;
+    /**
+     * Fetch attachments for an issue.
+     */
+    fetchIssueAttachments(issueId: string): Promise<Array<{
+        title: string;
+        url: string;
+    }>>;
+    /**
+     * Fetch comments for an issue with optional pagination.
+     */
+    fetchComments(issueId: string, options?: PaginationOptions): Promise<Connection<Comment>>;
+    /**
+     * Fetch a single comment by ID.
+     */
+    fetchComment(commentId: string): Promise<Comment>;
+    /**
+     * Fetch a comment with attachments.
+     */
+    fetchCommentWithAttachments(commentId: string): Promise<CommentWithAttachments>;
+    /**
+     * Create a comment on an issue.
+     */
+    createComment(issueId: string, input: CommentCreateInput): Promise<Comment>;
+    /**
+     * Fetch all teams in the workspace/organization.
+     */
+    fetchTeams(options?: PaginationOptions): Promise<Connection<Team>>;
+    /**
+     * Fetch a single team by ID or key.
+     */
+    fetchTeam(idOrKey: string): Promise<Team>;
+    /**
+     * Fetch all issue labels in the workspace/organization.
+     */
+    fetchLabels(options?: PaginationOptions): Promise<Connection<Label>>;
+    /**
+     * Fetch a single label by ID or name.
+     */
+    fetchLabel(idOrName: string): Promise<Label>;
+    /**
+     * Fetch label names for a specific issue.
+     */
+    getIssueLabels(issueId: string): Promise<string[]>;
+    /**
+     * Fetch workflow states for a team.
+     */
+    fetchWorkflowStates(teamId: string, options?: PaginationOptions): Promise<Connection<WorkflowState>>;
+    /**
+     * Fetch a single workflow state by ID.
+     */
+    fetchWorkflowState(stateId: string): Promise<WorkflowState>;
+    /**
+     * Fetch a user by ID.
+     */
+    fetchUser(userId: string): Promise<User>;
+    /**
+     * Fetch the current authenticated user.
+     */
+    fetchCurrentUser(): Promise<User>;
+    /**
+     * Create an agent session on an issue.
+     */
+    createAgentSessionOnIssue(input: AgentSessionCreateOnIssueInput): Promise<IssueTrackerAgentSessionPayload>;
+    /**
+     * Create an agent session on a comment thread.
+     */
+    createAgentSessionOnComment(input: AgentSessionCreateOnCommentInput): Promise<IssueTrackerAgentSessionPayload>;
+    /**
+     * Internal helper to create agent sessions.
+     */
+    private createAgentSessionInternal;
+    /**
+     * Fetch an agent session by ID.
+     */
+    fetchAgentSession(sessionId: string): Promise<IssueTrackerAgentSession>;
+    /**
+     * List agent sessions with optional filtering.
+     *
+     * @param options - Filtering options (issueId, limit, offset)
+     * @returns Array of agent session data
+     */
+    listAgentSessions(options?: {
+        issueId?: string;
+        limit?: number;
+        offset?: number;
+    }): CLIAgentSessionData[];
+    /**
+     * Update an agent session's status.
+     *
+     * @param sessionId - The session ID to update
+     * @param status - The new status
+     * @returns The updated session
+     */
+    updateAgentSessionStatus(sessionId: string, status: AgentSessionStatus): Promise<IssueTrackerAgentSession>;
+    /**
+     * Emit a stop signal webhook event for the EdgeWorker to handle.
+     * Should be called by the caller after stopping a session (e.g., CLIRPCServer.handleStopSession).
+     */
+    emitStopSignalEvent(sessionId: string): Promise<void>;
+    /**
+     * Prompt an agent session with a user message.
+     * This creates a comment on the associated issue and emits a prompted event.
+     *
+     * @param sessionId - The session ID to prompt
+     * @param message - The user's prompt message
+     * @returns The created comment
+     */
+    promptAgentSession(sessionId: string, message: string): Promise<Comment>;
+    /**
+     * Post an agent activity to an agent session.
+     */
+    createAgentActivity(input: AgentActivityCreateInput): Promise<AgentActivityPayload>;
+    /**
+     * List agent activities for a session.
+     *
+     * @param sessionId - The session ID to get activities for
+     * @param options - Pagination options
+     * @returns Array of agent activity data
+     */
+    listAgentActivities(sessionId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): CLIAgentActivityData[];
+    /**
+     * Request a file upload URL from the platform.
+     */
+    requestFileUpload(request: FileUploadRequest): Promise<FileUploadResponse>;
+    /**
+     * Get the platform type identifier.
+     */
+    getPlatformType(): string;
+    /**
+     * Get the platform's API version or other metadata.
+     */
+    getPlatformMetadata(): Record<string, unknown>;
+    /**
+     * Create an event transport for receiving webhook events.
+     *
+     * @param config - Transport configuration
+     * @returns CLI event transport implementation
+     */
+    createEventTransport(config: AgentEventTransportConfig): IAgentEventTransport;
+    /**
+     * Seed default teams and workflow states for testing.
+     * Creates a "default" team with standard workflow states.
+     */
+    seedDefaultData(): void;
+    /**
+     * Get the current in-memory state (for testing/debugging).
+     */
+    getState(): CLIIssueTrackerState;
+}
+//# sourceMappingURL=CLIIssueTrackerService.d.ts.map

package/dist/issue-tracker/adapters/CLIIssueTrackerService.d.ts.map

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