@sema-agent/client-core 0.100.0 → 0.102.0

package/dist/hostTurnSettings.d.ts

@@ -2,18 +2,21 @@ import type { TaskRequest } from '@sema-agent/sdk';
 import type { WireHooksConfig } from './finalVerifyWire.js';
 import type { memoryOffDeclared as MemoryOffDeclared } from './request/taskRequest.js';
 import type { EnvLike } from './hostEnv.js';
-import type { SettingsDocument } from './host.js';
-import { type HookSettingsSource, type HooksWirePlan } from './pluginHooksWire.js';
+import { type SettingsDocument } from './host.js';
+import type { HookSettingsSource, HooksWirePlan, HooksWirePlanOptions } from './pluginHooksWire.js';
+import { type HostSettingsSession, type HostSettingsSource } from './hostSettingsSource.js';
+import { type SubmissionIdentity } from './request/submissionIdentity.js';
 import { type WebSearchApiKeyFor } from './webSearchWireCaps.js';
 import { type FileHistoryCaptureReading } from './fileHistoryCaptureCapability.js';
+import type { PermissionsAllowGrantReading } from './permissionsAllowGrantCapability.js';
 export declare const HOST_SUPPLIED_KEYS: readonly ["settings.hooks", "settings.resolved", "settings.webSearch", "settings.outputStyle", "memory", "fileHistory"];
 export type HostSuppliedKey = (typeof HOST_SUPPLIED_KEYS)[number];
-export declare const HOST_SETTING_CAUSES: readonly ["carried", "entries_dropped", "source_rejected", "projection_failed", "source_unreadable", "empty", "no_source", "host_port_missing", "value_malformed"];
+export declare const HOST_SETTING_CAUSES: readonly ["carried", "entries_dropped", "source_rejected", "projection_failed", "source_unreadable", "empty", "no_source", "host_port_missing", "value_malformed", "held_previous", "policy_withheld"];
 export type HostSettingCause = (typeof HOST_SETTING_CAUSES)[number];
-export declare const HOST_SETTING_DISPOSITIONS: readonly ["carry", "carry_partial", "withhold_notice", "refuse_turn", "unwired", "nothing_to_carry"];
+export declare const HOST_SETTING_DISPOSITIONS: readonly ["carry", "carry_partial", "withhold_notice", "withhold_by_policy", "hold_for_consent", "refuse_turn", "unwired", "nothing_to_carry"];
 export type HostSettingDisposition = (typeof HOST_SETTING_DISPOSITIONS)[number];
 export type HostSettingPlane = 'turn' | 'session' | 'diagnostic';
-export type HostSettingNoticeId = 'HS-UNWIRED' | 'HS-MANAGED-REJECTED' | 'HS-PROJECTION' | 'HS-SOURCE-UNREADABLE' | 'HS-WEBSEARCH-MALFORMED' | 'HS-SWITCH-MALFORMED' | 'HS-FILEHISTORY-UNJUDGED';
+export type HostSettingNoticeId = 'HS-UNWIRED' | 'HS-MANAGED-REJECTED' | 'HS-PROJECTION' | 'HS-SOURCE-UNREADABLE' | 'HS-WEBSEARCH-MALFORMED' | 'HS-SWITCH-MALFORMED' | 'HS-FILEHISTORY-UNJUDGED' | 'HS-FILEHISTORY-RESTORE' | 'HS-MANAGED-UNREADABLE' | 'HS-LAYER-NOT-LOADED' | 'HS-HELD-PREVIOUS' | 'HS-STYLE-MISSING' | 'HS-STYLE-SAFE';
 export interface HostSettingRow {
     readonly key: HostSuppliedKey;
     readonly cause: HostSettingCause;
@@ -30,18 +33,29 @@ export type HostTurnVerdict = {
 } | {
     readonly kind: 'refuse';
     readonly notice: HostSettingNotice;
+} | {
+    readonly kind: 'hold';
+    readonly consentKey: string;
+    readonly notice: HostSettingNotice;
 };
+export type HooksPlanFacts = Omit<HooksWirePlanOptions, 'settings'>;
+export type HostOutputStyleBody = {
+    readonly state: 'present';
+    readonly body: string;
+    readonly turnReminder?: string;
+} | {
+    readonly state: 'absent';
+} | {
+    readonly state: 'unreadable';
+};
+export interface HostOutputStyleSource {
+    readBody(name: string): HostOutputStyleBody;
+}
 export interface HostTurnSettingsSources {
-    readonly hooks: {
-        readonly plan: HooksWirePlan;
-    } | 'none';
-    readonly resolved: {
-        readonly snapshot: SettingsDocument;
-    } | 'none';
+    readonly hooks: HooksPlanFacts | 'none';
+    readonly resolved: HostPermissionFacts | 'none';
     readonly webSearch: HostWebSearchSource | 'none';
-    readonly outputStyle: {
-        readonly name: string;
-    } | 'none';
+    readonly outputStyle: HostOutputStyleSource | 'none';
     readonly memory: HostMemorySource | 'none';
     readonly fileHistory: {
         readonly reading: FileHistoryCaptureReading;
@@ -49,15 +63,17 @@ export interface HostTurnSettingsSources {
     } | 'none';
 }
 export interface HostWebSearchSource {
-    readonly section?: SettingsDocument;
     readonly env: EnvLike;
     readonly apiKeyFor?: WebSearchApiKeyFor;
 }
 export interface HostMemorySource {
     readonly flag?: string;
-    readonly settingsMemory?: SettingsDocument;
 }
+export type { HostSettingsSession };
 export interface HostTurnSettingsInput {
+    readonly settings: HostSettingsSource | 'none';
+    readonly identity: SubmissionIdentity;
+    readonly previous?: HostSettingsSession;
     readonly sources: HostTurnSettingsSources;
 }
 export interface HostSettingsCarried {
@@ -68,6 +84,11 @@ export interface HostSettingsCarried {
     readonly memory?: TaskRequest['memory'];
     readonly fileHistory?: TaskRequest['fileHistory'];
 }
+export interface HostOutputStyleFacts {
+    readonly name: string;
+    readonly body: string;
+    readonly turnReminder?: string;
+}
 declare const hostTurnSettingsBrand: unique symbol;
 export interface HostTurnSettings {
     readonly [hostTurnSettingsBrand]: true;
@@ -76,16 +97,47 @@ export interface HostTurnSettings {
     readonly notices: readonly HostSettingNotice[];
     readonly hooks: HooksWirePlan | undefined;
     readonly carried: HostSettingsCarried;
+    readonly session: HostSettingsSession;
+    readonly outputStyle: HostOutputStyleFacts | undefined;
+    readonly held: HostSettingsHeld | undefined;
+}
+export interface HostSettingsHeld {
+    readonly wouldDrop: {
+        readonly deny: readonly string[];
+        readonly ask: readonly string[];
+    };
+    readonly version: string;
 }
 export interface HostTurnSettingsJudges {
     readonly materialize: HostResolvedMaterializer;
     readonly memoryOffDeclared: typeof MemoryOffDeclared;
 }
+export interface HostPermissionFacts {
+    readonly allowGrantReading: PermissionsAllowGrantReading;
+    readonly cliArg?: {
+        readonly allow?: readonly string[];
+        readonly deny?: readonly string[];
+    };
+    readonly session?: {
+        readonly deny?: readonly string[];
+        readonly ask?: readonly string[];
+    };
+    readonly clientOwnedServers?: readonly string[];
+    readonly serverVersion?: string;
+}
 export declare function rethrowHostResolvedDeferred(product: HostTurnSettings): void;
 export type HostResolvedMaterializer = (snapshot: SettingsDocument) => SettingsDocument;
 export declare function buildHostTurnSettings(input: HostTurnSettingsInput, judges: HostTurnSettingsJudges): HostTurnSettings;
+export declare function hostSettingsConsent(product: HostTurnSettings): HostTurnSettings;
+export interface HostSettingsAcceptConfirmation {
+    readonly version: string;
+    readonly deny: readonly string[];
+    readonly ask: readonly string[];
+}
+export declare function hostSettingsAcceptCurrent(product: HostTurnSettings, confirmation: HostSettingsAcceptConfirmation): HostSettingsSession | undefined;
 export declare function hostSettingsSelfCheck(product: HostTurnSettings): readonly HostSuppliedKey[];
 export declare const hostProjectionNotice: () => HostSettingNotice;
+export declare const hostFileHistoryRestoreNotice: () => HostSettingNotice;
 export declare class HostSettingsRefused extends Error {
     readonly notice: HostSettingNotice;
     constructor(n: HostSettingNotice);
@@ -104,7 +156,11 @@ export interface HostIntakeSnapshot {
     readonly refusingKeys: readonly HostSuppliedKey[];
     readonly turnNotices: readonly HostSettingNotice[] | undefined;
     readonly notice: HostSettingNotice | undefined;
+    readonly refusalCause: {
+        readonly key: HostSuppliedKey;
+        readonly error: {} | null | undefined;
+    } | undefined;
 }
 export declare function hostIntakeSnapshotOf(product: HostTurnSettings, onResolved?: (resolved: HostSettingsCarried['resolved']) => void): HostIntakeSnapshot | undefined;
+export declare function hostSettingsRefusedError(n: HostSettingNotice, intake: HostIntakeSnapshot, firstSeatedKey: HostSuppliedKey | undefined): HostSettingsRefused;
 export declare const UNWIRED_HOST_TURN_SETTINGS: HostTurnSettings;
-export {};