@sema-agent/core 5.20.0 → 5.21.1

package/dist/engine/llm/diagnostics.d.ts

@@ -10,9 +10,13 @@ export interface AssistantMessageDiagnostic {
     error?: DiagnosticErrorInfo;
     details?: Record<string, unknown>;
 }
+/** Formats arbitrary thrown values into diagnostic-safe text. */
 export declare function formatThrownValue(value: unknown): string;
+/** Extracts serializable diagnostic error fields from Error and non-Error throws. */
 export declare function extractDiagnosticError(error: unknown): DiagnosticErrorInfo;
+/** Creates a timestamped assistant-message diagnostic entry. */
 export declare function createAssistantMessageDiagnostic(type: string, error: unknown, details?: Record<string, unknown>): AssistantMessageDiagnostic;
+/** Appends a diagnostic while preserving existing message diagnostics. */
 export declare function appendAssistantMessageDiagnostic(message: {
     diagnostics?: AssistantMessageDiagnostic[];
 }, diagnostic: AssistantMessageDiagnostic): void;

package/dist/engine/llm/event-stream.d.ts

@@ -1,4 +1,5 @@
 import type { AssistantMessage, AssistantMessageEvent, AssistantMessageEventStreamContract } from "./types.js";
+/** Generic async-iterable event stream with a separately awaited final result. */
 export declare class EventStream<T, R = T> implements AsyncIterable<T> {
     private queue;
     private waiting;
@@ -15,7 +16,9 @@ export declare class EventStream<T, R = T> implements AsyncIterable<T> {
     [Symbol.asyncIterator](): AsyncIterator<T>;
     result(): Promise<R>;
 }
+/** Assistant-message event stream that resolves on done/error terminal events. */
 export declare class AssistantMessageEventStream extends EventStream<AssistantMessageEvent, AssistantMessage> implements AssistantMessageEventStreamContract {
     constructor();
 }
+/** Creates an assistant-message stream for provider and plugin adapters. */
 export declare function createAssistantMessageEventStream(): AssistantMessageEventStream;

package/dist/engine/llm/index.d.ts

@@ -1,3 +1,10 @@
+/**
+ * First-party llm layer (design/118 ①② — naturalized out of `src/vendor/llm-core`, de-vendoring 1-2/6).
+ * Provider-neutral model/message/tool types, the assistant-message event-stream primitive, and
+ * model-emitted tool-call validation/coercion. Behavior is pinned by `test/vendor-contracts.test.ts`
+ * (C9, EventStream terminal semantics) and `test/tool-arg-null-coercion.test.ts` (A1/#22 fail-open
+ * closures). Consumers outside `src/engine` import via the `src/internal/llm.ts` facade.
+ */
 export * from "./types.js";
 export * from "./diagnostics.js";
 export * from "./event-stream.js";