@ours.network/sdk 0.1.1

package/dist/inbox.d.ts

@@ -0,0 +1,38 @@
+export type EncryptionType = 'legacy' | 'e2e';
+export declare function e2eWireIdsFromEvents(events: Array<Record<string, unknown>>): Set<string>;
+export declare function encryptionFor(wireId: string | undefined | null, e2eWireIds: Set<string>): EncryptionType;
+export type MessageJson = {
+    msg_id: number;
+    wire_id: string;
+    from: {
+        id: string;
+        name: string;
+    };
+    encryption: EncryptionType;
+    transport: 'double_ratchet' | 'legacy_box';
+    text: string;
+    date: string;
+    status: string;
+    reply_to: {
+        wire_id: string;
+        sentence?: number;
+    } | null;
+};
+export type InboxLike = {
+    msg_id: number;
+    sender_id: string;
+    sender_name: string;
+    text: string;
+    date: string;
+    status: string;
+    wire_id: string;
+    reply_to: {
+        wire_id: string;
+        sentence?: number;
+    } | null;
+};
+export declare function toMessageJson(m: InboxLike, e2eWireIds: Set<string>): MessageJson;
+export declare function buildMessagesPayload(msgs: InboxLike[], e2eWireIds: Set<string>): {
+    count: number;
+    messages: MessageJson[];
+};

package/dist/inbox.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a,b,c,d}from"./chunk-LKFYUCN7.js";export{d as buildMessagesPayload,a as e2eWireIdsFromEvents,b as encryptionFor,c as toMessageJson};

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './errors.js';
+export type * from './api/types.js';
+export * from './api/identity.js';
+export * from './api/contacts.js';
+export * from './api/messaging.js';
+export * from './api/files.js';
+export * from './api/profile.js';
+export * from './client/http.js';
+export * from './version-advisory.js';
+export { FILE_SELECTION_CAP } from './identity/model.js';
+export * from './events.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a as Oo}from"./chunk-TZBRSDND.js";import{a as Po}from"./chunk-5EWCIQH6.js";import{a as oo,b as ro,c as po,d as eo,e as to,f as fo,g as mo,h as xo,i as Eo,j as so}from"./chunk-KZMPGVQM.js";import{a as yo,b as Co,c as Io}from"./chunk-AJQIWYXG.js";import{a as Lo,b as _o,c as ao,d as io,e as jo}from"./chunk-NSPYN5TT.js";import"./chunk-VW2KWXSJ.js";import{a as Ao,b as Fo,c as No}from"./chunk-3DQSMLVZ.js";import{a as K,b as M,c as Q,d as R,e as U,f as V,g as W,h as X,i as Y,j as Z,k as $}from"./chunk-7UUFYO6G.js";import{A as q,B as u,C as v,D as w,E as z,F as B,G as D,H as G,I as H,J,a as x,b as E,c as s,d as y,e as C,f as I,g as L,h as _,i as a,j as i,k as j,l as A,m as F,n as N,o as O,p as P,q as S,r as T,s as b,t as c,u as d,v as g,w as h,x as k,y as l,z as n}from"./chunk-UM73BGFH.js";import"./chunk-NMYSFQBL.js";import"./chunk-VOYMK2OO.js";import"./chunk-T25JIPX5.js";import"./chunk-HCIVLHKC.js";import"./chunk-NQQ4GSVI.js";import"./chunk-X4RVJ5VL.js";import"./chunk-DIRW7I4S.js";import"./chunk-YRPUM6JG.js";import"./chunk-LKFYUCN7.js";import"./chunk-P55RJGZU.js";import"./chunk-RAGUBE4Y.js";import{u as o}from"./chunk-Q3UVLSCX.js";import"./chunk-HSVIKO4D.js";import"./chunk-ZHH3PWEW.js";import"./chunk-IB2U7K6Y.js";import{a as r,b as p,c as e,d as t,e as f,f as m}from"./chunk-UJGRFV4J.js";export{o as FILE_SELECTION_CAP,Oo as OursClient,x as OursError,r as VETOABLE_EVENTS,eo as addContact,Fo as advertiseMigrate,W as chooseIdentity,R as closeTemporaryIdentityOp,M as createIdentity,U as createRootIdentity,Q as createTemporaryIdentity,Y as currentIdentity,jo as deferMessages,V as defineLocalIdentityFile,f as emitDaemonEvent,m as emitDaemonNotification,s as errBindingReassigned,c as errBoundElsewhere,y as errBoundIdentityGone,G as errDuplicateId,v as errFileUnreadable,g as errIdentityClosedWithError,k as errIdentityPartiallyRemoved,B as errInvalidSelection,D as errMalformedId,I as errNameTaken,L as errNoLeaseHeaders,P as errNoLeaseToken,n as errNoPolicyArgs,z as errNoRoot,O as errNoSuchIdentity,E as errNotBound,i as errNotBoundNoName,j as errNotTemporary,N as errPathNotAbsolute,l as errPublicInviteNamed,_ as errRandomNameExhausted,a as errRootExists,h as errRootHasRoles,w as errSaveFileFallback,q as errSendFileArgs,u as errSendFileFilenameRequired,F as errTempClosedWithError,C as errTempClosingBound,S as errTempClosingChoose,A as errTempOwnedElsewhereClose,d as errTempOwnedElsewhereRemove,T as errTempOwnedLive,b as errTempStale,J as errTool,H as errUnknownOrStaleId,Po as formatVersionAdvisory,oo as generateInvite,Co as getFiles,io as getMessages,t as isDefaultHandler,to as listContacts,X as listIdentities,yo as listIncomingFiles,ao as listIncomingMessages,ro as listInvites,fo as listLocalContactBook,$ as releaseLease,xo as removeContact,Z as removeIdentity,Eo as renameContact,K as requireBound,e as resetDaemonEventHandlers,so as respondToIntroduction,po as revokeInvite,Io as saveFileFallbackNotice,_o as sendFile,Lo as sendMessage,Ao as setBio,p as setDaemonEventHandler,mo as setLocalBookPolicy,No as setPersona};

package/dist/messaging/send.d.ts

@@ -0,0 +1,28 @@
+import type { AdaptValue } from '@adapt-toolkit/sdk/backend';
+import { type Identity } from '../identity/model.js';
+export declare function findSibling(id: Identity, contact: string): Identity | null;
+export declare function sendViaSibling(id: Identity, target: Identity, text: string): Promise<string>;
+export declare function sendViaLocalBook(id: Identity, contact: string, text: string): Promise<string>;
+export type SendVerdict = {
+    kind: 'refused';
+    wireId: string;
+    cid: string;
+} | {
+    kind: 'migrating';
+    wireId: string;
+    cid: string;
+    queued: number;
+} | {
+    kind: 'e2e';
+    wireId: string;
+    cid: string;
+    notRetained?: boolean;
+} | {
+    kind: 'deferred';
+    wireId: string;
+    queued: number;
+} | {
+    kind: 'sent';
+    wireId: string;
+};
+export declare const parseSendVerdict: (sent: AdaptValue) => SendVerdict;

package/dist/messaging/send.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a,b,c,d}from"../chunk-VW2KWXSJ.js";import"../chunk-HCIVLHKC.js";import"../chunk-NQQ4GSVI.js";import"../chunk-X4RVJ5VL.js";import"../chunk-DIRW7I4S.js";import"../chunk-YRPUM6JG.js";import"../chunk-LKFYUCN7.js";import"../chunk-P55RJGZU.js";import"../chunk-RAGUBE4Y.js";import"../chunk-Q3UVLSCX.js";import"../chunk-HSVIKO4D.js";import"../chunk-ZHH3PWEW.js";import"../chunk-IB2U7K6Y.js";import"../chunk-UJGRFV4J.js";export{a as findSibling,d as parseSendVerdict,c as sendViaLocalBook,b as sendViaSibling};

package/dist/mufl/handlers.d.ts

@@ -0,0 +1,5 @@
+import type { Identity } from '../identity/model.js';
+export interface WireHooks {
+    onNotify(identityName: string, summary: string): void;
+}
+export declare function wireHandlers(id: Identity, hooks: WireHooks): void;

package/dist/mufl/handlers.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{v as a}from"../chunk-NQQ4GSVI.js";import"../chunk-X4RVJ5VL.js";import"../chunk-DIRW7I4S.js";import"../chunk-YRPUM6JG.js";import"../chunk-LKFYUCN7.js";import"../chunk-P55RJGZU.js";import"../chunk-RAGUBE4Y.js";import"../chunk-Q3UVLSCX.js";import"../chunk-HSVIKO4D.js";import"../chunk-ZHH3PWEW.js";import"../chunk-IB2U7K6Y.js";import"../chunk-UJGRFV4J.js";export{a as wireHandlers};

package/dist/mufl/tx.d.ts

@@ -0,0 +1,9 @@
+import { AdaptObjectLifetime } from '@adapt-toolkit/sdk/common';
+import type { AdaptValue } from '@adapt-toolkit/sdk/backend';
+import type { Identity } from '../identity/model.js';
+export declare function withScope<T>(fn: (lt: AdaptObjectLifetime) => T): T;
+export declare function withScopeAsync<T>(fn: (lt: AdaptObjectLifetime) => Promise<T>): Promise<T>;
+export declare function readonlyTx(id: Identity, name: string, lt?: AdaptObjectLifetime): AdaptValue;
+export declare function withLock<T>(id: Identity, fn: () => Promise<T>): Promise<T>;
+export declare function enqueueMutation(id: Identity, envelope: AdaptValue, timeoutMs?: number): Promise<AdaptValue>;
+export declare function mutatingTx(id: Identity, name: string, targ: unknown, lt?: AdaptObjectLifetime, timeoutMs?: number): Promise<AdaptValue>;

package/dist/mufl/tx.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{E as a,F as b,G as c,H as d,I as e,J as f}from"../chunk-NQQ4GSVI.js";import"../chunk-X4RVJ5VL.js";import"../chunk-DIRW7I4S.js";import"../chunk-YRPUM6JG.js";import"../chunk-LKFYUCN7.js";import"../chunk-P55RJGZU.js";import"../chunk-RAGUBE4Y.js";import"../chunk-Q3UVLSCX.js";import"../chunk-HSVIKO4D.js";import"../chunk-ZHH3PWEW.js";import"../chunk-IB2U7K6Y.js";import"../chunk-UJGRFV4J.js";export{e as enqueueMutation,f as mutatingTx,c as readonlyTx,d as withLock,a as withScope,b as withScopeAsync};

package/dist/notify.d.ts

@@ -0,0 +1,24 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { AdaptValue } from '@adapt-toolkit/sdk/backend';
+import { type Identity } from './identity/model.js';
+import type { WireHooks } from './mufl/handlers.js';
+export type NotifyHook = (identityName: string, summary: string) => void;
+export declare function setNotifyHook(fn: NotifyHook | null): void;
+export declare function clearNotifyHook(fn: NotifyHook): void;
+export declare function fireNotify(identityName: string, summary: string): void;
+export declare const notifyHooks: WireHooks;
+export declare function fireNotifyWaiters(name: string): void;
+export declare function waitForNotify(name: string, ms: number): Promise<void>;
+export declare function appendNotifyLog(id: Identity, event: Record<string, unknown>): void;
+export declare function readE2eWireIds(id: Identity): Set<string>;
+export declare function binHexField(av: AdaptValue, field: string): string;
+export declare function notifyLogSize(logPath: string): number;
+export declare function readNotifyRange(logPath: string, from: number, to: number): {
+    events: Record<string, unknown>[];
+    cursor: number;
+};
+export declare function serveNotifications(req: IncomingMessage, res: ServerResponse, name: string, sinceParam: string | null): Promise<void>;
+export declare function refreshUnread(id: Identity): void;
+export declare function unreadSummary(): {
+    identities: Array<Record<string, unknown>>;
+};

package/dist/notify.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a,b,c,d,e,f,g,h,i,j,k,l,m,n}from"./chunk-NQQ4GSVI.js";import"./chunk-X4RVJ5VL.js";import"./chunk-DIRW7I4S.js";import"./chunk-YRPUM6JG.js";import"./chunk-LKFYUCN7.js";import"./chunk-P55RJGZU.js";import"./chunk-RAGUBE4Y.js";import"./chunk-Q3UVLSCX.js";import"./chunk-HSVIKO4D.js";import"./chunk-ZHH3PWEW.js";import"./chunk-IB2U7K6Y.js";import"./chunk-UJGRFV4J.js";export{g as appendNotifyLog,i as binHexField,b as clearNotifyHook,c as fireNotify,e as fireNotifyWaiters,d as notifyHooks,j as notifyLogSize,h as readE2eWireIds,k as readNotifyRange,m as refreshUnread,l as serveNotifications,a as setNotifyHook,n as unreadSummary,f as waitForNotify};

package/dist/process-state.d.ts

@@ -0,0 +1,2 @@
+export declare function linuxProcState(stat: string): string | null;
+export declare function linuxProcHasExited(stat: string): boolean;

package/dist/process-state.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+function e(n){let t=n.lastIndexOf(")");if(t<0)return null;let r=n.slice(t+1).trimStart();return/^[A-Za-z](?:\s|$)/.test(r)?r[0]:null}function s(n){let t=e(n);return t==="Z"||t==="X"||t==="x"}export{s as linuxProcHasExited,e as linuxProcState};

package/dist/protocol.d.ts

@@ -0,0 +1 @@
+export declare const OURS_COMPAT_VERSION = 1;

package/dist/protocol.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a}from"./chunk-37D5PCFY.js";export{a as OURS_COMPAT_VERSION};

package/dist/render/adapt-to-json.d.ts

@@ -0,0 +1,83 @@
+import type { AdaptValue } from '@adapt-toolkit/sdk/backend';
+import { type Identity } from '../identity/model.js';
+import { type StructuredVoiceOutcome } from '../transcribe.js';
+export declare function renderContacts(v: AdaptValue): Array<{
+    name: string;
+    container_id: string;
+}>;
+export declare function renderImportRenames(v: AdaptValue): Record<string, string>;
+export type ReplyRef = {
+    wire_id: string;
+    sentence?: number;
+};
+export type InboxMsg = {
+    msg_id: number;
+    sender_id: string;
+    sender_name: string;
+    text: string;
+    date: string;
+    status: string;
+    wire_id: string;
+    reply_to: ReplyRef | null;
+};
+export declare function renderInbox(v: AdaptValue): InboxMsg[];
+export type FileReplyRef = {
+    wire_id: string;
+    sentence?: number;
+};
+export type IncomingFileMeta = {
+    file_id: number;
+    wire_id: string;
+    from: {
+        id: string;
+        name: string;
+    };
+    filename: string;
+    mime: string;
+    size: number;
+    size_source: 'received_payload';
+    status: string;
+    date: string;
+    sha256: null;
+    reply_to: FileReplyRef | null;
+    kind: 'file' | 'voice_message';
+};
+export declare function renderFileMetadata(v: AdaptValue): IncomingFileMeta[];
+export declare function renderFiles(files: IncomingFileMeta[]): string;
+export type ReceivedFileMeta = {
+    file_id: number;
+    wire_id: string;
+    from: {
+        id: string;
+        name: string;
+    };
+    filename: string;
+    path: string;
+    mime: string;
+    size: number;
+    sha256: string;
+    status: 'processed';
+    date: string;
+    kind: 'file' | 'voice_message';
+    transcription?: StructuredVoiceOutcome;
+    sender: string;
+};
+export declare function writeIncomingFiles(id: Identity, v: AdaptValue): Promise<{
+    text: string;
+    files: ReceivedFileMeta[];
+}>;
+export declare function renderPending(v: AdaptValue): Array<{
+    container_id: string;
+    name: string;
+    queued: number;
+}>;
+export type ContactRoot = {
+    root_cid: string;
+    root_name: string;
+    role_id: string;
+};
+export declare function renderContactRoots(v: AdaptValue): Record<string, ContactRoot>;
+export declare function fmtContactRoot(r: ContactRoot | undefined): string;
+export declare function encodeWireBin(raw: Buffer): string;
+export declare function decodeWireBin(s: string): Buffer;
+export declare function adaptValueToJson(v: AdaptValue, fieldKey?: string): unknown;

package/dist/render/adapt-to-json.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a,b,c,d,e,f,g,h,i,j,k,l}from"../chunk-X4RVJ5VL.js";import"../chunk-DIRW7I4S.js";import"../chunk-P55RJGZU.js";import"../chunk-Q3UVLSCX.js";import"../chunk-HSVIKO4D.js";import"../chunk-ZHH3PWEW.js";import"../chunk-IB2U7K6Y.js";export{l as adaptValueToJson,k as decodeWireBin,j as encodeWireBin,i as fmtContactRoot,h as renderContactRoots,a as renderContacts,d as renderFileMetadata,e as renderFiles,b as renderImportRenames,c as renderInbox,g as renderPending,f as writeIncomingFiles};

package/dist/runtime/env.d.ts

@@ -0,0 +1,18 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type StartupProgressReporter } from '../startup-progress';
+export declare const VERSION: string;
+export declare const CONFIG: import("../config").OursConfig;
+export declare const STATE_DIR: string;
+export declare const BROKER_URL: string;
+export declare const PORT: number;
+export declare const GC_INTERVAL_MS: number;
+export declare const API_VISIBILITY: import("../config").ApiVisibility;
+export declare const startupProgress: StartupProgressReporter | null;
+export declare const log: (...parts: unknown[]) => boolean;
+export declare const API_TOKEN: string | null;
+export declare function tokenFromReq(req: IncomingMessage): string | undefined;
+export declare function authOk(req: IncomingMessage): boolean;
+export declare function requireAuth(req: IncomingMessage, res: ServerResponse): boolean;
+export declare const NAME_RE: RegExp;
+export declare const BOOK_DIR_NAME = "contact-book";
+export declare function validateName(name: string): string | null;

package/dist/runtime/env.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p}from"../chunk-HSVIKO4D.js";import"../chunk-ZHH3PWEW.js";import"../chunk-IB2U7K6Y.js";export{j as API_TOKEN,g as API_VISIBILITY,o as BOOK_DIR_NAME,d as BROKER_URL,b as CONFIG,f as GC_INTERVAL_MS,n as NAME_RE,e as PORT,c as STATE_DIR,a as VERSION,l as authOk,i as log,m as requireAuth,h as startupProgress,k as tokenFromReq,p as validateName};

package/dist/runtime/unit.d.ts

@@ -0,0 +1,15 @@
+export declare function locateUnit(): {
+    dir: string;
+    hash: string;
+    contents: Uint8Array;
+};
+export declare let UNIT: {
+    dir: string;
+    hash: string;
+    contents: Uint8Array;
+};
+export declare function setUnit(u: {
+    dir: string;
+    hash: string;
+    contents: Uint8Array;
+}): void;

package/dist/runtime/unit.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a,b,c}from"../chunk-YRPUM6JG.js";export{b as UNIT,a as locateUnit,c as setUnit};

package/dist/sse-keepalive.d.ts

@@ -0,0 +1,18 @@
+import type { ServerResponse } from 'node:http';
+/** Default cadence: a 12x margin under the 300s inter-chunk timeout. */
+export declare const DEFAULT_SSE_KEEPALIVE_MS = 25000;
+/** The comment frame. Payload is irrelevant; being a flushed body chunk is the point. */
+export declare const KEEPALIVE_FRAME = ": ka\n\n";
+/** Resolve the interval from the environment. 0 (or negative) disables. */
+export declare function sseKeepaliveMs(env?: NodeJS.ProcessEnv): number;
+/**
+ * Emit keepalive comment frames on `res` once it becomes an SSE stream.
+ * No-op for non-SSE responses, and self-cancelling when the response ends.
+ *
+ * Detecting "is SSE" by wrapping writeHead is deliberate: res.getHeader() does
+ * NOT see headers passed as writeHead(status, obj) — it returns undefined,
+ * verified — and @hono/node-server (which the MCP SDK's Node wrapper uses) sets
+ * the SSE headers exactly that way. Reading them back would silently never match,
+ * leaving a keepalive that looks armed and never fires.
+ */
+export declare function armSseKeepalive(res: ServerResponse, intervalMs?: number): void;

package/dist/sse-keepalive.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a,b,c,d}from"./chunk-V64IUVSS.js";export{a as DEFAULT_SSE_KEEPALIVE_MS,b as KEEPALIVE_FRAME,d as armSseKeepalive,c as sseKeepaliveMs};

package/dist/startup-progress.d.ts

@@ -0,0 +1,54 @@
+export declare const STARTUP_PROGRESS_FILENAME = "startup-progress.json";
+export declare const STARTUP_PROGRESS_VERSION = 1;
+export type StartupPhase = 'initializing' | 'wrapper' | 'registrar' | 'identities' | 'reconciliation' | 'server' | 'ready' | 'failed';
+export interface StartupProgress {
+    version: typeof STARTUP_PROGRESS_VERSION;
+    pid: number;
+    bootId: string;
+    phase: StartupPhase;
+    completed?: number;
+    total?: number;
+    startedAt: number;
+    updatedAt: number;
+}
+export interface StartupProgressReporter {
+    update(phase: StartupPhase, counts?: {
+        completed: number;
+        total: number;
+    }): void;
+    ready(): void;
+    failed(): void;
+}
+export declare function startupProgressPath(stateDir: string): string;
+export declare function readStartupProgress(stateDir: string): StartupProgress | null;
+export declare function createStartupProgressReporter(stateDir: string, opts?: {
+    heartbeatMs?: number;
+    pid?: number;
+    now?: () => number;
+}): StartupProgressReporter;
+export declare function formatStartupProgress(progress: StartupProgress): string;
+export declare function renderStartupProgress(progress: StartupProgress, interactive: boolean): string;
+export type StartupWaitFailure = 'process-exited' | 'daemon-reported-failure' | 'inactivity-timeout' | 'absolute-timeout';
+export type StartupWaitResult = {
+    ok: true;
+    elapsedMs: number;
+    lastProgress: StartupProgress | null;
+} | {
+    ok: false;
+    reason: StartupWaitFailure;
+    elapsedMs: number;
+    lastProgress: StartupProgress | null;
+};
+export interface StartupWaitOptions {
+    pid: number;
+    absoluteMs: number;
+    inactivityMs: number;
+    pollMs: number;
+    isProcessAlive: () => boolean;
+    isReady: () => Promise<boolean>;
+    readProgress: () => StartupProgress | null;
+    onProgress?: (progress: StartupProgress) => void;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare function waitForStartup(opts: StartupWaitOptions): Promise<StartupWaitResult>;

package/dist/startup-progress.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a,b,c,d,e,f,g,h}from"./chunk-ZHH3PWEW.js";export{a as STARTUP_PROGRESS_FILENAME,b as STARTUP_PROGRESS_VERSION,e as createStartupProgressReporter,f as formatStartupProgress,d as readStartupProgress,g as renderStartupProgress,c as startupProgressPath,h as waitForStartup};

package/dist/state.d.ts

@@ -0,0 +1,5 @@
+import { type Identity } from './identity/model.js';
+export declare function ensureRegistrar(): Promise<void>;
+export declare function hasSavedState(dir: string): boolean;
+export declare function saveState(id: Identity): void;
+export declare function saveStateFailClosed(id: Identity): void;

package/dist/state.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{A as a,B as b,C as c,D as d}from"./chunk-NQQ4GSVI.js";import"./chunk-X4RVJ5VL.js";import"./chunk-DIRW7I4S.js";import"./chunk-YRPUM6JG.js";import"./chunk-LKFYUCN7.js";import"./chunk-P55RJGZU.js";import"./chunk-RAGUBE4Y.js";import"./chunk-Q3UVLSCX.js";import"./chunk-HSVIKO4D.js";import"./chunk-ZHH3PWEW.js";import"./chunk-IB2U7K6Y.js";import"./chunk-UJGRFV4J.js";export{a as ensureRegistrar,b as hasSavedState,c as saveState,d as saveStateFailClosed};

package/dist/sweeps.d.ts

@@ -0,0 +1,18 @@
+import type { AdaptValue } from '@adapt-toolkit/sdk/backend';
+import { type Identity } from './identity/model.js';
+export declare function renderDegraded(av: AdaptValue): Array<{
+    cid: string;
+    name: string;
+    attempts: number;
+    queued: number;
+}>;
+export declare function renderDeferredQueues(av: AdaptValue): Array<{
+    cid: string;
+    queued: number;
+    degraded: boolean;
+}>;
+export declare function flushDeferredFor(id: Identity, contactCid: string): Promise<void>;
+export declare function contactRestoreSweep(id: Identity): Promise<void>;
+export declare function capabilityReconcileSweep(id: Identity): Promise<void>;
+export declare function scheduleCapabilityReconcile(id: Identity): void;
+export declare function e2eRecoverySweep(id: Identity): Promise<void>;

package/dist/sweeps.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{o as a,p as b,q as c,r as d,s as e,t as f,u as g}from"./chunk-NQQ4GSVI.js";import"./chunk-X4RVJ5VL.js";import"./chunk-DIRW7I4S.js";import"./chunk-YRPUM6JG.js";import"./chunk-LKFYUCN7.js";import"./chunk-P55RJGZU.js";import"./chunk-RAGUBE4Y.js";import"./chunk-Q3UVLSCX.js";import"./chunk-HSVIKO4D.js";import"./chunk-ZHH3PWEW.js";import"./chunk-IB2U7K6Y.js";import"./chunk-UJGRFV4J.js";export{e as capabilityReconcileSweep,d as contactRestoreSweep,g as e2eRecoverySweep,c as flushDeferredFor,b as renderDeferredQueues,a as renderDegraded,f as scheduleCapabilityReconcile};

package/dist/transcribe.d.ts

@@ -0,0 +1,113 @@
+/**
+ * The exact mime parameter the panel puts on voice messages.
+ * SINGLE SOURCE OF TRUTH — any change must be coordinated with the panel send
+ * side (Designer-1); swapping it is a one-line change here.
+ */
+export declare const VOICE_MESSAGE_MIME_PARAM = "x-ours-kind=voice-message";
+/**
+ * Fallback marker (also panel-controlled): filename `voice-message-<UTCstamp>.<ext>`
+ * — only honoured when the base mime is audio/*.
+ */
+export declare const VOICE_MESSAGE_FILENAME_PREFIX = "voice-message-";
+/**
+ * Deterministic voice-message check for an incoming file.
+ * PRIMARY: case-insensitive `x-ours-kind=voice-message` among the mime
+ * parameters. FALLBACK: filename starts with `voice-message-` AND the base
+ * type is audio/*.
+ */
+export declare function isVoiceMessage(mime: string, filename: string): boolean;
+/** The real container type, with our marker (and any other params) stripped. */
+export declare function baseMime(mime: string): string;
+export declare const STT_PROVIDERS: readonly ["openai-compatible", "elevenlabs", "deepgram", "custom"];
+export type SttProvider = (typeof STT_PROVIDERS)[number];
+/** Request template for `provider: "custom"` — plugs in ANY provider via config. */
+export interface SttCustomTemplate {
+    /** Full endpoint URL; `{model}` is substituted when set. */
+    url: string;
+    /** HTTP method (default POST). */
+    method?: string;
+    /** Auth header name (default Authorization). */
+    authHeaderName?: string;
+    /** Auth header value; `{key}` is substituted (default `Bearer {key}`). */
+    authHeaderTemplate?: string;
+    /** How the audio travels (default multipart). */
+    bodyMode?: 'multipart' | 'raw' | 'json-base64';
+    /** Multipart / JSON field carrying the audio (default `file`). */
+    fileField?: string;
+    /** Field carrying the model; empty string = omit the field (default `model`). */
+    modelField?: string;
+    /** Extra constant fields to send alongside. */
+    extraFields?: Record<string, string>;
+    /** Dot-path to the transcript in the JSON response (default `text`); numeric segments index arrays. */
+    responseTextPath?: string;
+}
+/** User-facing config block (config.json `stt: {}` / OURS_STT_* env). No defaults for provider/model/key. */
+export interface SttUserConfig {
+    provider?: string;
+    apiKey?: string;
+    model?: string;
+    baseUrl?: string;
+    language?: string;
+    maxBytes?: number;
+    timeoutMs?: number;
+    custom?: SttCustomTemplate;
+}
+export declare const STT_MAX_BYTES_DEFAULT: number;
+export declare const STT_TIMEOUT_MS_DEFAULT = 60000;
+export type SttStatus = {
+    ready: true;
+    provider: SttProvider;
+} | {
+    ready: false;
+    reason: string;
+};
+/**
+ * Deterministic readiness check with a PRECISE operator-facing reason when not
+ * configured. Partial configuration never guesses.
+ */
+export declare function sttStatus(cfg: SttUserConfig | undefined): SttStatus;
+export type SttResult = {
+    ok: true;
+    text: string;
+} | {
+    ok: false;
+    error: string;
+};
+/** Dot-path lookup; numeric segments index arrays ("results.channels.0.…"). */
+export declare function textAtPath(obj: unknown, path: string): string | undefined;
+/**
+ * Transcribe a voice message. Callers must have checked sttStatus().ready.
+ * Never throws; never logs the key.
+ */
+export declare function transcribeVoice(bytes: Buffer, filename: string, mime: string, cfg: SttUserConfig): Promise<SttResult>;
+export type VoiceOutcome = {
+    kind: 'transcript';
+    text: string;
+} | {
+    kind: 'unconfigured';
+    reason: string;
+} | {
+    kind: 'failed';
+    error: string;
+};
+export type StructuredVoiceOutcome = {
+    configured: boolean;
+    attempted: boolean;
+    status: 'succeeded' | 'failed' | 'unavailable';
+    provider: SttProvider | null;
+    text: string | null;
+    error_category: 'not_configured' | 'size_limit' | 'timeout' | 'provider_http' | 'invalid_response' | 'provider_error' | null;
+    audio_path: string;
+    file_wire_id: string;
+};
+/** Stable, secret-free machine view paired with the existing human delivery line. */
+export declare function structuredVoiceOutcome(readiness: SttStatus, outcome: VoiceOutcome, association: {
+    audioPath: string;
+    wireId: string;
+}): StructuredVoiceOutcome;
+export declare function voiceDeliveryLine(args: {
+    sender: string;
+    wire: string;
+    savedPath: string;
+    sizeBytes: number;
+}, outcome: VoiceOutcome): string;

package/dist/transcribe.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a,b,c,d,e,f,g,h,i,j,k,l}from"./chunk-DIRW7I4S.js";export{f as STT_MAX_BYTES_DEFAULT,e as STT_PROVIDERS,g as STT_TIMEOUT_MS_DEFAULT,b as VOICE_MESSAGE_FILENAME_PREFIX,a as VOICE_MESSAGE_MIME_PARAM,d as baseMime,c as isVoiceMessage,k as structuredVoiceOutcome,h as sttStatus,i as textAtPath,j as transcribeVoice,l as voiceDeliveryLine};

package/dist/version-advisory.d.ts

@@ -0,0 +1,4 @@
+export declare function formatVersionAdvisory(args: {
+    selfVersion: string;
+    daemonVersion: string | null;
+}): string | null;

package/dist/version-advisory.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import{a}from"./chunk-5EWCIQH6.js";export{a as formatVersionAdvisory};

package/dist/voice-setup.d.ts

@@ -0,0 +1,44 @@
+export declare const VOICE_PROVIDER_CHOICES: readonly [{
+    readonly value: "openai-compatible";
+    readonly label: "OpenAI-compatible";
+    readonly detail: "an OpenAI-style /v1 transcription endpoint";
+}, {
+    readonly value: "elevenlabs";
+    readonly label: "ElevenLabs";
+    readonly detail: "ElevenLabs speech-to-text";
+}, {
+    readonly value: "deepgram";
+    readonly label: "Deepgram";
+    readonly detail: "Deepgram speech-to-text";
+}, {
+    readonly value: "custom";
+    readonly label: "Custom HTTP endpoint";
+    readonly detail: "a fully specified transcription URL";
+}];
+type JsonObject = Record<string, unknown>;
+type DaemonState = 'managed' | 'external' | 'stopped';
+type ApplyResult = {
+    ok: boolean;
+};
+export interface VoiceSetupOptions {
+    configFile: string;
+    env?: NodeJS.ProcessEnv;
+    dryRun?: boolean;
+    daemonState?: DaemonState;
+    apply?: () => Promise<ApplyResult> | ApplyResult;
+    stdout?: (text: string) => void;
+}
+export declare function atomicWriteVoiceConfig(path: string, config: JsonObject): void;
+export type VoiceConfigTransactionResult = {
+    ok: true;
+    stage: 'write' | 'apply';
+} | {
+    ok: false;
+    stage: 'write' | 'apply' | 'rollback';
+    rolledBack: boolean;
+    daemonRestored: boolean;
+};
+export declare function transactVoiceConfig(path: string, config: JsonObject, daemonState: DaemonState, apply?: () => Promise<ApplyResult> | ApplyResult): Promise<VoiceConfigTransactionResult>;
+export declare function runVoiceSetup(options: VoiceSetupOptions): Promise<number>;
+export declare const VOICE_SETUP_HELP = "ours-mcp voice-setup \u2014 configure voice transcription securely\n\nUsage: ours-mcp voice-setup [--dry-run]\n\nInteractively choose exactly one provider, collect provider-specific fields, and\nread the provider API key with hidden input. The key is never accepted as a CLI\nargument. Configuration is written atomically with mode 0600. When the managed\ndaemon is running, it is restarted and readiness-checked; a failure restores the\nexact prior config.\n\n  --dry-run  walk the prompts without writing config or restarting the daemon\n  --help     show this help and exit\n\nHeadless automation remains environment-driven through OURS_STT_PROVIDER,\nOURS_STT_API_KEY, OURS_STT_MODEL, OURS_STT_BASE_URL, and OURS_STT_LANGUAGE.\nExit 2 means restart/readiness failed after a write and rollback was attempted.";
+export {};