@sema-agent/client-core 0.111.0 → 0.112.1

package/dist/localConfig/kernel.d.ts

@@ -0,0 +1,149 @@
+import type { SettingsDocument } from '../host.js';
+import type { UiLanguage } from '../env/uiLanguage.js';
+import { type LocalConfigDocumentName, type LocalConfigWritableDocumentName } from './documents.js';
+export declare const LOCAL_CONFIG_UNREADABLE_CAUSES: readonly ["bad_json", "bad_shape", "io"];
+export type LocalConfigUnreadableCause = (typeof LOCAL_CONFIG_UNREADABLE_CAUSES)[number];
+export type LocalConfigFileReading = {
+    readonly status: 'loaded';
+    readonly doc: SettingsDocument;
+    readonly revision: string;
+} | {
+    readonly status: 'absent';
+} | {
+    readonly status: 'unreadable';
+    readonly cause: LocalConfigUnreadableCause;
+} | {
+    readonly status: 'outside_fence';
+};
+export type LocalConfigFilesReading = {
+    readonly [D in LocalConfigDocumentName]?: LocalConfigFileReading;
+};
+export declare const LOCAL_CONFIG_REFUSALS: readonly ["invalid_request", "scope_unreadable", "scope_unwritable", "untrusted_folder", "policy_denied", "not_found", "already_exists", "lock_busy", "lock_failed", "changed_during_write", "write_failed", "not_written", "name_unusable", "name_reserved", "mcp_entry_invalid", "ambiguous_scope", "credentials_need_reentry", "base_conflict", "skill_locked_by_higher_layer", "skill_managed_by_plugin", "skill_locked_by_author", "skill_name_unstorable", "entry_in_use", "credential_unpaired", "env_catalog_present", "probe_failed", "probe_unverified"];
+export type LocalConfigRefusal = (typeof LOCAL_CONFIG_REFUSALS)[number];
+export declare const LOCAL_CONFIG_NOT_WRITTEN_CAUSES: readonly ["lock_busy", "lock_failed", "changed_during_write", "write_failed"];
+export type LocalConfigNotWrittenCause = (typeof LOCAL_CONFIG_NOT_WRITTEN_CAUSES)[number];
+export declare const LOCAL_CONFIG_UNAVAILABLE_CAUSES: readonly ["engine_is_remote", "not_single_user", "config_home_unpinned", "domain_not_hosted"];
+export type LocalConfigUnavailableCause = (typeof LOCAL_CONFIG_UNAVAILABLE_CAUSES)[number];
+export declare const LOCAL_CONFIG_UNKNOWN_CAUSES: readonly ["commit_unconfirmed", "report_unreadable"];
+export type LocalConfigUnknownCause = (typeof LOCAL_CONFIG_UNKNOWN_CAUSES)[number];
+export declare const LOCAL_CONFIG_APPLIES_ON: readonly ["next_turn", "engine_reload", "next_engine_start"];
+export type LocalConfigAppliesOn = (typeof LOCAL_CONFIG_APPLIES_ON)[number];
+export declare const LOCAL_CONFIG_RESIDUES: readonly ["orphan_key_slot", "legacy_tier_groups_left"];
+export type LocalConfigResidue = (typeof LOCAL_CONFIG_RESIDUES)[number];
+export declare const LOCAL_CONFIG_DISCLOSURE_KINDS: readonly ["decided_by", "shadowed_by", "tier_group_overridden"];
+export type LocalConfigDisclosureKind = (typeof LOCAL_CONFIG_DISCLOSURE_KINDS)[number];
+export interface LocalConfigDisclosure {
+    readonly kind: LocalConfigDisclosureKind;
+    readonly layer?: LocalConfigDocumentName;
+    readonly detail?: string;
+}
+export declare const LOCAL_CONFIG_STEP_ROLES: readonly ["prepare", "effect", "cleanup"];
+export type LocalConfigStepRole = (typeof LOCAL_CONFIG_STEP_ROLES)[number];
+export type LocalConfigReceipt = {
+    readonly kind: 'applied';
+    readonly appliesOn: LocalConfigAppliesOn;
+    readonly changed: boolean;
+    readonly residue?: readonly LocalConfigResidue[];
+    readonly disclosures?: readonly LocalConfigDisclosure[];
+} | {
+    readonly kind: 'refused';
+    readonly reason: LocalConfigRefusal;
+    readonly detail?: string;
+    readonly residue?: readonly LocalConfigResidue[];
+} | {
+    readonly kind: 'unavailable';
+    readonly cause: LocalConfigUnavailableCause;
+} | {
+    readonly kind: 'unknown';
+    readonly cause: LocalConfigUnknownCause;
+    readonly residue?: readonly LocalConfigResidue[];
+};
+export type LocalConfigPreview = {
+    readonly kind: 'preview';
+    readonly appliesOn: LocalConfigAppliesOn;
+    readonly changed: boolean;
+    readonly writes: readonly LocalConfigWritableDocumentName[];
+    readonly disclosures?: readonly LocalConfigDisclosure[];
+} | Extract<LocalConfigReceipt, {
+    readonly kind: 'refused' | 'unavailable';
+}>;
+export declare const LOCAL_CONFIG_WRITE_PRECONDITIONS: readonly ["shared_path_lock", "lock_loss_returned", "writers_joined", "shared_rank", "global_state_migrated", "targets_bound_by_host", "write_route"];
+export type LocalConfigWritePrecondition = (typeof LOCAL_CONFIG_WRITE_PRECONDITIONS)[number];
+export interface LocalConfigHostFacts {
+    readonly engine: 'local' | 'cloud';
+    readonly tenancy: 'single_user' | 'multi_tenant';
+    readonly configHomePinned?: boolean;
+    readonly route: 'host' | 'seat_proxy' | 'bff_direct';
+    readonly targetsBoundByHost?: boolean;
+    readonly sharedPathLock?: boolean;
+    readonly lockLossReturned?: boolean;
+    readonly writersJoined?: boolean;
+    readonly sharedRanks?: readonly string[];
+    readonly globalStateMigrated?: boolean;
+}
+export type LocalConfigAccessRequest = {
+    readonly access: 'read';
+} | {
+    readonly access: 'write';
+    readonly docs: readonly LocalConfigDocumentName[];
+};
+export type LocalConfigAccess = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly cause: LocalConfigUnavailableCause;
+    readonly missing: readonly LocalConfigWritePrecondition[];
+};
+export declare function localConfigAccess(facts: LocalConfigHostFacts, request: LocalConfigAccessRequest): LocalConfigAccess;
+export interface LocalConfigTransactStep {
+    readonly lock: readonly LocalConfigWritableDocumentName[];
+    readonly snapshot: readonly LocalConfigDocumentName[];
+}
+export interface LocalConfigFileWrite {
+    readonly doc: LocalConfigWritableDocumentName;
+    readonly next: SettingsDocument;
+    readonly expectRevision: string | null;
+}
+export type LocalConfigCommitReport = 'committed' | 'no_write' | {
+    readonly notCommitted: LocalConfigNotWrittenCause | undefined;
+};
+export interface LocalConfigStorePort {
+    read(docs: readonly LocalConfigDocumentName[]): LocalConfigFilesReading | Promise<LocalConfigFilesReading>;
+    transact(step: LocalConfigTransactStep, build: (fresh: LocalConfigFilesReading) => LocalConfigFileWrite | undefined): Promise<LocalConfigCommitReport>;
+}
+export interface LocalConfigStepInput {
+    readonly fresh: LocalConfigFilesReading;
+    readonly carried: SettingsDocument;
+    readonly mode: 'commit' | 'preview';
+}
+export type LocalConfigStepPlan = {
+    readonly kind: 'write';
+    readonly next: SettingsDocument;
+    readonly carry?: SettingsDocument;
+    readonly disclose?: readonly LocalConfigDisclosure[];
+} | {
+    readonly kind: 'unchanged';
+    readonly carry?: SettingsDocument;
+    readonly disclose?: readonly LocalConfigDisclosure[];
+} | {
+    readonly kind: 'refuse';
+    readonly reason: LocalConfigRefusal;
+    readonly detail?: string;
+};
+export interface LocalConfigStep {
+    readonly doc: LocalConfigWritableDocumentName;
+    readonly role: LocalConfigStepRole;
+    readonly residue?: LocalConfigResidue;
+    readonly lock?: readonly LocalConfigWritableDocumentName[];
+    readonly snapshot?: readonly LocalConfigDocumentName[];
+    readonly plan: (input: LocalConfigStepInput) => LocalConfigStepPlan;
+}
+export interface LocalConfigIntent {
+    readonly appliesOn: LocalConfigAppliesOn;
+    readonly steps: readonly LocalConfigStep[];
+}
+export declare function applyLocalConfigIntent(intent: LocalConfigIntent, store: LocalConfigStorePort, facts: LocalConfigHostFacts): Promise<LocalConfigReceipt>;
+export declare function previewLocalConfigIntent(intent: LocalConfigIntent, store: LocalConfigStorePort, facts: LocalConfigHostFacts): Promise<LocalConfigPreview>;
+export declare function localConfigReceiptSentence(receipt: LocalConfigReceipt | LocalConfigPreview, lang?: UiLanguage): string;
+export declare function localConfigDisclosureSentence(disclosure: LocalConfigDisclosure, lang?: UiLanguage): string | undefined;
+export declare function localConfigResidueSentence(residue: LocalConfigResidue, lang?: UiLanguage): string | undefined;