@byok-sdk/cloud 0.4.1 → 0.4.2

package/dist/activity.d.ts

@@ -0,0 +1,122 @@
+import { type TenantId } from '@byok-sdk/core';
+import { type AgentEventOrUnknown } from '@byok-sdk/protocol';
+import { z } from 'zod';
+export declare const DEFAULT_ACTIVITY_CAPACITY = 50;
+export declare const ActivityAppendRequestSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    sourceEnvelopeId: z.ZodString;
+    batchSeq: z.ZodNumber;
+    events: z.ZodArray<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"progress">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_use">;
+        tool: z.ZodString;
+        input: z.ZodOptional<z.ZodUnknown>;
+        toolCallId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_result">;
+        tool: z.ZodString;
+        output: z.ZodOptional<z.ZodUnknown>;
+        toolCallId: z.ZodOptional<z.ZodString>;
+        isError: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"artifact">;
+        name: z.ZodString;
+        contentType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"needs_approval">;
+        summary: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"turn_end">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"error">;
+        message: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"usage">;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        cachedInputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        reasoningTokens: z.ZodOptional<z.ZodNumber>;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "type">, z.ZodObject<{
+        type: z.ZodString;
+    }, z.core.$loose>]>>;
+    dropped: z.ZodNumber;
+}, z.core.$strip>;
+export declare const TimelineEventSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    sourceEnvelopeId: z.ZodString;
+    batchSeq: z.ZodNumber;
+    eventIndex: z.ZodNumber;
+    receivedAt: z.ZodISODateTime;
+    event: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"progress">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_use">;
+        tool: z.ZodString;
+        input: z.ZodOptional<z.ZodUnknown>;
+        toolCallId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_result">;
+        tool: z.ZodString;
+        output: z.ZodOptional<z.ZodUnknown>;
+        toolCallId: z.ZodOptional<z.ZodString>;
+        isError: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"artifact">;
+        name: z.ZodString;
+        contentType: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"needs_approval">;
+        summary: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"turn_end">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"error">;
+        message: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"usage">;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        cachedInputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        reasoningTokens: z.ZodOptional<z.ZodNumber>;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "type">, z.ZodObject<{
+        type: z.ZodString;
+    }, z.core.$loose>]>;
+}, z.core.$strip>;
+export type TimelineEvent = Readonly<z.infer<typeof TimelineEventSchema>>;
+export interface ActivityCursor {
+    readonly batchSeq: number;
+    readonly eventIndex: number;
+}
+export interface ActivityTail {
+    readonly tenantId: TenantId;
+    readonly taskId: string;
+    readonly entries: readonly TimelineEvent[];
+    readonly cursor?: ActivityCursor;
+    readonly dropped: number;
+    readonly capacity: number;
+    readonly expiresAt: string;
+}
+export interface ActivityAppendInput {
+    readonly taskId: string;
+    readonly sourceEnvelopeId: string;
+    readonly batchSeq: number;
+    readonly events: readonly AgentEventOrUnknown[];
+    readonly dropped: number;
+    readonly ttlMs: number;
+    readonly capacity?: number;
+}
+export interface ActivityStore {
+    append(tenant: TenantId, input: ActivityAppendInput): Promise<ActivityTail>;
+    read(tenant: TenantId, taskId: string): Promise<ActivityTail | undefined>;
+}
+export declare function validateActivityAppend(input: ActivityAppendInput): number;
+export declare function projectTimelineEvents(input: ActivityAppendInput, receivedAt: string): readonly TimelineEvent[];
+export declare function parseTimelineEvents(value: unknown): readonly TimelineEvent[];
+export declare function compareTimelineEvents(left: TimelineEvent, right: TimelineEvent): number;
+export declare function activityCursor(entries: readonly TimelineEvent[]): ActivityCursor | undefined;
+export declare function activityTailKey(tenant: TenantId, taskId: string): string;

package/dist/approval-timeline.d.ts

@@ -0,0 +1,74 @@
+import { type TenantId } from '@byok-sdk/core';
+import { z } from 'zod';
+export declare const DEFAULT_APPROVAL_TIMELINE_CAPACITY = 50;
+export declare const DEFAULT_APPROVAL_TIMELINE_TTL_MS: number;
+export declare const APPROVAL_SUMMARY_MAX_BYTES: number;
+export declare const ApprovalTimelineEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"approval_requested">;
+    summary: z.ZodString;
+    approvalId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"approval_resolved">;
+    approvalId: z.ZodString;
+    decision: z.ZodEnum<{
+        approve: "approve";
+        reject: "reject";
+    }>;
+    resolvedBy: z.ZodEnum<{
+        local: "local";
+    }>;
+    at: z.ZodISODateTime;
+}, z.core.$strip>], "type">;
+export type ApprovalTimelineEvent = Readonly<z.infer<typeof ApprovalTimelineEventSchema>>;
+export declare const ApprovalObservationSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    sourceEnvelopeId: z.ZodString;
+    revision: z.ZodNumber;
+    receivedAt: z.ZodISODateTime;
+    event: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"approval_requested">;
+        summary: z.ZodString;
+        approvalId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"approval_resolved">;
+        approvalId: z.ZodString;
+        decision: z.ZodEnum<{
+            approve: "approve";
+            reject: "reject";
+        }>;
+        resolvedBy: z.ZodEnum<{
+            local: "local";
+        }>;
+        at: z.ZodISODateTime;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>;
+export type ApprovalObservation = Readonly<z.infer<typeof ApprovalObservationSchema>>;
+export interface ApprovalTimelineTail {
+    readonly tenantId: TenantId;
+    readonly taskId: string;
+    readonly entries: readonly ApprovalObservation[];
+    readonly cursor?: number;
+    readonly dropped: number;
+    readonly capacity: number;
+    readonly expiresAt: string;
+}
+export interface ApprovalTimelineAppendInput {
+    readonly taskId: string;
+    readonly sourceEnvelopeId: string;
+    readonly event: ApprovalTimelineEvent;
+    readonly ttlMs?: number;
+    readonly capacity?: number;
+}
+export interface ApprovalTimelineStore {
+    append(tenant: TenantId, input: ApprovalTimelineAppendInput): Promise<ApprovalTimelineTail>;
+    read(tenant: TenantId, taskId: string): Promise<ApprovalTimelineTail | undefined>;
+}
+export interface ValidatedApprovalTimelineAppend {
+    readonly capacity: number;
+    readonly ttlMs: number;
+    readonly event: ApprovalTimelineEvent;
+}
+export declare function validateApprovalTimelineAppend(input: ApprovalTimelineAppendInput): ValidatedApprovalTimelineAppend;
+export declare function approvalTimelineKey(tenant: TenantId, taskId: string): string;
+export declare function parseApprovalObservations(value: unknown): readonly ApprovalObservation[];
+export declare function approvalTimelineCursor(entries: readonly ApprovalObservation[]): number | undefined;

package/dist/cloud.d.ts

@@ -14,7 +14,9 @@
  * quietly undo that — a Running/session map — is asserted absent by
  * `src/__tests__/constraints.test.ts`.
  */
-import { type ActivityTail, type BoardItem, type BoardItemInput, type BoardListQuery, type BoardPage, type CapabilityDeclaration, type Clock, type CoreStores, type PresenceHint, type SkillPackStore, type TenantId } from '@byok-sdk/core';
+import { type BoardItem, type BoardItemInput, type BoardListQuery, type BoardPage, type CapabilityDeclaration, type Clock, type CoreStores, type PresenceHint, type SkillPackStore, type TenantId } from '@byok-sdk/core';
+import type { ActivityTail } from './activity';
+import type { ApprovalTimelineTail } from './approval-timeline';
 import { type Envelope, type TaskOfferPayload, type TaskOfferWithToolsetsPayload } from '@byok-sdk/protocol';
 import type { TokenSigner } from './auth/tokens';
 import type { CloudCrypto } from './crypto/port';
@@ -150,5 +152,6 @@ export interface ByokCloud {
     acceptBoardItem(tenant: TenantId, itemId: string): Promise<BoardItem>;
     listPresence(tenant: TenantId): Promise<readonly PresenceHint[]>;
     readActivity(tenant: TenantId, taskId: string): Promise<ActivityTail | undefined>;
+    readApprovalTimeline(tenant: TenantId, taskId: string): Promise<ApprovalTimelineTail | undefined>;
 }
 export declare function createByokCloud(options: ByokCloudOptions): ByokCloud;

package/dist/coordination.d.ts

@@ -1,11 +1,11 @@
-import type { ActivityTail } from '@byok-sdk/core';
 import type { AgentEventOrUnknown } from '@byok-sdk/protocol';
+import { type ActivityAppendInput, type ActivityTail } from './activity';
 import type { TenantBoundActivity } from './tenant-stores';
 export declare const DEFAULT_BOARD_CHANNEL_MAX_BYTES = 128;
 export declare const DEFAULT_BOARD_TITLE_MAX_BYTES = 512;
 export declare const DEFAULT_ACTIVITY_MAX_EVENTS = 50;
 export declare const DEFAULT_ACTIVITY_MAX_BYTES: number;
-export declare const DEFAULT_ACTIVITY_CAPACITY = 50;
+export { DEFAULT_ACTIVITY_CAPACITY } from './activity';
 export declare const DEFAULT_ACTIVITY_TTL_MS: number;
 export declare const DEFAULT_PRESENCE_TTL_MS = 90000;
 export declare const DEFAULT_PRESENCE_MINIMUM_INTERVAL_MS = 5000;
@@ -21,9 +21,12 @@ export declare function assertBoardLabels(channel: string, title: string, limits
     readonly channelMaxBytes: number;
     readonly titleMaxBytes: number;
 }): void;
-export declare function activityDetails(events: readonly AgentEventOrUnknown[], dropped: number, bounds: ActivityBounds): readonly string[];
+export declare function validateActivityEvents(events: readonly AgentEventOrUnknown[], dropped: number, bounds: ActivityBounds): void;
+export declare function validateActivityBatch(input: Omit<ActivityAppendInput, 'ttlMs' | 'capacity'>, bounds: ActivityBounds): void;
 export declare function appendActivityEvents(activity: TenantBoundActivity, input: {
     readonly taskId: string;
+    readonly sourceEnvelopeId: string;
+    readonly batchSeq: number;
     readonly events: readonly AgentEventOrUnknown[];
     readonly dropped: number;
 }, bounds: ActivityBounds): Promise<ActivityTail>;

package/dist/index.d.ts

@@ -43,9 +43,13 @@ export type { InboundOutcome } from './inbound';
 export { projectTerminalResult } from './terminal-result';
 export type { TerminalResult } from './terminal-result';
 export { tenantStoresFor } from './tenant-stores';
-export type { TenantBoundActivity, TenantBoundBoard, CloudRootStores, TenantBoundBlobs, TenantBoundDedup, TenantBoundDevices, TenantBoundMailbox, TenantBoundPresence, TenantBoundQuota, TenantBoundRateLimiter, TenantBoundReceipts, TenantBoundTaskAttempts, TenantStores, } from './tenant-stores';
+export type { TenantBoundActivity, TenantBoundApprovalTimeline, TenantBoundBoard, CloudRootStores, TenantBoundBlobs, TenantBoundDedup, TenantBoundDevices, TenantBoundMailbox, TenantBoundPresence, TenantBoundQuota, TenantBoundRateLimiter, TenantBoundReceipts, TenantBoundTaskAttempts, TenantStores, } from './tenant-stores';
+export { ApprovalObservationSchema, ApprovalTimelineEventSchema, APPROVAL_SUMMARY_MAX_BYTES, DEFAULT_APPROVAL_TIMELINE_CAPACITY, DEFAULT_APPROVAL_TIMELINE_TTL_MS, approvalTimelineCursor, parseApprovalObservations, validateApprovalTimelineAppend, } from './approval-timeline';
+export type { ApprovalObservation, ApprovalTimelineAppendInput, ApprovalTimelineEvent, ApprovalTimelineStore, ApprovalTimelineTail, } from './approval-timeline';
 export { DEFAULT_ACTIVITY_BOUNDS, DEFAULT_ACTIVITY_CAPACITY, DEFAULT_ACTIVITY_MAX_BYTES, DEFAULT_ACTIVITY_MAX_EVENTS, DEFAULT_ACTIVITY_TTL_MS, DEFAULT_BOARD_CHANNEL_MAX_BYTES, DEFAULT_BOARD_TITLE_MAX_BYTES, DEFAULT_PRESENCE_DETAIL_MAX_BYTES, DEFAULT_PRESENCE_MINIMUM_INTERVAL_MS, DEFAULT_PRESENCE_TTL_MS, } from './coordination';
 export type { ActivityBounds } from './coordination';
+export { TimelineEventSchema, ActivityAppendRequestSchema, activityCursor, parseTimelineEvents, projectTimelineEvents, validateActivityAppend, } from './activity';
+export type { ActivityAppendInput, ActivityCursor, ActivityStore, ActivityTail, TimelineEvent, } from './activity';
 export { BoardFeedClient, BoardFeedRetryableError, BoardFeedStoppedError } from './coordination-client';
 export type { BoardFeedClientOptions, BoardFeedItem, BoardFeedMode, BoardFeedPage, BoardFeedRead, } from './coordination-client';
 export { TRUTH_BATCH_MAX_RECORDS, TRUTH_INLINE_CONTENT_TYPE, TRUTH_LABEL_MAX_LENGTH, TRUTH_MANIFEST_MAX_LIMIT, TRUTH_RECORD_CAPABILITY, TRUTH_RECORD_KEY_MAX_LENGTH, TRUTH_REQUEST_ID_MAX_LENGTH, TruthBodyInputSchema, TruthCommitResponseSchema, TruthRecordKeySchema, TruthRecordMetadataSchema, TruthWriteRequestSchema, truthManifestMetadata, truthRecordMetadata, } from './truth/contract';
@@ -56,5 +60,5 @@ export type { TruthCommitErrorCode } from './truth/errors';
 export { CLOUD_STORE_NAMES, TASK_ATTEMPT_STATUSES } from './stores/ports';
 export { CLOUD_PORT_INTERFACES, CLOUD_PORT_METHODS } from './stores/ports-contract';
 export type { BlobContent, BlobContentProxy, BlobDeclaration, BlobObservation, BlobWriteResult, CloudBlobStore, CloudStoreName, CloudStores, DeviceDirectory, DeviceRecord, DeviceRegistration, InboundDedupStore, InboundRateLimiter, NonceStore, PairingCodeClaims, PairingCodeInfo, PairingCodeIssueInput, PairingCodeStore, ProofRequestReceipt, ProofRequestReceiptInput, ProofRequestReceiptStore, RequestReceipt, RequestReceiptStore, TaskAttempt, TaskAttemptStatus, TaskAttemptStore, } from './stores/ports';
-export { AllowAllRateLimiter, BLOB_URL_TTL_MS, DEDUP_RING_CAPACITY, InMemoryBlobContentProxy, InMemoryCloudBlobStore, InMemoryDeviceDirectory, InMemoryInboundDedupStore, InMemoryNonceStore, InMemoryPairingCodeStore, InMemoryRequestReceiptStore, InMemoryProofRequestReceiptStore, InMemoryTaskAttemptStore, NONCE_TTL_MS, createInMemoryBlobs, createInMemoryCloudStores, } from './stores/in-memory/index';
+export { AllowAllRateLimiter, BLOB_URL_TTL_MS, DEDUP_RING_CAPACITY, InMemoryBlobContentProxy, InMemoryCloudBlobStore, InMemoryActivityStore, InMemoryDeviceDirectory, InMemoryInboundDedupStore, InMemoryNonceStore, InMemoryPairingCodeStore, InMemoryRequestReceiptStore, InMemoryProofRequestReceiptStore, InMemoryTaskAttemptStore, NONCE_TTL_MS, createInMemoryBlobs, createInMemoryCloudStores, } from './stores/in-memory/index';
 export type { InMemoryBlobStoreOptions, InMemoryBlobs, InMemoryCloudComposition, } from './stores/in-memory/index';