youmd 0.11.0 → 0.13.0

package/dist/lib/api.d.ts

@@ -2,7 +2,9 @@
  * API client for communicating with the You.md Convex backend.
  * Uses the HTTP action endpoints at the Convex site URL.
  */
-import type { ProjectBrainContentPayload, ProjectBrainScan } from "./brain";
+import type { ProjectBrainApprovalVerificationKey, ProjectBrainContentPayload, ProjectBrainScan } from "./brain";
+import type { ProjectVisionIndex } from "./brain/vision";
+import type { PortableSessionCheckpoint } from "./sessionCheckpoint";
 export interface ApiResponse<T = unknown> {
     ok: boolean;
     status: number;
@@ -18,6 +20,53 @@ export interface RealtimeSyncSession {
     canReadVaultMetadata: boolean;
     secretValuesExposed: false;
 }
+export interface ConversationProofSession {
+    sessionId: string;
+    surface: string;
+    projectRef: string;
+    taskRef: string | null;
+    titleSha256: string | null;
+    archived: boolean;
+    messageCount: number;
+    attachmentCount: number;
+    createdAt: number;
+    updatedAt: number;
+    lastMessageAt: number;
+}
+export interface ConversationProofMessage {
+    messageId: string;
+    role: string;
+    ordinal: number;
+    contentSha256: string;
+    createdAt: number | null;
+    updatedAt: number | null;
+}
+export interface ConversationProofAttachment {
+    attachmentId: string;
+    messageId: string;
+    ordinal: number;
+    nameSha256: string;
+    mimeType: string;
+    sizeBytes: number;
+    width: number | null;
+    height: number | null;
+    sha256: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Secret-safe, owner-scoped evidence that one durable conversation is
+ * identical across clients. Message content, attachment bytes, storage ids,
+ * and download URLs are deliberately absent from this contract.
+ */
+export interface ConversationProof {
+    schema: "you-md/conversation-proof/v1";
+    version: 1;
+    session: ConversationProofSession;
+    messages: ConversationProofMessage[];
+    attachments: ConversationProofAttachment[];
+    revision: string;
+}
 /**
  * Extract the server's error message from a failed response payload.
  * Error responses are JSON objects with an `error` field regardless of the
@@ -49,6 +98,7 @@ export declare function createRealtimeSyncSession(options?: {
     clientName?: string;
     ttlSeconds?: number;
 }): Promise<ApiResponse<RealtimeSyncSession>>;
+export declare function getConversationProof(sessionId: string): Promise<ApiResponse<ConversationProof>>;
 export interface AgentBusMessage {
     id?: string;
     messageId: string;
@@ -132,6 +182,242 @@ export declare function listAgentBusMessages(opts?: {
     since?: number;
     limit?: number;
 }): Promise<ApiResponse<AgentBusMessagesResponse>>;
+export interface AgentSessionSnapshot {
+    id: string;
+    sessionKey: string;
+    runtime: string;
+    nativeSessionId: string | null;
+    machineHostname: string;
+    machineRef: string | null;
+    workspacePath: string | null;
+    projectSlug: string | null;
+    repoFullName: string | null;
+    branch: string | null;
+    title: string | null;
+    contextSummary: string | null;
+    resumeHint: string | null;
+    gitState: {
+        dirtyFiles?: number;
+        ahead?: number;
+        behind?: number;
+        lastCommit?: string;
+    } | null;
+    status: string;
+    claimedByHost: string | null;
+    claimedAt: number | null;
+    lastEventAt: number;
+    createdAt: number;
+    updatedAt: number;
+    checkpoint?: PortableSessionCheckpoint | null;
+    secretValuesExposed: false;
+}
+export declare function publishAgentSession(payload: {
+    sessionKey: string;
+    runtime: string;
+    machineHostname: string;
+    nativeSessionId?: string;
+    machineRef?: string;
+    workspacePath?: string;
+    projectSlug?: string;
+    repoFullName?: string;
+    branch?: string;
+    title?: string;
+    contextSummary?: string;
+    resumeHint?: string;
+    gitState?: {
+        dirtyFiles?: number;
+        ahead?: number;
+        behind?: number;
+        lastCommit?: string;
+    };
+    status?: string;
+    lastEventAt?: number;
+    checkpoint?: PortableSessionCheckpoint;
+}): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/agent-session/v1";
+    session: AgentSessionSnapshot;
+    secretValuesExposed: false;
+}>>;
+export declare function listAgentSessions(opts?: {
+    status?: string;
+    machine?: string;
+    includeClosed?: boolean;
+    limit?: number;
+}): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/agent-sessions/v1";
+    sessions: AgentSessionSnapshot[];
+    count: number;
+    secretValuesExposed: false;
+}>>;
+export declare function claimAgentSession(payload: {
+    sessionKey: string;
+    claimedByHost?: string;
+    close?: boolean;
+}): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/agent-session/v1";
+    session: AgentSessionSnapshot;
+    secretValuesExposed: false;
+}>>;
+export interface FounderOverviewResponse {
+    success: boolean;
+    schemaVersion: "you-md/founder-overview/v1";
+    overview: Record<string, unknown>;
+    secretValuesExposed: false;
+}
+export declare function getFounderOverview(): Promise<ApiResponse<FounderOverviewResponse>>;
+export interface BusinessOverviewProject {
+    slug: string;
+    name: string;
+    weeklyFocus: string | null;
+    weeklyIntent: string | null;
+    repoFullName: string | null;
+    [key: string]: unknown;
+}
+export interface BusinessOverviewEntry {
+    slug: string;
+    name: string;
+    tagline: string | null;
+    stage: string;
+    rootContextRepo: string | null;
+    rootContextPath: string | null;
+    revenueCurrency: string;
+    projects: BusinessOverviewProject[];
+    latestRevenue: Record<string, {
+        mrr: number | null;
+        revenue: number | null;
+        currency: string;
+    }>;
+    [key: string]: unknown;
+}
+export interface BusinessesOverviewResponse {
+    success: boolean;
+    schemaVersion: "you-md/businesses-overview/v1";
+    businesses: BusinessOverviewEntry[];
+    ungroupedProjects: BusinessOverviewProject[];
+    secretValuesExposed: false;
+}
+export declare function getBusinessesOverview(): Promise<ApiResponse<BusinessesOverviewResponse>>;
+export declare function upsertBusinessRecord(payload: {
+    slug: string;
+    rootContextRepo?: string;
+    rootContextPath?: string;
+}): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/business/v1";
+    business: Record<string, unknown>;
+    secretValuesExposed: false;
+}>>;
+export declare function connectBusinessStripe(payload: {
+    businessSlug: string;
+    apiKey?: string;
+    disconnect?: boolean;
+}): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/stripe-connection/v1";
+    businessSlug: string;
+    keyPrefix?: string;
+    livemode?: boolean;
+    rotated?: boolean;
+    disconnected?: boolean;
+    secretValuesExposed: false;
+}>>;
+export declare function syncBusinessStripe(): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/stripe-sync/v1";
+    summary: {
+        attempted: number;
+        succeeded: number;
+        failed: number;
+        results: Array<{
+            businessSlug: string;
+            ok: boolean;
+            mrr?: number;
+            revenue?: number;
+            error?: string;
+        }>;
+    };
+    secretValuesExposed: false;
+}>>;
+export declare function migrateFounderPortfolio(): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/founder-portfolio-migration/v1";
+    migration: Record<string, unknown>;
+    secretValuesExposed: false;
+}>>;
+export interface ContextReconcilerSchedule {
+    enabled: boolean;
+    cadenceMinutes: number;
+    nextRunAt: number;
+    quietHoursStartMinute: number | null;
+    quietHoursEndMinute: number | null;
+    timezone: string | null;
+    monthlyCostCapUsd: number;
+    monthSpendBucket?: string | null;
+    monthCostUsd?: number;
+    modelPolicy?: string;
+    lastRunAt?: number | null;
+    lastRunRef?: string | null;
+    lastResult?: string | null;
+}
+export interface ContextReconcilerStatusResponse {
+    success: boolean;
+    schemaVersion: "you-md/context-reconciler-status/v1";
+    status: Record<string, unknown> & {
+        schedule?: ContextReconcilerSchedule | null;
+    };
+    secretValuesExposed: false;
+}
+export declare function getContextReconcilerStatus(): Promise<ApiResponse<ContextReconcilerStatusResponse>>;
+export declare function runContextReconciliation(payload: {
+    holderRef: string;
+    machineRef: string;
+}): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/context-reconciliation-run/v1";
+    result: Record<string, unknown>;
+    secretValuesExposed: false;
+}>>;
+export declare function getContextReconcilerSchedule(): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/context-reconciler-schedule/v1";
+    schedule: ContextReconcilerSchedule | null;
+    secretValuesExposed: false;
+}>>;
+export declare function updateContextReconcilerSchedule(payload: {
+    enabled: boolean;
+    cadenceMinutes?: number;
+    nextRunAt?: number;
+    quietHoursStartMinute?: number;
+    quietHoursEndMinute?: number;
+    timezone?: string;
+    monthlyCostCapUsd?: number;
+}): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/context-reconciler-schedule/v1";
+    schedule: ContextReconcilerSchedule;
+    secretValuesExposed: false;
+}>>;
+export declare function publishSessionCheckpoint(checkpoint: PortableSessionCheckpoint): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/session-checkpoint/v1";
+    checkpoint: PortableSessionCheckpoint;
+    created: boolean;
+    secretValuesExposed: false;
+}>>;
+export declare function listSessionCheckpoints(options?: {
+    projectRef?: string;
+    sessionRef?: string;
+    limit?: number;
+}): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/session-checkpoints/v1";
+    checkpoints: PortableSessionCheckpoint[];
+    count: number;
+    secretValuesExposed: false;
+}>>;
 export declare function recordBrainActivity(payload: BrainActivityPayload): Promise<ApiResponse<{
     success: boolean;
     schemaVersion: "you-md/brain-activity/v1";
@@ -200,6 +486,78 @@ export declare function listRemoteCommands(opts?: {
     commands: RemoteCommandRecord[];
     count: number;
 }>>;
+export type RemoteAgentEventKind = "started" | "progress" | "waiting" | "needs_input" | "completed" | "failed" | "stopped";
+export type RemoteAgentEventStatus = "active" | "idle" | "waiting" | "blocked" | "done" | "error";
+export type RemoteScreenCaptureState = "unavailable" | "disabled" | "permission_required" | "denied" | "error";
+export interface RemoteAgentEventRecord {
+    id: string;
+    eventId: string;
+    hostKey: string;
+    hostName: string;
+    agentId: string;
+    agentName: string;
+    projectSlug: string | null;
+    sessionId: string;
+    kind: RemoteAgentEventKind;
+    status: RemoteAgentEventStatus;
+    summary: string;
+    detail: string | null;
+    sourceRuntime: string | null;
+    consent: {
+        eventStream: true;
+        source: string;
+    };
+    screenCapture: {
+        state: RemoteScreenCaptureState;
+        frame: null;
+    };
+    occurredAt: number;
+    expiresAt: number;
+    createdAt: number;
+    secretValuesExposed: false;
+}
+export declare function publishRemoteAgentEvent(payload: {
+    eventId: string;
+    hostKey: string;
+    hostName: string;
+    agentId: string;
+    agentName: string;
+    projectSlug?: string;
+    sessionId: string;
+    kind: RemoteAgentEventKind;
+    status: RemoteAgentEventStatus;
+    sourceRuntime?: string;
+    consent: {
+        eventStream: true;
+        source: string;
+    };
+    screenCaptureState?: RemoteScreenCaptureState;
+    occurredAt?: number;
+    expiresAt?: number;
+}): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/remote-agent-event/v1";
+    event: RemoteAgentEventRecord;
+    secretValuesExposed: false;
+}>>;
+export declare function listRemoteAgentEvents(opts?: {
+    hostKey?: string;
+    hostName?: string;
+    sessionId?: string;
+    projectSlug?: string;
+    since?: number;
+    limit?: number;
+}): Promise<ApiResponse<{
+    success: boolean;
+    schemaVersion: "you-md/remote-agent-events/v1";
+    events: RemoteAgentEventRecord[];
+    count: number;
+    screenCapture: {
+        state: "unavailable";
+        reason: string;
+    };
+    secretValuesExposed: false;
+}>>;
 export interface DeviceStartData {
     deviceCode: string;
     userCode: string;
@@ -386,6 +744,7 @@ export interface PortfolioTaskPayload {
     projectSlug?: string;
     title: string;
     description?: string;
+    verify?: string;
     goal?: string;
     successCriteria?: string;
     parentId?: string;
@@ -408,6 +767,23 @@ export interface PortfolioTaskPayload {
 }
 export interface PortfolioWriteResult {
     success: boolean;
+    accepted?: boolean;
+    authority?: "repository" | "convex";
+    applyRequired?: boolean;
+    proposal?: {
+        proposalId: string;
+        proposalRef: string;
+        mutationRef: string;
+        status: string;
+        filesystemApplied: false;
+    };
+    taskProposals?: Array<{
+        proposalId: string;
+        proposalRef: string;
+        mutationRef: string;
+        status: string;
+        filesystemApplied: false;
+    }>;
     taskId?: string;
     captureId?: string;
     taskIds?: string[];
@@ -439,6 +815,7 @@ export interface PortfolioTaskUpdatePayload {
     projectSlug?: string | null;
     title?: string;
     description?: string | null;
+    verify?: string | null;
     goal?: string | null;
     successCriteria?: string | null;
     parentId?: string | null;
@@ -1301,9 +1678,23 @@ export interface ProjectBrainContentUploadResponse {
     }>;
     secretValuesExposed: false;
 }
+/** Read one hosted, revision-bound Vision Artifact reference index. */
+export declare function getHostedProjectVision(project: string): Promise<ApiResponse<ProjectVisionIndex>>;
+export interface ProjectBrainApprovalKeySet {
+    schemaVersion: "you-md/project-brain-approval-jwks/v1";
+    keys: ProjectBrainApprovalVerificationKey[];
+    cacheMaxAgeSeconds: 300;
+    approvalMaxAgeSeconds: 900;
+    minimumRotationOverlapSeconds: 1200;
+    secretValuesExposed: false;
+}
+/** Public verification material for exact hosted Project Brain approvals. */
+export declare function getProjectBrainApprovalVerificationKeys(options?: {
+    refresh?: boolean;
+}): Promise<ApiResponse<ProjectBrainApprovalKeySet>>;
 export declare function uploadProjectBrainSnapshot(snapshot: ProjectBrainScan): Promise<ApiResponse<ProjectBrainSnapshotUploadResponse>>;
 export declare function uploadProjectBrainArtifactContents(payload: ProjectBrainContentPayload): Promise<ApiResponse<ProjectBrainContentUploadResponse>>;
-export type ProjectBrainApplyCapability = "managed_write" | "task_write";
+export type ProjectBrainApplyCapability = "descriptor_adopt" | "managed_write" | "task_write";
 export type ProjectBrainApplyStatus = "claimed" | "applying" | "applied" | "rollback_failed" | "manual_recovery_required";
 export type ProjectBrainApplyFailureCode = "safe_open_failed" | "stale_base" | "encryption_unavailable" | "write_failed" | "verification_failed" | "rollback_failed" | "manual_recovery_required" | "unknown";
 export interface ProjectBrainApplyBinding {