@beeuni/sdk 0.2.0 → 0.3.0

package/dist/core/rest/projects-client/iam-actions.js

@@ -0,0 +1,101 @@
+import { reviewItemTarget } from './review-items.js';
+export const PROJECT_ACTIONS = {
+    PROJECT_READ: 'project.read',
+    PROJECT_WRITE: 'project.write',
+    PROJECT_DELETE: 'project.delete',
+    PROJECT_SESSION_READ: 'project.session.read',
+    PROJECT_SESSION_START: 'project.session.start',
+    PROJECT_SESSION_STOP: 'project.session.stop',
+    PROJECT_SESSION_BINDINGS_WRITE: 'project.session.bindings.write',
+    PROJECT_MEMBERS_READ: 'project.members.read',
+    PROJECT_MEMBERS_MANAGE: 'project.members.manage',
+    PROJECT_TRIGGER_READ: 'project.trigger.read',
+    PROJECT_TRIGGER_CREATE: 'project.trigger.create',
+    PROJECT_TRIGGER_UPDATE: 'project.trigger.update',
+    PROJECT_TRIGGER_DELETE: 'project.trigger.delete',
+    PROJECT_TRIGGER_FIRE: 'project.trigger.fire',
+    PROJECT_GATEWAY_LOGS_READ: 'project.gateway.logs.read',
+    PROJECT_GATEWAY_SPEND_READ: 'project.gateway.spend.read',
+    PROJECT_USAGE_READ: 'project.usage.read',
+    PROJECT_GATEWAY_BUDGET_SET: 'project.gateway.budget.set',
+    PROJECT_GATEWAY_KEYS_MANAGE: 'project.gateway.keys.manage',
+    PROJECT_AGENT_READ: 'project.agent.read',
+    PROJECT_AGENT_WRITE: 'project.agent.write',
+    PROJECT_SKILL_READ: 'project.skill.read',
+    PROJECT_SKILL_WRITE: 'project.skill.write',
+    PROJECT_COMMAND_READ: 'project.command.read',
+    PROJECT_COMMAND_WRITE: 'project.command.write',
+    PROJECT_FILE_READ: 'project.file.read',
+    PROJECT_FILE_WRITE: 'project.file.write',
+    PROJECT_SETTINGS_WRITE: 'project.settings.write',
+    PROJECT_SANDBOX_WRITE: 'project.sandbox.write',
+    PROJECT_MODEL_READ: 'project.model.read',
+    PROJECT_MODEL_WRITE: 'project.model.write',
+    PROJECT_GITOPS_READ: 'project.gitops.read',
+    PROJECT_GITOPS_PUSH: 'project.gitops.push',
+    PROJECT_GITOPS_MERGE: 'project.gitops.merge',
+    PROJECT_GITOPS_REF_ANY: 'project.gitops.ref.any',
+    PROJECT_GITOPS_REF_DELETE: 'project.gitops.ref.delete',
+    PROJECT_SECRET_READ: 'project.secret.read',
+    PROJECT_SECRET_WRITE: 'project.secret.write',
+    PROJECT_CONNECTOR_READ: 'project.connector.read',
+    PROJECT_CONNECTOR_CONNECTIONS_MANAGE: 'project.connector.connections.manage',
+    PROJECT_CONNECTOR_WRITE: 'project.connector.write',
+    PROJECT_APP_READ: 'project.app.read',
+    PROJECT_APP_WRITE: 'project.app.write',
+    PROJECT_APP_DEPLOY: 'project.app.deploy',
+    PROJECT_APP_ADMIN: 'project.app.admin',
+    PROJECT_REVIEW_READ: 'project.review.read',
+    PROJECT_REVIEW_SUBMIT: 'project.review.submit',
+    PROJECT_REVIEW_ACT: 'project.review.act',
+    PROJECT_CREDENTIALS_ISSUE: 'project.credentials.issue',
+};
+export const TRIGGER_CONTROL_ACTIONS = [
+    PROJECT_ACTIONS.PROJECT_WRITE,
+    PROJECT_ACTIONS.PROJECT_TRIGGER_CREATE,
+    PROJECT_ACTIONS.PROJECT_TRIGGER_FIRE,
+    PROJECT_ACTIONS.PROJECT_TRIGGER_UPDATE,
+    PROJECT_ACTIONS.PROJECT_TRIGGER_DELETE,
+];
+export function triggerControlsFrom(cans) {
+    const allowed = (action) => cans[action]?.allowed === true;
+    const write = allowed(PROJECT_ACTIONS.PROJECT_WRITE);
+    return {
+        canCreate: write && allowed(PROJECT_ACTIONS.PROJECT_TRIGGER_CREATE),
+        canFire: allowed(PROJECT_ACTIONS.PROJECT_TRIGGER_FIRE),
+        canUpdate: write && allowed(PROJECT_ACTIONS.PROJECT_TRIGGER_UPDATE),
+        canDelete: write && allowed(PROJECT_ACTIONS.PROJECT_TRIGGER_DELETE),
+    };
+}
+export const REVIEW_CONTROL_ACTIONS = [
+    PROJECT_ACTIONS.PROJECT_WRITE,
+    PROJECT_ACTIONS.PROJECT_GITOPS_PUSH,
+    PROJECT_ACTIONS.PROJECT_GITOPS_MERGE,
+    PROJECT_ACTIONS.PROJECT_REVIEW_ACT,
+];
+export function changeRequestControlsFrom(cans) {
+    const allowed = (action) => cans[action]?.allowed === true;
+    const write = allowed(PROJECT_ACTIONS.PROJECT_WRITE);
+    return {
+        canOpen: write && allowed(PROJECT_ACTIONS.PROJECT_GITOPS_PUSH),
+        canMerge: write && allowed(PROJECT_ACTIONS.PROJECT_GITOPS_MERGE),
+        canClose: write,
+    };
+}
+export function reviewVerdictAllowed(item, verdict, cans) {
+    const target = reviewItemTarget(item.id);
+    if (target.type === 'connector_call') {
+        const call = item.kind === 'approval' ? item.detail.actions?.[0] : undefined;
+        return ((verdict === 'approve' || verdict === 'reject') &&
+            call?.canResolve !== false &&
+            call?.previewAuthorized !== false);
+    }
+    if (target.type === 'change_request') {
+        if (verdict === 'answer')
+            return false;
+        if (verdict === 'approve')
+            return changeRequestControlsFrom(cans).canMerge;
+    }
+    return (cans[PROJECT_ACTIONS.PROJECT_WRITE]?.allowed === true &&
+        cans[PROJECT_ACTIONS.PROJECT_REVIEW_ACT]?.allowed === true);
+}

package/dist/core/rest/projects-client/iam.d.ts

@@ -1,4 +1,5 @@
 export * from './iam-types.js';
+export * from './iam-actions.js';
 export * from './iam-groups.js';
 export * from './iam-grants.js';
 export * from './iam-policies.js';

package/dist/core/rest/projects-client/iam.js

@@ -1,4 +1,5 @@
 export * from './iam-types.js';
+export * from './iam-actions.js';
 export * from './iam-groups.js';
 export * from './iam-grants.js';
 export * from './iam-policies.js';

package/dist/core/rest/projects-client/notifications.d.ts

@@ -22,7 +22,7 @@ export declare function unregisterDeviceToken(deviceToken: string, options?: {
     success: true;
     deleted: boolean;
 }>;
-export declare const INBOX_NOTIFICATION_KINDS: readonly ["turn_done", "turn_error", "question", "permission", "shared", "automation_failed", "automation_recovered"];
+export declare const INBOX_NOTIFICATION_KINDS: readonly ["turn_done", "turn_error", "question", "permission", "shared", "automation_failed", "automation_recovered", "capture_device_down", "capture_device_recovered"];
 export type InboxNotificationKind = (typeof INBOX_NOTIFICATION_KINDS)[number];
 export interface InboxNotification {
     id: string;

package/dist/core/rest/projects-client/notifications.js

@@ -14,6 +14,8 @@ export const INBOX_NOTIFICATION_KINDS = [
     'shared',
     'automation_failed',
     'automation_recovered',
+    'capture_device_down',
+    'capture_device_recovered',
 ];
 export async function listNotifications(params = {}, options) {
     const query = new URLSearchParams();
@@ -39,6 +41,8 @@ export const DEFAULT_NOTIFICATION_PREFERENCES = {
     shared: { push: true, email: true },
     automation_failed: { push: true, email: true },
     automation_recovered: { push: true, email: false },
+    capture_device_down: { push: true, email: true },
+    capture_device_recovered: { push: true, email: false },
 };
 export async function getNotificationPreferences() {
     return unwrap(await backendApi.get('/notifications/preferences', { showErrors: false }));

package/dist/core/rest/projects-client/projects.d.ts

@@ -2,8 +2,8 @@ import type { CatalogModel } from '@beeuni/llm-catalog';
 import { type ApiClientOptions } from '../../http/api-client.js';
 import type { SandboxProviderName } from '../platform-client/types.js';
 import { type ProjectFileEntry, type ProjectGitConnection, type ProjectRole, type ServerTokenOptions } from './shared.js';
-export type FeatureFlagKey = 'agent_tunnel' | 'marketplace' | 'connectors_api_discover' | 'agentmail_email' | 'teams' | 'llm_gateway' | 'review_center' | 'meta_agent' | 'apps' | 'monitors' | 'reminders' | 'warm_sessions' | 'secrets_egress' | 'pi_worker' | 'session_transcript_history' | 'pooled_provider_secrets' | 'pi_harness' | 'config_releases' | 'agent_principal' | 'us_region' | 'event_triggers' | 'notification_center' | 'volumes' | 'stateless_sessions' | 'drives' | 'ephemeral_sandboxes' | 'session_log' | 'human_messaging';
-type GraduatedFeatureFlagKey = 'agent_tunnel' | 'teams' | 'review_center' | 'session_transcript_history' | 'agent_principal' | 'human_messaging' | 'pi_worker' | 'config_releases';
+export type FeatureFlagKey = 'agent_tunnel' | 'marketplace' | 'connectors_api_discover' | 'agentmail_email' | 'teams' | 'llm_gateway' | 'review_center' | 'meta_agent' | 'apps' | 'monitors' | 'reminders' | 'warm_sessions' | 'secrets_egress' | 'pi_worker' | 'session_transcript_history' | 'pooled_provider_secrets' | 'pi_harness' | 'genui' | 'config_releases' | 'agent_principal' | 'us_region' | 'event_triggers' | 'notification_center' | 'volumes' | 'stateless_sessions' | 'drives' | 'ephemeral_sandboxes' | 'session_log' | 'session_log_restore' | 'human_messaging';
+type GraduatedFeatureFlagKey = 'agent_tunnel' | 'teams' | 'review_center' | 'session_transcript_history' | 'agent_principal' | 'human_messaging' | 'pi_worker' | 'config_releases' | 'apps' | 'stateless_sessions' | 'ephemeral_sandboxes';
 type ServedFeatureFlagKey = Exclude<FeatureFlagKey, GraduatedFeatureFlagKey>;
 export declare const FEATURE_FLAG_KEYS: readonly FeatureFlagKey[];
 export type FeatureFlagStability = 'experimental' | 'beta' | 'stable';
@@ -138,6 +138,7 @@ export interface GatewayCatalogModel {
 }
 export interface ProjectLlmCatalogResponse {
     models: Record<string, GatewayCatalogModel>;
+    platformFeePercent?: number;
     managedPricingRoutes?: Record<string, Array<{
         route: string;
         role: 'preferred' | 'eligible';

package/dist/core/rest/projects-client/projects.js

@@ -7,21 +7,20 @@ export const FEATURE_FLAG_KEYS = [
     'agentmail_email',
     'llm_gateway',
     'meta_agent',
-    'apps',
     'monitors',
     'reminders',
     'warm_sessions',
     'secrets_egress',
     'pooled_provider_secrets',
     'pi_harness',
+    'genui',
     'us_region',
     'event_triggers',
     'notification_center',
     'volumes',
-    'stateless_sessions',
     'drives',
-    'ephemeral_sandboxes',
     'session_log',
+    'session_log_restore',
 ];
 export async function listProjects() {
     return unwrap(await backendApi.get('/projects'));

package/dist/core/rest/projects-client/review-items.d.ts

@@ -49,6 +49,8 @@ export interface ReviewApprovalAction {
     rawArgsPreview?: Record<string, unknown>;
     reviewComplete?: boolean;
     previewAuthorized?: boolean;
+    canResolve?: boolean;
+    resolvers?: 'managers' | 'managers_and_launcher';
     approvalContext?: string;
     connectorRisk?: string | null;
     policySource: string;

package/dist/core/rest/projects-client/review-items.js

@@ -138,6 +138,10 @@ function approvalDetail(detail, row) {
                 rawArgsPreview: hasArgsPreview ? rawArgsPreview : undefined,
                 reviewComplete: detail.args_preview_complete === true,
                 previewAuthorized: detail.args_preview_authorized !== false,
+                canResolve: typeof row.can_resolve === 'boolean'
+                    ? row.can_resolve
+                    : detail.args_preview_authorized !== false,
+                ...(row.resolvers ? { resolvers: row.resolvers } : {}),
                 approvalContext: asString(detail.approval_context),
                 connectorRisk: asString(detail.risk) ?? null,
                 policySource: 'Requires approval',

package/dist/core/rest/projects-client/review.d.ts

@@ -24,13 +24,27 @@ export interface ApiReviewItem {
     metadata: Record<string, unknown>;
     created_at: string;
     updated_at: string;
+    can_resolve?: boolean;
+    resolvers?: 'managers' | 'managers_and_launcher' | null;
 }
-export declare function listReviewItems(projectId: string, params?: {
+export interface ReviewItemsQuery {
     segment?: ReviewSegment;
     kind?: ReviewItemKind;
-}): Promise<{
+    sessionId?: string;
+    limit?: number;
+}
+export interface ReviewItemsPage {
     review_items: ApiReviewItem[];
-}>;
+    next_cursor?: string | null;
+}
+export declare function listReviewItems(projectId: string, params?: ReviewItemsQuery & {
+    cursor?: string;
+}): Promise<ReviewItemsPage>;
+export interface ReviewSummary {
+    needs_you_total: number;
+    needs_you_by_session: Record<string, number>;
+}
+export declare function getReviewSummary(projectId: string): Promise<ReviewSummary>;
 export declare function getReviewItem(projectId: string, reviewItemId: string): Promise<{
     review_item: ApiReviewItem;
 }>;

package/dist/core/rest/projects-client/review.js

@@ -6,9 +6,20 @@ export async function listReviewItems(projectId, params) {
         q.set('segment', params.segment);
     if (params?.kind)
         q.set('kind', params.kind);
+    if (params?.sessionId)
+        q.set('session_id', params.sessionId);
+    if (params?.limit != null)
+        q.set('limit', String(params.limit));
+    if (params?.cursor)
+        q.set('cursor', params.cursor);
     const qs = q.toString();
     return unwrap(await backendApi.get(`/projects/${projectId}/review/items${qs ? `?${qs}` : ''}`, { showErrors: false }));
 }
+export async function getReviewSummary(projectId) {
+    return unwrap(await backendApi.get(`/projects/${projectId}/review/summary`, {
+        showErrors: false,
+    }));
+}
 export async function getReviewItem(projectId, reviewItemId) {
     return unwrap(await backendApi.get(`/projects/${projectId}/review/items/${reviewItemId}`));
 }

package/dist/core/rest/projects-client/secrets.d.ts

@@ -4,6 +4,7 @@ export type SecretDeliveryStrategy = 'runtime' | 'egress' | 'broker' | 'denied';
 export type SecretConsumer = 'sandbox' | 'llm_gateway' | 'connector' | 'git_proxy' | 'http_broker' | 'network';
 export type SecretDeliveryStatus = 'available' | 'unavailable' | 'disabled';
 export type SecretDeliveryBlockedReason = 'no_agent_grant';
+export type SecretValueStatus = 'ok' | 'undecryptable';
 export type SecretInjectionSlot = {
     kind: 'header';
     name: string;
@@ -62,6 +63,7 @@ export interface ProjectSecret {
     mine: {
         active: boolean;
         updated_at: string;
+        status?: SecretValueStatus;
     } | null;
     effective_source: 'mine' | 'shared' | 'none';
     can_manage_shared: boolean;
@@ -76,6 +78,7 @@ export interface ProjectSecret {
     requires_rotation?: boolean;
     shared_with?: ConnectionShare[];
     usable?: boolean;
+    status?: SecretValueStatus;
 }
 export interface SecretSharePrincipal {
     principal_type: 'user' | 'group' | 'agent';

package/dist/core/rest/projects-client/session-attachments.js

@@ -107,6 +107,18 @@ function showItems(raw) {
         return [];
     }
 }
+function asV1Message(record) {
+    const parts = record.blocks.filter(isObject).map((block) => {
+        if (block.type === "attachment")
+            return { type: "file", url: block.ref ?? block.url, filename: block.name, mime: block.mime };
+        if (block.type === "tool_call")
+            return { type: "tool", tool: block.name, state: { input: block.input } };
+        if (block.type === "harness" && isObject(block.data))
+            return block.data;
+        return block;
+    });
+    return { info: { id: record.message_id, role: record.role }, parts };
+}
 function attachmentsFromTextPart(text, add) {
     for (const attrs of fileTagAttributes(text)) {
         add(tagAttribute(attrs, "attachment"), tagAttribute(attrs, "filename") ?? basename(tagAttribute(attrs, "path")), tagAttribute(attrs, "mime"));
@@ -123,7 +135,8 @@ export function findSessionAttachments(messages) {
         return [];
     const found = [];
     const seen = new Set();
-    for (const message of messages) {
+    for (const entry of messages) {
+        const message = isObject(entry) && Array.isArray(entry.blocks) ? asV1Message(entry) : entry;
         if (!isObject(message) || !isObject(message.info) || !Array.isArray(message.parts))
             continue;
         const messageId = stringOrNull(message.info.id);

package/dist/core/rest/projects-client/sessions.d.ts

@@ -1,4 +1,5 @@
 import { type ApiClientOptions } from '../../http/api-client.js';
+import { type SessionLogPage, type SessionLogPageQuery } from '../../session-log/source.js';
 import type { AuditEvent } from './audit.js';
 import { type ConnectorSharing } from './shared.js';
 export type ProjectSessionStatus = 'queued' | 'branching' | 'provisioning' | 'running' | 'stopped' | 'failed' | 'completed';
@@ -52,6 +53,8 @@ export interface ProjectSession {
     runtime_status?: 'provisioning' | 'active' | 'stopped' | 'error' | 'archived' | null;
     deleted_at?: string | null;
     deleted_by?: string | null;
+    pinned_at?: string | null;
+    archived_at?: string | null;
     created_at: string;
     updated_at: string;
 }
@@ -83,6 +86,7 @@ export interface CreateProjectSessionInput {
     agent_name?: string;
     sandbox_slug?: string;
     initial_prompt?: string;
+    initial_context?: string;
     pending_prompt?: PendingSessionPrompt;
     model?: string;
     opencode_model?: string;
@@ -137,6 +141,7 @@ export interface ListProjectSessionsOptions {
     startedBy?: 'me' | 'others' | 'automated';
     q?: string;
     labels?: string[];
+    view?: 'pinned' | 'archived';
 }
 export interface ProjectSessionPage {
     items: ProjectSession[];
@@ -164,6 +169,12 @@ export declare function getSessionWatch(projectId: string, sessionId: string): P
 export declare function setSessionWatch(projectId: string, sessionId: string, watching: boolean): Promise<{
     watching: boolean;
 }>;
+export interface SessionListState {
+    pinned_at: string | null;
+    archived_at: string | null;
+}
+export declare function setSessionPinned(projectId: string, sessionId: string, pinned: boolean): Promise<SessionListState>;
+export declare function setSessionArchived(projectId: string, sessionId: string, archived: boolean): Promise<SessionListState>;
 export interface SessionPreviewCandidate {
     id: string;
     label: string;
@@ -247,6 +258,8 @@ export interface SessionAuditAction {
     at: string;
     resolved_at: string | null;
     approval_url?: string | null;
+    can_resolve?: boolean;
+    resolvers?: 'managers' | 'managers_and_launcher' | null;
 }
 export interface SessionAudit {
     session_id: string;
@@ -322,6 +335,9 @@ export declare function getSessionTranscriptSync(projectId: string, sessionId: s
     before?: string | null;
     child?: string | null;
 }): Promise<SessionTranscriptSyncEnvelope>;
+export declare function getSessionLogPage(projectId: string, sessionId: string, query?: SessionLogPageQuery, options?: {
+    signal?: AbortSignal;
+}): Promise<SessionLogPage | null>;
 export type SessionTurnState = 'delivering' | 'active';
 export interface SessionTurn {
     turn_token: string;
@@ -352,8 +368,11 @@ export interface SessionTurnStatus {
     turns: SessionTurn[];
     last_ended?: SessionTurnEnded;
     recent_failures?: SessionTurnFailure[];
+    can_stop?: boolean;
 }
-export declare function getSessionTurn(projectId: string, sessionId: string): Promise<SessionTurnStatus>;
+export declare function getSessionTurn(projectId: string, sessionId: string, options?: {
+    showErrors?: boolean;
+}): Promise<SessionTurnStatus>;
 export interface SessionOpenBundleUnknown {
     known: false;
     reason: string;
@@ -528,8 +547,15 @@ export interface UpdateProjectSessionInput {
 export declare function updateProjectSession(projectId: string, sessionId: string, input: UpdateProjectSessionInput): Promise<ProjectSession>;
 export declare function deleteProjectSession(projectId: string, sessionId: string): Promise<{
     ok: boolean;
+    restore_until?: string;
+}>;
+export declare function recoverProjectSession(projectId: string, sessionId: string): Promise<{
+    ok: true;
+}>;
+export declare function restoreProjectSession(projectId: string, sessionId: string): Promise<{
+    ok: boolean;
 }>;
-export declare function restartProjectSession(projectId: string, sessionId: string, opts?: {
+export declare function restartProjectSession(projectId: string, sessionId: string, _opts?: {
     reset_machine?: boolean;
     discard_state?: boolean;
 }): Promise<{
@@ -650,6 +676,7 @@ export type SessionMessageAuthor = {
 export interface SessionMessageAuthors {
     authors: Record<string, SessionMessageAuthor>;
     initial_author: SessionMessageAuthor | null;
+    stops?: Record<string, SessionMessageAuthor>;
 }
 export declare function getSessionMessageAuthors(projectId: string, sessionId: string): Promise<SessionMessageAuthors>;
 export interface SessionServedModel {

package/dist/core/rest/projects-client/sessions.js

@@ -2,6 +2,8 @@ import { ApiError, backendApi } from '../../http/api-client.js';
 import { markSessionFresh } from '../../http/fresh-sessions.js';
 import { currentSavedCopyStore } from '../../session-sync/saved-copy-store.js';
 import { noteSessionStopped } from '../../http/session-stopped.js';
+import { isSessionLogPage } from '../../session-log/guard.js';
+import { loadSessionLogPage } from '../../session-log/source.js';
 import { unwrap } from './shared.js';
 export function sessionParentId(session) {
     const parent = typeof session.parent_session_id === 'string'
@@ -34,6 +36,8 @@ function projectSessionListQuery(options) {
         params.set('q', q);
     for (const label of options?.labels ?? [])
         params.append('label', label);
+    if (options?.view)
+        params.set(options.view, 'only');
     return params.size > 0 ? `?${params}` : '';
 }
 export async function listProjectSessionsPage(projectId, options) {
@@ -63,6 +67,12 @@ export async function setSessionWatch(projectId, sessionId, watching) {
         watching,
     }));
 }
+export async function setSessionPinned(projectId, sessionId, pinned) {
+    return unwrap(await backendApi.put(`/projects/${projectId}/sessions/${sessionId}/pin`, { pinned }));
+}
+export async function setSessionArchived(projectId, sessionId, archived) {
+    return unwrap(await backendApi.put(`/projects/${projectId}/sessions/${sessionId}/archive`, { archived }));
+}
 export function resolvePublicShareUrl(share, origin) {
     const raw = share.public_url ?? share.public_path ?? share.proxy_path ?? share.public_token ?? '';
     if (!raw)
@@ -165,8 +175,22 @@ export async function getSessionTranscriptSync(projectId, sessionId, options) {
         search.set('child', options.child);
     return unwrap(await backendApi.get(`/projects/${projectId}/sessions/${sessionId}/transcript?${search.toString()}`, { showErrors: false, signal: options?.signal }));
 }
-export async function getSessionTurn(projectId, sessionId) {
-    return unwrap(await backendApi.get(`/projects/${projectId}/sessions/${sessionId}/turn`));
+export async function getSessionLogPage(projectId, sessionId, query = {}, options) {
+    let page;
+    try {
+        page = await loadSessionLogPage(projectId, sessionId, query, options?.signal);
+    }
+    catch (error) {
+        if (error?.status === 404)
+            return null;
+        throw error;
+    }
+    if (!isSessionLogPage(page))
+        throw new Error('The response is not a session log page');
+    return page;
+}
+export async function getSessionTurn(projectId, sessionId, options) {
+    return unwrap(await backendApi.get(`/projects/${projectId}/sessions/${sessionId}/turn`, options?.showErrors === false ? { showErrors: false } : undefined));
 }
 export async function getSessionOpenBundle(projectId, sessionId, options) {
     const search = new URLSearchParams();
@@ -222,8 +246,14 @@ export async function deleteProjectSession(projectId, sessionId) {
     void currentSavedCopyStore()?.remove(projectId, sessionId);
     return result;
 }
-export async function restartProjectSession(projectId, sessionId, opts = {}) {
-    return unwrap(await backendApi.post(`/projects/${projectId}/sessions/${sessionId}/restart`, opts.reset_machine ? { reset_machine: true, ...(opts.discard_state ? { discard_state: true } : {}) } : {}));
+export async function recoverProjectSession(projectId, sessionId) {
+    return unwrap(await backendApi.post(`/projects/${projectId}/sessions/${sessionId}/recover`, {}, { showErrors: false }));
+}
+export async function restoreProjectSession(projectId, sessionId) {
+    return unwrap(await backendApi.post(`/projects/${projectId}/sessions/${sessionId}/restore`, {}, { showErrors: false }));
+}
+export async function restartProjectSession(projectId, sessionId, _opts = {}) {
+    return unwrap(await backendApi.post(`/projects/${projectId}/sessions/${sessionId}/restart`, {}));
 }
 export async function stopProjectSession(projectId, sessionId) {
     const stopped = unwrap(await backendApi.post(`/projects/${projectId}/sessions/${sessionId}/stop`, {}));

package/dist/core/runtime/runtime-rest-client.js

@@ -158,7 +158,7 @@ export function fetchEventTransport(fetchFn = globalThis.fetch) {
         const reader = response.body.pipeThrough(new TextDecoderStream()).getReader();
         const cancel = () => {
             try {
-                void reader.cancel();
+                reader.cancel().catch(() => { });
             }
             catch {
             }

package/dist/core/runtime/runtime-types.d.ts

@@ -599,6 +599,7 @@ export type Command = {
     template: string;
     subtask?: boolean;
     hints: Array<string>;
+    agents?: Array<string>;
 };
 export type Agent = {
     name: string;

package/dist/core/session/open-bundle.d.ts

@@ -1,7 +1,9 @@
 import { type SessionAudit, type SessionOpenBundle, type SessionPrompt, type SessionTranscriptSyncEnvelope, type SessionTurn, type SessionTurnEnded, type SessionTurnFailure } from '../rest/projects-client/sessions.js';
 export declare const OPEN_BUNDLE_SHARE_MS = 5000;
-export declare const OPEN_BUNDLE_TRANSCRIPT_TTL_MS = 60000;
 export declare const OPEN_BUNDLE_TRANSCRIPT_LIMIT = 40;
+export declare const SAVED_WINDOW_HOLD_MS: number;
+export declare function holdSavedWindow(projectId: string, sessionId: string, envelope: SessionTranscriptSyncEnvelope, nowMs?: number): void;
+export declare function heldSavedWindow(projectId: string, sessionId: string, nowMs?: number): SessionTranscriptSyncEnvelope | null;
 export declare function resetSessionOpenBundles(): void;
 export interface OpenSessionBundleOptions {
     transcript?: number;
@@ -9,16 +11,14 @@ export interface OpenSessionBundleOptions {
 }
 export declare function openSessionBundle(projectId: string, sessionId: string, options?: OpenSessionBundleOptions): void;
 export declare function claimOpenBundle(projectId: string, sessionId: string, nowMs?: number): Promise<SessionOpenBundle | null> | null;
-export declare function settledOpenBundle(projectId: string, sessionId: string, nowMs?: number): SessionOpenBundle | null;
 export interface OpenBundleTurnObservation {
     turns: SessionTurn[];
     last_ended: SessionTurnEnded | undefined;
     recent_failures?: SessionTurnFailure[];
+    can_stop?: boolean;
     atMs: number;
 }
 export declare function openBundleTurn(bundle: SessionOpenBundle): OpenBundleTurnObservation | null;
 export declare function openBundleQueue(bundle: SessionOpenBundle): SessionPrompt[] | null;
 export declare function openBundleAudit(bundle: SessionOpenBundle): SessionAudit | null;
 export declare function openBundleHistory(bundle: SessionOpenBundle): SessionTranscriptSyncEnvelope | null;
-export declare function takeOpenBundleTranscriptAbsence(projectId: string, sessionId: string, nowMs?: number): boolean;
-export declare function takeOpenBundleTranscript(projectId: string, sessionId: string, nowMs?: number): SessionTranscriptSyncEnvelope | null;

package/dist/core/session/open-bundle.js

@@ -1,17 +1,37 @@
 import { getSessionOpenBundle, } from '../rest/projects-client/sessions.js';
 export const OPEN_BUNDLE_SHARE_MS = 5_000;
-export const OPEN_BUNDLE_TRANSCRIPT_TTL_MS = 60_000;
 export const OPEN_BUNDLE_TRANSCRIPT_LIMIT = 40;
+export const SAVED_WINDOW_HOLD_MS = 5 * 60_000;
+const HELD_WINDOW_CAP = 16;
+const heldWindows = new Map();
+export function holdSavedWindow(projectId, sessionId, envelope, nowMs = Date.now()) {
+    const key = scopeKey(projectId, sessionId);
+    heldWindows.delete(key);
+    heldWindows.set(key, { envelope, atMs: nowMs });
+    while (heldWindows.size > HELD_WINDOW_CAP) {
+        const oldest = heldWindows.keys().next().value;
+        if (oldest === undefined)
+            break;
+        heldWindows.delete(oldest);
+    }
+}
+export function heldSavedWindow(projectId, sessionId, nowMs = Date.now()) {
+    const held = heldWindows.get(scopeKey(projectId, sessionId));
+    if (!held)
+        return null;
+    if (nowMs - held.atMs > SAVED_WINDOW_HOLD_MS) {
+        heldWindows.delete(scopeKey(projectId, sessionId));
+        return null;
+    }
+    return held.envelope;
+}
 const entries = new Map();
-const transcripts = new Map();
-const absentTranscripts = new Map();
 function scopeKey(projectId, sessionId) {
     return `${projectId}/${sessionId}`;
 }
 export function resetSessionOpenBundles() {
     entries.clear();
-    transcripts.clear();
-    absentTranscripts.clear();
+    heldWindows.clear();
 }
 export function openSessionBundle(projectId, sessionId, options = {}) {
     if (!projectId || !sessionId)
@@ -26,17 +46,12 @@ export function openSessionBundle(projectId, sessionId, options = {}) {
         startedAtMs: nowMs,
         settledAtMs: null,
         promise: getSessionOpenBundle(projectId, sessionId, {
-            transcript: options.transcript ?? OPEN_BUNDLE_TRANSCRIPT_LIMIT,
-        })
-            .then((bundle) => {
-            stashTranscript(key, bundle, now());
-            return bundle;
-        })
-            .catch(() => null),
+            transcript: options.transcript ??
+                (heldSavedWindow(projectId, sessionId, nowMs) ? 0 : OPEN_BUNDLE_TRANSCRIPT_LIMIT),
+        }).catch(() => null),
     };
     entry.promise = entry.promise.then((bundle) => {
         entry.settledAtMs = now();
-        entry.bundle = bundle;
         return bundle;
     });
     entries.set(key, entry);
@@ -59,10 +74,6 @@ export function claimOpenBundle(projectId, sessionId, nowMs = Date.now()) {
     }
     return entry.promise;
 }
-export function settledOpenBundle(projectId, sessionId, nowMs = Date.now()) {
-    const entry = entries.get(scopeKey(projectId, sessionId));
-    return entry && entry.settledAtMs !== null && claimable(entry, nowMs) ? (entry.bundle ?? null) : null;
-}
 export function openBundleTurn(bundle) {
     const turn = bundle.turn;
     if (!turn || turn.known !== true)
@@ -72,6 +83,7 @@ export function openBundleTurn(bundle) {
         turns: turn.turns ?? [],
         last_ended: turn.last_ended,
         recent_failures: turn.recent_failures,
+        ...(typeof turn.can_stop === 'boolean' ? { can_stop: turn.can_stop } : {}),
         atMs: Number.isFinite(observedAtMs) ? observedAtMs : Date.now(),
     };
 }
@@ -104,32 +116,3 @@ export function openBundleHistory(bundle) {
     const savedRoot = envelope.runtime_session_id ?? envelope.opencode_session_id;
     return root && savedRoot === root ? envelope : null;
 }
-function stashTranscript(key, bundle, nowMs) {
-    const transcript = bundle.transcript;
-    if (!transcript || transcript.known !== true || transcript.requested !== true)
-        return;
-    if (!transcript.available || transcript.messages.length === 0) {
-        absentTranscripts.set(key, nowMs);
-        return;
-    }
-    const { known: _known, requested: _requested, ...envelope } = transcript;
-    transcripts.set(key, { envelope, stashedAtMs: nowMs });
-}
-export function takeOpenBundleTranscriptAbsence(projectId, sessionId, nowMs = Date.now()) {
-    const key = scopeKey(projectId, sessionId);
-    const answeredAtMs = absentTranscripts.get(key);
-    if (answeredAtMs === undefined)
-        return false;
-    absentTranscripts.delete(key);
-    return nowMs - answeredAtMs <= OPEN_BUNDLE_TRANSCRIPT_TTL_MS;
-}
-export function takeOpenBundleTranscript(projectId, sessionId, nowMs = Date.now()) {
-    const key = scopeKey(projectId, sessionId);
-    const stash = transcripts.get(key);
-    if (!stash)
-        return null;
-    transcripts.delete(key);
-    if (nowMs - stash.stashedAtMs > OPEN_BUNDLE_TRANSCRIPT_TTL_MS)
-        return null;
-    return stash.envelope;
-}