@pnds/sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,454 @@
+export type UserType = 'human' | 'agent';
+export type UserStatus = 'active' | 'disabled';
+export interface User {
+    id: string;
+    type: UserType;
+    display_name: string;
+    avatar_url: string | null;
+    email: string | null;
+    phone: string | null;
+    agent_provider: string | null;
+    agent_endpoint: string | null;
+    agent_model: string | null;
+    agent_permissions: string[];
+    status: UserStatus;
+    email_verified: boolean;
+    last_seen_at: string | null;
+    created_at: string;
+}
+export type ChatType = 'direct' | 'group';
+export interface Chat {
+    id: string;
+    type: ChatType;
+    org_id: string;
+    name: string | null;
+    avatar_url: string | null;
+    description: string | null;
+    last_message_at: string | null;
+    last_message_preview: string | null;
+    last_message_sender: string | null;
+    creator_id: string;
+    created_at: string;
+    updated_at: string;
+}
+export type ChatMemberRole = 'owner' | 'admin' | 'member';
+export type NotificationLevel = 'all' | 'mentions_only' | 'none';
+export interface ChatMember {
+    chat_id: string;
+    user_id: string;
+    role: ChatMemberRole;
+    notification_level: NotificationLevel;
+    pinned: boolean;
+    joined_at: string;
+    user?: User;
+}
+export type MessageType = 'text' | 'image' | 'file' | 'tool_call' | 'tool_result' | 'approval_card' | 'state_delta' | 'system';
+export declare const MENTION_ALL_USER_ID = "all";
+export interface Mention {
+    user_id: string;
+    offset: number;
+    length: number;
+}
+export interface LinkPreview {
+    url: string;
+    title: string;
+    image: string;
+    description: string;
+}
+export interface TextContent {
+    text: string;
+    format?: string;
+    mentions?: Mention[];
+    link_previews?: LinkPreview[];
+}
+export interface MediaContent {
+    attachment_id: string;
+    file_name: string;
+    file_size: number;
+    mime_type: string;
+    url: string;
+    thumbnail_url?: string;
+    width?: number;
+    height?: number;
+    duration?: number;
+    caption?: string;
+}
+export interface ToolCallContent {
+    tool_name: string;
+    tool_input: Record<string, unknown>;
+    status: string;
+    started_at: string;
+}
+export interface ToolResultContent {
+    tool_call_id: string;
+    tool_name: string;
+    status: string;
+    output: string;
+    duration_ms: number;
+    collapsible: boolean;
+}
+export interface ApprovalOption {
+    key: string;
+    label: string;
+    style: 'primary' | 'danger' | 'secondary';
+}
+export interface ApprovalCardContent {
+    approval_id: string;
+    title: string;
+    description: string;
+    action_type: string;
+    action_payload: Record<string, unknown>;
+    risk_level: string;
+    status: string;
+    options: ApprovalOption[];
+    expires_at: string;
+}
+export type AgentState = 'thinking' | 'tool_calling' | 'streaming' | 'waiting_approval' | 'completed' | 'error';
+export interface StateDeltaContent {
+    state: AgentState;
+    text: string;
+    progress: number;
+    collapsible: boolean;
+}
+export type SystemEvent = 'member_joined' | 'member_left' | 'member_role_changed' | 'chat_renamed' | 'chat_avatar_changed' | 'agent_added' | 'agent_removed';
+export interface SystemContent {
+    event: SystemEvent;
+    user_id: string;
+    user_name: string;
+}
+export type MessageContent = TextContent | MediaContent | ToolCallContent | ToolResultContent | ApprovalCardContent | StateDeltaContent | SystemContent | Record<string, unknown>;
+export interface Message {
+    id: string;
+    chat_id: string;
+    sender_id: string;
+    sender?: User;
+    thread_root_id: string | null;
+    message_type: MessageType;
+    content: MessageContent;
+    version: number;
+    reply_count: number;
+    edited_at: string | null;
+    deleted_at: string | null;
+    created_at: string;
+    idempotency_key: string | null;
+}
+export interface Attachment {
+    id: string;
+    message_id: string | null;
+    uploader_id: string;
+    file_name: string;
+    file_size: number;
+    mime_type: string;
+    storage_key: string;
+    width: number | null;
+    height: number | null;
+    duration: number | null;
+    thumbnail_key: string | null;
+    created_at: string;
+}
+export type ApprovalStatus = 'pending' | 'approved' | 'rejected' | 'expired';
+export interface Approval {
+    id: string;
+    message_id: string;
+    chat_id: string;
+    requester_id: string;
+    status: ApprovalStatus;
+    action_type: string;
+    action_payload: Record<string, unknown>;
+    decided_by: string | null;
+    decided_at: string | null;
+    expires_at: string | null;
+    created_at: string;
+}
+export type OrgMemberRole = 'owner' | 'admin' | 'member';
+export interface Organization {
+    id: string;
+    name: string;
+    avatar_url: string | null;
+    is_personal: boolean;
+    created_at: string;
+}
+export interface OrgMember {
+    org_id: string;
+    user_id: string;
+    role: OrgMemberRole;
+    joined_at: string;
+    user?: User;
+}
+export interface ApiKey {
+    id: string;
+    key: string;
+    agent_id: string;
+    created_at: string;
+}
+export interface CreateAgentResponse {
+    user: User;
+    api_key: string;
+}
+export interface UnreadCount {
+    chat_id: string;
+    unread_count: number;
+    last_read_message_id: string;
+    last_read_at: string;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    has_more: boolean;
+    next_cursor?: string;
+}
+export interface ErrorResponse {
+    error: string;
+    code: string;
+    details?: Record<string, unknown>;
+}
+export interface AuthTokens {
+    access_token: string;
+    refresh_token: string;
+    expires_in: number;
+    user: User;
+    is_new_user?: boolean;
+}
+export interface CheckEmailResponse {
+    exists: boolean;
+}
+export interface PresignResponse {
+    upload_url: string;
+    attachment_id: string;
+    expires_in: number;
+}
+export interface WsTicketResponse {
+    ticket: string;
+    expires_at: string;
+    ws_url: string;
+}
+export interface RegisterRequest {
+    email: string;
+    password: string;
+    display_name: string;
+}
+export interface LoginRequest {
+    email: string;
+    password: string;
+}
+export interface CreateChatRequest {
+    type: ChatType;
+    org_id: string;
+    name?: string;
+    description?: string;
+    member_ids: string[];
+}
+export interface SendMessageRequest {
+    message_type: MessageType;
+    content: MessageContent;
+    thread_root_id?: string;
+    idempotency_key?: string;
+}
+export interface PatchMessageRequest {
+    version: number;
+    ops: JsonPatchOp[];
+}
+export interface JsonPatchOp {
+    op: 'replace' | 'add';
+    path: string;
+    value: unknown;
+}
+export interface WorkspaceFiles {
+    soul_md?: string;
+    agents_md?: string;
+    tools_md?: string;
+}
+export interface HostedStatus {
+    state: 'running' | 'stopped' | 'creating' | 'error';
+}
+export interface CreateAgentRequest {
+    display_name: string;
+    agent_provider?: string;
+    agent_endpoint?: string;
+    agent_model?: string;
+    agent_permissions?: string[];
+    machine_type?: string;
+    machine_label?: string;
+    machine_host?: string;
+    workspace?: WorkspaceFiles;
+}
+export interface AgentProfile {
+    user_id: string;
+    provider: string | null;
+    endpoint: string | null;
+    model: string | null;
+    permissions: string[];
+    machine_type: string | null;
+    machine_label: string | null;
+    machine_host: string | null;
+    compute_provider: string | null;
+    compute_resource_id: string | null;
+    compute_metadata: Record<string, string> | null;
+    created_by: string;
+    created_at: string;
+}
+export interface AgentRun {
+    chat_id: string;
+    status: string;
+    started_at: string;
+}
+export interface AgentPresence {
+    online: boolean;
+    status: string;
+    session_id?: string;
+    run?: AgentRun;
+    telemetry?: Record<string, unknown>;
+}
+export interface AgentWithRuntime extends User {
+    agent_profile?: AgentProfile | null;
+    presence?: AgentPresence | null;
+}
+export interface PresignUploadRequest {
+    file_name: string;
+    file_size: number;
+    mime_type: string;
+}
+export type TaskStatus = 'todo' | 'in_progress' | 'in_review' | 'done' | 'canceled';
+export type TaskPriority = 'high' | 'normal' | 'low';
+export type TaskRelationTargetType = 'task' | 'message' | 'chat' | 'agent_run';
+export type TaskRelationType = 'blocks' | 'related' | 'duplicate' | 'source' | 'reference' | 'discussion' | 'execution';
+export interface Task {
+    id: string;
+    org_id: string;
+    title: string;
+    description: string | null;
+    status: TaskStatus;
+    priority: TaskPriority;
+    assignee_id: string | null;
+    creator_id: string;
+    parent_id: string | null;
+    sort_order: number;
+    created_at: string;
+    updated_at: string;
+    started_at: string | null;
+    completed_at: string | null;
+    canceled_at: string | null;
+}
+export interface TaskRelation {
+    id: string;
+    task_id: string;
+    target_type: TaskRelationTargetType;
+    target_id: string;
+    relation_type: TaskRelationType;
+    created_by: string;
+    created_at: string;
+}
+export interface CreateTaskRequest {
+    title: string;
+    description?: string;
+    priority?: TaskPriority;
+    assignee_id?: string;
+    parent_id?: string;
+    sort_order?: number;
+}
+export interface UpdateTaskRequest {
+    title?: string;
+    description?: string;
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    assignee_id?: string | null;
+    sort_order?: number;
+}
+export interface CreateTaskRelationRequest {
+    target_type: TaskRelationTargetType;
+    target_id: string;
+    relation_type: TaskRelationType;
+}
+export interface WsFrame<T = unknown> {
+    type: string;
+    seq?: number;
+    data: T;
+}
+export interface HelloData {
+    conn_id: string;
+    user_id: string;
+    session_id?: string;
+    server_time: string;
+    heartbeat_interval: number;
+}
+export interface MessageNewData {
+    id: string;
+    chat_id: string;
+    sender_id: string;
+    sender?: User;
+    thread_root_id: string | null;
+    message_type: MessageType;
+    content: MessageContent;
+    version: number;
+    created_at: string;
+}
+export interface MessagePatchData {
+    message_id: string;
+    chat_id: string;
+    version: number;
+    ops: JsonPatchOp[];
+}
+export interface MessageEditData {
+    message_id: string;
+    chat_id: string;
+    content: MessageContent;
+    edited_at: string;
+}
+export interface MessageDeleteData {
+    message_id: string;
+    chat_id: string;
+}
+export interface TypingUpdateData {
+    chat_id: string;
+    thread_root_id: string | null;
+    user_id: string;
+    action: 'start' | 'stop';
+}
+export interface ChatUpdateData {
+    chat_id: string;
+    changes: Record<string, unknown>;
+}
+export interface ApprovalUpdateData {
+    approval_id: string;
+    message_id: string;
+    chat_id: string;
+    status: ApprovalStatus;
+    decided_by: string;
+    decided_at: string;
+}
+export interface RecoveryOverflowData {
+    message: string;
+}
+export interface WatchingData {
+    chat_ids: string[];
+}
+export interface MembershipChangedData {
+    chat_id: string;
+    user_id: string;
+    action: 'added' | 'removed';
+}
+export type TaskCreatedData = Task;
+export type TaskUpdatedData = Task;
+export interface TaskDeletedData {
+    task_id: string;
+    org_id: string;
+}
+export type WsEventMap = {
+    'hello': HelloData;
+    'message.new': MessageNewData;
+    'message.patch': MessagePatchData;
+    'message.edit': MessageEditData;
+    'message.delete': MessageDeleteData;
+    'typing.update': TypingUpdateData;
+    'chat.update': ChatUpdateData;
+    'approval.update': ApprovalUpdateData;
+    'recovery.overflow': RecoveryOverflowData;
+    'watching': WatchingData;
+    'pong': {
+        ts: number;
+    };
+    'membership.changed': MembershipChangedData;
+    'task.created': TaskCreatedData;
+    'task.updated': TaskUpdatedData;
+    'task.deleted': TaskDeletedData;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+// ============================================================
+// Entity Types — mirror server data model
+// ============================================================
+export const MENTION_ALL_USER_ID = 'all';

package/dist/ws.d.ts

@@ -0,0 +1,49 @@
+import type { WsEventMap, WsTicketResponse } from './types.js';
+export type WsEventType = keyof WsEventMap;
+export type WsEventHandler<T extends WsEventType> = (data: WsEventMap[T], seq?: number) => void;
+export type WsConnectionState = 'connecting' | 'connected' | 'disconnected' | 'reconnecting';
+export interface PondWsOptions {
+    /** Async function that fetches a one-time WS ticket from the API. */
+    getTicket: () => Promise<WsTicketResponse>;
+    /** Fallback WS URL if getTicket response doesn't include ws_url. */
+    wsUrl?: string;
+    lastSeq?: number;
+    reconnect?: boolean;
+    reconnectInterval?: number;
+    maxReconnectInterval?: number;
+}
+export declare class PondWs {
+    private ws;
+    private options;
+    private listeners;
+    private stateListeners;
+    private heartbeatTimer;
+    private reconnectTimer;
+    private reconnectAttempts;
+    private lastSeq;
+    private _state;
+    private intentionalClose;
+    constructor(options: PondWsOptions);
+    get state(): WsConnectionState;
+    connect(): Promise<void>;
+    disconnect(): void;
+    /** Tell the server which chats the user is currently viewing (no auth implications). */
+    watch(chatIds: string[]): void;
+    sendTyping(chatId: string, action: 'start' | 'stop', threadRootId?: string): void;
+    sendAck(messageId: string): void;
+    sendRead(chatId: string, lastReadId: string): void;
+    /** Send an agent heartbeat with telemetry data. */
+    sendAgentHeartbeat(sessionId: string, telemetry?: Record<string, unknown>): void;
+    sendEvent(type: string, data: unknown): void;
+    on<T extends WsEventType>(event: T, handler: WsEventHandler<T>): () => void;
+    off<T extends WsEventType>(event: T, handler: WsEventHandler<T>): void;
+    onStateChange(handler: (state: WsConnectionState) => void): () => void;
+    private send;
+    private handleFrame;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private scheduleReconnect;
+    private clearReconnect;
+    private setState;
+}
+//# sourceMappingURL=ws.d.ts.map

package/dist/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC;AAC3C,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEhG,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,cAAc,CAAC;AAE7F,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,SAAS,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3C,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAkG;IACjH,OAAO,CAAC,SAAS,CAAuD;IACxE,OAAO,CAAC,cAAc,CAAiD;IACvE,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,EAAE,aAAa;IAUlC,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAEK,OAAO;IA+Db,UAAU;IAaV,wFAAwF;IACxF,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE;IAIvB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAO1E,OAAO,CAAC,SAAS,EAAE,MAAM;IAIzB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAI3C,mDAAmD;IACnD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOzE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;IAMrC,EAAE,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;IAY9D,GAAG,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;IAI/D,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;IASzD,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,QAAQ;CAMjB"}