@byfriends/sdk 0.2.5 → 0.3.1

package/dist/index.d.mts

@@ -65,9 +65,6 @@ declare interface AgentAPI {
     setPermission: (payload: SetPermissionPayload) => void;
     setModel: (payload: SetModelPayload) => SetModelResult;
     getModel: (payload: EmptyPayload) => string;
-    enterPlan: (payload: EmptyPayload) => void;
-    cancelPlan: (payload: CancelPlanPayload) => void;
-    clearPlan: (payload: EmptyPayload) => void;
     beginCompaction: (payload: BeginCompactionPayload) => void;
     cancelCompaction: (payload: EmptyPayload) => void;
     registerTool: (payload: RegisterToolPayload) => void;
@@ -81,7 +78,6 @@ declare interface AgentAPI {
     getContext: (payload: EmptyPayload) => AgentContextData;
     getConfig: (payload: EmptyPayload) => AgentConfigData;
     getPermission: (payload: EmptyPayload) => PermissionData;
-    getPlan: (payload: EmptyPayload) => PlanData;
     getUsage: (payload: EmptyPayload) => UsageStatus;
     getTools: (payload: EmptyPayload) => readonly ToolInfo[];
     getBackground: (payload: GetBackgroundPayload) => readonly BackgroundTaskInfo[];
@@ -140,6 +136,13 @@ declare interface AgentMeta {
     readonly homedir: string;
     readonly type: AgentType;
     readonly parentAgentId: string | null;
+    /**
+     * The parent agent's tool-call id that spawned this agent. Absent for the
+     * main agent and for sessions persisted before this field existed. The TUI
+     * uses it on resume to map a main-agent `Agent` tool-call back to its child
+     * agent's activity (the child's own replay/usage/text).
+     */
+    readonly parentToolCallId?: string | undefined;
 }
 
 declare type AgentRecord = {
@@ -171,15 +174,6 @@ declare interface AgentRecordEvents {
     };
     'permission.record_approval_result': PermissionApprovalResultRecord;
     'full_compaction.begin': CompactionBeginData;
-    'plan_mode.enter': {
-        id: string;
-    };
-    'plan_mode.cancel': {
-        id?: string;
-    };
-    'plan_mode.exit': {
-        id?: string;
-    };
     'tools.register_user_tool': UserToolRegistration;
     'tools.unregister_user_tool': {
         name: string;
@@ -253,9 +247,6 @@ declare class AgentRecords {
 export declare type AgentReplayRecord = {
     type: 'message';
     message: ContextMessage;
-} | {
-    type: 'plan_updated';
-    enabled: boolean;
 } | {
     type: 'config_updated';
     config: AgentConfigUpdateData;
@@ -326,6 +317,7 @@ export declare interface ApplyCatalogProviderOptions {
 
 export declare function applyProviderConfig(config: ConfigShape, options: {
     readonly name: string;
+    readonly type?: string | undefined;
     readonly baseUrl: string;
     readonly apiKey: string;
     readonly models: readonly ModelInfo[];
@@ -654,7 +646,7 @@ declare class BackgroundProcessManager {
     /** Drop a persisted task from disk and ghost map. */
     forgetTask(taskId: string): Promise<void>;
     /**
-     * Persist the current state of a live ManagedProcess. Called from
+     * Persist the current state of a live TaskEntry. Called from
      * `register()` and the lifecycle finally block. No-op unless attached.
      */
     private persistLive;
@@ -676,7 +668,7 @@ export declare interface BackgroundTaskInfo {
     readonly command: string;
     readonly description: string;
     readonly status: BackgroundTaskStatus;
-    readonly pid: number;
+    readonly pid: number | null;
     readonly exitCode: number | null;
     readonly startedAt: number;
     readonly endedAt: number | null;
@@ -1141,8 +1133,8 @@ declare const ByfConfigPatchSchema: z.ZodObject<{
     defaultThinking: z.ZodOptional<z.ZodBoolean>;
     defaultPermissionMode: z.ZodOptional<z.ZodEnum<{
         auto: "auto";
-        yolo: "yolo";
         manual: "manual";
+        yolo: "yolo";
     }>>;
     permission: z.ZodOptional<z.ZodObject<{
         rules: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1182,19 +1174,19 @@ declare const ByfConfigPatchSchema: z.ZodObject<{
         timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>>;
     services: z.ZodOptional<z.ZodObject<{
-        byfSearch: z.ZodOptional<z.ZodObject<{
-            baseUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            apiKey: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            oauth: z.ZodOptional<z.ZodOptional<z.ZodObject<{
-                storage: z.ZodEnum<{
-                    file: "file";
-                    keyring: "keyring";
+        webSearch: z.ZodOptional<z.ZodObject<{
+            providers: z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    exa: "exa";
+                    brave: "brave";
+                    firecrawl: "firecrawl";
                 }>;
-                key: z.ZodString;
-            }, z.core.$strip>>>;
-            customHeaders: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
+                apiKeys: z.ZodArray<z.ZodString>;
+                baseUrl: z.ZodOptional<z.ZodString>;
+                priority: z.ZodNumber;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
-        byfFetch: z.ZodOptional<z.ZodObject<{
+        fetchUrl: z.ZodOptional<z.ZodObject<{
             baseUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             apiKey: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             oauth: z.ZodOptional<z.ZodOptional<z.ZodObject<{
@@ -1279,8 +1271,8 @@ declare const ByfConfigSchema: z.ZodObject<{
     defaultThinking: z.ZodOptional<z.ZodBoolean>;
     defaultPermissionMode: z.ZodOptional<z.ZodEnum<{
         auto: "auto";
-        yolo: "yolo";
         manual: "manual";
+        yolo: "yolo";
     }>>;
     permission: z.ZodOptional<z.ZodObject<{
         rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -1320,19 +1312,19 @@ declare const ByfConfigSchema: z.ZodObject<{
         timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>>;
     services: z.ZodOptional<z.ZodObject<{
-        byfSearch: z.ZodOptional<z.ZodObject<{
-            baseUrl: z.ZodOptional<z.ZodString>;
-            apiKey: z.ZodOptional<z.ZodString>;
-            oauth: z.ZodOptional<z.ZodObject<{
-                storage: z.ZodEnum<{
-                    file: "file";
-                    keyring: "keyring";
+        webSearch: z.ZodOptional<z.ZodObject<{
+            providers: z.ZodArray<z.ZodObject<{
+                type: z.ZodEnum<{
+                    exa: "exa";
+                    brave: "brave";
+                    firecrawl: "firecrawl";
                 }>;
-                key: z.ZodString;
+                apiKeys: z.ZodArray<z.ZodString>;
+                baseUrl: z.ZodOptional<z.ZodString>;
+                priority: z.ZodNumber;
             }, z.core.$strip>>;
-            customHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         }, z.core.$strip>>;
-        byfFetch: z.ZodOptional<z.ZodObject<{
+        fetchUrl: z.ZodOptional<z.ZodObject<{
             baseUrl: z.ZodOptional<z.ZodString>;
             apiKey: z.ZodOptional<z.ZodString>;
             oauth: z.ZodOptional<z.ZodObject<{
@@ -1398,9 +1390,6 @@ declare class ByfCore implements PromisableMethods<CoreAPI> {
     setThinking({ sessionId, ...payload }: SessionAgentPayload<SetThinkingPayload>): void | Promise<void>;
     setPermission({ sessionId, ...payload }: SessionAgentPayload<SetPermissionPayload>): void | Promise<void>;
     getModel({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): string | Promise<string>;
-    enterPlan({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): void | Promise<void>;
-    cancelPlan({ sessionId, ...payload }: SessionAgentPayload<CancelPlanPayload>): void | Promise<void>;
-    clearPlan({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): void | Promise<void>;
     beginCompaction({ sessionId, ...payload }: SessionAgentPayload<BeginCompactionPayload>): void | Promise<void>;
     cancelCompaction({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): void | Promise<void>;
     registerTool({ sessionId, ...payload }: SessionAgentPayload<RegisterToolPayload>): void | Promise<void>;
@@ -1414,7 +1403,6 @@ declare class ByfCore implements PromisableMethods<CoreAPI> {
     getContext({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): AgentContextData | Promise<AgentContextData>;
     getConfig({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): AgentConfigData | Promise<AgentConfigData>;
     getPermission({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): PermissionData | Promise<PermissionData>;
-    getPlan({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): Promise<null> | null;
     getUsage({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): UsageStatus | Promise<UsageStatus>;
     getTools({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): readonly ToolInfo[] | Promise<readonly ToolInfo[]>;
     getBackground({ sessionId, ...payload }: SessionAgentPayload<GetBackgroundPayload>): readonly BackgroundTaskInfo[] | Promise<readonly BackgroundTaskInfo[]>;
@@ -1506,7 +1494,7 @@ export declare class ByfHarness {
     get sessions(): ReadonlyMap<string, Session>;
     get interactiveAgentId(): string;
     set interactiveAgentId(agentId: string);
-    track(event: string, properties?: Record<string, unknown>): void;
+    track(_event: string, _properties?: Record<string, unknown>): void;
     createSession(options: CreateSessionOptions): Promise<Session>;
     resumeSession(input: ResumeSessionInput): Promise<Session>;
     forkSession(input: ForkSessionInput): Promise<Session>;
@@ -1519,6 +1507,7 @@ export declare class ByfHarness {
     ensureConfigFile(): Promise<void>;
     setConfig(patch: ByfConfigPatch): Promise<ByfConfig>;
     removeProvider(providerId: string): Promise<ByfConfig>;
+    updateConfig(input?: UpdateConfigInput): Promise<UpdateConfigResult>;
     shellExec(command: string, options?: {
         cwd?: string;
         timeout?: number;
@@ -1531,6 +1520,7 @@ export declare interface ByfHarnessOptions {
     readonly identity?: HostIdentity | undefined;
     readonly homeDir?: string | undefined;
     readonly configPath?: string | undefined;
+    readonly runtime?: RuntimeConfig | undefined;
     readonly autoLoadConfig?: boolean | undefined;
     readonly uiMode?: string;
     readonly skillDirs?: readonly string[];
@@ -1613,10 +1603,6 @@ declare interface CancelPayload {
     readonly turnId?: number;
 }
 
-declare interface CancelPlanPayload {
-    readonly id?: string;
-}
-
 /** Top-level catalog: `{ [providerId]: ProviderEntry }` (e.g. models.dev/api.json). */
 export declare type Catalog = Record<string, CatalogProviderEntry>;
 
@@ -1883,6 +1869,12 @@ declare class ContextMemory implements RecordRestoreHandler {
     get tokenCountWithPending(): number;
     get history(): readonly ContextMessage[];
     get messages(): Message[];
+    /**
+     * Project history into provider-ready messages, optionally with
+     * ephemeral injections (e.g. timestamp, permission mode) appended
+     * at the `'before_user'` position.
+     */
+    getMessages(ephemeral?: readonly EphemeralInjection[]): Message[];
     applyObservationMasking(config?: MaskingConfig): MaskingResult;
     applyPruning(config?: {
         effectiveCapacityRatio?: number;
@@ -1993,6 +1985,12 @@ declare interface Environment {
     readonly shellPath: string;
 }
 
+declare interface EphemeralInjection {
+    kind: 'memory_recall' | 'system_reminder' | 'pending_notification';
+    content: string | Record<string, unknown>;
+    position?: 'before_user' | 'after_system';
+}
+
 /**
  * Error codes for Byf Core's public error protocol.
  *
@@ -2174,12 +2172,44 @@ export declare function fetchCatalog(url: string, signal?: AbortSignal, fetchImp
 
 export declare function fetchModels(baseUrl: string, apiKey: string, fetchImpl?: typeof fetch, signal?: AbortSignal): Promise<ModelInfo[]>;
 
+/**
+ * Lists models from a provider using its native wire-type endpoint. Dispatches
+ * per `type` so each protocol gets its correct auth header and response shape.
+ * `openai-completions` and `openai_responses` share the OpenAI-compatible
+ * `/models` endpoint; `anthropic` uses its native `x-api-key` endpoint with
+ * pagination. Other types have dedicated native fetchers (added in
+ * later slices).
+ */
+export declare function fetchModelsByType(type: string, baseUrl: string, apiKey: string, fetchImpl?: typeof fetch, signal?: AbortSignal): Promise<ModelInfo[]>;
+
 /**
  * Searches all providers in the catalog for a model whose ID matches
  * `modelId` (prefix + separator boundary). Returns the first match.
  */
 export declare function findCatalogModel(catalog: Catalog, modelId: string): CatalogModel | undefined;
 
+/**
+ * Update-rules for `byf update-config`.
+ *
+ * Each rule corresponds to a deprecated / renamed / migrated field that
+ * `analyzeConfig` can detect in `config.raw` and (where applicable) that
+ * `applyFixes` can clean up.
+ *
+ * **Principles** (from PRD-0013 grill decisions):
+ * - G2 — Whitelist approach: only fields explicitly registered here are removed.
+ * - Every rule carries a `deprecatedSince` version annotation so the report
+ *   tells the user *when* the field became obsolete.
+ */
+export declare interface Finding {
+    kind: 'removed' | 'renamed' | 'migrated' | 'dangling' | 'unknown' | 'invalid-value';
+    /** TOML dotted path, e.g. `'services.byf_search'`, `'loop_control.max_steps_per_run'`. */
+    path: string;
+    /** Human-readable description of what was found and what will happen. */
+    detail: string;
+    /** Version when this field was deprecated (optional — may be unknown for very old fields). */
+    deprecatedSince?: string;
+}
+
 /**
  * Normalized finish-reason signal indicating why a generation stopped.
  *
@@ -2516,6 +2546,7 @@ declare class InjectionManager {
     private readonly injectors;
     constructor(agent: Agent);
     inject(): Promise<void>;
+    getEphemeralInjections(): readonly EphemeralInjection[];
     onContextClear(): void;
     onContextCompacted(compactedCount: number): void;
 }
@@ -3500,15 +3531,6 @@ declare type PermissionRuleDecision = 'allow' | 'deny' | 'ask';
  */
 declare type PermissionRuleScope = 'turn-override' | 'session-runtime' | 'project' | 'user';
 
-declare type PlanData = null;
-
-export declare interface PlanInfo {
-    readonly id: string;
-    readonly exists: boolean;
-    readonly content: string;
-    readonly path: string;
-}
-
 declare type PreparedSystemPromptContext = Pick<SystemPromptContext, 'cwd' | 'agentsMd'>;
 
 declare interface PrepareToolExecutionResult {
@@ -3928,11 +3950,17 @@ export declare interface ResumedAgentState {
     readonly context: AgentContextData;
     readonly replay: readonly AgentReplayRecord[];
     readonly permission: PermissionData;
-    readonly plan: PlanData;
     readonly usage: UsageStatus;
     readonly tools: readonly ToolInfo[];
     readonly toolStore?: Readonly<Record<string, unknown>>;
     readonly background: readonly BackgroundTaskInfo[];
+    /**
+     * For sub-agents: the parent agent's tool-call id that spawned this agent.
+     * Absent for the main agent and for sessions persisted before this field
+     * existed. The TUI uses it to attach a resumed main-agent `Agent` tool-call
+     * to this child's activity (replay/usage/text).
+     */
+    readonly parentToolCallId?: string | undefined;
 }
 
 export declare type ResumedSessionState = Pick<ResumeSessionResult, 'sessionMetadata' | 'agents' | 'warning'>;
@@ -4059,8 +4087,6 @@ declare class SDKRpcClient {
     setModel(input: SetSessionModelRpcInput): Promise<SetSessionModelRpcResult>;
     setThinking(input: SetSessionThinkingRpcInput): Promise<void>;
     setPermission(input: SetSessionPermissionRpcInput): Promise<void>;
-    getPlan(input: SessionIdRpcInput): Promise<SessionPlan>;
-    clearPlan(input: SessionIdRpcInput): Promise<void>;
     compact(input: SessionIdRpcInput & CompactOptions): Promise<void>;
     cancelCompaction(input: SessionIdRpcInput): Promise<void>;
     getUsage(input: SessionIdRpcInput): Promise<SessionUsage>;
@@ -4107,6 +4133,7 @@ declare interface SDKRpcClientOptions {
     readonly homeDir?: string | undefined;
     readonly configPath?: string | undefined;
     readonly skillDirs?: readonly string[];
+    readonly runtime?: RuntimeConfig | undefined;
 }
 
 declare type SDKSessionAPI = WithAgentId<SDKAgentAPI>;
@@ -4120,19 +4147,19 @@ declare interface ServicesConfig_2 {
 }
 
 declare const ServicesConfigSchema: z.ZodObject<{
-    byfSearch: z.ZodOptional<z.ZodObject<{
-        baseUrl: z.ZodOptional<z.ZodString>;
-        apiKey: z.ZodOptional<z.ZodString>;
-        oauth: z.ZodOptional<z.ZodObject<{
-            storage: z.ZodEnum<{
-                file: "file";
-                keyring: "keyring";
+    webSearch: z.ZodOptional<z.ZodObject<{
+        providers: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                exa: "exa";
+                brave: "brave";
+                firecrawl: "firecrawl";
             }>;
-            key: z.ZodString;
+            apiKeys: z.ZodArray<z.ZodString>;
+            baseUrl: z.ZodOptional<z.ZodString>;
+            priority: z.ZodNumber;
         }, z.core.$strip>>;
-        customHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>>;
-    byfFetch: z.ZodOptional<z.ZodObject<{
+    fetchUrl: z.ZodOptional<z.ZodObject<{
         baseUrl: z.ZodOptional<z.ZodString>;
         apiKey: z.ZodOptional<z.ZodString>;
         oauth: z.ZodOptional<z.ZodObject<{
@@ -4170,8 +4197,6 @@ export declare class Session {
     setModel(model: string): Promise<void>;
     setThinking(level: string): Promise<void>;
     setPermission(mode: PermissionMode): Promise<void>;
-    getPlan(): Promise<SessionPlan>;
-    clearPlan(): Promise<void>;
     compact(options?: CompactOptions): Promise<void>;
     cancelCompaction(): Promise<void>;
     getUsage(): Promise<SessionUsage>;
@@ -4246,7 +4271,7 @@ declare class Session_2 {
     }>;
     close(): Promise<void>;
     private stopBackgroundTasksOnExit;
-    createAgent(config: Partial<AgentConfig>, profile?: ResolvedAgentProfile, parentAgentId?: string | undefined): Promise<{
+    createAgent(config: Partial<AgentConfig>, profile?: ResolvedAgentProfile, parentAgentId?: string | undefined, parentToolCallId?: string | undefined): Promise<{
         readonly id: string;
         readonly agent: Agent;
     }>;
@@ -4347,8 +4372,6 @@ declare interface SessionOptions {
     readonly onClose?: (() => void | Promise<void>) | undefined;
 }
 
-export declare type SessionPlan = PlanInfo | null;
-
 declare interface SessionPromptRpcInput {
     readonly sessionId: string;
     readonly input: PromptInput;
@@ -5266,6 +5289,17 @@ declare interface UnregisterToolPayload {
 
 export declare type Unsubscribe = () => void;
 
+export declare interface UpdateConfigInput {
+    readonly fix?: boolean;
+    readonly configPath?: string;
+}
+
+export declare interface UpdateConfigResult {
+    readonly findings: readonly Finding[];
+    readonly fixed: boolean;
+    readonly backupPath?: string;
+}
+
 declare interface UpdateSessionMetadataPayload {
     readonly metadata: SessionMetadataPatch;
 }