@bunny-agent/manager 0.9.63-beta.2 → 0.10.0-beta.3

package/dist/contracts/types.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Browser-safe public types for the versioned web search / answer citation
+ * contract (OpenSpec change `standardize-search-tool-citation-contract`).
+ *
+ * This module and its siblings under `contracts/` MUST stay free of Node
+ * built-ins (`node:crypto`, `node:fs`, ...) so they can be re-exported through
+ * `@bunny-agent/sdk/contracts` for browser consumers. Server-only helpers
+ * (URL source ID hashing) live in `source-id.ts`, which is never imported
+ * from this subpath's barrel.
+ */
+/** Current and only supported search contract version. */
+export declare const SEARCH_CONTRACT_VERSION_1: 1;
+/** Union of search contract versions this release understands. */
+export type SearchContractVersion = typeof SEARCH_CONTRACT_VERSION_1;
+/** Offset unit declared on terminal text citation metadata. */
+export type CitationOffsetUnit = "unicode-code-points";
+/** Where a validated citation annotation originated. */
+export type CitationOrigin = "provider" | "explicit_source_marker";
+/** Whether retrieval detail is actually available for a search record. */
+export type SourceDetails = "available" | "unavailable";
+/** Lifecycle status of a structured search record. */
+export type WebSearchCallStatus = "completed" | "failed";
+/** Safe, provider-neutral error codes for structured search failures. */
+export type WebSearchErrorCode = "authentication" | "rate_limit" | "network" | "invalid_request" | "provider_error";
+/** Sanitized structured failure, never containing raw auth headers or keys. */
+export interface WebSearchError {
+    code: WebSearchErrorCode;
+    message: string;
+    retryable: boolean;
+}
+/** A single validated source referenced by a search action. */
+export interface WebSearchSource {
+    type: "url";
+    source_id: string;
+    url: string;
+    title?: string;
+}
+/** A single detailed retrieval result, bound to its source identity. */
+export interface WebSearchResultItem {
+    source_id: string;
+    url: string;
+    title?: string;
+    snippet?: string;
+    age?: string;
+    /** Optional fetched page content; kept separate from `snippet`. */
+    content?: string;
+}
+/** The `action` field of a v1 web search call envelope. */
+export interface WebSearchAction {
+    type: "search";
+    query: string;
+    sources: WebSearchSource[];
+}
+/**
+ * Versioned, Responses-aligned structured web search result envelope.
+ *
+ * `schema_version`, `source_id`, `source_details`, `results`, `provider`,
+ * and `truncated` are Bunny extensions: this is not an assertion of exact
+ * OpenAI Responses API compatibility.
+ */
+interface WebSearchCallRecordBase {
+    schema_version: 1;
+    type: "web_search_call";
+    /** The actual local tool-call ID, not a provider request ID. */
+    id: string;
+    action: WebSearchAction;
+    source_details: SourceDetails;
+    results: WebSearchResultItem[];
+    provider: string;
+    truncated: boolean;
+}
+/** Failure information is required when narrowing a failed search record. */
+export type WebSearchCallRecord = WebSearchCallRecordBase & ({
+    status: "completed";
+    error?: never;
+} | {
+    status: "failed";
+    error: WebSearchError;
+});
+/** The flat Responses-shaped URL citation annotation. */
+export interface UrlCitationAnnotation {
+    type: "url_citation";
+    start_index: number;
+    end_index: number;
+    url: string;
+    /** Canonical annotations always carry a title; use the URL if absent upstream. */
+    title: string;
+}
+/** Responses-shaped answer text content carrying citation annotations. */
+export interface OutputTextContent {
+    type: "output_text";
+    text: string;
+    annotations: UrlCitationAnnotation[];
+}
+/**
+ * Bunny extension binding one annotation (by index into the sibling
+ * `annotations` array) to its source identity and provenance.
+ */
+export interface CitationBinding {
+    annotation_index: number;
+    source_id: string;
+    origin: CitationOrigin;
+    /** Tool-call IDs known to have contributed this source, if any. */
+    tool_call_ids: string[];
+}
+/** Whether a text part's citation processing completed or was bounded. */
+export type CitationProcessingState = "complete" | "partial";
+/**
+ * Terminal per-text-part citation metadata, attached to the runner's
+ * `text-end` event under `providerMetadata["bunny-agent"].citation_contract`.
+ */
+export interface CitationContractMetadata {
+    schema_version: 1;
+    offset_unit: CitationOffsetUnit;
+    annotations: UrlCitationAnnotation[];
+    bindings: CitationBinding[];
+    processing: CitationProcessingState;
+    /** Sanitized diagnostics describing invalid annotations or bounded limits. */
+    diagnostics?: CitationDiagnostic[];
+}
+/** Non-secret diagnostic describing a rejected/truncated citation input. */
+export interface CitationDiagnostic {
+    code: "invalid_version" | "invalid_range" | "unsafe_target" | "duplicate_range" | "unknown_source" | "malformed_token" | "budget_exceeded" | "unavailable_offset_unit";
+    message: string;
+}
+/** Declared capability acknowledgement for a negotiated contract version. */
+export interface SearchContractCapabilities {
+    version: SearchContractVersion;
+    structured_retrieval: boolean;
+    native_annotations: boolean;
+    explicit_source_marker_annotations: boolean;
+}
+/** Processing limits published alongside the v1 contract. */
+export interface SearchContractLimits {
+    maxSourcesPerSearch: number;
+    maxSourcesPerTurn: number;
+    maxAnnotationsPerTextPart: number;
+    maxCodePointsPerTextPart: number;
+    maxPendingMarkerSuffixChars: number;
+}
+export declare const SEARCH_CONTRACT_LIMITS: Readonly<SearchContractLimits>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/contracts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/contracts/types.ts"],"names":[],"mappings":"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"}

package/dist/contracts/types.js

@@ -0,0 +1,20 @@
+/**
+ * Browser-safe public types for the versioned web search / answer citation
+ * contract (OpenSpec change `standardize-search-tool-citation-contract`).
+ *
+ * This module and its siblings under `contracts/` MUST stay free of Node
+ * built-ins (`node:crypto`, `node:fs`, ...) so they can be re-exported through
+ * `@bunny-agent/sdk/contracts` for browser consumers. Server-only helpers
+ * (URL source ID hashing) live in `source-id.ts`, which is never imported
+ * from this subpath's barrel.
+ */
+/** Current and only supported search contract version. */
+export const SEARCH_CONTRACT_VERSION_1 = 1;
+export const SEARCH_CONTRACT_LIMITS = Object.freeze({
+    maxSourcesPerSearch: 50,
+    maxSourcesPerTurn: 500,
+    maxAnnotationsPerTextPart: 1_000,
+    maxCodePointsPerTextPart: 256_000,
+    maxPendingMarkerSuffixChars: 128,
+});
+//# sourceMappingURL=types.js.map

package/dist/contracts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/contracts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAU,CAAC;AAiKpD,MAAM,CAAC,MAAM,sBAAsB,GACjC,MAAM,CAAC,MAAM,CAAC;IACZ,mBAAmB,EAAE,EAAE;IACvB,iBAAiB,EAAE,GAAG;IACtB,yBAAyB,EAAE,KAAK;IAChC,wBAAwB,EAAE,OAAO;IACjC,2BAA2B,EAAE,GAAG;CACjC,CAAC,CAAC"}

package/dist/contracts/validators.d.ts

@@ -0,0 +1,31 @@
+import { type CitationBinding, type CitationContractMetadata, type SearchContractVersion, type UrlCitationAnnotation, type WebSearchAction, type WebSearchCallRecord, type WebSearchError, type WebSearchResultItem, type WebSearchSource } from "./types.js";
+/** Absolute HTTP(S) URLs without embedded user credentials. */
+export declare function isSafeHttpUrl(value: unknown): value is string;
+export declare function isSupportedSearchContractVersion(value: unknown): value is SearchContractVersion;
+export declare function isWebSearchSource(value: unknown): value is WebSearchSource;
+export declare function isWebSearchResultItem(value: unknown): value is WebSearchResultItem;
+export declare function isWebSearchAction(value: unknown): value is WebSearchAction;
+export declare function isWebSearchError(value: unknown): value is WebSearchError;
+/** Recognized records are trusted only after state and source associations agree. */
+export declare function isValidWebSearchCallRecord(value: unknown): value is WebSearchCallRecord;
+export declare function isUrlCitationAnnotation(value: unknown): value is UrlCitationAnnotation;
+/** Validate every boundary against the exact emitted Markdown text. */
+export declare function isAnnotationRangeValidForText(annotation: UrlCitationAnnotation, text: string): boolean;
+export declare function isCitationBinding(value: unknown): value is CitationBinding;
+/** Optional external context makes text bounds and source-table validation explicit. */
+export interface CitationValidationContext {
+    text?: string;
+    sources?: readonly WebSearchSource[];
+}
+/**
+ * Check intrinsic structure, unique ranges, and complete, consistent bindings.
+ * Supply `text` and `sources` to also validate against emitted text and the
+ * authoritative source table. Structural validation alone cannot establish
+ * truthfulness of externally supplied source claims.
+ */
+export declare function isValidCitationContractMetadata(value: unknown, context?: CitationValidationContext): value is CitationContractMetadata;
+export declare function enforceSourceLimit<T>(sources: T[]): {
+    kept: T[];
+    truncated: boolean;
+};
+//# sourceMappingURL=validators.d.ts.map

package/dist/contracts/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/contracts/validators.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAI7B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAEnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAUpB,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAY7D;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qBAAqB,CAEhC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAQ1E;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mBAAmB,CAU9B;AAOD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAkB1E;AAUD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAQxE;AAED,qFAAqF;AACrF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mBAAmB,CAwC9B;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qBAAqB,CAYhC;AAED,uEAAuE;AACvE,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,qBAAqB,EACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAMT;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAoB1E;AAsBD,wFAAwF;AACxF,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,yBAA8B,GACtC,KAAK,IAAI,wBAAwB,CA4FnC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG;IACnD,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,SAAS,EAAE,OAAO,CAAC;CACpB,CAIA"}

package/dist/contracts/validators.js

@@ -0,0 +1,261 @@
+/** Browser-safe validation of the v1 search and answer citation contracts. */
+import { codePointLength, isValidCodePointRange } from "./projection.js";
+import { SEARCH_CONTRACT_LIMITS, SEARCH_CONTRACT_VERSION_1, } from "./types.js";
+function isPlainObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+/** Absolute HTTP(S) URLs without embedded user credentials. */
+export function isSafeHttpUrl(value) {
+    if (typeof value !== "string" || value.length === 0)
+        return false;
+    try {
+        const parsed = new URL(value);
+        return ((parsed.protocol === "http:" || parsed.protocol === "https:") &&
+            parsed.username.length === 0 &&
+            parsed.password.length === 0);
+    }
+    catch {
+        return false;
+    }
+}
+export function isSupportedSearchContractVersion(value) {
+    return value === SEARCH_CONTRACT_VERSION_1;
+}
+export function isWebSearchSource(value) {
+    if (!isPlainObject(value))
+        return false;
+    return (value.type === "url" &&
+        isNonEmptyString(value.source_id) &&
+        isSafeHttpUrl(value.url) &&
+        (value.title === undefined || typeof value.title === "string"));
+}
+export function isWebSearchResultItem(value) {
+    if (!isPlainObject(value))
+        return false;
+    return (isNonEmptyString(value.source_id) &&
+        isSafeHttpUrl(value.url) &&
+        (value.title === undefined || typeof value.title === "string") &&
+        (value.snippet === undefined || typeof value.snippet === "string") &&
+        (value.age === undefined || typeof value.age === "string") &&
+        (value.content === undefined || typeof value.content === "string"));
+}
+/** Comparison matches the server's stable URL hashing without stripping query/fragment. */
+function urlIdentity(url) {
+    return new URL(url).toString();
+}
+export function isWebSearchAction(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (value.type !== "search" || typeof value.query !== "string")
+        return false;
+    if (!Array.isArray(value.sources) ||
+        value.sources.length > SEARCH_CONTRACT_LIMITS.maxSourcesPerSearch ||
+        !value.sources.every(isWebSearchSource))
+        return false;
+    const ids = new Set();
+    const urls = new Set();
+    for (const source of value.sources) {
+        const url = urlIdentity(source.url);
+        if (ids.has(source.source_id) || urls.has(url))
+            return false;
+        ids.add(source.source_id);
+        urls.add(url);
+    }
+    return true;
+}
+const WEB_SEARCH_ERROR_CODES = new Set([
+    "authentication",
+    "rate_limit",
+    "network",
+    "invalid_request",
+    "provider_error",
+]);
+export function isWebSearchError(value) {
+    return (isPlainObject(value) &&
+        typeof value.code === "string" &&
+        WEB_SEARCH_ERROR_CODES.has(value.code) &&
+        typeof value.message === "string" &&
+        typeof value.retryable === "boolean");
+}
+/** Recognized records are trusted only after state and source associations agree. */
+export function isValidWebSearchCallRecord(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (value.schema_version !== 1 || value.type !== "web_search_call")
+        return false;
+    if (!isNonEmptyString(value.id) || !isNonEmptyString(value.provider))
+        return false;
+    if (value.status !== "completed" && value.status !== "failed")
+        return false;
+    if (!isWebSearchAction(value.action))
+        return false;
+    if (value.source_details !== "available" &&
+        value.source_details !== "unavailable")
+        return false;
+    if (!Array.isArray(value.results) ||
+        value.results.length > SEARCH_CONTRACT_LIMITS.maxSourcesPerSearch ||
+        !value.results.every(isWebSearchResultItem))
+        return false;
+    if (typeof value.truncated !== "boolean")
+        return false;
+    if (value.status === "failed") {
+        if (!isWebSearchError(value.error) ||
+            value.source_details !== "unavailable")
+            return false;
+        if (value.action.sources.length > 0 || value.results.length > 0)
+            return false;
+    }
+    else if (value.error !== undefined)
+        return false;
+    if (value.source_details === "unavailable") {
+        if (value.action.sources.length > 0 || value.results.length > 0)
+            return false;
+    }
+    const sources = new Map(value.action.sources.map((s) => [s.source_id, urlIdentity(s.url)]));
+    for (const result of value.results) {
+        if (sources.get(result.source_id) !== urlIdentity(result.url))
+            return false;
+    }
+    return true;
+}
+export function isUrlCitationAnnotation(value) {
+    if (!isPlainObject(value) || value.type !== "url_citation")
+        return false;
+    return (Number.isInteger(value.start_index) &&
+        value.start_index >= 0 &&
+        Number.isInteger(value.end_index) &&
+        value.end_index > value.start_index &&
+        value.end_index <=
+            SEARCH_CONTRACT_LIMITS.maxCodePointsPerTextPart &&
+        isSafeHttpUrl(value.url) &&
+        typeof value.title === "string");
+}
+/** Validate every boundary against the exact emitted Markdown text. */
+export function isAnnotationRangeValidForText(annotation, text) {
+    return isValidCodePointRange(text, annotation.start_index, annotation.end_index);
+}
+export function isCitationBinding(value) {
+    if (!isPlainObject(value))
+        return false;
+    if (!Number.isInteger(value.annotation_index) ||
+        value.annotation_index < 0)
+        return false;
+    if (!isNonEmptyString(value.source_id))
+        return false;
+    if (value.origin !== "provider" && value.origin !== "explicit_source_marker")
+        return false;
+    if (!Array.isArray(value.tool_call_ids) ||
+        !value.tool_call_ids.every(isNonEmptyString))
+        return false;
+    if (new Set(value.tool_call_ids).size !== value.tool_call_ids.length)
+        return false;
+    return (value.origin !== "explicit_source_marker" || value.tool_call_ids.length > 0);
+}
+const DIAGNOSTIC_CODES = new Set([
+    "invalid_version",
+    "invalid_range",
+    "unsafe_target",
+    "duplicate_range",
+    "unknown_source",
+    "malformed_token",
+    "budget_exceeded",
+    "unavailable_offset_unit",
+]);
+function isCitationDiagnostic(value) {
+    return (isPlainObject(value) &&
+        typeof value.code === "string" &&
+        DIAGNOSTIC_CODES.has(value.code) &&
+        typeof value.message === "string");
+}
+/**
+ * Check intrinsic structure, unique ranges, and complete, consistent bindings.
+ * Supply `text` and `sources` to also validate against emitted text and the
+ * authoritative source table. Structural validation alone cannot establish
+ * truthfulness of externally supplied source claims.
+ */
+export function isValidCitationContractMetadata(value, context = {}) {
+    if (!isPlainObject(value))
+        return false;
+    if (value.schema_version !== 1 || value.offset_unit !== "unicode-code-points")
+        return false;
+    const textLength = context.text === undefined ? undefined : codePointLength(context.text);
+    if (!Array.isArray(value.annotations) ||
+        value.annotations.length >
+            SEARCH_CONTRACT_LIMITS.maxAnnotationsPerTextPart ||
+        !value.annotations.every(isUrlCitationAnnotation))
+        return false;
+    if (!Array.isArray(value.bindings) ||
+        value.bindings.length !== value.annotations.length ||
+        !value.bindings.every(isCitationBinding))
+        return false;
+    if (value.processing !== "complete" && value.processing !== "partial")
+        return false;
+    if (value.diagnostics !== undefined &&
+        (!Array.isArray(value.diagnostics) ||
+            !value.diagnostics.every(isCitationDiagnostic)))
+        return false;
+    if (textLength !== undefined &&
+        textLength > SEARCH_CONTRACT_LIMITS.maxCodePointsPerTextPart &&
+        (value.processing !== "partial" ||
+            !value.diagnostics?.some((d) => d.code === "budget_exceeded")))
+        return false;
+    const knownUrls = new Map();
+    const knownIds = new Map();
+    if (context.sources !== undefined) {
+        for (const source of context.sources) {
+            if (!isWebSearchSource(source))
+                return false;
+            const url = urlIdentity(source.url);
+            if ((knownUrls.has(source.source_id) &&
+                knownUrls.get(source.source_id) !== url) ||
+                (knownIds.has(url) && knownIds.get(url) !== source.source_id))
+                return false;
+            knownUrls.set(source.source_id, url);
+            knownIds.set(url, source.source_id);
+        }
+    }
+    const annotations = value.annotations;
+    const seenRanges = new Set();
+    for (const annotation of annotations) {
+        const key = JSON.stringify([
+            annotation.start_index,
+            annotation.end_index,
+            urlIdentity(annotation.url),
+        ]);
+        if (seenRanges.has(key))
+            return false;
+        seenRanges.add(key);
+        if (textLength !== undefined && annotation.end_index > textLength)
+            return false;
+    }
+    const boundIndices = new Set();
+    const sourceUrls = new Map();
+    const urlSources = new Map();
+    for (const binding of value.bindings) {
+        if (boundIndices.has(binding.annotation_index) ||
+            binding.annotation_index >= annotations.length)
+            return false;
+        boundIndices.add(binding.annotation_index);
+        const url = urlIdentity(annotations[binding.annotation_index].url);
+        if ((sourceUrls.has(binding.source_id) &&
+            sourceUrls.get(binding.source_id) !== url) ||
+            (urlSources.has(url) && urlSources.get(url) !== binding.source_id))
+            return false;
+        if (context.sources !== undefined &&
+            knownUrls.get(binding.source_id) !== url)
+            return false;
+        sourceUrls.set(binding.source_id, url);
+        urlSources.set(url, binding.source_id);
+    }
+    return sourceUrls.size <= SEARCH_CONTRACT_LIMITS.maxSourcesPerTurn;
+}
+export function enforceSourceLimit(sources) {
+    const max = SEARCH_CONTRACT_LIMITS.maxSourcesPerSearch;
+    if (sources.length <= max)
+        return { kept: sources, truncated: false };
+    return { kept: sources.slice(0, max), truncated: true };
+}
+//# sourceMappingURL=validators.js.map

package/dist/contracts/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/contracts/validators.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -150,6 +150,16 @@ export interface BunnyAgentCodingRunBody {
      * Passed through to the runner; pi maps it to its native ThinkingLevel enum.
      */
     effort?: string;
+    /**
+     * Explicit opt-in to the versioned web search / answer citation contract
+     * (see `@bunny-agent/manager/contracts`). Absent means legacy text-only
+     * search behavior; `1` requests the structured retrieval envelope and
+     * Responses-shaped answer annotations. Request-scoped — never a
+     * process-global switch. Runners that do not support the requested
+     * version reject the request explicitly rather than silently falling
+     * back to legacy behavior.
+     */
+    searchContractVersion?: number;
 }
 /**
  * Represents a handle to an active sandbox instance
@@ -288,6 +298,11 @@ export interface RunnerSpec {
     yolo?: boolean;
     /** Reasoning effort / thinking level (e.g. "low", "medium", "high"). */
     effort?: string;
+    /**
+     * Explicit opt-in to the versioned web search / answer citation contract.
+     * See {@link BunnyAgentCodingRunBody.searchContractVersion}.
+     */
+    searchContractVersion?: number;
 }
 /**
  * Options for creating a BunnyAgent instance

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,4GAA4G;AAC5G,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,oGAAoG;AACpG,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,WAAW,EAAE,eAAe,CAAC;IAC7B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;AAEzE,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IACjD,mBAAmB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IACH,UAAU,IAAI,MAAM,EAAE,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IACH,UAAU,IAAI,MAAM,CAAC;IAErB;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAEvE;;;;OAIG;IACH,MAAM,CACJ,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAA;KAAE,CAAC,EAC5D,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5C;;;;OAIG;IACH,eAAe,CAAC,CACd,IAAI,EAAE,uBAAuB,EAC7B,IAAI,CAAC,EAAE,WAAW,GACjB,aAAa,CAAC,UAAU,CAAC,CAAC;IAE7B;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAEjC;;;OAGG;IACH,SAAS,IAAI,aAAa,GAAG,IAAI,CAAC;IAElC;;;OAGG;IACH,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC;;OAEG;IACH,UAAU,CAAC,IAAI,MAAM,CAAC;IAEtB;;;OAGG;IACH,gBAAgB,CAAC,IAAI,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC/D,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,2BAA2B;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,iCAAiC;IACjC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,6BAA6B;IAC7B,OAAO,EACH,MAAM,GACN,KAAK,CACD;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAC9B;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CACpD,CAAC;CACP;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,uDAAuD;IACvD,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,8BAA8B;IAC9B,SAAS,CAAC,EAAE;QACV,sCAAsC;QACtC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;IACvD,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;OAEG;IACH,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunny-agent/manager",
-  "version": "0.9.63-beta.2",
+  "version": "0.10.0-beta.3",
   "description": "BunnyAgent Manager - Manages sandbox and runner lifecycle, defines core interfaces",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,6 +10,22 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./citation-guidance": {
+      "import": "./dist/citation-guidance.js",
+      "types": "./dist/citation-guidance.d.ts"
+    },
+    "./contracts": {
+      "import": "./dist/contracts/index.js",
+      "types": "./dist/contracts/index.d.ts"
+    },
+    "./contracts/source-id": {
+      "import": "./dist/contracts/source-id.js",
+      "types": "./dist/contracts/source-id.d.ts"
+    },
+    "./contracts/record": {
+      "import": "./dist/contracts/record.js",
+      "types": "./dist/contracts/record.d.ts"
     }
   },
   "files": [