@zooid/transport-matrix 0.7.4 → 0.9.0

package/dist/index.d.ts

@@ -92,6 +92,9 @@ declare class MatrixClient {
         asUserId: string;
         targetUserId: string;
     }): Promise<void>;
+    leaveRoom(roomId: string, asUserId: string, opts?: {
+        reason?: string;
+    }): Promise<void>;
     joinRoom(roomIdOrAlias: string, asUserId: string): Promise<void>;
     sendMessage(input: SendMessageInput): Promise<{
         event_id: string;
@@ -221,7 +224,13 @@ interface AgentBinding {
      */
     rooms: RoomBinding[];
     trigger: 'mention' | 'any';
+    /** Host path of the agent's workspace (resolved agent.workdir). Media files land here. */
+    workspaceDir?: string;
+    /** Path prefix as the agent sees it: '/workspace' for containers, = workspaceDir for local. */
+    agentWorkspacePath?: string;
 }
+declare const MEDIA_MSGTYPES: Set<string>;
+declare function isMediaMsgtype(t: string | undefined): boolean;
 interface ThreadState {
     /** Agent names that have posted in this thread, in order. */
     participants: string[];
@@ -266,6 +275,36 @@ declare class BotPool {
     findByName(name: string): AgentBinding | undefined;
 }
 
+interface WriteAttachmentInput {
+    workspaceDir: string;
+    agentWorkspacePath: string;
+    eventId: string;
+    filename: string;
+    data: Uint8Array;
+}
+declare function writeAttachment(input: WriteAttachmentInput): {
+    hostPath: string;
+    agentPath: string;
+};
+
+interface MediaClientLike {
+    download(input: {
+        mxcUri: string;
+        asUserId: string;
+        maxBytes?: number;
+    }): Promise<{
+        data: Uint8Array;
+        contentType: string;
+    }>;
+    upload(input: {
+        data: Uint8Array;
+        contentType: string;
+        filename?: string;
+        asUserId: string;
+    }): Promise<{
+        content_uri: string;
+    }>;
+}
 interface CreateMatrixTransportOptions {
     agents: AcpRegistry;
     approvals: ApprovalCorrelator;
@@ -280,6 +319,14 @@ interface CreateMatrixTransportOptions {
     drainQuietMs?: number;
     /** Hard cap on the post-turn drain. Defaults to `DRAIN_MAX_MS`. */
     drainMaxMs?: number;
+    /** Injected media client for downloading/uploading Matrix media. */
+    media?: MediaClientLike;
+    /** Injected attachment writer (defaults to the real writeAttachment). */
+    writeAttachmentFn?: typeof writeAttachment;
+    /** AS sender-bot MXID (@<sender_localpart>:<server>). Together with the agent
+     *  bindings this forms the set of "our bot users" whose ad-hoc invites are
+     *  declined. */
+    botUserId?: string;
 }
 declare function createMatrixTransport(opts: CreateMatrixTransportOptions): {
     app: Hono<hono_types.BlankEnv, hono_types.BlankSchema, "/">;
@@ -304,6 +351,15 @@ interface EnsureSpaceOpts {
      * if the alias already resolves we return the existing room untouched.
      */
     admins?: string[];
+    /**
+     * Join rule pinned on the space at creation. Defaults to `invite`: a
+     * workspace is joined by invitation, not self-service, so it can't be walked
+     * into (which would otherwise satisfy every restricted child room's `allow`).
+     * `zooid dev` passes `public` so a self-service-registered local account can
+     * join `#<space>` straight from the web client without an invite — acceptable
+     * because the dev homeserver is local-only and never deployed.
+     */
+    joinRule?: 'invite' | 'public';
 }
 declare function ensureWorkforceSpace(opts: EnsureSpaceOpts): Promise<string>;
 interface EnsureDefaultChannelOpts {
@@ -359,4 +415,63 @@ interface StartOpts {
 }
 declare function startWorkforcePublisher(opts: StartOpts): Promise<PublisherHandle>;
 
-export { type AgentBinding, BotPool, type CreateMatrixTransportOptions, type EnsureDefaultChannelOpts, type EnsureSpaceOpts, MatrixClient, type MatrixClientOptions, MatrixContextProvider, type MatrixContextProviderOpts, type MatrixTransportConfig, type MaybeMessage, type PublishOpts, type PublisherHandle, type RouteMatch, type SendCustomEventInput, type SendMessageInput, type StartOpts as StartWorkforcePublisherOpts, type WorkforceRoster, buildWorkforceRoster, createMatrixTransport, ensureDefaultChannel, ensureWorkforceSpace, extractMentions, publishWorkforce, renderRegistration, route, serverNameFromMxid, startWorkforcePublisher };
+/** Limits are routing policy, not enforcement — see ZOD057 (enforcement lives
+ *  in Tuwunel config + the Zoon composer). */
+declare const MAX_INLINE_IMAGE_BYTES = 524288;
+declare const INLINE_IMAGE_MIMES: string[];
+declare const MAX_DOWNLOAD_BYTES = 33554432;
+interface MediaClientOptions {
+    homeserver: string;
+    asToken: string;
+    fetch?: typeof globalThis.fetch;
+}
+declare function parseMxcUri(uri: string): {
+    serverName: string;
+    mediaId: string;
+} | null;
+declare class MediaClient {
+    private readonly homeserver;
+    private readonly asToken;
+    private readonly fetch;
+    constructor(opts: MediaClientOptions);
+    download(input: {
+        mxcUri: string;
+        asUserId: string;
+        maxBytes?: number;
+    }): Promise<{
+        data: Uint8Array;
+        contentType: string;
+    }>;
+    upload(input: {
+        data: Uint8Array;
+        contentType: string;
+        filename?: string;
+        asUserId: string;
+    }): Promise<{
+        content_uri: string;
+    }>;
+}
+
+declare const MAX_MEDIA_PER_TURN = 8;
+interface PendingMediaItem {
+    eventId: string;
+    sender: string;
+    msgtype: string;
+    body: string;
+    filename?: string;
+    url: string;
+    info?: {
+        mimetype?: string;
+        size?: number;
+        w?: number;
+        h?: number;
+    };
+}
+declare class PendingMediaStore {
+    private readonly queues;
+    private key;
+    add(roomId: string, threadKey: string | undefined, item: PendingMediaItem): void;
+    drain(roomId: string, threadKey: string | undefined, sender: string): PendingMediaItem[];
+}
+
+export { type AgentBinding, BotPool, type CreateMatrixTransportOptions, type EnsureDefaultChannelOpts, type EnsureSpaceOpts, INLINE_IMAGE_MIMES, MAX_DOWNLOAD_BYTES, MAX_INLINE_IMAGE_BYTES, MAX_MEDIA_PER_TURN, MEDIA_MSGTYPES, MatrixClient, type MatrixClientOptions, MatrixContextProvider, type MatrixContextProviderOpts, type MatrixTransportConfig, type MaybeMessage, MediaClient, type MediaClientLike, type MediaClientOptions, type PendingMediaItem, PendingMediaStore, type PublishOpts, type PublisherHandle, type RouteMatch, type SendCustomEventInput, type SendMessageInput, type StartOpts as StartWorkforcePublisherOpts, type WorkforceRoster, type WriteAttachmentInput, buildWorkforceRoster, createMatrixTransport, ensureDefaultChannel, ensureWorkforceSpace, extractMentions, isMediaMsgtype, parseMxcUri, publishWorkforce, renderRegistration, route, serverNameFromMxid, startWorkforcePublisher, writeAttachment };