@bizagent/dsh 0.0.0-stage → 1.0.0

package/lib/client-types/domain.d.ts

@@ -0,0 +1,818 @@
+import { z } from 'zod';
+export declare const HOME_TYPES: readonly ["personal", "line", "business", "role", "capability"];
+export type HomeType = typeof HOME_TYPES[number];
+export declare const ORGANIZATION_RELATIONS: readonly ["member-of", "fulfills-role", "serves", "belongs-to-line"];
+export type OrganizationRelation = typeof ORGANIZATION_RELATIONS[number];
+export declare const ASSET_KINDS: readonly ["memory", "insight", "knowledge", "method", "identity"];
+export type AssetKind = typeof ASSET_KINDS[number];
+export declare const ASSET_STATUSES: readonly ["candidate", "active", "superseded", "retired"];
+export type AssetStatus = typeof ASSET_STATUSES[number];
+export declare const HomeAddressSchema: z.ZodString;
+export type HomeAddress = `${HomeType}:${string}`;
+export declare const UserAddressSchema: z.ZodString;
+export type UserAddress = `user:${string}`;
+export declare const ProjectSeatAddressSchema: z.ZodString;
+export type ProjectSeatAddress = `seat:${string}:seat-${string}`;
+export declare const InboxAddressSchema: z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodString]>;
+export type InboxAddress = HomeAddress | UserAddress | ProjectSeatAddress;
+export declare const InboxSenderAddressSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodString]>, z.ZodLiteral<"engine:inbox">]>;
+export type InboxSenderAddress = InboxAddress | 'engine:inbox';
+export declare const HumanActionSchema: z.ZodObject<{
+    request: z.ZodString;
+    reason: z.ZodString;
+    recommendation: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type HumanAction = z.infer<typeof HumanActionSchema>;
+export declare const EvidenceRefSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"session-events">;
+    sessionId: z.ZodString;
+    fromSeq: z.ZodNumber;
+    toSeq: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"worklog">;
+    sessionId: z.ZodString;
+    revisionId: z.ZodString;
+    fingerprint: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool-result">;
+    sessionId: z.ZodString;
+    eventSeq: z.ZodNumber;
+    toolCallId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"artifact">;
+    uri: z.ZodString;
+    digest: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document">;
+    uri: z.ZodString;
+    digest: z.ZodString;
+    authority: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"asset">;
+    ownerAddress: z.ZodString;
+    assetId: z.ZodString;
+    revision: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"user-confirmation">;
+    sessionId: z.ZodString;
+    eventSeq: z.ZodNumber;
+}, z.core.$strip>], "type">;
+export type EvidenceRef = z.infer<typeof EvidenceRefSchema>;
+export declare const AgentHomeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    address: z.ZodString;
+    type: z.ZodEnum<{
+        personal: "personal";
+        line: "line";
+        business: "business";
+        role: "role";
+        capability: "capability";
+    }>;
+    displayName: z.ZodString;
+    owner: z.ZodOptional<z.ZodString>;
+    revision: z.ZodNumber;
+    contextDigest: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+    }>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type AgentHome = z.infer<typeof AgentHomeSchema> & {
+    address: HomeAddress;
+};
+export declare const OrganizationLinkSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    relation: z.ZodEnum<{
+        "member-of": "member-of";
+        "fulfills-role": "fulfills-role";
+        serves: "serves";
+        "belongs-to-line": "belongs-to-line";
+    }>;
+}, z.core.$strip>;
+export declare const OrganizationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    name: z.ZodString;
+    mission: z.ZodString;
+    lineHome: z.ZodOptional<z.ZodString>;
+    businessHome: z.ZodString;
+    members: z.ZodArray<z.ZodObject<{
+        personalHome: z.ZodString;
+        roleHome: z.ZodString;
+    }, z.core.$strip>>;
+    capabilityHomes: z.ZodArray<z.ZodString>;
+    links: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        relation: z.ZodEnum<{
+            "member-of": "member-of";
+            "fulfills-role": "fulfills-role";
+            serves: "serves";
+            "belongs-to-line": "belongs-to-line";
+        }>;
+    }, z.core.$strip>>;
+    revision: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type Organization = Omit<z.infer<typeof OrganizationSchema>, 'lineHome' | 'businessHome' | 'members' | 'capabilityHomes' | 'links'> & {
+    lineHome?: HomeAddress;
+    businessHome: HomeAddress;
+    members: Array<{
+        personalHome: HomeAddress;
+        roleHome: HomeAddress;
+    }>;
+    capabilityHomes: HomeAddress[];
+    links: Array<{
+        from: HomeAddress;
+        to: HomeAddress;
+        relation: OrganizationRelation;
+    }>;
+};
+export declare const AssetMetadataSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    ownerAddress: z.ZodString;
+    kind: z.ZodEnum<{
+        memory: "memory";
+        insight: "insight";
+        knowledge: "knowledge";
+        method: "method";
+        identity: "identity";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceRefs: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"session-events">;
+        sessionId: z.ZodString;
+        fromSeq: z.ZodNumber;
+        toSeq: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"worklog">;
+        sessionId: z.ZodString;
+        revisionId: z.ZodString;
+        fingerprint: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool-result">;
+        sessionId: z.ZodString;
+        eventSeq: z.ZodNumber;
+        toolCallId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"artifact">;
+        uri: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"document">;
+        uri: z.ZodString;
+        digest: z.ZodString;
+        authority: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"asset">;
+        ownerAddress: z.ZodString;
+        assetId: z.ZodString;
+        revision: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"user-confirmation">;
+        sessionId: z.ZodString;
+        eventSeq: z.ZodNumber;
+    }, z.core.$strip>], "type">>;
+    confidence: z.ZodNumber;
+    fitness: z.ZodNumber;
+    status: z.ZodEnum<{
+        candidate: "candidate";
+        active: "active";
+        superseded: "superseded";
+        retired: "retired";
+    }>;
+    revision: z.ZodNumber;
+    proposalId: z.ZodOptional<z.ZodString>;
+    proposalApplications: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        proposalId: z.ZodString;
+        revision: z.ZodNumber;
+        bodySha256: z.ZodString;
+    }, z.core.$strip>>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type AssetMetadata = z.infer<typeof AssetMetadataSchema> & {
+    ownerAddress: HomeAddress;
+};
+export interface StoredAsset extends AssetMetadata {
+    body: string;
+    bodyPath: string;
+}
+export declare const SessionBindingSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    homeAddress: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    boundAt: z.ZodString;
+}, z.core.$strip>;
+export type SessionBinding = z.infer<typeof SessionBindingSchema> & {
+    homeAddress: HomeAddress;
+};
+export declare const ProjectTurnParticipationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectId: z.ZodString;
+    sessionId: z.ZodString;
+    homeAddress: z.ZodString;
+    turn: z.ZodNumber;
+    recordedAt: z.ZodString;
+}, z.core.$strip>;
+export type ProjectTurnParticipation = z.infer<typeof ProjectTurnParticipationSchema> & {
+    homeAddress: HomeAddress;
+};
+export declare const LearningMaterialObservationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    homeAddress: z.ZodString;
+    sessionId: z.ZodString;
+    fingerprint: z.ZodString;
+    eventCount: z.ZodNumber;
+    lastSeq: z.ZodNumber;
+    sourceKind: z.ZodOptional<z.ZodLiteral<"worklog">>;
+    worklogRevisionId: z.ZodOptional<z.ZodString>;
+    worklogRevision: z.ZodOptional<z.ZodNumber>;
+    observedAt: z.ZodString;
+}, z.core.$strip>;
+export type LearningMaterialObservation = z.infer<typeof LearningMaterialObservationSchema> & {
+    homeAddress: HomeAddress;
+};
+export declare const LearningMaterialReviewSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    materialId: z.ZodString;
+    homeAddress: z.ZodString;
+    reviewerSessionId: z.ZodString;
+    summary: z.ZodString;
+    batchRunId: z.ZodOptional<z.ZodString>;
+    assetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    reviewedAt: z.ZodString;
+}, z.core.$strip>;
+export type LearningMaterialReview = z.infer<typeof LearningMaterialReviewSchema> & {
+    homeAddress: HomeAddress;
+};
+export declare const LearningLibraryFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    sha256: z.ZodString;
+    bytes: z.ZodNumber;
+}, z.core.$strip>;
+export type LearningLibraryFile = z.infer<typeof LearningLibraryFileSchema>;
+export declare const LearningLibraryChangeSchema: z.ZodObject<{
+    path: z.ZodString;
+    result: z.ZodEnum<{
+        created: "created";
+        updated: "updated";
+        deleted: "deleted";
+    }>;
+    before: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+        bytes: z.ZodNumber;
+    }, z.core.$strip>>;
+    after: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+        bytes: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LearningLibraryChange = z.infer<typeof LearningLibraryChangeSchema>;
+export declare const LearningBatchRunSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    homeAddress: z.ZodString;
+    reviewerSessionId: z.ZodString;
+    materialIds: z.ZodArray<z.ZodString>;
+    status: z.ZodEnum<{
+        open: "open";
+        completed: "completed";
+        abandoned: "abandoned";
+    }>;
+    summary: z.ZodOptional<z.ZodString>;
+    libraryBefore: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+        bytes: z.ZodNumber;
+    }, z.core.$strip>>>;
+    libraryChanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        result: z.ZodEnum<{
+            created: "created";
+            updated: "updated";
+            deleted: "deleted";
+        }>;
+        before: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+            bytes: z.ZodNumber;
+        }, z.core.$strip>>;
+        after: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+            bytes: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    libraryChangeError: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type LearningBatchRun = z.infer<typeof LearningBatchRunSchema> & {
+    homeAddress: HomeAddress;
+};
+export declare const LearningLaunchSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    homeAddress: z.ZodString;
+    requestedBySessionId: z.ZodString;
+    workerSessionId: z.ZodString;
+    workspace: z.ZodString;
+    promptMessageId: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    trigger: z.ZodOptional<z.ZodEnum<{
+        explicit: "explicit";
+        schedule: "schedule";
+    }>>;
+    scheduledFor: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodEnum<{
+        active: "active";
+        completed: "completed";
+        abandoned: "abandoned";
+        reserved: "reserved";
+        needs_review: "needs_review";
+    }>;
+    reason: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type LearningLaunch = z.infer<typeof LearningLaunchSchema> & {
+    homeAddress: HomeAddress;
+};
+export declare const LearningScheduleCursorSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    homeAddress: z.ZodString;
+    scheduleFingerprint: z.ZodString;
+    nextDueAt: z.ZodNumber;
+    lastDueAt: z.ZodOptional<z.ZodNumber>;
+    lastOutcome: z.ZodOptional<z.ZodEnum<{
+        launched: "launched";
+        empty: "empty";
+        limit: "limit";
+        deferred: "deferred";
+        expired: "expired";
+    }>>;
+    lastLaunchId: z.ZodOptional<z.ZodString>;
+    lastReason: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type LearningScheduleCursor = z.infer<typeof LearningScheduleCursorSchema> & {
+    homeAddress: HomeAddress;
+};
+export declare const LearningSchedulePolicySchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    homeAddress: z.ZodString;
+    revision: z.ZodNumber;
+    enabled: z.ZodBoolean;
+    cron: z.ZodString;
+    dailyRuns: z.ZodNumber;
+    updatedBy: z.ZodLiteral<"local-ui">;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type LearningSchedulePolicy = z.infer<typeof LearningSchedulePolicySchema> & {
+    homeAddress: HomeAddress;
+};
+export declare const FRAME_MODES: readonly ["lead", "contribute", "reference"];
+export type FrameMode = typeof FRAME_MODES[number];
+export declare const AgentFrameSchema: z.ZodObject<{
+    address: z.ZodString;
+    mode: z.ZodEnum<{
+        lead: "lead";
+        contribute: "contribute";
+        reference: "reference";
+    }>;
+    revision: z.ZodNumber;
+    digest: z.ZodString;
+    contextEpoch: z.ZodOptional<z.ZodNumber>;
+    openedAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type AgentFrame = Omit<z.infer<typeof AgentFrameSchema>, 'address'> & {
+    address: HomeAddress;
+};
+export declare const AgentFrameStateSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sessionId: z.ZodString;
+    primaryHome: z.ZodString;
+    contextEpoch: z.ZodOptional<z.ZodNumber>;
+    lastCompactionSeq: z.ZodOptional<z.ZodNumber>;
+    frames: z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        mode: z.ZodEnum<{
+            lead: "lead";
+            contribute: "contribute";
+            reference: "reference";
+        }>;
+        revision: z.ZodNumber;
+        digest: z.ZodString;
+        contextEpoch: z.ZodOptional<z.ZodNumber>;
+        openedAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    focusAddress: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type AgentFrameState = Omit<z.infer<typeof AgentFrameStateSchema>, 'primaryHome' | 'frames' | 'focusAddress'> & {
+    primaryHome: HomeAddress;
+    frames: AgentFrame[];
+    focusAddress?: HomeAddress;
+};
+export declare const HumanTurnProvenanceSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    turn: z.ZodNumber;
+    fromSeq: z.ZodNumber;
+    userMessageSeq: z.ZodNumber;
+    toSeq: z.ZodNumber;
+    sourceSha256: z.ZodString;
+    recipient: z.ZodString;
+    authorityRef: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type HumanTurnProvenance = z.infer<typeof HumanTurnProvenanceSchema> & {
+    recipient: UserAddress;
+};
+export declare const InboxMessageSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    idempotencyKey: z.ZodString;
+    fromAddress: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodString]>, z.ZodLiteral<"engine:inbox">]>;
+    returnToSessionId: z.ZodOptional<z.ZodString>;
+    wakeOptions: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    returnAddress: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
+    projectId: z.ZodOptional<z.ZodString>;
+    to: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodString]>>;
+    cc: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodString]>>;
+    subject: z.ZodString;
+    body: z.ZodString;
+    kind: z.ZodEnum<{
+        ordinary: "ordinary";
+        "project-outcome-rework": "project-outcome-rework";
+        conclusion: "conclusion";
+        escalation: "escalation";
+        "work-request": "work-request";
+        "work-result": "work-result";
+        "work-notice": "work-notice";
+        "turn-complete": "turn-complete";
+    }>;
+    priority: z.ZodEnum<{
+        normal: "normal";
+        urgent: "urgent";
+    }>;
+    due: z.ZodOptional<z.ZodString>;
+    contextRefs: z.ZodArray<z.ZodString>;
+    humanAction: z.ZodOptional<z.ZodObject<{
+        request: z.ZodString;
+        reason: z.ZodString;
+        recommendation: z.ZodOptional<z.ZodString>;
+        href: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    humanTurn: z.ZodOptional<z.ZodObject<{
+        sessionId: z.ZodString;
+        turn: z.ZodNumber;
+        fromSeq: z.ZodNumber;
+        userMessageSeq: z.ZodNumber;
+        toSeq: z.ZodNumber;
+        sourceSha256: z.ZodString;
+        recipient: z.ZodString;
+        authorityRef: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    projectOutcomeRework: z.ZodOptional<z.ZodObject<{
+        projectId: z.ZodString;
+        claimId: z.ZodString;
+        lead: z.ZodString;
+    }, z.core.$strict>>;
+    automaticEscalation: z.ZodOptional<z.ZodObject<{
+        sourceMessageId: z.ZodString;
+        authorityRef: z.ZodString;
+    }, z.core.$strip>>;
+    conclusionArtifact: z.ZodOptional<z.ZodString>;
+    replyTo: z.ZodOptional<z.ZodString>;
+    rootId: z.ZodString;
+    chain: z.ZodNumber;
+    topicId: z.ZodOptional<z.ZodString>;
+    hop: z.ZodOptional<z.ZodNumber>;
+    sentAt: z.ZodString;
+}, z.core.$strip>;
+export type InboxMessage = Omit<z.infer<typeof InboxMessageSchema>, 'fromAddress' | 'to' | 'cc' | 'returnAddress'> & {
+    fromAddress: InboxSenderAddress;
+    to: InboxAddress[];
+    cc: InboxAddress[];
+    returnAddress?: HomeAddress | ProjectSeatAddress;
+};
+export declare function inboxShouldConverge(hop: number, topicCount: number): boolean;
+export declare const InboxWakeOriginSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sessionId: z.ZodString;
+    homeAddress: z.ZodString;
+    topicId: z.ZodString;
+    hop: z.ZodNumber;
+    wakePlanId: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type InboxWakeOrigin = Omit<z.infer<typeof InboxWakeOriginSchema>, 'homeAddress'> & {
+    homeAddress: HomeAddress;
+};
+export declare const InboxWakePlanSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    recipient: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+    messageIds: z.ZodArray<z.ZodString>;
+    sessionId: z.ZodString;
+    topicId: z.ZodString;
+    scope: z.ZodOptional<z.ZodEnum<{
+        owner: "owner";
+        topic: "topic";
+    }>>;
+    reason: z.ZodOptional<z.ZodEnum<{
+        initial: "initial";
+        "nudge-due": "nudge-due";
+        "nudge-stale": "nudge-stale";
+    }>>;
+    hop: z.ZodNumber;
+    workspace: z.ZodString;
+    dueAt: z.ZodString;
+    createdAt: z.ZodString;
+    dispatchedAt: z.ZodOptional<z.ZodString>;
+    retiredReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type InboxWakePlan = Omit<z.infer<typeof InboxWakePlanSchema>, 'recipient'> & {
+    recipient: HomeAddress | ProjectSeatAddress;
+};
+export declare const InboxReturnRouteSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    messageId: z.ZodString;
+    recipient: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+    sessionId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        fallback: "fallback";
+    }>;
+    updatedAt: z.ZodString;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type InboxReturnRoute = Omit<z.infer<typeof InboxReturnRouteSchema>, 'recipient'> & {
+    recipient: HomeAddress | ProjectSeatAddress;
+};
+export declare const InboxDeliverySchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    messageId: z.ZodString;
+    recipient: z.ZodUnion<readonly [z.ZodString, z.ZodString, z.ZodString]>;
+    status: z.ZodEnum<{
+        delivered: "delivered";
+        bounced: "bounced";
+    }>;
+    reason: z.ZodOptional<z.ZodString>;
+    wakePolicy: z.ZodOptional<z.ZodEnum<{
+        immediate: "immediate";
+        batch: "batch";
+        scheduled: "scheduled";
+        carried: "carried";
+    }>>;
+    wakeAt: z.ZodOptional<z.ZodString>;
+    nudgedAt: z.ZodOptional<z.ZodString>;
+    nudgeReason: z.ZodOptional<z.ZodEnum<{
+        due: "due";
+        stale: "stale";
+    }>>;
+    handledAt: z.ZodOptional<z.ZodString>;
+    handledBySessionId: z.ZodOptional<z.ZodString>;
+    handledByUserId: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type InboxDelivery = Omit<z.infer<typeof InboxDeliverySchema>, 'recipient'> & {
+    recipient: InboxAddress;
+};
+export declare const HumanNotificationPreferenceSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    recipient: z.ZodString;
+    enabled: z.ZodBoolean;
+    revision: z.ZodNumber;
+    updatedAt: z.ZodString;
+}, z.core.$strict>;
+export type HumanNotificationPreference = Omit<z.infer<typeof HumanNotificationPreferenceSchema>, 'recipient'> & {
+    recipient: UserAddress;
+};
+/** A push attempt is unknown before calling an external channel, so crashes cannot cause blind resend. */
+export declare const InboxHumanNotificationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    messageId: z.ZodString;
+    recipient: z.ZodString;
+    attempt: z.ZodDefault<z.ZodNumber>;
+    priorRejections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        attemptedAt: z.ZodString;
+        resolvedAt: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>>>;
+    status: z.ZodEnum<{
+        unknown: "unknown";
+        sent: "sent";
+        rejected: "rejected";
+        suppressed: "suppressed";
+    }>;
+    attemptedAt: z.ZodOptional<z.ZodString>;
+    suppressedAt: z.ZodOptional<z.ZodString>;
+    resolvedAt: z.ZodOptional<z.ZodString>;
+    providerReceipt: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type InboxHumanNotification = Omit<z.infer<typeof InboxHumanNotificationSchema>, 'recipient'> & {
+    recipient: UserAddress;
+};
+export declare const MemoryProposalSchema: z.ZodObject<{
+    id: z.ZodString;
+    fromAddress: z.ZodString;
+    toAddress: z.ZodString;
+    proposedKind: z.ZodEnum<{
+        memory: "memory";
+        insight: "insight";
+        knowledge: "knowledge";
+        method: "method";
+        identity: "identity";
+    }>;
+    description: z.ZodString;
+    body: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sourceRefs: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"session-events">;
+        sessionId: z.ZodString;
+        fromSeq: z.ZodNumber;
+        toSeq: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"worklog">;
+        sessionId: z.ZodString;
+        revisionId: z.ZodString;
+        fingerprint: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool-result">;
+        sessionId: z.ZodString;
+        eventSeq: z.ZodNumber;
+        toolCallId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"artifact">;
+        uri: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"document">;
+        uri: z.ZodString;
+        digest: z.ZodString;
+        authority: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"asset">;
+        ownerAddress: z.ZodString;
+        assetId: z.ZodString;
+        revision: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"user-confirmation">;
+        sessionId: z.ZodString;
+        eventSeq: z.ZodNumber;
+    }, z.core.$strip>], "type">>;
+    status: z.ZodEnum<{
+        rejected: "rejected";
+        pending: "pending";
+        accepted: "accepted";
+        withdrawn: "withdrawn";
+    }>;
+    baseAsset: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        bodySha256: z.ZodString;
+    }, z.core.$strip>>;
+    targetAssetId: z.ZodOptional<z.ZodString>;
+    appliedAssetRevision: z.ZodOptional<z.ZodNumber>;
+    appliedBodySha256: z.ZodOptional<z.ZodString>;
+    humanReview: z.ZodOptional<z.ZodObject<{
+        reviewerId: z.ZodString;
+        authorityRef: z.ZodString;
+        action: z.ZodEnum<{
+            accept: "accept";
+            reject: "reject";
+        }>;
+        decision: z.ZodString;
+        reviewedAt: z.ZodString;
+    }, z.core.$strip>>;
+    decision: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    decidedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MemoryProposal = z.infer<typeof MemoryProposalSchema> & {
+    fromAddress: HomeAddress;
+    toAddress: HomeAddress;
+};
+export declare const FITNESS_SIGNALS: readonly ["retrieved", "applied", "confirmed", "contradicted", "failed"];
+export type FitnessSignal = typeof FITNESS_SIGNALS[number];
+export declare const FitnessReceiptSchema: z.ZodObject<{
+    id: z.ZodString;
+    assetId: z.ZodString;
+    ownerAddress: z.ZodString;
+    sessionId: z.ZodString;
+    eventSeq: z.ZodOptional<z.ZodNumber>;
+    assetRevision: z.ZodOptional<z.ZodNumber>;
+    assetBodySha256: z.ZodOptional<z.ZodString>;
+    signal: z.ZodEnum<{
+        retrieved: "retrieved";
+        applied: "applied";
+        confirmed: "confirmed";
+        contradicted: "contradicted";
+        failed: "failed";
+    }>;
+    outcome: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type FitnessReceipt = z.infer<typeof FitnessReceiptSchema> & {
+    ownerAddress: HomeAddress;
+};
+export declare const LEARNING_CHECKPOINT_STATUSES: readonly ["pending", "remembered", "skipped", "failed"];
+export type LearningCheckpointStatus = typeof LEARNING_CHECKPOINT_STATUSES[number];
+export declare const LearningCheckpointSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    turn: z.ZodNumber;
+    homeAddress: z.ZodString;
+    reason: z.ZodLiteral<"explicit-correction">;
+    status: z.ZodEnum<{
+        pending: "pending";
+        failed: "failed";
+        remembered: "remembered";
+        skipped: "skipped";
+    }>;
+    evidenceRef: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"session-events">;
+        sessionId: z.ZodString;
+        fromSeq: z.ZodNumber;
+        toSeq: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"worklog">;
+        sessionId: z.ZodString;
+        revisionId: z.ZodString;
+        fingerprint: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool-result">;
+        sessionId: z.ZodString;
+        eventSeq: z.ZodNumber;
+        toolCallId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"artifact">;
+        uri: z.ZodString;
+        digest: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"document">;
+        uri: z.ZodString;
+        digest: z.ZodString;
+        authority: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"asset">;
+        ownerAddress: z.ZodString;
+        assetId: z.ZodString;
+        revision: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"user-confirmation">;
+        sessionId: z.ZodString;
+        eventSeq: z.ZodNumber;
+    }, z.core.$strip>], "type">;
+    excerpt: z.ZodString;
+    assetId: z.ZodOptional<z.ZodString>;
+    decision: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    settledAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type LearningCheckpoint = z.infer<typeof LearningCheckpointSchema> & {
+    homeAddress: HomeAddress;
+};
+export interface ContextBudget {
+    identityMaxBytes: number;
+    indexMaxBytes: number;
+}
+export declare function parseHomeAddress(value: string): HomeAddress;
+export declare function parseInboxAddress(value: string): InboxAddress;
+export declare function isUserAddress(value: string): value is UserAddress;
+export declare function isHomeAddress(value: string): value is HomeAddress;
+export declare function isProjectSeatAddress(value: string): value is ProjectSeatAddress;
+export declare function parseUserAddress(value: string): UserAddress;
+export declare function homeTypeOf(address: HomeAddress): HomeType;
+export declare function stableId(prefix: string, value: string): string;
+export declare function safeHomeId(address: HomeAddress): string;
+export declare function nowIso(): string;