@byfriends/sdk 0.2.4 → 0.3.0

package/LICENSE

@@ -0,0 +1,28 @@
+BYF PROPRIETARY LICENSE
+
+Copyright (c) 2026-2027 ByronFinn
+
+Permission is hereby granted to copy and redistribute this software in its
+unmodified form, without charge. This permission does not extend to modified
+versions of the software.
+
+Local modification of this software for personal use is permitted, provided
+that such modifications are not distributed to third parties.
+
+Restrictions:
+1. You may NOT redistribute modified versions of this software.
+2. You may NOT use this software for commercial purposes.
+3. You may NOT sublicense, sell, or offer this software as a service.
+
+This software is source-available but NOT open source. The source code is
+made publicly visible for review purposes only.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+For questions about licensing, contact: https://github.com/ByronFinn/byf/issues

package/dist/index.d.mts

@@ -140,6 +140,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 = {
@@ -326,6 +333,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[];
@@ -393,6 +401,7 @@ export declare type BackgroundConfig = z.infer<typeof BackgroundConfigSchema>;
 
 declare const BackgroundConfigSchema: z.ZodObject<{
     maxRunningTasks: z.ZodOptional<z.ZodNumber>;
+    maxConcurrentSubagents: z.ZodOptional<z.ZodNumber>;
     keepAliveOnExit: z.ZodOptional<z.ZodBoolean>;
     killGracePeriodMs: z.ZodOptional<z.ZodNumber>;
     agentTaskTimeoutS: z.ZodOptional<z.ZodNumber>;
@@ -653,7 +662,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;
@@ -675,7 +684,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;
@@ -1217,6 +1226,7 @@ declare const ByfConfigPatchSchema: z.ZodObject<{
     }, z.core.$strip>>;
     background: z.ZodOptional<z.ZodObject<{
         maxRunningTasks: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        maxConcurrentSubagents: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         keepAliveOnExit: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         killGracePeriodMs: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
         agentTaskTimeoutS: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
@@ -1354,6 +1364,7 @@ declare const ByfConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
     background: z.ZodOptional<z.ZodObject<{
         maxRunningTasks: z.ZodOptional<z.ZodNumber>;
+        maxConcurrentSubagents: z.ZodOptional<z.ZodNumber>;
         keepAliveOnExit: z.ZodOptional<z.ZodBoolean>;
         killGracePeriodMs: z.ZodOptional<z.ZodNumber>;
         agentTaskTimeoutS: z.ZodOptional<z.ZodNumber>;
@@ -1880,6 +1891,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;
@@ -1990,6 +2007,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.
  *
@@ -2171,6 +2194,16 @@ 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.
@@ -2513,6 +2546,7 @@ declare class InjectionManager {
     private readonly injectors;
     constructor(agent: Agent);
     inject(): Promise<void>;
+    getEphemeralInjections(): readonly EphemeralInjection[];
     onContextClear(): void;
     onContextCompacted(compactedCount: number): void;
 }
@@ -3930,6 +3964,13 @@ export declare interface ResumedAgentState {
     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'>;
@@ -4243,7 +4284,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;
     }>;
@@ -4384,10 +4425,13 @@ declare class SessionSubagentHost {
     private readonly ownerAgentId;
     readonly backgroundTaskTimeoutMs?: number | undefined;
     private readonly activeChildren;
-    constructor(session: Session_2, ownerAgentId: string, backgroundTaskTimeoutMs?: number | undefined);
+    /** Maximum concurrent subagents; exposed for testing and config diagnostics. */
+    readonly maxConcurrentSubagents: number;
+    constructor(session: Session_2, ownerAgentId: string, backgroundTaskTimeoutMs?: number | undefined, maxConcurrentSubagents?: number | undefined);
     spawn(profileName: string, options: RunSubagentOptions): Promise<SubagentHandle>;
     resume(agentId: string, options: RunSubagentOptions): Promise<SubagentHandle>;
     cancelAll(): void;
+    private assertCanSpawn;
     getProfileName(agentId: string): string | undefined;
     private resolveProfile;
     private runChild;