@sema-agent/client-core 0.88.0 → 0.89.0

package/dist/hooksWireCaps.js

@@ -1,8 +1,8 @@
-import { engineCapNestedTrue, engineCapState } from './engineCapsCache.js';
+import { engineCapNestedTrue, engineCapState, engineCapValue } from './engineCapsCache.js';
 import { displayUntrusted } from './displayUntrusted.js';
 import { collapseLabel } from './fleetTaskDesc.js';
 import { hostLog, hostSettings } from './host.js';
-import { decidePluginHooks, dedupeSettingsHookGroups, filterSettingsHookGroups, occupancyOf, settingsHookDropText, } from './pluginHooksWire.js';
+import { createSettingsHookJudge, decidePluginHooks, dedupeSettingsHookGroups, filterSettingsHookGroups, occupancyOf, settingsHookDropText, } from './pluginHooksWire.js';
 import { MAX_HOOK_NOTICE_TEXT_CHARS } from './notifications.js';
 import { goalStopHookMatcher, __resetGoalStopHookForTests } from './goalStopHook.js';
 export { GOAL_STOP_HOOK_WIRE_ENV, CC_STOP_SEMANTICS_MIN_SERVER, ccStopSemanticsFromVersion, engineCcStopSemantics, isGoalStopHookWireArmed, setWireSessionStopHook, getWireSessionStopHook, getWireSessionStopHookCcSemantics, buildGoalStopHookPrompt, } from './goalStopHook.js';
@@ -121,7 +121,7 @@ function readPluginHooks(settings, warnIfAbsent) {
     }
     return { state: 'absent' };
 }
-const NO_PLAN_ENGINE = { ownedByThisShell: null, pluginHooksCapable: null };
+const NO_PLAN_ENGINE = { ownedByThisShell: null, pluginHooksCapable: null, hooksCapable: null };
 export function hooksForWire(opts = {}) {
     const given = opts?.plan;
     if (isHooksWirePlan(given))
@@ -131,7 +131,7 @@ export function hooksForWire(opts = {}) {
     }
     if (isHooksWirePlan(opts))
         return opts.wire;
-    return buildHooksWirePlan(NO_PLAN_ENGINE, new Set(), false).wire;
+    return buildHooksWirePlan(NO_PLAN_ENGINE, () => false, false, true).wire;
 }
 function isHooksWirePlan(v) {
     try {
@@ -139,14 +139,17 @@ function isHooksWirePlan(v) {
             return false;
         const o = v;
         for (const k of PLAN_KEYS)
-            if (!Object.hasOwn(o, k))
+            if (!Object.hasOwn(o, k) && k !== 'settingsVerdicts' && k !== 'settingsExcluded')
                 return false;
         const reader = o.pluginReader;
         const engineFacts = o.engine;
         const wire = o.wire;
+        const arrayOrAbsent = (k) => !Object.hasOwn(o, k) || Array.isArray(o[k]);
         return (Array.isArray(o.verdicts) &&
             Array.isArray(o.excluded) &&
             Array.isArray(o.settingsDropped) &&
+            arrayOrAbsent('settingsVerdicts') &&
+            arrayOrAbsent('settingsExcluded') &&
             (reader === 'present' || reader === 'absent' || reader === 'failed') &&
             typeof engineFacts === 'object' &&
             engineFacts !== null &&
@@ -157,7 +160,7 @@ function isHooksWirePlan(v) {
         return false;
     }
 }
-const PLAN_KEYS = ['engine', 'pluginReader', 'verdicts', 'excluded', 'settingsDropped', 'wire'];
+const PLAN_KEYS = ['engine', 'pluginReader', 'verdicts', 'excluded', 'settingsDropped', 'settingsVerdicts', 'settingsExcluded', 'wire'];
 const _planKeysPin = [true, true];
 void _planKeysPin;
 export function hooksWirePlan(opts = {}) {
@@ -168,6 +171,7 @@ export function hooksWirePlan(opts = {}) {
         pluginHooksCapable: engineCapState(o.baseUrl, 'taskSettings') === 'unprobed'
             ? null
             : engineCapNestedTrue(o.baseUrl, 'taskSettings', 'pluginHooks'),
+        hooksCapable: taskHooksCapability(o.baseUrl),
     };
     const shellEvents = new Set();
     if (Array.isArray(o.shellHookEvents)) {
@@ -175,12 +179,72 @@ export function hooksWirePlan(opts = {}) {
             if (typeof e === 'string')
                 shellEvents.add(e);
     }
-    return buildHooksWirePlan(engine, shellEvents, true);
+    const typesByEvent = shellHookTypesOf(o);
+    const shellRuns = (event, type) => {
+        if (!shellEvents.has(event))
+            return false;
+        const types = typesByEvent?.get(event);
+        return types === undefined || (typeof type === 'string' && types.has(type));
+    };
+    const settingsShellRuns = typesByEvent !== undefined ? shellRuns : (event, type) => type !== 'prompt' && type !== 'agent' && shellRuns(event, type);
+    return buildHooksWirePlan(engine, shellRuns, true, promptAuthoredByUserOf(o), settingsShellRuns);
+}
+function taskHooksCapability(baseUrl) {
+    const v = engineCapValue(baseUrl, 'taskSettings');
+    if (v.kind !== 'value')
+        return null;
+    if (v.value === false)
+        return false;
+    if (typeof v.value !== 'object' || v.value === null || Array.isArray(v.value))
+        return null;
+    const hooks = v.value.hooks;
+    return hooks === true ? true : hooks === false ? false : null;
+}
+function shellHookTypesOf(o) {
+    let raw;
+    try {
+        raw = o.shellHookTypesByEvent;
+        if (raw === undefined)
+            return undefined;
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+            throw new TypeError('not a plain object');
+        const out = new Map();
+        for (const key of Object.keys(raw)) {
+            const types = raw[key];
+            if (!Array.isArray(types) || !types.every((t) => typeof t === 'string'))
+                throw new TypeError(`value for one event is not an array of strings`);
+            out.set(key, new Set(types));
+        }
+        return out;
+    }
+    catch (err) {
+        hostLog('debug', `hooksWirePlan: shellHookTypesByEvent is malformed — treated as absent (command and http hooks count as running on every reported event; prompt and agent hooks from settings stay with the engine): ${String(err)}`);
+        return undefined;
+    }
+}
+function promptAuthoredByUserOf(o) {
+    let v;
+    try {
+        v = o.promptAuthoredByUser;
+    }
+    catch (err) {
+        hostLog('debug', `hooksWirePlan: promptAuthoredByUser threw while being read — treated as written by the user: ${String(err)}`);
+        return true;
+    }
+    if (v === false)
+        return false;
+    if (v !== undefined && v !== true) {
+        hostLog('debug', 'hooksWirePlan: promptAuthoredByUser is not a boolean — treated as written by the user');
+    }
+    return true;
 }
-function buildHooksWirePlan(engine, shellEvents, withPlugins) {
+function buildHooksWirePlan(engine, shellRuns, withPlugins, promptAuthoredByUser, settingsShellRuns = shellRuns) {
     const settingsDropped = [];
+    const settingsVerdicts = [];
+    const settingsExcluded = [];
+    const judge = withPlugins ? createSettingsHookJudge(engine, settingsShellRuns, promptAuthoredByUser) : undefined;
     let settingsStripped = 0;
-    const planOf = (pluginReader, wire, verdicts = [], excluded = []) => ({ engine, pluginReader, verdicts, excluded, settingsDropped, wire });
+    const planOf = (pluginReader, wire, verdicts = [], excluded = []) => ({ engine, pluginReader, verdicts, excluded, settingsDropped, settingsVerdicts, settingsExcluded, wire });
     const closedPlan = (settings, reason) => {
         if (!withPlugins)
             return planOf('absent', undefined);
@@ -193,7 +257,8 @@ function buildHooksWirePlan(engine, shellEvents, withPlugins) {
             exclusion: reason,
             managedOnly: false,
             engine,
-            shellHookEvents: shellEvents,
+            shellRuns,
+            promptAuthoredByUser,
             occupied: new Map(),
         }));
         if (d === undefined)
@@ -265,8 +330,10 @@ function buildHooksWirePlan(engine, shellEvents, withPlugins) {
         for (const [event, groups] of Object.entries(hooks)) {
             if (!Array.isArray(groups) || groups.length === 0)
                 continue;
-            const kept = filterSettingsHookGroups(source, event, groups, engine.pluginHooksCapable === true, shellEvents.has(event), !withPlugins);
+            const kept = filterSettingsHookGroups(source, event, groups, engine.pluginHooksCapable === true, (type) => shellRuns(event, type), !withPlugins, judge);
             settingsDropped.push(...kept.drops);
+            settingsVerdicts.push(...kept.verdicts);
+            settingsExcluded.push(...kept.excluded);
             settingsStripped += kept.stripped;
             if (kept.groups.length === 0)
                 continue;
@@ -334,7 +401,8 @@ function buildHooksWirePlan(engine, shellEvents, withPlugins) {
             exclusion: startup ? 'startup_mode' : undefined,
             managedOnly: managedOnlyPlugins,
             engine,
-            shellHookEvents: shellEvents,
+            shellRuns,
+            promptAuthoredByUser,
             occupied,
         });
     });

package/dist/index.d.ts

@@ -40,6 +40,7 @@ export * from './deviceExecutorManagementCapability.js';
 export * from './mcpReconnect.js';
 export * from './leaderConflict.js';
 export * from './runTerminal.js';
+export { providerRejectionResend, type ProviderRejectionResend } from './providerRejection.js';
 export * from './runCancelContext.js';
 export * from './argvFlagValue.js';
 export * from './readFacePosture.js';
@@ -66,7 +67,7 @@ export type { DisplayUntrustedOptions, DisplayMark, DisplayMarkSpan, DisplayUntr
 export type * from './types/engineState.js';
 export * from './hostEnv.js';
 export * from './unrefTimer.js';
-export * from './controlRouter.js';
+export { ControlRouter, ControlSafetyError, errCodes, type ControlClientLike, type ControlRouterOptions, type ControlSafetyCode, type ErrCodes, type QueuedCommand, type QueuePriority, type RunsResourceLike, } from './controlRouter.js';
 export * from './sseIdleTriage.js';
 export * from './engineWireSdk.js';
 export * from './classifierVerdictWire.js';
@@ -111,6 +112,8 @@ export * from './adapter/downstream/terminalToSdkResult.js';
 export * from './adapter/runStream.js';
 export * from './adapter/activeRunSelfHeal.js';
 export * from './request/taskRequest.js';
+export { disableSkillsDeclaration } from './disableSkillsWire.js';
+export type { DisableSkillsDeclaration } from './disableSkillsWire.js';
 export * from './clientSlice.js';
 export * from './host.js';
 export { DEFAULT_SESSION_KEY } from './sessionSlot.js';
@@ -159,7 +162,7 @@ export * from './detachWire.js';
 export * from './workflowMonitor.js';
 export * from './workflowClient.js';
 export * from './hooksWireCaps.js';
-export { ENGINE_FIRED_HOOK_EVENTS, PLUGIN_HOOK_DISPOSITIONS, PLUGIN_HOOK_REASONS, PLUGIN_HOOK_EXCLUSION_REASONS, SETTINGS_HOOK_DROP_REASONS, isEngineFiredHookEvent, pluginHookVerdictOf, pluginHookReasonText, settingsHookDropText, pluginHookExecutorLabel, hooksNotRunNotice, type EngineFiredHookEvent, type PluginHookDisposition, type PluginHookReason, type PluginHookExclusionReason, type SettingsHookDropReason, type HookSettingsSource, type PluginHookKey, type PluginHookVerdict, type PluginHookExclusion, type SettingsHookDrop, type HooksWireEngineFacts, type PluginHookReaderState, type HooksWirePlan, type HooksWirePlanOptions, } from './pluginHooksWire.js';
+export { ENGINE_FIRED_HOOK_EVENTS, PLUGIN_HOOK_DISPOSITIONS, PLUGIN_HOOK_REASONS, PLUGIN_HOOK_EXCLUSION_REASONS, SETTINGS_HOOK_DROP_REASONS, isEngineFiredHookEvent, pluginHookVerdictOf, pluginHookReasonText, settingsHookDropText, pluginHookExecutorLabel, hooksNotRunNotice, settingsHooksKeptLocally, type EngineFiredHookEvent, type PluginHookDisposition, type PluginHookReason, type PluginHookExclusionReason, type SettingsHookDropReason, type HookSettingsSource, type PluginHookKey, type PluginHookVerdict, type PluginHookExclusion, type SettingsHookDrop, type SettingsHookVerdict, type SettingsHookExclusion, type HooksWireEngineFacts, type PluginHookReaderState, type HooksWirePlan, type HooksWirePlanOptions, } from './pluginHooksWire.js';
 export * from './liveInitToolFace.js';
 export * from './printInitToolFace.js';
 export * from './model/providerPresets.js';
@@ -197,7 +200,7 @@ export * from './request/printNotification.js';
 export * from './seatContract.js';
 export * from './agentSession/contract.js';
 export * from './agentSession/backgroundView.js';
-export { READ_CREDENTIAL_NOT_ACCEPTED_NOTICE } from './readCredentialRefusal.js';
+export { READ_CREDENTIAL_NOT_ACCEPTED_NOTICE, isReadCredentialRefusal } from './readCredentialRefusal.js';
 export { readEngineAgentRegistry, isEngineAgentRegistryListingSuperseded } from './agentSession/engineAgentRegistryRead.js';
 export type { EngineAgentRegistryClient } from './agentSession/engineAgentRegistryRead.js';
 export { stopEngineSessionBackground, engineSessionBackgroundReceiptReadingOf, ENGINE_SESSION_BACKGROUND_RECEIPT_STATES, } from './agentSession/engineSessionBackgroundStop.js';

package/dist/index.js

@@ -35,6 +35,7 @@ export * from './deviceExecutorManagementCapability.js';
 export * from './mcpReconnect.js';
 export * from './leaderConflict.js';
 export * from './runTerminal.js';
+export { providerRejectionResend } from './providerRejection.js';
 export * from './runCancelContext.js';
 export * from './argvFlagValue.js';
 export * from './readFacePosture.js';
@@ -59,7 +60,7 @@ export * from './fleetTaskDesc.js';
 export { displayUntrusted, displayUntrustedMarks } from './displayUntrusted.js';
 export * from './hostEnv.js';
 export * from './unrefTimer.js';
-export * from './controlRouter.js';
+export { ControlRouter, ControlSafetyError, errCodes, } from './controlRouter.js';
 export * from './sseIdleTriage.js';
 export * from './engineWireSdk.js';
 export * from './classifierVerdictWire.js';
@@ -102,6 +103,7 @@ export * from './adapter/downstream/terminalToSdkResult.js';
 export * from './adapter/runStream.js';
 export * from './adapter/activeRunSelfHeal.js';
 export * from './request/taskRequest.js';
+export { disableSkillsDeclaration } from './disableSkillsWire.js';
 export * from './clientSlice.js';
 export * from './host.js';
 export { DEFAULT_SESSION_KEY } from './sessionSlot.js';
@@ -145,7 +147,7 @@ export * from './detachWire.js';
 export * from './workflowMonitor.js';
 export * from './workflowClient.js';
 export * from './hooksWireCaps.js';
-export { ENGINE_FIRED_HOOK_EVENTS, PLUGIN_HOOK_DISPOSITIONS, PLUGIN_HOOK_REASONS, PLUGIN_HOOK_EXCLUSION_REASONS, SETTINGS_HOOK_DROP_REASONS, isEngineFiredHookEvent, pluginHookVerdictOf, pluginHookReasonText, settingsHookDropText, pluginHookExecutorLabel, hooksNotRunNotice, } from './pluginHooksWire.js';
+export { ENGINE_FIRED_HOOK_EVENTS, PLUGIN_HOOK_DISPOSITIONS, PLUGIN_HOOK_REASONS, PLUGIN_HOOK_EXCLUSION_REASONS, SETTINGS_HOOK_DROP_REASONS, isEngineFiredHookEvent, pluginHookVerdictOf, pluginHookReasonText, settingsHookDropText, pluginHookExecutorLabel, hooksNotRunNotice, settingsHooksKeptLocally, } from './pluginHooksWire.js';
 export * from './liveInitToolFace.js';
 export * from './printInitToolFace.js';
 export * from './model/providerPresets.js';
@@ -181,7 +183,7 @@ export * from './request/printNotification.js';
 export * from './seatContract.js';
 export * from './agentSession/contract.js';
 export * from './agentSession/backgroundView.js';
-export { READ_CREDENTIAL_NOT_ACCEPTED_NOTICE } from './readCredentialRefusal.js';
+export { READ_CREDENTIAL_NOT_ACCEPTED_NOTICE, isReadCredentialRefusal } from './readCredentialRefusal.js';
 export { readEngineAgentRegistry, isEngineAgentRegistryListingSuperseded } from './agentSession/engineAgentRegistryRead.js';
 export { stopEngineSessionBackground, engineSessionBackgroundReceiptReadingOf, ENGINE_SESSION_BACKGROUND_RECEIPT_STATES, } from './agentSession/engineSessionBackgroundStop.js';
 export { eraseSessionMemory, sessionMemoryEraseOutcome, SESSION_MEMORY_ERASE_REFUSAL_REASONS, SESSION_MEMORY_ERASE_UNCONFIRMED_WHYS, SESSION_MEMORY_ERASE_RETRIES, } from './sessionMemoryErase.js';

package/dist/pluginHooksWire.d.ts

@@ -4,9 +4,9 @@ export declare const ENGINE_FIRED_HOOK_EVENTS: readonly ["PreToolUse", "PostTool
 export type EngineFiredHookEvent = (typeof ENGINE_FIRED_HOOK_EVENTS)[number];
 export declare const PLUGIN_HOOK_DISPOSITIONS: readonly ["engine", "shell", "not_run"];
 export type PluginHookDisposition = (typeof PLUGIN_HOOK_DISPOSITIONS)[number];
-export declare const PLUGIN_HOOK_REASONS: readonly ["projected", "shell_event", "no_executor", "engine_not_local", "engine_locality_unknown", "engine_capability_absent", "engine_capability_unknown", "not_command", "sensitive_options", "engine_limit", "shell_form_user_config", "user_config_unset", "malformed_entry"];
+export declare const PLUGIN_HOOK_REASONS: readonly ["projected", "shell_event", "no_executor", "engine_not_local", "engine_locality_unknown", "engine_capability_absent", "engine_capability_unknown", "not_command", "sensitive_options", "engine_limit", "shell_form_user_config", "user_config_unset", "malformed_entry", "engine_hooks_off", "engine_hooks_unknown", "engine_type_skipped", "engine_llm_limit", "engine_unconfirmed", "engine_elsewhere"];
 export type PluginHookReason = (typeof PLUGIN_HOOK_REASONS)[number];
-export declare const PLUGIN_HOOK_EXCLUSION_REASONS: readonly ["workspace_untrusted", "governance_unreadable", "policy_disable_all", "startup_mode", "managed_plugins_only"];
+export declare const PLUGIN_HOOK_EXCLUSION_REASONS: readonly ["workspace_untrusted", "governance_unreadable", "policy_disable_all", "startup_mode", "managed_plugins_only", "prompt_not_user_authored"];
 export type PluginHookExclusionReason = (typeof PLUGIN_HOOK_EXCLUSION_REASONS)[number];
 export declare const SETTINGS_HOOK_DROP_REASONS: readonly ["exec_form_unsupported", "mcp_tool_unsupported"];
 export type SettingsHookDropReason = (typeof SETTINGS_HOOK_DROP_REASONS)[number];
@@ -33,9 +33,25 @@ export interface SettingsHookDrop {
     readonly reason: SettingsHookDropReason;
     readonly notRun: boolean;
 }
+export interface SettingsHookVerdict {
+    readonly source: HookSettingsSource;
+    readonly event: string;
+    readonly groupIndex: number;
+    readonly hookIndex: number;
+    readonly disposition: PluginHookDisposition;
+    readonly reason: PluginHookReason;
+}
+export interface SettingsHookExclusion {
+    readonly source: HookSettingsSource;
+    readonly event: string;
+    readonly groupIndex: number;
+    readonly hookIndex: number;
+    readonly reason: PluginHookExclusionReason;
+}
 export interface HooksWireEngineFacts {
     readonly ownedByThisShell: boolean | null;
     readonly pluginHooksCapable: boolean | null;
+    readonly hooksCapable: boolean | null;
 }
 export type PluginHookReaderState = 'present' | 'absent' | 'failed';
 export interface HooksWirePlan {
@@ -44,19 +60,34 @@ export interface HooksWirePlan {
     readonly verdicts: readonly PluginHookVerdict[];
     readonly excluded: readonly PluginHookExclusion[];
     readonly settingsDropped: readonly SettingsHookDrop[];
+    readonly settingsVerdicts: readonly SettingsHookVerdict[];
+    readonly settingsExcluded: readonly SettingsHookExclusion[];
     readonly wire: WireHooksConfig | undefined;
 }
 export interface HooksWirePlanOptions {
     readonly baseUrl?: string;
     readonly engineOwnedByThisShell?: boolean;
     readonly shellHookEvents?: readonly string[];
+    readonly shellHookTypesByEvent?: Readonly<Record<string, readonly string[]>>;
+    readonly promptAuthoredByUser?: boolean;
 }
 export declare const ENGINE_HOOK_LIMITS: {
     readonly maxGroupsPerEvent: 16;
     readonly maxEntriesPerEvent: 32;
     readonly maxCommandChars: 8192;
+    readonly maxLlmEntriesPerEvent: 4;
+};
+export type ShellRunsHook = (event: string, type: string | undefined) => boolean;
+type HookExecutor = {
+    readonly kind: 'excluded';
+    readonly reason: 'prompt_not_user_authored';
+} | {
+    readonly kind: 'judged';
+    readonly disposition: PluginHookDisposition;
+    readonly reason: PluginHookReason;
 };
 type WireHookGroup = NonNullable<WireHooksConfig[string]>[number];
+type WireHookEntry = WireHookGroup['hooks'][number];
 export declare function isEngineFiredHookEvent(event: string): boolean;
 export interface EventOccupancy {
     readonly groups: number;
@@ -68,7 +99,8 @@ export interface PluginHookDecisionInput {
     readonly exclusion: PluginHookExclusionReason | undefined;
     readonly managedOnly: boolean;
     readonly engine: HooksWireEngineFacts;
-    readonly shellHookEvents: ReadonlySet<string>;
+    readonly shellRuns: ShellRunsHook;
+    readonly promptAuthoredByUser: boolean;
     readonly occupied: ReadonlyMap<string, EventOccupancy>;
 }
 export interface PluginHookDecision {
@@ -78,12 +110,16 @@ export interface PluginHookDecision {
     readonly unreadable: number;
 }
 export declare function decidePluginHooks(input: PluginHookDecisionInput): PluginHookDecision;
-export declare function filterSettingsHookGroups(source: HookSettingsSource, event: string, groups: readonly WireHookGroup[], execFormCapable: boolean, hostFires: boolean, failLoudMcpTool: boolean): SettingsHookFilterResult;
+export declare function filterSettingsHookGroups(source: HookSettingsSource, event: string, groups: readonly WireHookGroup[], execFormCapable: boolean, shellRunsType: (type: string | undefined) => boolean, failLoudMcpTool: boolean, judge?: SettingsHookJudge): SettingsHookFilterResult;
 export interface SettingsHookFilterResult {
     readonly groups: WireHookGroup[];
     readonly drops: SettingsHookDrop[];
     readonly stripped: number;
+    readonly verdicts: SettingsHookVerdict[];
+    readonly excluded: SettingsHookExclusion[];
 }
+export type SettingsHookJudge = (event: string, group: WireHookGroup, entry: WireHookEntry) => HookExecutor;
+export declare function createSettingsHookJudge(engine: HooksWireEngineFacts, shellRuns: ShellRunsHook, promptAuthoredByUser: boolean): SettingsHookJudge;
 export interface SourcedSettingsHookGroup {
     readonly source: HookSettingsSource;
     readonly group: WireHookGroup;
@@ -94,6 +130,12 @@ export interface SettingsHookDedupResult {
     readonly removed: number;
 }
 export declare function pluginHookVerdictOf(plan: HooksWirePlan, pluginId: string, event: string, groupIndex: number, hookIndex: number): PluginHookVerdict | undefined;
+export declare function settingsHooksKeptLocally<T>(plan: HooksWirePlan, event: string, group: {
+    readonly matcher?: string;
+    readonly hooks: readonly T[];
+}, opts?: {
+    readonly engineCompaction?: 'performed' | 'not_performed';
+}): readonly T[];
 export declare function pluginHookReasonText(reason: PluginHookReason): string;
 export declare function settingsHookDropText(reason: SettingsHookDropReason): string;
 export declare function pluginHookExecutorLabel(v: PluginHookVerdict): string;