@swarm-agent/sdk 0.1.47

package/dist/index.js

@@ -0,0 +1,20 @@
+export * from './client.js';
+export * from './auth.js';
+export * from './automations.js';
+export * from './workers.js';
+export * from './deliverables.js';
+export * from './deploy/index.js';
+export * from './notifications.js';
+export * from './sessions.js';
+export * from './projects.js';
+export * from './workspaces.js';
+export * from './system.js';
+export * from './transport.js';
+export * from './errors.js';
+export * from './types.js';
+export * from './storage/index.js';
+export { SwarmUsageNamespace } from './usage.js';
+export { SwarmAppsNamespace } from './apps.js';
+export * from './settings.js';
+export * from './provider-auth.js';
+export * from './realtime.js';

package/dist/notifications.d.ts

@@ -0,0 +1,28 @@
+import type { SwarmTransport } from './transport.js';
+import type { NotificationListFilter, NotificationRecord, NotificationSummary, SubmitNotificationParams, UpdateNotificationParams } from './types.js';
+export declare class SwarmNotificationsNamespace {
+    private readonly transport;
+    constructor(transport: SwarmTransport);
+    /**
+     * Submits a new notification to the Swarm Inbox (e.g. AI deliverable, pairing request, background job alert).
+     */
+    submit(params: SubmitNotificationParams): Promise<NotificationRecord>;
+    /**
+     * Lists notifications across the account/swarm, optionally filtered by limit and swarm_id.
+     */
+    list(filter?: NotificationListFilter): Promise<NotificationRecord[]>;
+    /**
+     * Gets the notification summary count (total, unread, active).
+     */
+    summary(swarmId?: string): Promise<NotificationSummary>;
+    /**
+     * Updates a notification (mark as read, acknowledged, muted, or update status).
+     */
+    update(id: string, params?: UpdateNotificationParams): Promise<NotificationRecord>;
+    /**
+     * Clears (deletes) resolved notifications.
+     */
+    clear(swarmId?: string): Promise<{
+        deleted: number;
+    }>;
+}

package/dist/notifications.js

@@ -0,0 +1,65 @@
+export class SwarmNotificationsNamespace {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    /**
+     * Submits a new notification to the Swarm Inbox (e.g. AI deliverable, pairing request, background job alert).
+     */
+    async submit(params) {
+        const res = await this.transport.request('/v1/notifications/inbox', {
+            method: 'POST',
+            body: params,
+        });
+        return res.data.notification;
+    }
+    /**
+     * Lists notifications across the account/swarm, optionally filtered by limit and swarm_id.
+     */
+    async list(filter = {}) {
+        const q = new URLSearchParams();
+        if (typeof filter.limit === 'number')
+            q.set('limit', String(filter.limit));
+        if (filter.swarm_id)
+            q.set('swarm_id', filter.swarm_id);
+        const path = q.toString() ? `/v1/notifications?${q.toString()}` : '/v1/notifications';
+        const res = await this.transport.request(path, {
+            method: 'GET',
+        });
+        return res.data.notifications || [];
+    }
+    /**
+     * Gets the notification summary count (total, unread, active).
+     */
+    async summary(swarmId) {
+        const path = swarmId
+            ? `/v1/notifications/summary?swarm_id=${encodeURIComponent(swarmId)}`
+            : '/v1/notifications/summary';
+        const res = await this.transport.request(path, {
+            method: 'GET',
+        });
+        return res.data.summary;
+    }
+    /**
+     * Updates a notification (mark as read, acknowledged, muted, or update status).
+     */
+    async update(id, params = {}) {
+        const res = await this.transport.request(`/v1/notifications/${encodeURIComponent(id)}`, {
+            method: 'POST',
+            body: params,
+        });
+        return res.data.notification;
+    }
+    /**
+     * Clears (deletes) resolved notifications.
+     */
+    async clear(swarmId) {
+        const path = swarmId
+            ? `/v1/notifications/clear?swarm_id=${encodeURIComponent(swarmId)}`
+            : '/v1/notifications/clear';
+        const res = await this.transport.request(path, {
+            method: 'POST',
+        });
+        return { deleted: res.data.result?.deleted ?? 0 };
+    }
+}

package/dist/projects.d.ts

@@ -0,0 +1,147 @@
+import type { SwarmTransport } from './transport.js';
+import type { ApproveProjectTaskResult, ClearProjectContextResult, CompleteProjectTaskResult, CreateProjectParams, CreateProjectTaskParams, CreateProjectTaskResult, DeleteProjectMediaResult, DeleteProjectResult, DeleteProjectTaskResult, DeployProjectTaskProgramResult, GetProjectTaskProgramResult, GetProjectTaskResult, IntegrateProjectTaskResult, ListProjectsParams, PreviewProjectTaskParams, ProjectRecord, ProjectTaskApprovalGuards, ProjectTaskMediaRef, ProjectTaskModelPreviewResult, ProjectTaskPreviewResult, ProjectTaskRecord, RedeployProjectTaskJobResult, RefineProjectTaskParams, RefineProjectTaskResult, RejectProjectTaskResult, ReopenProjectTaskResult, RequestOptions, SyncStreamParams, SyncStreamResult, SynthesizeProjectContextParams, UpdateProjectParams, UpdateProjectTaskParams } from './types.js';
+export declare class SwarmProjectsNamespace {
+    private readonly transport;
+    constructor(transport: SwarmTransport);
+    /**
+     * Lists projects across the active account.
+     */
+    list(params?: ListProjectsParams, options?: RequestOptions): Promise<ProjectRecord[]>;
+    /**
+     * Creates a new project in the active account.
+     */
+    create(params: CreateProjectParams, options?: RequestOptions): Promise<ProjectRecord>;
+    /**
+     * Retrieves a single project by ID.
+     */
+    get(projectId: string, options?: RequestOptions): Promise<ProjectRecord>;
+    /**
+     * Updates an existing project's metadata, context, or bound workspaces.
+     */
+    update(projectId: string, params: UpdateProjectParams, options?: RequestOptions): Promise<ProjectRecord>;
+    /**
+     * Deletes a project by ID.
+     */
+    delete(projectId: string, options?: RequestOptions): Promise<DeleteProjectResult>;
+    /**
+     * Synthesizes Markdown project context from project name and linked workspaces.
+     */
+    synthesizeContext(params: SynthesizeProjectContextParams, options?: RequestOptions): Promise<string>;
+    /**
+     * Clears orchestrator context for a project, archiving old session and provisioning replacement.
+     */
+    clearContext(projectId: string, options?: RequestOptions): Promise<ClearProjectContextResult>;
+    /**
+     * Lists media items attached to a project.
+     */
+    listMedia(projectId: string, options?: RequestOptions): Promise<ProjectTaskMediaRef[]>;
+    /**
+     * Uploads or attaches a media item to a project.
+     */
+    uploadMedia(projectId: string, media: Partial<ProjectTaskMediaRef>, options?: RequestOptions): Promise<ProjectTaskMediaRef>;
+    /**
+     * Removes an attached media item from a project.
+     */
+    deleteMedia(projectId: string, mediaId: string, options?: RequestOptions): Promise<DeleteProjectMediaResult>;
+    /**
+     * Lists tasks associated with a project.
+     */
+    listTasks(projectId: string, options?: RequestOptions, view?: 'active' | 'archived'): Promise<ProjectTaskRecord[]>;
+    /**
+     * Creates a new autonomous task inside a project.
+     */
+    createTask(projectId: string, params: CreateProjectTaskParams, options?: RequestOptions): Promise<CreateProjectTaskResult>;
+    /**
+     * Retrieves a single task by ID within a project, including model preview.
+     */
+    getTask(projectId: string, taskId: string, options?: RequestOptions): Promise<GetProjectTaskResult>;
+    /**
+     * Updates an existing pending or queued task in a project.
+     */
+    updateTask(projectId: string, taskId: string, params: UpdateProjectTaskParams, options?: RequestOptions): Promise<ProjectTaskRecord>;
+    /** Archives a task only at the supplied revision. */
+    archiveTask(projectId: string, taskId: string, revision: number, options?: RequestOptions): Promise<ProjectTaskRecord>;
+    /** Deletes only an archived, unlaunched task at the supplied revision. */
+    deleteTask(projectId: string, taskId: string, revision: number, options?: RequestOptions): Promise<DeleteProjectTaskResult>;
+    /**
+     * Previews how a task will be routed, planned, and modeled before creating it.
+     */
+    previewTask(projectId: string, params: PreviewProjectTaskParams, options?: RequestOptions): Promise<ProjectTaskPreviewResult>;
+    /**
+     * Retrieves the authoritative model preview for an existing task.
+     */
+    getTaskModelPreview(projectId: string, taskId: string, options?: RequestOptions): Promise<ProjectTaskModelPreviewResult>;
+    /**
+     * Approves a task session with optional exact revision guards.
+     * If the task is bound to a structured plan, exact session_id, plan_id, and definition_revision
+     * guards are enforced by the backend to prevent stale approvals.
+     */
+    approveTask(projectId: string, taskId: string, guards?: ProjectTaskApprovalGuards, options?: RequestOptions): Promise<ApproveProjectTaskResult>;
+    /**
+     * Convenient alias for approveTask.
+     */
+    acceptTask(projectId: string, taskId: string, guards?: ProjectTaskApprovalGuards, options?: RequestOptions): Promise<ApproveProjectTaskResult>;
+    /**
+     * Rejects a task and marks its bound plan as rejected.
+     */
+    rejectTask(projectId: string, taskId: string, guards?: ProjectTaskApprovalGuards, options?: RequestOptions): Promise<RejectProjectTaskResult>;
+    /**
+     * Reopens a completed or needs_review task with optional feedback instructions.
+     */
+    reopenTask(projectId: string, taskId: string, params?: ProjectTaskApprovalGuards & {
+        feedback?: string;
+    }, options?: RequestOptions): Promise<ReopenProjectTaskResult>;
+    /**
+     * Marks a task as accepted and completed by the user.
+     */
+    completeTask(projectId: string, taskId: string, options?: RequestOptions): Promise<CompleteProjectTaskResult>;
+    /**
+     * Refines a task plan based on user feedback directives or error recovery strategy.
+     */
+    refineTask(projectId: string, taskId: string, params: RefineProjectTaskParams, options?: RequestOptions): Promise<RefineProjectTaskResult>;
+    /**
+     * Integrates task commits into the parent workspace repository.
+     */
+    integrateTask(projectId: string, taskId: string, options?: RequestOptions): Promise<IntegrateProjectTaskResult>;
+    /**
+     * Deploys a task program for staged multi-agent execution.
+     */
+    deployTaskProgram(projectId: string, taskId: string, options?: RequestOptions): Promise<DeployProjectTaskProgramResult>;
+    /**
+     * Redeploys a failed or rejected job within a deployed task program.
+     */
+    redeployTaskProgramJob(projectId: string, taskId: string, params: {
+        job_id: string;
+        feedback?: string;
+    }, options?: RequestOptions): Promise<RedeployProjectTaskJobResult>;
+    /**
+     * Inspects the durable TaskProgramRecord for a deployed task program.
+     */
+    getTaskProgram(projectId: string, taskId: string, options?: RequestOptions): Promise<GetProjectTaskProgramResult>;
+    /**
+     * Streams outbox events after an opaque endpoint cursor via HTTP POST /v3/sync/stream.
+     * Cursors remain strictly opaque strings.
+     */
+    syncStream<TEvent = any>(params: SyncStreamParams, options?: RequestOptions): Promise<SyncStreamResult<TEvent>>;
+    /**
+     * Replays events starting after an opaque endpoint cursor.
+     */
+    replayEvents<TEvent = any>(cursor: string, params?: Omit<SyncStreamParams, 'endpoint_cursor'>, options?: RequestOptions): Promise<SyncStreamResult<TEvent>>;
+    /**
+     * Polls a task until a predicate condition is satisfied, or times out/aborts.
+     */
+    waitForTask(projectId: string, taskId: string, predicate: (task: ProjectTaskRecord) => boolean, options?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        signal?: AbortSignal;
+    }): Promise<ProjectTaskRecord>;
+    /**
+     * Async generator yielding sync stream events starting after an opaque cursor,
+     * respecting cancellation via AbortSignal.
+     */
+    streamEvents<TEvent = any>(initialCursor: string, params?: Omit<SyncStreamParams, 'endpoint_cursor'>, options?: {
+        pollIntervalMs?: number;
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): AsyncIterableIterator<TEvent>;
+}