@guildai/cli 0.11.0 → 0.12.1

package/dist/lib/api-types.d.ts

@@ -357,6 +357,50 @@ export interface Organization {
     viewer_role: 'ADMIN' | 'MEMBER' | null;
 }
 export type OrganizationListResponse = PaginatedResponse<Organization>;
+/**
+ * Skill entity from the API.
+ * Used by: skill list, skill get, skill create, skill update
+ */
+export interface Skill {
+    id: string;
+    entity_type: string;
+    type: 'skill';
+    full_name: string;
+    name: string;
+    overview: string;
+    is_public: boolean;
+    avatar_url: string | null;
+    owner: {
+        id: string;
+        name: string;
+        type: string;
+    };
+    viewer_can_edit: boolean;
+    created_at: string;
+    updated_at: string;
+    latest_version?: SkillVersion | null;
+}
+/**
+ * Skill version entity from the API.
+ * Used by: skill version list, skill version get, skill version create
+ */
+export interface SkillVersion {
+    id: string;
+    entity_type: string;
+    type: 'skill_version';
+    version_number: string;
+    description: string;
+    body?: string;
+    skill?: Skill;
+    author?: {
+        id: string;
+        name: string;
+    };
+    created_at: string;
+    updated_at: string;
+}
+export type SkillListResponse = PaginatedResponse<Skill>;
+export type SkillVersionListResponse = PaginatedResponse<SkillVersion>;
 export interface Credentials {
     id: string;
     integration: {

package/dist/lib/config.d.ts

@@ -48,6 +48,15 @@ export declare function getGuildcoreUrl(): string;
  * Used to construct clickable links to dashboard pages.
  */
 export declare function getDashboardUrl(): string;
+/**
+ * Get the Guildcore WebSocket base URL
+ *
+ * Derives the WebSocket URL from the HTTP guildcore URL:
+ * - http:// → ws://, https:// → wss://
+ *
+ * @returns WebSocket base URL (e.g., "wss://app.guild.ai/api")
+ */
+export declare function getGuildcoreWsUrl(): string;
 /**
  * Check if the given URL is an IAP-protected host
  *

package/dist/lib/display-message.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Canonical terminal chat row shared by live chat, resume rendering, and
+ * markdown helpers.
+ */
+export interface DisplayMessage {
+    key: string;
+    content: string;
+    type: 'user' | 'assistant' | 'progress';
+    timestamp?: string;
+}
+//# sourceMappingURL=display-message.d.ts.map

package/dist/lib/errors.d.ts

@@ -39,7 +39,7 @@ export declare const ErrorCodes: {
     readonly VALIDATION_ERROR: "VALIDATION_ERROR";
 };
 /**
- * Check if debug mode is enabled (CLI flag or config)
+ * Check if debug mode is enabled (CLI flag, config, or env var)
  */
 export declare function isDebugMode(): boolean;
 /**

package/dist/lib/markdown.d.ts

@@ -12,13 +12,6 @@ export declare function renderMarkdown(content: string): Promise<string>;
  * Render markdown synchronously (for use in non-async contexts)
  */
 export declare function renderMarkdownSync(content: string): string;
-/**
- * Message type for display in chat UI
- */
-export interface DisplayMessage {
-    key: string;
-    content: string;
-    type: 'user' | 'assistant' | 'progress';
-    timestamp?: string;
-}
+export declare function renderAssistantMessageContent(text: string, taskName: string): string;
+export type { DisplayMessage } from './display-message.js';
 //# sourceMappingURL=markdown.d.ts.map

package/dist/lib/output.d.ts

@@ -1,5 +1,5 @@
 import { type Spinner } from './progress.js';
-import type { Agent, AgentVersion, Credentials, CredentialsPolicy, Context, Integration, IntegrationVersion, JobStep, Pagination, Session, Task, ValidationStep, Workspace, WorkspaceAgent, Trigger } from './api-types.js';
+import type { Agent, AgentVersion, Credentials, CredentialsPolicy, Context, Integration, IntegrationVersion, JobStep, Pagination, Session, Skill, SkillVersion, Task, ValidationStep, Workspace, WorkspaceAgent, Trigger } from './api-types.js';
 /**
  * Format an agent list as a human-readable table.
  * Shared by agent list and agent search commands.
@@ -10,6 +10,16 @@ export declare function formatAgentTable(agents: Agent[], pagination: Pagination
  * Used by integration list command.
  */
 export declare function formatIntegrationTable(integrations: Integration[], pagination: Pagination): void;
+/**
+ * Format a skill list as a human-readable table.
+ * Used by skill list command.
+ */
+export declare function formatSkillTable(skills: Skill[], pagination: Pagination): void;
+/**
+ * Format a skill version list as a human-readable table.
+ * Used by skill version list command.
+ */
+export declare function formatSkillVersionTable(versions: SkillVersion[], pagination: Pagination, skillName: string): void;
 /**
  * Format an integration version list as a human-readable table.
  * Used by integration version list command.

package/dist/lib/response-stream-display-state.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Response-stream chat display state.
+ *
+ * Ink's <Static> component is append-only, so live LLM draft text cannot be
+ * rendered there without printing every update as a new transcript row. These
+ * helpers keep in-flight response streams in a dynamic active block, then
+ * remove or commit them into the append-only transcript once terminal events
+ * and final-message dedupe decide their durable fate.
+ */
+import type { DisplayMessage } from './display-message.js';
+import type { ResponseStreamResumeState } from './session-resume.js';
+export interface SplitResponseStreamDisplayMessages {
+    transcriptMessages: DisplayMessage[];
+    dynamicMessages: DisplayMessage[];
+    activeMessages: DisplayMessage[];
+}
+export interface ClearResponseStreamResult {
+    removedKeys: Set<string>;
+    detachedKeys: Set<string>;
+}
+export interface ActiveResponseStreamUpdate {
+    dynamicMessages: DisplayMessage[];
+    affectedMessages: DisplayMessage[];
+}
+export declare function splitResponseStreamDisplayMessages(displayMessages: DisplayMessage[], responseStreamState: ResponseStreamResumeState | null | undefined): SplitResponseStreamDisplayMessages;
+/** Build the mutable active-draft lookup used by the live chat renderer. */
+export declare function createActiveResponseStreamMessageMap(messages: DisplayMessage[]): Map<string, DisplayMessage>;
+/** Replace or insert a live draft in the repaintable chronological tail. */
+export declare function upsertDynamicResponseStreamMessage(dynamicMessages: DisplayMessage[], activeMessagesByKey: Map<string, DisplayMessage>, message: DisplayMessage): DisplayMessage[];
+/** Remove live drafts without keeping them in the visible chronological tail. */
+export declare function removeDynamicResponseStreamMessages(dynamicMessages: DisplayMessage[], activeMessagesByKey: Map<string, DisplayMessage>, keys: Set<string>): ActiveResponseStreamUpdate;
+/** Stop repainting live drafts while keeping their current row in chronological order. */
+export declare function commitDynamicResponseStreamMessages(dynamicMessages: DisplayMessage[], activeMessagesByKey: Map<string, DisplayMessage>, keys: Set<string>): {
+    dynamicMessages: DisplayMessage[];
+    committedMessages: DisplayMessage[];
+    affectedMessages: DisplayMessage[];
+};
+/** Append the repaintable chronological tail to the append-only transcript. */
+export declare function flushDynamicMessagesIntoTranscript(transcriptMessages: DisplayMessage[], dynamicMessages: DisplayMessage[]): DisplayMessage[];
+/** Drop an aborted stream from all tracking maps and return its display key. */
+export declare function abortTrackedResponseStream(state: ResponseStreamResumeState, streamId: string, taskId: string | undefined): Set<string>;
+/** Clear tracked streams after a durable final message or error arrives. */
+export declare function clearTrackedResponseStreamsForTask(state: ResponseStreamResumeState, taskId: string | undefined, options?: {
+    preserveContinued?: boolean;
+    finalText?: string;
+}): ClearResponseStreamResult;
+/** Clear tracked terminal streams after root runtime completion. */
+export declare function commitTerminalTrackedResponseStreamsForTask(state: ResponseStreamResumeState, taskId: string | undefined): Set<string>;
+/** Commit terminal tracked streams for every task, leaving active streams live. */
+export declare function commitAllTerminalTrackedResponseStreams(state: ResponseStreamResumeState): Set<string>;
+//# sourceMappingURL=response-stream-display-state.d.ts.map

package/dist/lib/session-events.d.ts

@@ -4,7 +4,7 @@
  * These types match the backend event system from the messaging refactor (PR #819).
  * All CLI commands should import these types instead of defining their own.
  */
-export type TaskStatus = 'CREATED' | 'STARTED' | 'RUNNING' | 'WAITING' | 'DONE' | 'ERROR' | 'INTERRUPTED';
+export type TaskStatus = 'CREATED' | 'DISPATCHED' | 'STARTED' | 'RUNNING' | 'WAITING' | 'DONE' | 'ERROR' | 'INTERRUPTED';
 export interface BaseTaskFields {
     id: string;
     status: TaskStatus;
@@ -61,6 +61,10 @@ export declare function getAgentName(agent: AgentRef | null | undefined): string
 export declare function matchesAgent(taskAgent: AgentRef | null | undefined, targetAgent: string): boolean;
 /** Get display name for a task - agent name or tool name */
 export declare function getTaskDisplayName(task: SessionTask): string;
+/** Resolve the display name for an event's originating agent. */
+export declare function getEventAgentName(event: {
+    task?: SessionTaskItem | SessionTask;
+}, fallbackName?: string): string;
 /** Get task type label */
 export declare function getTaskTypeLabel(task: SessionTask): string;
 export interface BaseEvent {

package/dist/lib/session-polling.d.ts

@@ -1,11 +1,21 @@
 import { GuildAPIClient } from './api-client.js';
+import { SessionEvent } from './session-events.js';
 export interface PollResult {
     response: string | null;
     /** Last event ID seen — pass as `afterEventId` on next call. */
     lastEventId: string | undefined;
 }
+export interface PollOnceResult {
+    events: SessionEvent[];
+    lastEventId: string | undefined;
+    reason: 'completion' | 'error' | 'ui_prompt' | 'inactivity_timeout';
+}
 /**
- * Poll for agent response using from_id cursor.
+ * Poll for agent response using WebSocket streaming with HTTP fallback.
+ *
+ * Does one initial HTTP GET (using from_id cursor) to check if the response
+ * is already available, then opens a WebSocket for real-time events.
+ * Falls back to HTTP polling if the WebSocket connection fails.
  *
  * Handles both multi-turn agents (which emit agent_notification_message)
  * and one-shot agents (which may only emit runtime_done with output content).
@@ -23,6 +33,19 @@ export declare function pollForResponse(client: GuildAPIClient, sessionId: strin
  * Same completion logic as pollForResponse(), but writes each event that
  * passes the filter to stdout so callers get intermediate output (console.log,
  * progress, etc.) in JSON/JSONL automation modes.
+ *
+ * Uses HTTP polling (not WebSocket) since it needs to emit each event
+ * individually to stdout as JSONL.
  */
 export declare function pollForResponseWithEvents(client: GuildAPIClient, sessionId: string, eventFilter: Set<string>, afterEventId: string | undefined, maxWaitTime?: number): Promise<PollResult>;
+/**
+ * Poll for --once mode using WebSocket streaming with HTTP fallback.
+ *
+ * Accumulates all events (unlike pollForResponse which returns a single response)
+ * and checks for completion conditions after each batch.
+ */
+export declare function pollForOnce(client: GuildAPIClient, sessionId: string, options?: {
+    inactivityTimeoutMs?: number;
+    pollIntervalMs?: number;
+}): Promise<PollOnceResult>;
 //# sourceMappingURL=session-polling.d.ts.map

package/dist/lib/session-resume.d.ts

@@ -1,5 +1,7 @@
 import { GuildAPIClient } from './api-client.js';
 import { type ResponseStreamContent, SessionEvent, Session } from './session-events.js';
+import type { DisplayMessage } from './display-message.js';
+export type { DisplayMessage } from './display-message.js';
 /**
  * Print a dimmed resume hint to stderr on session exit.
  * Only call when a session ID is available.
@@ -13,12 +15,6 @@ export declare function fetchSessionEvents(client: GuildAPIClient, sessionId: st
  * Fetch an existing session by ID.
  */
 export declare function fetchSession(client: GuildAPIClient, sessionId: string): Promise<Session>;
-export interface DisplayMessage {
-    key: string;
-    content: string;
-    type: 'user' | 'assistant' | 'progress';
-    timestamp?: string;
-}
 export interface ResponseStreamResumeState {
     keys: Map<string, string>;
     contents: Map<string, ResponseStreamContent[]>;

package/dist/lib/websocket-client.d.ts

@@ -0,0 +1,46 @@
+type WsState = 'connecting' | 'connected' | 'disconnected' | 'reconnecting';
+export interface WebSocketClientOptions<R> {
+    /** WebSocket endpoint path (e.g., "/sessions/{id}/events/ws") */
+    path: string;
+    /** Query parameters to append to the URL */
+    queryParams?: Record<string, string>;
+    /** Called for each received JSON message */
+    onMessage: (message: R) => void;
+    /** Called when the connection fails permanently (auth error, max retries) */
+    onError?: (error: Error) => void;
+    /** Returns the last seen ID for reconnection resume via from_id */
+    getFromId?: () => string | undefined;
+    /** Debug label for logging */
+    label: string;
+}
+/**
+ * Node.js WebSocket client for Guild backend endpoints.
+ *
+ * Handles auth headers (Bearer + IAP), auto-reconnect with exponential
+ * backoff + jitter, connection timeout, and from_id resume on reconnect.
+ */
+export declare class GuildWebSocketClient<R> {
+    private ws;
+    private state;
+    private readonly options;
+    private reconnectTimer;
+    private connectTimeout;
+    private reconnectAttempts;
+    private constructor();
+    /**
+     * Create and connect a WebSocket client.
+     * Rejects if initial connection or auth fails.
+     */
+    static create<R>(options: WebSocketClientOptions<R>): Promise<GuildWebSocketClient<R>>;
+    private buildUrl;
+    private getHeaders;
+    private cleanupSocket;
+    private connect;
+    private scheduleReconnect;
+    /** Close the connection cleanly. No reconnection will be attempted. */
+    close(): void;
+    /** Current connection state */
+    getState(): WsState;
+}
+export {};
+//# sourceMappingURL=websocket-client.d.ts.map

package/dist/open-RF4X5MOP.js

@@ -0,0 +1,13 @@
+import { createRequire as _cjsReq } from 'module'; if(typeof require === 'undefined') var require = _cjsReq(import.meta.url);
+import {
+  apps,
+  openApp,
+  open_default
+} from "./chunk-56YCMGL3.js";
+import "./chunk-OYQ476FQ.js";
+export {
+  apps,
+  open_default as default,
+  openApp
+};
+//# sourceMappingURL=open-RF4X5MOP.js.map

package/dist/open-RF4X5MOP.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}