@agentknight/sdk 0.9.38 → 0.9.40

package/dist/index.d.ts

@@ -444,6 +444,18 @@ declare const SessionGitProjectSchema: z.ZodObject<{
 }, z.core.$strict>;
 type SessionGitProject = z.infer<typeof SessionGitProjectSchema>;
 
+declare const SessionImageCommitResultSchema: z.ZodObject<{
+    imageId: z.ZodUUID;
+    machineId: z.ZodString;
+    sessionId: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    sha256: z.ZodString;
+    expiresAt: z.ZodNumber;
+}, z.core.$strict>;
+type SessionImageCommitResult = z.infer<typeof SessionImageCommitResultSchema>;
+
 declare const SessionSummarySchema: z.ZodObject<{
     userId: z.ZodString;
     sessionId: z.ZodString;
@@ -578,6 +590,18 @@ declare const SessionRemoteStatusSchema: z.ZodObject<{
 }, z.core.$strip>;
 type SessionRemoteStatus = z.infer<typeof SessionRemoteStatusSchema>;
 
+declare const SessionAvatarPersonaSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        default: "default";
+        designer: "designer";
+        filmmaker: "filmmaker";
+        developer: "developer";
+        secretary: "secretary";
+    }>;
+    displayName: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type SessionAvatarPersona = z.infer<typeof SessionAvatarPersonaSchema>;
+
 declare const InteractionRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"permission">;
     permissionKind: z.ZodString;
@@ -1190,6 +1214,10 @@ declare const SessionTimelinePageSchema: z.ZodObject<{
             sha256: z.ZodOptional<z.ZodString>;
             imageRef: z.ZodOptional<z.ZodLiteral<"sha256">>;
         }, z.core.$strict>>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            "assistant-message": "assistant-message";
+            "task-completion": "task-completion";
+        }>>;
     }, z.core.$strip>>;
     userPreview: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
@@ -1591,6 +1619,20 @@ type AgentModelOption = CopilotModelOption;
 type AgentPermissionRequest = Readonly<{
     kind: string;
 }>;
+declare class TimelinePageBudgetError extends Error {
+}
+interface TimelineImageProjection {
+    readonly sessionId: string;
+    readonly referenceItem: (sessionId: string, item: ConversationItem) => ConversationItem;
+}
+interface TimelineReadOptions {
+    cursor?: string;
+    pageSize?: number;
+    metadataOnly?: boolean;
+    assistantPreview?: boolean;
+    readOnly?: boolean;
+    imageProjection?: TimelineImageProjection;
+}
 interface AgentSessionConfiguration {
     modelId?: string;
     agentMode: SessionAgentMode;
@@ -1687,16 +1729,11 @@ interface CodingAgentAdapter {
     configureSession(sessionId: string, options: AgentSessionConfigureOptions): Promise<AgentSessionConfiguration>;
     getSessionRemoteStatus(sessionId: string): Promise<SessionRemoteStatus>;
     setSessionRemote(sessionId: string, enabled: boolean): Promise<SessionRemoteStatus>;
-    readSessionTimelinePage(sessionId: string, options?: {
-        cursor?: string;
-        pageSize?: number;
-        metadataOnly?: boolean;
-        assistantPreview?: boolean;
-    }): Promise<SessionTimelinePage>;
+    readSessionTimelinePage(sessionId: string, options?: TimelineReadOptions): Promise<SessionTimelinePage>;
     readSessionPlan?(sessionId: string): Promise<ConversationItem>;
     watchSession(sessionId: string, watched: boolean): Promise<void>;
     setSessionCallbacks(callbacks: CodingAgentSessionCallbacks): void;
-    sendPrompt(sessionId: string, prompt: string, mode: "enqueue" | "immediate", attachments?: readonly PromptImageAttachment[], persistInteractions?: boolean, fileAttachments?: readonly PromptFileAttachment[], operationId?: string): Promise<{
+    sendPrompt(sessionId: string, prompt: string, mode: "enqueue" | "immediate", attachments?: readonly PromptImageAttachment[], persistInteractions?: boolean, fileAttachments?: readonly PromptFileAttachment[], operationId?: string, avatarPersona?: SessionAvatarPersona): Promise<{
         messageId: string;
         deliveryState: "queued" | "processing";
         submittedAt?: string;
@@ -1737,6 +1774,12 @@ interface AgentSelectionProvider {
 }
 declare function supportsAgentSelection(adapter: CodingAgentAdapter): adapter is CodingAgentAdapter & AgentSelectionProvider;
 
+declare const SessionImagesConfigSchema: z.ZodObject<{
+    allowUnencryptedStorage: z.ZodLiteral<true>;
+    storageAccount: z.ZodString;
+    storageContainer: z.ZodString;
+}, z.core.$strict>;
+declare const SessionImageRelayUrlSchema: z.ZodPipe<z.ZodURL, z.ZodTransform<string, string>>;
 type CodingAgentConfig = {
     kind: "managed";
     initialSelection?: AgentSelection;
@@ -1771,6 +1814,8 @@ interface PcAgentConfig {
     timelineCompressionEnabled?: boolean;
     timelineIncrementalEnabled?: boolean;
     secureMessagePacketBudget?: number;
+    /** Explicit consent: image bytes are readable by Relay and Azure storage, not end-to-end encrypted. */
+    sessionImages?: z.infer<typeof SessionImagesConfigSchema>;
 }
 
 /** Owns a data directory without opening an IPC or HTTP listener. */
@@ -1951,6 +1996,34 @@ interface Agent {
 /** Initializes owned state only. The caller explicitly starts and stops the runtime. */
 declare function initialize(options: InitializeOptions): Promise<Agent>;
 
+declare const UploaderConfigSchema: z.ZodObject<{
+    relayUrl: z.ZodPipe<z.ZodURL, z.ZodTransform<string, string>>;
+    relayToken: z.ZodString;
+    userId: z.ZodString;
+    machineId: z.ZodString;
+    storageAccount: z.ZodString;
+    storageContainer: z.ZodString;
+}, z.core.$strip>;
+type SessionImageUploaderConfig = z.input<typeof UploaderConfigSchema>;
+type Stage = "config" | "source" | "reserve" | "put" | "complete";
+type SessionImageUploadErrorCode = "IMAGE_CONFIG_INVALID" | "IMAGE_CONTENT_INVALID" | "IMAGE_CAPACITY_EXCEEDED" | "IMAGE_UPLOADER_CLOSED" | "IMAGE_ABORTED" | "IMAGE_TIMEOUT" | "IMAGE_NETWORK_ERROR" | "IMAGE_HTTP_ERROR" | "IMAGE_RESPONSE_INVALID" | "IMAGE_RESPONSE_TOO_LARGE" | "IMAGE_UPLOAD_TARGET_INVALID" | "IMAGE_UPLOAD_EXPIRED" | "IMAGE_COMMIT_MISMATCH" | "IMAGE_COMPLETION_FAILED" | "IMAGE_ACCESS_REVOKED";
+/** Safe to log: never retains a response body, URL, token, or raw transport/schema error. */
+declare class SessionImageUploadError extends Error {
+    readonly code: SessionImageUploadErrorCode;
+    readonly stage: Stage;
+    readonly status?: number | undefined;
+    constructor(code: SessionImageUploadErrorCode, stage: Stage, status?: number | undefined, cause?: unknown);
+}
+/** Uploads already-derived WebP bytes only. Consent and session authorization belong to the caller. */
+declare class SessionImageUploader {
+    #private;
+    constructor(config: SessionImageUploaderConfig, dependencies?: {
+        fetch?: typeof fetch;
+    });
+    close(): void;
+    upload(sessionId: string, source: Buffer, signal?: AbortSignal, assertCurrent?: () => void): Promise<SessionImageCommitResult>;
+}
+
 declare function assertPiRuntimeSupported(nodeVersion?: string): void;
 declare function createCodingAgentAdapter(config: Pick<PcAgentConfig, "codingAgent" | "dataDirectory" | "groupChatEnabled" | "peerChatEnabled">, onDiagnostic?: (message: string) => void, owner?: Pick<AgentSessionCreateOptions, "userId" | "machineId">): Promise<CodingAgentAdapter>;
 
@@ -1960,5 +2033,5 @@ interface CodingAgentPresentation {
 }
 declare function codingAgentPresentation(agentId: string): CodingAgentPresentation;
 
-export { AgentSelectionSchema, CachedPairingProvider, ContentCipher, DataDirectoryLease, DeviceIdentitySchema, PEER_CHAT_TIMEOUT_MS, PeerChatRequestSchema, PeerChatResultSchema, assertPiRuntimeSupported, buildPairingUri, codingAgentPresentation, createCodingAgentAdapter, createPersistentContentCipher, generateContentKey, initialize, loadOrCreateContentKey, parseContentKey, requestPairingUri, supportsAgentSelection };
-export type { Agent, AgentSelection, AgentSelectionProvider, AgentSessionConfiguration, AgentSessionConfigureOptions, AgentSessionCreateOptions, CodingAgentAdapter, CodingAgentConfig, CodingAgentId, CodingAgentSessionCallbacks, ContentKeyMaterial, DeviceIdentity, InitializeOptions, PairingProvider, PairingTicket, PcAgentConfig, PeerChatRequest, PeerChatResult, RelayRegistrationStatus, RelaySocket, RelaySocketFactory, SelectableAgent };
+export { AgentSelectionSchema, CachedPairingProvider, ContentCipher, DataDirectoryLease, DeviceIdentitySchema, PEER_CHAT_TIMEOUT_MS, PeerChatRequestSchema, PeerChatResultSchema, SessionImageRelayUrlSchema, SessionImageUploadError, SessionImageUploader, SessionImagesConfigSchema, TimelinePageBudgetError, assertPiRuntimeSupported, buildPairingUri, codingAgentPresentation, createCodingAgentAdapter, createPersistentContentCipher, generateContentKey, initialize, loadOrCreateContentKey, parseContentKey, requestPairingUri, supportsAgentSelection };
+export type { Agent, AgentSelection, AgentSelectionProvider, AgentSessionConfiguration, AgentSessionConfigureOptions, AgentSessionCreateOptions, CodingAgentAdapter, CodingAgentConfig, CodingAgentId, CodingAgentSessionCallbacks, ContentKeyMaterial, DeviceIdentity, InitializeOptions, PairingProvider, PairingTicket, PcAgentConfig, PeerChatRequest, PeerChatResult, RelayRegistrationStatus, RelaySocket, RelaySocketFactory, SelectableAgent, SessionImageUploadErrorCode, SessionImageUploaderConfig, TimelineImageProjection, TimelineReadOptions };