@kmlckj/aios-agent-server-sdk 0.0.0-stage → 0.0.2

package/dist/shared/cloud-assistant-api.d.ts

@@ -0,0 +1,532 @@
+import type { AccountSchedulesApi } from './account-schedules-api.js';
+import type { ModelReasoningConfig } from './model-selection.js';
+import type { ContextUsageSnapshot } from './context-usage.js';
+import type { EnterpriseProjectCapabilityPage, EnterpriseProjectSearchRequest } from './enterprise-project-api.js';
+export type { ScheduleTriggerType, WorkbenchSchedule, WorkbenchScheduleRun, SaveScheduleRequest, ScheduleListQuery, ScheduleRunQuery } from './account-schedules-api.js';
+export interface PersonalAgentSkill {
+    id: string;
+    profileKey: string;
+    skillId: string;
+    tenantId?: string | null;
+    sourceType: string;
+    sourcePath: string | null;
+    enabled: boolean;
+    sortOrder: number;
+    name: string;
+    description: string | null;
+    iconUrl: string | null;
+    mySkillEnabled: boolean;
+}
+export interface CollaborationProject {
+    id: string;
+    ownerUserId: string;
+    name: string;
+    description: string | null;
+    status: string;
+    pinned: boolean;
+    sortOrder: number;
+    memberCount: number;
+    viewerRole: CollaborationMemberRole;
+    lastMessagePreview: string | null;
+    lastMessageAt: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+export interface CollaborationProjectList {
+    items: CollaborationProject[];
+    total: number;
+}
+export type CollaborationMemberRole = 'OWNER' | 'ADMIN' | 'MEMBER' | 'VIEWER' | string;
+export interface CollaborationMember {
+    id: string;
+    projectId: string;
+    userId: string;
+    displayName: string | null;
+    username: string | null;
+    avatarUrl: string | null;
+    role: CollaborationMemberRole;
+    pinned: boolean;
+    sortOrder: number;
+    createdAt: string | null;
+    updatedAt: string | null;
+}
+export type CollaborationSenderType = 'USER' | 'AGENT' | 'SYSTEM' | 'TOOL' | string;
+export interface CollaborationMessage {
+    id: string;
+    executionTaskId?: string;
+    executionCommandId?: string;
+    projectId: string;
+    sessionId: string;
+    turnId: string | null;
+    senderType: CollaborationSenderType;
+    senderUserId: string | null;
+    senderProfileKey: string | null;
+    senderName: string | null;
+    senderAvatarUrl: string | null;
+    content: string;
+    status: string;
+    createdAt: string;
+    updatedAt: string | null;
+    richContent?: CloudChatRichContent;
+    attachments?: CloudChatAttachment[];
+    skillReferences?: CloudChatSkillReference[];
+    conversationReference?: CloudChatConversationReference;
+}
+export interface CollaborationMessageList {
+    items: CollaborationMessage[];
+    total: number;
+}
+export interface UpdateCollaborationProjectRequest {
+    projectId: string;
+    name?: string;
+    description?: string;
+    status?: string;
+}
+export interface UpdateProjectPinRequest {
+    projectId: string;
+    pinned: boolean;
+}
+export interface ProjectMessageQuery {
+    projectId: string;
+    sessionId?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ProjectSendMessageRequest {
+    projectId: string;
+    sessionId: string;
+    content: string;
+    attachments?: CloudUploadedAttachment[];
+    references?: CloudMessageReference[];
+    richContent?: CloudChatRichContent;
+}
+export type CloudFileSource = 'agent' | 'project';
+export interface CloudFileListQuery {
+    directory?: string;
+    keyword?: string;
+}
+export interface CloudFileEntry {
+    id: string;
+    source: CloudFileSource;
+    name: string;
+    path: string;
+    directory: boolean;
+    sizeBytes: number;
+    mediaType: string | null;
+    createdAt: string | null;
+    updatedAt?: string | null;
+    createdBy?: string | null;
+    updatedBy?: string | null;
+    children?: CloudFileEntry[];
+}
+export interface CloudFileList {
+    items: CloudFileEntry[];
+    total: number;
+    usedBytes: number | null;
+    totalBytes: number | null;
+}
+export type CloudFileTarget = {
+    source: 'project';
+    projectId: string;
+    artifactId: string;
+};
+export type CloudFileContainer = {
+    source: 'project';
+    projectId: string;
+    directory: string;
+};
+export interface UploadCloudFileRequest {
+    container: CloudFileContainer;
+    fileName: string;
+    mediaType: string;
+    data: ArrayBuffer;
+}
+export interface CreateCloudDirectoryRequest {
+    container: CloudFileContainer;
+    name: string;
+}
+export interface RenameCloudFileRequest {
+    target: CloudFileTarget;
+    directory: boolean;
+    currentPath: string;
+    newName: string;
+}
+export interface SaveCloudFileRequest {
+    target: CloudFileTarget;
+    fileName: string;
+    mediaType: string;
+    data: ArrayBuffer;
+}
+export type CloudFileDataSource = CloudFileTarget | {
+    source: 'url';
+    url: string;
+};
+export interface CloudFileContent {
+    mediaType: string;
+    text: string | null;
+    dataUrl: string | null;
+    truncated: boolean;
+}
+export interface DownloadCloudFileRequest {
+    target: CloudFileDataSource;
+    fileName: string;
+}
+export interface HistorySearchItem {
+    sessionId: string;
+    sessionTitle: string | null;
+    isMain: boolean;
+    preview: string;
+    message: CloudChatMessage;
+}
+export interface CreateChatShareRequest {
+    sourceType: 'COLLABORATION_PROJECT';
+    projectId: string;
+    sessionId: string;
+    messageIds: string[];
+    allowFileAccess: boolean;
+}
+export interface ChatShare {
+    shareId: string;
+    shareUrl: string;
+    title: string;
+    allowFileAccess: boolean;
+    messageCount: number;
+    createdAt: string | null;
+}
+export interface CreateCollaborationProjectRequest {
+    name: string;
+    description?: string;
+    idempotencyKey?: string;
+}
+export type CloudChatRole = 'system' | 'user' | 'assistant' | 'tool';
+export type CloudChatMessageStatus = 'complete' | 'streaming' | 'failed';
+export type CloudChatRichTokenType = 'agent' | 'member' | 'skill' | 'enterprise_project' | 'collection' | 'attachment';
+export type CloudChatRichSegment = {
+    type: 'text';
+    text: string;
+} | {
+    type: CloudChatRichTokenType;
+    id: string;
+    name: string;
+    avatarUrl?: string | null;
+    source?: string | null;
+    tenantId?: string | null;
+    profileKey?: string | null;
+    agentId?: string | null;
+    ownerUserId?: string | null;
+    previewUrl?: string | null;
+    downloadUrl?: string | null;
+    mediaType?: string | null;
+    sizeBytes?: number | null;
+    reference?: Record<string, unknown> | null;
+};
+export interface CloudChatRichContent {
+    version: 1;
+    segments: CloudChatRichSegment[];
+}
+export type CloudMessageReference = {
+    type: 'conversation';
+    message_ids: string[];
+} | {
+    type: 'platform_skill';
+    skill_id: string;
+    tenant_id?: string;
+} | {
+    type: 'system_skill';
+    skill_id: string;
+} | {
+    type: 'local_skill';
+    path: string;
+} | {
+    type: 'remote_file';
+    url: string;
+    name: string;
+    mime_type?: string;
+    size?: number;
+    source: 'enterprise_knowledge';
+    knowledge_base_id: string;
+    document_id: string;
+} | {
+    type: 'url';
+    url: string;
+};
+export interface AvailableChatModel {
+    reasoningConfig?: ModelReasoningConfig | null;
+    modelId: string;
+    modelCode: string;
+    displayName: string;
+    avatarUrl: string | null;
+    providerCode: string | null;
+    description: string | null;
+    categoryCode: string | null;
+    categoryName: string | null;
+    capabilityCode: string | null;
+    callMode: string | null;
+    async: boolean;
+    requiredHeaders: string[];
+    tagText: string | null;
+    tagNameText: string | null;
+    sourceTagCode: string | null;
+    sourceTagName: string | null;
+    sourceTagColor: string | null;
+    tools: string | null;
+    inputCapabilities: string | null;
+    outputCapabilities: string | null;
+    generalScore?: number | null;
+    codingScore?: number | null;
+    webScore?: number | null;
+    officeScore?: number | null;
+    researchScore?: number | null;
+    multimodalScore?: number | null;
+    standardInputPrice?: number | null;
+    standardOutputPrice?: number | null;
+    priceUnit?: string | null;
+    priceCurrency?: string | null;
+    modelExperience: boolean;
+    functionCalling: boolean;
+    structuredOutput: boolean;
+    webSearch: boolean;
+    prefixCompletion: boolean;
+    cacheContext: boolean;
+    batchInference: boolean;
+    modelFinetune: boolean;
+    maxInputLength: string | null;
+    maxOutputLength: string | null;
+    maxInputLengthThinking: string | null;
+    maxOutputLengthThinking: string | null;
+    contextLength: string | null;
+    rpmLimit: number | null;
+    tpmLimit: number | null;
+    platformEnabled: boolean;
+    comingOffline: boolean;
+    availableEnabled: boolean;
+    recommended: boolean;
+    reason: string | null;
+    sortOrder: number;
+    updatedAt: string | null;
+}
+export interface CloudChatAttachment {
+    id: string;
+    name: string;
+    mediaType: string;
+    sizeBytes: number;
+    sourcePath?: string;
+    previewUrl?: string;
+    downloadUrl?: string;
+}
+export interface CloudChatSkillReference {
+    tenantId?: string | null;
+    id: string;
+    name: string;
+    iconUrl?: string | null;
+}
+export interface CloudChatConversationReference {
+    id: string;
+    messageIds: string[];
+    senderName: string;
+    summary: string;
+    createdAt?: string;
+    role?: 'user' | 'assistant';
+}
+export interface CloudChatMessage {
+    id: string;
+    executionTaskId?: string;
+    executionCommandId?: string;
+    role: CloudChatRole;
+    content: string;
+    thinkingContent?: string;
+    thinkingComplete?: boolean;
+    historyInteraction?: {
+        kind: 'approval' | 'user_input' | 'elicitation';
+        title: string;
+        request: string;
+        response: string;
+        status: 'approved' | 'denied' | 'submitted' | 'cancelled' | 'timed_out';
+    };
+    createdAt: string;
+    status: CloudChatMessageStatus;
+    turnId?: string;
+    senderName?: string;
+    senderAvatarUrl?: string | null;
+    senderProfileKey?: string | null;
+    richContent?: CloudChatRichContent;
+    attachments?: CloudChatAttachment[];
+    skillReferences?: CloudChatSkillReference[];
+    conversationReference?: CloudChatConversationReference;
+}
+export interface CloudUploadedAttachment {
+    artifactId?: string;
+    projectId?: string;
+    accessUrl?: string;
+    fileName: string;
+    filePath: string;
+    fileUrl: string;
+    previewUrl: string;
+    downloadUrl: string;
+    mediaType: string;
+    sizeBytes: number;
+    createdAt: string;
+    expiresAt: number;
+    expiresInSeconds: number;
+}
+export interface UploadAgentAttachmentRequest {
+    profileKey: string;
+    sessionId: string;
+    fileName: string;
+    mediaType: string;
+    data: ArrayBuffer;
+}
+export interface UploadProjectAttachmentRequest {
+    projectId: string;
+    fileName: string;
+    mediaType: string;
+    data: ArrayBuffer;
+}
+export type CloudChatStreamPayload = {
+    type: 'text-delta';
+    text: string;
+} | {
+    type: 'thinking-delta';
+    text: string;
+} | {
+    type: 'thinking-complete';
+} | {
+    type: 'state';
+    state: string;
+} | {
+    type: 'status';
+    message: string;
+} | {
+    type: 'context-usage';
+    usage: ContextUsageSnapshot;
+} | {
+    type: 'tool-start';
+    name: string;
+} | {
+    type: 'tool-result';
+    name: string;
+    output: string;
+    failed: boolean;
+} | {
+    type: 'interaction-changed';
+    interaction?: PersonalAgentInteraction;
+    interactionId: string;
+    status: PersonalAgentInteractionStatus;
+} | {
+    type: 'complete';
+    finalText: string;
+} | {
+    type: 'message-upsert';
+    message: CloudChatMessage;
+    clientMessageId?: string;
+} | {
+    type: 'error';
+    message: string;
+    retryable: boolean;
+};
+export type PersonalAgentInteractionStatus = 'pending' | 'resolving' | 'resolved';
+export type PersonalAgentInteractionKind = 'approval' | 'user_input';
+export interface PersonalAgentInteractionOption {
+    id: string;
+    label: string;
+    description?: string;
+    decision?: 'approve' | 'deny';
+}
+export interface PersonalAgentInteraction {
+    id: string;
+    profileKey: string;
+    sessionId: string;
+    kind: PersonalAgentInteractionKind;
+    status: PersonalAgentInteractionStatus;
+    title: string;
+    description?: string;
+    toolCallId?: string;
+    requestId?: string;
+    interactionType?: 'question' | 'elicitation';
+    options?: PersonalAgentInteractionOption[];
+    allowOther?: boolean;
+    secret?: boolean;
+    formSchema?: Record<string, unknown> | unknown[];
+    mode?: string;
+    serverName?: string;
+    url?: string;
+    cancelable?: boolean;
+    createdAt?: string;
+}
+export interface ListPersonalAgentInteractionsRequest {
+    profileKey: string;
+    sessionId: string;
+}
+export interface ResolvePersonalAgentInteractionRequest extends ListPersonalAgentInteractionsRequest {
+    interactionId: string;
+    kind: PersonalAgentInteractionKind;
+    decision?: 'approve' | 'deny' | 'submit' | 'cancel';
+    toolCallId?: string;
+    requestId?: string;
+    interactionType?: 'question' | 'elicitation';
+    optionId?: string;
+    response?: string | Record<string, unknown>;
+}
+export interface ProjectEventSubscriptionRequest {
+    projectId: string;
+    sessionId: string;
+    objectKey: string;
+}
+export type CloudAssistantEventSubscriptionRequest = ProjectEventSubscriptionRequest;
+export interface CloudChatStreamEvent {
+    subscriptionId: string;
+    objectKey: string;
+    sessionId: string;
+    sequence: number;
+    streamKey?: string;
+    senderName?: string;
+    senderAvatarUrl?: string | null;
+    payload: CloudChatStreamPayload;
+}
+export interface CloudAssistantApi {
+    enterpriseProjects: {
+        search: (request: EnterpriseProjectSearchRequest) => Promise<EnterpriseProjectCapabilityPage>;
+    };
+    projects: {
+        list: () => Promise<CollaborationProjectList>;
+        get: (projectId: string) => Promise<CollaborationProject>;
+        create: (request: CreateCollaborationProjectRequest) => Promise<CollaborationProject>;
+        update: (request: UpdateCollaborationProjectRequest) => Promise<CollaborationProject>;
+        delete: (projectId: string) => Promise<void>;
+        listMembers: (projectId: string) => Promise<CollaborationMember[]>;
+        updatePin: (request: UpdateProjectPinRequest) => Promise<CollaborationMember>;
+        listMessages: (query: ProjectMessageQuery) => Promise<CollaborationMessageList>;
+        sendMessage: (request: ProjectSendMessageRequest) => Promise<CollaborationMessage>;
+    };
+    files: {
+        listProject: (projectId: string, query?: CloudFileListQuery) => Promise<CloudFileList>;
+        readContent: (target: CloudFileTarget) => Promise<CloudFileContent>;
+        readBinary: (source: CloudFileDataSource) => Promise<ArrayBuffer>;
+        getDownloadUrl: (target: CloudFileTarget) => Promise<string>;
+        upload: (request: UploadCloudFileRequest) => Promise<void>;
+        createDirectory: (request: CreateCloudDirectoryRequest) => Promise<void>;
+        rename: (request: RenameCloudFileRequest) => Promise<void>;
+        delete: (target: CloudFileTarget & {
+            directory: boolean;
+        }) => Promise<void>;
+        save: (request: SaveCloudFileRequest) => Promise<void>;
+        uploadProjectAttachment: (request: UploadProjectAttachmentRequest) => Promise<CloudUploadedAttachment>;
+        download: (request: DownloadCloudFileRequest) => Promise<{
+            canceled: boolean;
+            path?: string;
+        }>;
+    };
+    models: {
+        listText: () => Promise<AvailableChatModel[]>;
+        listLocalAgentText: () => Promise<AvailableChatModel[]>;
+    };
+    schedules: AccountSchedulesApi;
+    chatShares: {
+        create: (request: CreateChatShareRequest) => Promise<ChatShare>;
+    };
+    events: {
+        subscribe: (request: CloudAssistantEventSubscriptionRequest) => Promise<string>;
+        unsubscribe: (subscriptionId: string) => Promise<void>;
+        onEvent: (listener: (event: CloudChatStreamEvent) => void) => () => void;
+    };
+}

package/dist/shared/cloud-task-resources.d.ts

@@ -0,0 +1,24 @@
+import type { LocalTaskArtifact } from './local-task-api.js';
+import type { TaskOperationSnapshot } from './task-operation.js';
+import type { TeamState } from './team-control.js';
+export type CloudSessionArtifact = LocalTaskArtifact & {
+    source: {
+        kind: 'execution' | 'workspace';
+        eventId?: string;
+        runId?: string;
+        threadId?: string;
+        tool?: string;
+        at?: string;
+    };
+};
+export interface CloudSessionResources {
+    metadata: {
+        id: string;
+        name: string;
+        workspacePath: string;
+        [key: string]: unknown;
+    };
+    artifacts: CloudSessionArtifact[];
+    operations: TaskOperationSnapshot[];
+    team: TeamState | null;
+}