@byok-sdk/client 0.15.0 → 0.16.0

package/dist/daemon/agent-message-outbox.d.ts

@@ -53,6 +53,8 @@ export declare class AgentMessageOutbox {
     activate(taskId: string, sessionRef: string, isCurrent?: () => boolean): Promise<AgentMessageOutboxRecord | undefined>;
     /** Local lifecycle cancellation, never a synthesized consumer disposition. */
     revoke(taskId: string): Promise<void>;
+    /** The same terminal classification used by operator receipts and archival. */
+    terminalRecords(): readonly AgentMessageOutboxRecord[];
     private isTerminalEvidence;
     publishPayload(record: AgentMessageOutboxRecord): AgentMessagePublishPayload;
     applyDisposition(taskId: string, input: unknown): Promise<'accepted' | 'held' | 'refused' | 'mismatch' | 'unknown'>;

package/dist/diagnostics/diagnostics.d.ts

@@ -14,16 +14,8 @@ export interface CollectDiagnosticsOptions {
     connectControl?: typeof connectControlClient;
     runtimeProbeTimeoutMs?: number;
 }
-export type OperationalHealthFixResult = {
-    status: 'not-needed';
-    reason: 'missing' | 'valid';
-} | {
-    status: 'quarantined';
-    evidenceName: string;
-    manifestName: string;
-    sha256: string;
-    sizeBytes: number;
-};
+import type { OperationalHealthFixResult } from './types';
+export type { OperationalHealthFixResult } from './types';
 export declare function collectDiagnostics(config: DaemonConfig, storeDir: string, options?: CollectDiagnosticsOptions): Promise<DiagnosticsSnapshot>;
 export declare function stableIdentifierHash(value: string): string;
 /**

package/dist/diagnostics/operator-actions.d.ts

@@ -0,0 +1,63 @@
+import { type AgentRef } from '@byok-sdk/protocol';
+import type { DaemonConfig } from '../daemon/create-daemon';
+import type { OperationalHealthFixResult } from './types';
+import type { DiagnoseDeviceOptions } from './device-doctor';
+declare const MESSAGES: {
+    readonly 'confirmation-required': 'Explicit confirmation is required for this local maintenance action.';
+    readonly 'invalid-input': 'The maintenance action requires valid explicit inputs.';
+    readonly 'daemon-running': 'Stop the host daemon before local maintenance.';
+    readonly 'store-busy': 'Another operation owns the device store.';
+    readonly 'agent-busy': 'Another operation owns the Agent home.';
+    readonly 'target-mismatch': 'The stored device or Agent records do not match the authorized target.';
+    readonly 'source-unavailable': 'The local source cannot be accessed safely; preserve it for inspection.';
+    readonly 'output-exists': 'The selected output already exists; it will not be overwritten.';
+    readonly 'operation-failed': 'The maintenance operation did not complete; preserve evidence before retrying.';
+};
+export type DeviceOperatorErrorCode = keyof typeof MESSAGES;
+/** Closed codes only: never attach filesystem/OS error text, paths or nested causes. */
+export declare class DeviceOperatorError extends Error {
+    readonly code: DeviceOperatorErrorCode;
+    constructor(code: DeviceOperatorErrorCode);
+}
+export interface ConfirmDeviceMaintenanceInput {
+    confirmed: true;
+}
+export type DeviceHealthQuarantineResult = OperationalHealthFixResult & {
+    action: 'quarantine-operational-health';
+    scope: 'device';
+};
+export interface ExportDeviceSupportBundleInput extends DiagnoseDeviceOptions {
+    /** Absolute, previously unused file in an existing directory. */
+    outputPath: string;
+}
+export interface DeviceSupportBundleExportResult {
+    action: 'export-support-bundle';
+    scope: 'device';
+    status: 'written';
+    bundleVersion: 1;
+}
+export interface ArchiveAgentTerminalMessagesInput extends ConfirmDeviceMaintenanceInput {
+    expectedTenantId: string;
+    expectedDeviceId: string;
+    /** Selects one Agent home. Historical profile revisions are preserved verbatim. */
+    agentRef: AgentRef;
+    /** Absolute NEW directory in an existing parent; contains sensitive audit bodies. */
+    archiveDirectory: string;
+}
+export type AgentTerminalMessagesArchiveResult = {
+    action: 'archive-terminal-messages';
+    scope: 'agent';
+} & ({
+    status: 'not-needed';
+} | {
+    status: 'archived';
+    archivedRecords: number;
+    archiveFileName: string;
+});
+/** Quarantines confirmed-corrupt health only; the host owns supervisor stop/restart. */
+export declare function quarantineDeviceOperationalHealth(config: DaemonConfig, input: ConfirmDeviceMaintenanceInput): Promise<DeviceHealthQuarantineResult>;
+/** Read-only source observation; publishes only the SDK allowlisted bundle, never raw logs. */
+export declare function exportDeviceSupportBundle(config: DaemonConfig, input: ExportDeviceSupportBundleInput): Promise<DeviceSupportBundleExportResult>;
+/** Archive refused/revoked evidence for one Agent under device and Agent single-writer leases. */
+export declare function archiveAgentTerminalMessages(config: DaemonConfig, input: ArchiveAgentTerminalMessagesInput): Promise<AgentTerminalMessagesArchiveResult>;
+export {};

package/dist/diagnostics/types.d.ts

@@ -80,3 +80,13 @@ export interface DiagnosticsSnapshot {
     };
     checks: DiagnosticCheck[];
 }
+export type OperationalHealthFixResult = {
+    status: 'not-needed';
+    reason: 'missing' | 'valid';
+} | {
+    status: 'quarantined';
+    evidenceName: string;
+    manifestName: string;
+    sha256: string;
+    sizeBytes: number;
+};

package/dist/index.d.ts

@@ -84,3 +84,5 @@ export type { ClaudeAdapterOptions } from './adapters/claude/claude-adapter';
 export { CodexAdapter, type CodexAdapterOptions } from './adapters/codex/codex-adapter';
 export { diagnoseDevice, repairDeviceEnrollmentMetadata, DeviceMetadataRepairError } from './diagnostics/device-doctor';
 export type { DiagnoseDeviceOptions, DiagnosticsSnapshot, DiagnosticCheck, DiagnosticStatus, RepairDeviceEnrollmentMetadataInput, DeviceMetadataRepairResult, DeviceMetadataRepairErrorCode, } from './diagnostics/device-doctor';
+export { quarantineDeviceOperationalHealth, exportDeviceSupportBundle, archiveAgentTerminalMessages, DeviceOperatorError } from './diagnostics/operator-actions';
+export type { ConfirmDeviceMaintenanceInput, DeviceHealthQuarantineResult, ExportDeviceSupportBundleInput, DeviceSupportBundleExportResult, ArchiveAgentTerminalMessagesInput, AgentTerminalMessagesArchiveResult, DeviceOperatorErrorCode } from './diagnostics/operator-actions';