@obversa/api 0.1.0

package/dist/result.d.ts

@@ -0,0 +1,30 @@
+import type { AgentResult, AgentResultPart, EngineIncompleteResultEvidence, EngineSelectionRecord, EngineTransportFailure, UsageReceipt } from './contracts.js';
+export declare function validateIncompleteResultEvidence(result: EngineIncompleteResultEvidence): EngineIncompleteResultEvidence;
+export declare function validateAgentResult(result: AgentResult): AgentResult;
+export declare function engineSelection(input: {
+    adapter: string;
+    adapterVersion?: string | null;
+    provider?: string | null;
+    modelFamily?: string | null;
+    model?: string | null;
+    executable?: string | null;
+    capabilities?: readonly string[];
+}): EngineSelectionRecord;
+export declare function reportedUsage(usage: {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationInputTokens?: number;
+    cacheReadInputTokens?: number;
+}): UsageReceipt;
+export declare function assistantResult(input: {
+    text: string;
+    usage: UsageReceipt;
+    requested: EngineSelectionRecord;
+    effective?: EngineSelectionRecord;
+    stopReason?: string;
+    transportFailure?: EngineTransportFailure;
+    raw?: unknown;
+}): AgentResult;
+export declare function finalResultPart(result: AgentResult): AgentResultPart;
+export declare function finalResultText(result: AgentResult): string | undefined;
+export declare function requireFinalResultText(result: AgentResult): string;

package/dist/run-definition-support.d.ts

@@ -0,0 +1 @@
+export { runDefinitionSupport } from './run-definition.js';

package/dist/run-definition-support.js

@@ -0,0 +1,5 @@
+export { runDefinitionSupport } from './chunk-VWZKI7AG.js';
+import './chunk-WGLWWKF3.js';
+import './chunk-AJ353QD5.js';
+//# sourceMappingURL=run-definition-support.js.map
+//# sourceMappingURL=run-definition-support.js.map

package/dist/run-definition-support.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"run-definition-support.js"}

package/dist/run-definition.d.ts

@@ -0,0 +1,73 @@
+import type { CompiledGraphDefinition, RunBrief } from './graph-contract.js';
+import { type JsonObject, type JsonValue, type Sha256Digest } from './json.js';
+import { type ArtifactReference, type ArtifactStore } from './artifacts/store.js';
+import { type DomainEventEnvelope, type NewDomainEvent } from './events/envelope.js';
+import type { EventStore } from './events/store.js';
+export interface StorageProviderRecord extends JsonObject {
+    readonly schemaVersion: 1;
+    readonly name: string;
+    readonly version: string;
+    readonly configDigest: Sha256Digest;
+}
+export interface SensitiveContentPolicy extends JsonObject {
+    readonly marked: 'reject';
+    readonly exact: 'reject';
+    readonly freeText: 'redact-before-hash';
+}
+export interface RunStoragePolicy extends JsonObject {
+    readonly schemaVersion: 1;
+    readonly maxEventPayloadBytes: number;
+    readonly maxAppendBatchBytes: number;
+    readonly maxArtifactBytes: number;
+    readonly maxTotalArtifactBytesPerRun: number;
+    readonly retention: 'until-run-delete';
+    readonly sensitiveContent: SensitiveContentPolicy;
+}
+export interface RunStorageRecord extends JsonObject {
+    readonly schemaVersion: 1;
+    readonly namespace: string;
+    readonly eventStore: StorageProviderRecord;
+    readonly artifactStore: StorageProviderRecord;
+    readonly policy: RunStoragePolicy;
+}
+export interface RunDefinition extends JsonObject {
+    readonly schemaVersion: 1;
+    readonly runId: string;
+    readonly graphDefinition: CompiledGraphDefinition;
+    readonly resolvedPlan: ArtifactReference<'resolved-plan'>;
+    readonly resolvedInputs: RunBrief;
+    readonly storage: RunStorageRecord;
+    readonly workspaceBinding: JsonObject | null;
+    readonly hostBinding: ArtifactReference<'host-binding'> | null;
+}
+export interface RunStartedPayload extends JsonObject {
+    readonly definition: RunDefinition;
+}
+export type NewRunStartedEvent = NewDomainEvent<'graph:run-started', 1, RunStartedPayload>;
+export type RunStartRecord = DomainEventEnvelope<'graph:run-started', 1, RunStartedPayload>;
+export interface RunStorageBinding {
+    readonly record: RunStorageRecord;
+    readonly eventStore: EventStore;
+    readonly artifactStore: ArtifactStore;
+    readonly knownSecrets: readonly string[];
+}
+type RecordValue = Readonly<Record<string, JsonValue>>;
+declare function fail(path: string, message: string): never;
+declare function json(value: unknown, path: string): JsonValue;
+declare function record(value: unknown, path: string, label: string): RecordValue;
+declare function text(value: unknown, path: string, label: string): string;
+declare function digest(value: unknown, path: string): Sha256Digest;
+export declare function validateRunStoragePolicy(value: unknown): RunStoragePolicy;
+export declare function validateRunStorageRecord(value: unknown): RunStorageRecord;
+declare function validateCompiledDefinition(value: unknown): CompiledGraphDefinition;
+export declare function validateRunDefinition(value: unknown): RunDefinition;
+export declare function validateRunStartRecord(value: unknown): RunStartRecord;
+export declare const runDefinitionSupport: Readonly<{
+    fail: typeof fail;
+    json: typeof json;
+    record: typeof record;
+    text: typeof text;
+    digest: typeof digest;
+    validateCompiledDefinition: typeof validateCompiledDefinition;
+}>;
+export {};

package/dist/storage/error.d.ts

@@ -0,0 +1,7 @@
+import { type JsonObject } from '../json.js';
+export type StorageErrorCode = 'INVALID_STORED_VALUE' | 'UNSUPPORTED_ENVELOPE_VERSION' | 'REVISION_CONFLICT' | 'DUPLICATE_EVENT_ID' | 'CORRUPT_EVENT_STREAM' | 'ARTIFACT_NOT_FOUND' | 'ARTIFACT_NOT_ADMITTED' | 'ARTIFACT_INTEGRITY' | 'STORAGE_LIMIT_EXCEEDED' | 'SENSITIVE_CONTENT' | 'KNOWN_SECRET' | 'UNSAFE_STORAGE_PATH';
+export declare class StorageError extends Error {
+    readonly code: StorageErrorCode;
+    readonly details: JsonObject;
+    constructor(code: StorageErrorCode, message: string, details?: JsonObject);
+}

package/dist/storage/id.d.ts

@@ -0,0 +1,2 @@
+/** Validate one namespace, stream, or run identity used by a storage port. */
+export declare function validateStorageId(value: unknown, path: string): string;

package/dist/testing.d.ts

@@ -0,0 +1,5 @@
+export * from './engine-conformance.js';
+export * from './memory-conformance.js';
+export * from './events/conformance.js';
+export * from './artifacts/conformance.js';
+export * from './workspace/conformance.js';