@tangle-network/braid 0.1.0

package/dist/app/profile-selection.js

@@ -0,0 +1,114 @@
+import { harnessHonorsEffort, harnessHonorsModel, harnessHonorsSelectors, harnessReasoningEfforts, harnessSupportsModel, preferredHarnessForModel, reasoningEffortsFor, snapHarnessToModel, snapModelToHarness, } from '../adapters/agent-interface/harness-runtime.js';
+import { mergeAgentProfiles, snapshotAgentProfile, } from '../adapters/agent-interface/profile-runtime.js';
+export function selectBaseProfile(candidates) {
+    const choices = [
+        ['command-line', candidates.commandLine],
+        ['branch', candidates.branch],
+        ['workspace', candidates.workspaceTrusted === true ? candidates.workspace : undefined],
+        ['user', candidates.user],
+        ['first-run', candidates.firstRun],
+    ];
+    for (const [reason, profile] of choices) {
+        if (profile !== undefined)
+            return { profile, reason };
+    }
+    return undefined;
+}
+function firstDefined(first, second) {
+    return first !== undefined ? first : second;
+}
+function selectedOverrides(input) {
+    const branch = input.branchOverrides;
+    const next = input.nextRunOverrides;
+    const selected = {};
+    const harness = firstDefined(next?.harness, branch?.harness);
+    const model = firstDefined(next?.model, branch?.model);
+    const effort = firstDefined(next?.effort, branch?.effort);
+    const mode = firstDefined(next?.mode, branch?.mode);
+    const connectionId = firstDefined(next?.connectionId, branch?.connectionId);
+    if (harness !== undefined)
+        selected.harness = harness;
+    if (model !== undefined)
+        selected.model = model;
+    if (effort !== undefined)
+        selected.effort = effort;
+    if (mode !== undefined)
+        selected.mode = mode;
+    if (connectionId !== undefined)
+        selected.connectionId = connectionId;
+    return Object.freeze(selected);
+}
+function applyProfileOverrides(profile, overrides) {
+    const overlay = {
+        ...(overrides.harness === undefined ? {} : { harness: overrides.harness }),
+        ...(overrides.model === undefined && overrides.effort === undefined
+            ? {}
+            : {
+                model: {
+                    ...(profile.model ?? {}),
+                    ...(overrides.model === undefined ? {} : { default: overrides.model }),
+                    ...(overrides.effort === undefined ? {} : { reasoningEffort: overrides.effort }),
+                },
+            }),
+    };
+    const merged = mergeAgentProfiles(profile, overlay);
+    if (merged === undefined)
+        throw new Error('AgentProfile override unexpectedly produced no profile');
+    return snapshotAgentProfile(merged);
+}
+function compatibility(runner, model, input) {
+    if (runner === undefined)
+        return {};
+    const modelSupported = model === undefined ? undefined : harnessSupportsModel(runner, model);
+    const output = {
+        ...(modelSupported === undefined ? {} : { modelSupported }),
+        modelHonored: harnessHonorsModel(runner),
+        effortHonored: harnessHonorsEffort(runner),
+        selectorsHonored: harnessHonorsSelectors(runner),
+        availableEfforts: [
+            ...(model === undefined
+                ? harnessReasoningEfforts(runner)
+                : reasoningEffortsFor(runner, input.modelReasoning)),
+        ],
+    };
+    if (modelSupported === false && model !== undefined) {
+        const suggestedRunner = snapHarnessToModel(runner, model);
+        const suggestedModel = input.availableModelIds === undefined
+            ? undefined
+            : snapModelToHarness(runner, model, input.availableModelIds);
+        return {
+            ...output,
+            ...(suggestedRunner === runner ? {} : { suggestedRunner }),
+            ...(suggestedModel === undefined || suggestedModel === model ? {} : { suggestedModel }),
+        };
+    }
+    return output;
+}
+export function resolveEffectiveProfile(input) {
+    const profile = input.profile.profile;
+    const overrides = selectedOverrides(input);
+    const model = overrides.model ?? input.profile.profile.model?.default;
+    const effort = overrides.effort ?? input.profile.profile.model?.reasoningEffort;
+    const runner = overrides.harness ??
+        input.branchOverrides?.harness ??
+        profile.harness ??
+        (model === undefined ? undefined : (preferredHarnessForModel(model) ?? undefined));
+    const mode = overrides.mode ?? input.branchOverrides?.mode;
+    const connectionId = overrides.connectionId ??
+        input.branchOverrides?.connectionId ??
+        (input.workspaceTrusted === true ? input.workspaceConnectionId : undefined) ??
+        input.userConnectionId;
+    const effectiveProfile = applyProfileOverrides(profile, overrides);
+    return Object.freeze({
+        authoredProfile: profile,
+        effectiveProfile,
+        ...(runner === undefined ? {} : { runner }),
+        ...(model === undefined ? {} : { model }),
+        ...(effort === undefined ? {} : { effort }),
+        ...(mode === undefined ? {} : { mode }),
+        ...(connectionId === undefined ? {} : { connectionId }),
+        overrides,
+        compatibility: compatibility(runner, model, input),
+    });
+}
+//# sourceMappingURL=profile-selection.js.map

package/dist/app/profile-selection.js.map

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

package/dist/app/profile-snapshots.d.ts

@@ -0,0 +1,8 @@
+import type { ProfileSnapshotInput, ProfileSnapshotReceipt } from './profile-types.js';
+/**
+ * Capture the exact source/effective profile decision before execution.
+ * The stored profile values are the canonical redacted snapshots; their source
+ * and effective digests remain distinct so a provider cannot hide a change.
+ */
+export declare function createProfileSnapshot(input: ProfileSnapshotInput): ProfileSnapshotReceipt;
+//# sourceMappingURL=profile-snapshots.d.ts.map

package/dist/app/profile-snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-snapshots.d.ts","sourceRoot":"","sources":["../../src/app/profile-snapshots.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAgB,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAqBpG;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,sBAAsB,CAoDzF"}

package/dist/app/profile-snapshots.js

@@ -0,0 +1,77 @@
+import { canonicalAgentProfileDigest, canonicalCandidateDigest, snapshotAgentProfile, } from '../adapters/agent-interface/profile-runtime.js';
+import { redactStructuredValue } from '../domain/bounded-structured.js';
+import { exportProfileDocument } from './profile-persistence.js';
+import { AGENT_INTERFACE_PACKAGE_NAME, AGENT_INTERFACE_PACKAGE_VERSION, } from './profile-validation.js';
+function freezeDeep(value, seen = new WeakSet()) {
+    if (value === null || typeof value !== 'object' || seen.has(value))
+        return value;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        for (const item of value)
+            freezeDeep(item, seen);
+    }
+    else {
+        for (const child of Object.values(value))
+            freezeDeep(child, seen);
+    }
+    return Object.freeze(value);
+}
+function safeIssues(issues) {
+    return issues.map((item) => Object.freeze({ ...item }));
+}
+/**
+ * Capture the exact source/effective profile decision before execution.
+ * The stored profile values are the canonical redacted snapshots; their source
+ * and effective digests remain distinct so a provider cannot hide a change.
+ */
+export function createProfileSnapshot(input) {
+    const authored = snapshotAgentProfile(input.effective.authoredProfile);
+    const effective = snapshotAgentProfile(input.effective.effectiveProfile);
+    const redactedAuthored = exportProfileDocument(authored, { redact: true }).profile;
+    const redactedEffective = exportProfileDocument(effective, { redact: true }).profile;
+    const source = Object.freeze({ ...input.source.source });
+    const overrides = Object.freeze({ ...input.effective.overrides });
+    const capabilities = input.capabilities === undefined ? undefined : structuredClone(input.capabilities);
+    const base = {
+        kind: 'braid-profile-snapshot',
+        schemaVersion: 1,
+        agentInterfacePackage: {
+            name: AGENT_INTERFACE_PACKAGE_NAME,
+            version: AGENT_INTERFACE_PACKAGE_VERSION,
+        },
+        source,
+        authoredProfile: redactedAuthored,
+        effectiveProfile: redactedEffective,
+        authoredProfileDigest: canonicalAgentProfileDigest(authored),
+        effectiveProfileDigest: canonicalAgentProfileDigest(effective),
+        ...(input.effective.runner === undefined ? {} : { runner: input.effective.runner }),
+        ...(input.effective.model === undefined ? {} : { model: input.effective.model }),
+        ...(input.effective.effort === undefined ? {} : { effort: input.effective.effort }),
+        ...(input.effective.mode === undefined ? {} : { mode: input.effective.mode }),
+        ...(input.effective.connectionId === undefined
+            ? {}
+            : { connectionId: input.effective.connectionId }),
+        overrides,
+        validation: {
+            ok: input.validation.ok,
+            issues: safeIssues(input.validation.issues),
+            ...(input.validation.acceptedProviderWarningCodes === undefined
+                ? {}
+                : {
+                    acceptedProviderWarningCodes: [...input.validation.acceptedProviderWarningCodes],
+                }),
+        },
+        ...(capabilities === undefined ? {} : { capabilities }),
+        ...(input.providerMaterializationReceipt === undefined
+            ? {}
+            : {
+                providerMaterializationReceipt: redactStructuredValue(input.providerMaterializationReceipt),
+            }),
+    };
+    const receipt = {
+        ...base,
+        digest: canonicalCandidateDigest(base),
+    };
+    return freezeDeep(receipt);
+}
+//# sourceMappingURL=profile-snapshots.js.map

package/dist/app/profile-snapshots.js.map

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

package/dist/app/profile-sources.d.ts

@@ -0,0 +1,21 @@
+import type { AgentProfile, AgentProfileRef } from '@tangle-network/agent-interface';
+import type { ProfileDiscoveryInput, ProfileDiscoveryResult, ProfileRecord, ProfileSourceDescriptor, ProfileSourceResolution, ProfileSourceResolverContext, ProfileSourceSpec, ProfileSourceKind } from './profile-types.js';
+export declare function describeProfileSource(spec: ProfileSourceSpec, overrides?: {
+    readonly revision?: string;
+    readonly writable?: boolean;
+}): ProfileSourceDescriptor;
+export declare function createProfileRecord(source: ProfileSourceDescriptor, profile: AgentProfile): ProfileRecord;
+export declare function resolveProfileSource(spec: ProfileSourceSpec, context?: ProfileSourceResolverContext): Promise<ProfileRecord>;
+/** Resolve an inline AgentProfile or a provider/package catalog identifier. */
+export declare function resolveProfileReference(reference: AgentProfileRef, source: Omit<ProfileSourceDescriptor, 'kind'> & {
+    readonly kind: ProfileSourceKind;
+}, resolver?: (reference: string, context: ProfileSourceResolverContext) => AgentProfile | ProfileSourceResolution | Promise<AgentProfile | ProfileSourceResolution>, context?: ProfileSourceResolverContext): Promise<ProfileRecord>;
+/**
+ * Discover only explicitly supplied source entries.
+ *
+ * There is intentionally no directory walk: a workspace or user config must
+ * name each profile source before Braid reads it.
+ */
+export declare function discoverProfiles(input?: ProfileDiscoveryInput): Promise<ProfileDiscoveryResult>;
+export declare function profileSourceKey(record: ProfileRecord): string;
+//# sourceMappingURL=profile-sources.d.ts.map

package/dist/app/profile-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-sources.d.ts","sourceRoot":"","sources":["../../src/app/profile-sources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AASpF,OAAO,KAAK,EACV,qBAAqB,EAErB,sBAAsB,EAEtB,aAAa,EACb,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,oBAAoB,CAAA;AAQ3B,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,SAAS,GAAE;IACT,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACvB,GACL,uBAAuB,CAazB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,YAAY,GACpB,aAAa,CAef;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,aAAa,CAAC,CA+BxB;AAQD,+EAA+E;AAC/E,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,EACpF,QAAQ,CAAC,EAAE,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,4BAA4B,KAClC,YAAY,GAAG,uBAAuB,GAAG,OAAO,CAAC,YAAY,GAAG,uBAAuB,CAAC,EAC7F,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,aAAa,CAAC,CAuBxB;AA0BD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,GAAE,qBAA0B,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAgBjC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAE9D"}

package/dist/app/profile-sources.js

@@ -0,0 +1,135 @@
+import { basename, resolve } from 'node:path';
+import { canonicalCandidateDigest } from '../adapters/agent-interface/profile-runtime.js';
+import { redactSensitiveText } from '../domain/secret-sanitizer.js';
+import { readProfileFile, ProfilePersistenceError } from './profile-persistence.js';
+import { AGENT_INTERFACE_PACKAGE_VERSION, validateProfileShape, ProfileValidationError, } from './profile-validation.js';
+function sourceLabel(spec) {
+    if (spec.label !== undefined && spec.label.length > 0)
+        return spec.label;
+    if (spec.kind === 'file')
+        return basename(resolve(spec.path));
+    return spec.reference;
+}
+export function describeProfileSource(spec, overrides = {}) {
+    const revision = overrides.revision ?? spec.revision;
+    return {
+        kind: spec.kind,
+        reference: redactSensitiveText(spec.kind === 'file' ? resolve(spec.path) : spec.reference, 2048),
+        label: redactSensitiveText(sourceLabel(spec), 512),
+        ...(revision === undefined ? {} : { revision: redactSensitiveText(revision, 512) }),
+        writable: overrides.writable ?? spec.writable ?? spec.kind === 'file',
+        trusted: spec.trusted ?? false,
+    };
+}
+export function createProfileRecord(source, profile) {
+    const validated = validateProfileShape(profile);
+    if (!validated.ok || validated.profile === undefined || validated.digest === undefined) {
+        throw new ProfileValidationError(validated.issues);
+    }
+    const descriptor = Object.freeze({ ...source });
+    const identity = canonicalCandidateDigest({ source: descriptor, profile: validated.digest });
+    return Object.freeze({
+        id: `profile-${identity.slice('sha256:'.length)}`,
+        displayName: validated.profile.name ?? descriptor.label,
+        source: descriptor,
+        profile: validated.profile,
+        digest: validated.digest,
+        agentInterfacePackageVersion: AGENT_INTERFACE_PACKAGE_VERSION,
+    });
+}
+export async function resolveProfileSource(spec, context = {}) {
+    if (spec.kind === 'inline') {
+        return createProfileRecord(describeProfileSource(spec), spec.profile);
+    }
+    if (spec.kind === 'file') {
+        const path = resolve(spec.path);
+        const read = readProfileFile(path);
+        if (spec.revision !== undefined && spec.revision !== read.bytesDigest) {
+            throw new ProfilePersistenceError('PROFILE_SOURCE_REVISION_MISMATCH', 'The profile file revision does not match the requested immutable reference');
+        }
+        return createProfileRecord(describeProfileSource(spec, { revision: read.bytesDigest }), read.imported.profile);
+    }
+    const resolved = await spec.resolve(spec.reference, context);
+    const profile = isProfileResolution(resolved) ? resolved.profile : resolved;
+    const revision = isProfileResolution(resolved) ? resolved.revision : undefined;
+    const writable = isProfileResolution(resolved) ? resolved.writable : undefined;
+    return createProfileRecord(describeProfileSource(spec, {
+        ...(revision === undefined ? {} : { revision }),
+        ...(writable === undefined ? {} : { writable }),
+    }), profile);
+}
+function isProfileResolution(value) {
+    return value !== null && typeof value === 'object' && 'profile' in value;
+}
+/** Resolve an inline AgentProfile or a provider/package catalog identifier. */
+export async function resolveProfileReference(reference, source, resolver, context = {}) {
+    if (typeof reference !== 'string') {
+        return createProfileRecord(source, reference);
+    }
+    if (resolver === undefined) {
+        throw new ProfilePersistenceError('PROFILE_REFERENCE_UNRESOLVED', `No source adapter can resolve profile reference ${reference}`);
+    }
+    const resolved = await resolver(reference, context);
+    const profile = isProfileResolution(resolved) ? resolved.profile : resolved;
+    const revision = isProfileResolution(resolved) ? resolved.revision : source.revision;
+    const writable = isProfileResolution(resolved) ? resolved.writable : source.writable;
+    return createProfileRecord({
+        ...source,
+        reference: redactSensitiveText(reference, 2048),
+        ...(revision === undefined ? {} : { revision: redactSensitiveText(revision, 512) }),
+        ...(writable === undefined ? {} : { writable }),
+    }, profile);
+}
+function sourceIssue(spec, error) {
+    let code = 'profile-source-failed';
+    const message = error instanceof Error ? error.message : String(error);
+    if (error instanceof ProfilePersistenceError)
+        code = error.code;
+    if (error instanceof ProfileValidationError)
+        code = 'profile-validation-failed';
+    const issue = {
+        origin: 'source',
+        level: 'error',
+        code: redactSensitiveText(code, 256),
+        message: redactSensitiveText(message, 4096),
+    };
+    return { source: describeProfileSource(spec), issue };
+}
+function orderedSpecs(input) {
+    return [
+        ...(input.explicit ?? []),
+        ...(input.workspaceTrusted === true ? (input.workspace ?? []) : []),
+        ...(input.user ?? []),
+        ...(input.provider ?? []),
+        ...(input.recent ?? []),
+    ];
+}
+/**
+ * Discover only explicitly supplied source entries.
+ *
+ * There is intentionally no directory walk: a workspace or user config must
+ * name each profile source before Braid reads it.
+ */
+export async function discoverProfiles(input = {}) {
+    const profiles = [];
+    const issues = [];
+    const seen = new Set();
+    for (const spec of orderedSpecs(input)) {
+        try {
+            const record = await resolveProfileSource(spec, input.resolverContext);
+            const identity = `${record.source.kind}\u0000${record.source.reference}\u0000${record.digest}`;
+            if (seen.has(identity))
+                continue;
+            seen.add(identity);
+            profiles.push(record);
+        }
+        catch (error) {
+            issues.push(sourceIssue(spec, error));
+        }
+    }
+    return { profiles, issues };
+}
+export function profileSourceKey(record) {
+    return `${record.source.kind}\u0000${record.source.reference}\u0000${record.digest}`;
+}
+//# sourceMappingURL=profile-sources.js.map

package/dist/app/profile-sources.js.map

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

package/dist/app/profile-types.d.ts

@@ -0,0 +1,240 @@
+import type { AgentProfile, AgentProfileCapabilities, AgentProfileRef, AgentProfileSecurityPolicy, AgentProfileValidationIssue, AgentProfileValidationResult, HarnessType, ReasoningEffort, Sha256Digest } from '@tangle-network/agent-interface';
+import type { AgentEnvironmentCapabilities } from '@tangle-network/agent-interface/environment-provider';
+export declare const PROFILE_EXPORT_FORMAT: 'braid-agent-profile';
+export declare const PROFILE_EXPORT_SCHEMA_VERSION: 1;
+export type ProfileSourceKind = 'inline' | 'file' | 'provider' | 'package' | 'github' | 'recent';
+export interface ProfileSourceDescriptor {
+    readonly kind: ProfileSourceKind;
+    readonly reference: string;
+    readonly label: string;
+    readonly revision?: string;
+    readonly writable: boolean;
+    readonly trusted: boolean;
+}
+export interface ProfileSourceRecord {
+    readonly source: ProfileSourceDescriptor;
+    readonly profile: Readonly<AgentProfile>;
+    readonly digest: Sha256Digest;
+    readonly agentInterfacePackageVersion: string;
+}
+export interface ProfileSourceResolverContext {
+    readonly signal?: AbortSignal;
+    readonly workspaceRoot?: string;
+}
+export type ProfileSourceResolver = (reference: string, context: ProfileSourceResolverContext) => Promise<AgentProfile | ProfileSourceResolution>;
+export interface ProfileSourceResolution {
+    readonly profile: AgentProfile;
+    readonly revision?: string;
+    readonly writable?: boolean;
+}
+interface ProfileSourceSpecBase {
+    readonly reference: string;
+    readonly label?: string;
+    readonly revision?: string;
+    readonly writable?: boolean;
+    readonly trusted?: boolean;
+}
+export interface InlineProfileSourceSpec extends ProfileSourceSpecBase {
+    readonly kind: 'inline';
+    readonly profile: AgentProfile;
+}
+export interface FileProfileSourceSpec extends ProfileSourceSpecBase {
+    readonly kind: 'file';
+    readonly path: string;
+}
+export interface ResolvedProfileSourceSpec extends ProfileSourceSpecBase {
+    readonly kind: 'provider' | 'package' | 'github' | 'recent';
+    readonly resolve: ProfileSourceResolver;
+}
+export type ProfileSourceSpec = InlineProfileSourceSpec | FileProfileSourceSpec | ResolvedProfileSourceSpec;
+export interface ProfileRecord extends ProfileSourceRecord {
+    readonly id: string;
+    readonly displayName: string;
+}
+export type ProfileIssueOrigin = 'schema' | 'security' | 'provider' | 'source';
+export interface ProfileIssue extends AgentProfileValidationIssue {
+    readonly origin: ProfileIssueOrigin;
+    readonly path?: string;
+}
+export interface ProfileProviderValidation {
+    readonly provider: string;
+    readonly result: AgentProfileValidationResult;
+    readonly capabilities?: AgentProfileCapabilities;
+}
+export interface ProfileValidationReport {
+    readonly ok: boolean;
+    readonly issues: readonly ProfileIssue[];
+    readonly profile?: Readonly<AgentProfile>;
+    readonly digest?: Sha256Digest;
+    readonly provider?: ProfileProviderValidation;
+    readonly acceptedProviderWarningCodes?: readonly string[];
+}
+export interface ProfileValidationOptions {
+    readonly securityPolicy?: AgentProfileSecurityPolicy;
+    readonly provider?: ProfileProvider;
+    readonly acceptedProviderWarningCodes?: readonly string[];
+    readonly signal?: AbortSignal;
+}
+/** The narrow provider surface needed to validate a portable profile. */
+export interface ProfileProvider {
+    readonly name: string;
+    readonly capabilities?: () => AgentEnvironmentCapabilities | Promise<AgentEnvironmentCapabilities>;
+    readonly validateProfile?: (profile: AgentProfileRef) => AgentProfileValidationResult | Promise<AgentProfileValidationResult>;
+}
+export interface ProfileDiscoveryInput {
+    readonly explicit?: readonly ProfileSourceSpec[];
+    readonly workspace?: readonly ProfileSourceSpec[];
+    readonly workspaceTrusted?: boolean;
+    readonly user?: readonly ProfileSourceSpec[];
+    readonly provider?: readonly ProfileSourceSpec[];
+    readonly recent?: readonly ProfileSourceSpec[];
+    readonly resolverContext?: ProfileSourceResolverContext;
+}
+export interface ProfileDiscoveryIssue {
+    readonly source: ProfileSourceDescriptor;
+    readonly issue: ProfileIssue;
+}
+export interface ProfileDiscoveryResult {
+    readonly profiles: readonly ProfileRecord[];
+    readonly issues: readonly ProfileDiscoveryIssue[];
+}
+export interface ProfileSelectionCandidates {
+    readonly commandLine?: ProfileRecord;
+    readonly branch?: ProfileRecord;
+    readonly workspace?: ProfileRecord;
+    readonly user?: ProfileRecord;
+    readonly firstRun?: ProfileRecord;
+    readonly workspaceTrusted?: boolean;
+}
+export type ProfileSelectionReason = 'command-line' | 'branch' | 'workspace' | 'user' | 'first-run';
+export interface ProfileSelectionResult {
+    readonly profile: ProfileRecord;
+    readonly reason: ProfileSelectionReason;
+}
+export interface ProfileRunOverrides {
+    readonly harness?: HarnessType;
+    readonly model?: string;
+    readonly effort?: ReasoningEffort;
+    readonly mode?: string;
+    readonly connectionId?: string;
+}
+export interface EffectiveProfileInput {
+    readonly profile: ProfileRecord;
+    readonly branchOverrides?: ProfileRunOverrides;
+    readonly nextRunOverrides?: ProfileRunOverrides;
+    readonly workspaceTrusted?: boolean;
+    readonly workspaceConnectionId?: string;
+    readonly userConnectionId?: string;
+    readonly availableModelIds?: readonly string[];
+    readonly modelReasoning?: {
+        readonly supportsReasoning?: boolean;
+        readonly maxEffort?: ReasoningEffort;
+    };
+}
+export interface EffectiveProfileResult {
+    readonly authoredProfile: Readonly<AgentProfile>;
+    readonly effectiveProfile: Readonly<AgentProfile>;
+    readonly runner?: HarnessType;
+    readonly model?: string;
+    readonly effort?: ReasoningEffort;
+    readonly mode?: string;
+    readonly connectionId?: string;
+    readonly overrides: Readonly<ProfileRunOverrides>;
+    readonly compatibility: ProfileCompatibility;
+}
+export interface ProfileCompatibility {
+    readonly modelSupported?: boolean;
+    readonly suggestedModel?: string;
+    readonly suggestedRunner?: HarnessType;
+    readonly modelHonored?: boolean;
+    readonly effortHonored?: boolean;
+    readonly selectorsHonored?: boolean;
+    readonly availableEfforts?: readonly ReasoningEffort[];
+}
+export interface ProfileDraftValidation {
+    readonly ok: boolean;
+    readonly issues: readonly ProfileIssue[];
+    readonly profile?: Readonly<AgentProfile>;
+    readonly digest?: Sha256Digest;
+}
+export interface ProfileExportDocument {
+    readonly format: typeof PROFILE_EXPORT_FORMAT;
+    readonly schemaVersion: typeof PROFILE_EXPORT_SCHEMA_VERSION;
+    readonly agentInterfacePackage: {
+        readonly name: '@tangle-network/agent-interface';
+        readonly version: string;
+    };
+    /** Digest of the profile before export redaction. */
+    readonly sourceProfileDigest: Sha256Digest;
+    /** Digest of the exact profile carried in this document. */
+    readonly profileDigest: Sha256Digest;
+    readonly redacted: boolean;
+    readonly profile: Readonly<AgentProfile>;
+}
+export interface ImportedProfileDocument {
+    readonly profile: Readonly<AgentProfile>;
+    readonly digest: Sha256Digest;
+    readonly redacted: boolean;
+    readonly sourceProfileDigest?: Sha256Digest;
+    readonly packageVersion: string;
+}
+export interface ProfileExportOptions {
+    readonly redact?: boolean;
+    readonly pretty?: boolean;
+}
+export interface ProfileImportOptions {
+    readonly allowRedacted?: boolean;
+}
+export interface ProfileFileState {
+    readonly path: string;
+    readonly bytesDigest: Sha256Digest;
+    readonly record: ProfileRecord;
+}
+export interface SaveProfileFileOptions {
+    readonly expectedBytesDigest?: Sha256Digest;
+    readonly expectedProfileDigest?: Sha256Digest;
+    readonly expectedBytesAbsent?: boolean;
+    readonly overwrite?: boolean;
+    readonly sourceLabel?: string;
+    readonly trusted?: boolean;
+    readonly onPhase?: (phase: ProfileFileWritePhase) => void;
+}
+export type ProfileFileWritePhase = 'temporary-written' | 'temporary-fsynced' | 'renamed' | 'directory-fsynced';
+export interface ExportProfileFileOptions extends SaveProfileFileOptions, ProfileExportOptions {
+}
+export interface ProfileSnapshotInput {
+    readonly source: ProfileRecord;
+    readonly effective: EffectiveProfileResult;
+    readonly validation: ProfileValidationReport;
+    readonly capabilities?: AgentProfileCapabilities;
+    readonly providerMaterializationReceipt?: unknown;
+}
+export interface ProfileSnapshotReceipt {
+    readonly kind: 'braid-profile-snapshot';
+    readonly schemaVersion: 1;
+    readonly agentInterfacePackage: {
+        readonly name: '@tangle-network/agent-interface';
+        readonly version: string;
+    };
+    readonly source: ProfileSourceDescriptor;
+    readonly authoredProfile: Readonly<AgentProfile>;
+    readonly effectiveProfile: Readonly<AgentProfile>;
+    readonly authoredProfileDigest: Sha256Digest;
+    readonly effectiveProfileDigest: Sha256Digest;
+    readonly runner?: HarnessType;
+    readonly model?: string;
+    readonly effort?: ReasoningEffort;
+    readonly mode?: string;
+    readonly connectionId?: string;
+    readonly overrides: Readonly<ProfileRunOverrides>;
+    readonly validation: {
+        readonly ok: boolean;
+        readonly issues: readonly ProfileIssue[];
+        readonly acceptedProviderWarningCodes?: readonly string[];
+    };
+    readonly capabilities?: AgentProfileCapabilities;
+    readonly providerMaterializationReceipt?: unknown;
+    readonly digest: Sha256Digest;
+}
+export {};
+//# sourceMappingURL=profile-types.d.ts.map