@tarkahq/sdk 0.0.0-stage → 0.3.0

package/dist/esm/generated/tarka/channels/v1/channels.d.ts

@@ -0,0 +1,370 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import { Empty } from "../../../google/protobuf/empty.js";
+export declare const protobufPackage = "tarka.channels.v1";
+/**
+ * Copyright 2026 Tarka
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface Channel {
+    id: string;
+    orgId: string;
+    realmId: string;
+    /** active, suspended, revoked, or provisioning; validated by resource kind. */
+    status: string;
+    /** Optimistic concurrency version, managed by the server. */
+    version: bigint;
+    createdAt: Date | undefined;
+    updatedAt: Date | undefined;
+    /** telegram, discord, slack, or teams. */
+    provider: string;
+    name: string;
+    /**
+     * Optional legacy connection reference. Messaging credentials are configured
+     * independently using ConfigureChannelInstallation.
+     */
+    connectionId: string;
+    agentId: string;
+    configuration: {
+        [key: string]: any;
+    } | undefined;
+}
+/**
+ * Contains public installation metadata only. Credentials are never returned.
+ * A ready installation proves signed provider delivery, not customer consent
+ * or permission to execute an agent.
+ */
+export interface ChannelInstallation {
+    channelId: string;
+    channelVersion: bigint;
+    credentialGeneration: bigint;
+    /**
+     * setup_required, registering, awaiting_delivery, ready,
+     * configuration_changed, or disabled.
+     */
+    status: string;
+    provider: string;
+    workspaceId: string;
+    applicationId: string;
+    botId: string;
+    webhookUrl: string;
+    verifiedAt: Date | undefined;
+    /** Stable code identifying the remaining provider setup action. */
+    setupCode: string;
+}
+export interface GetChannelInstallationRequest {
+    orgId: string;
+    realmId: string;
+    channelId: string;
+}
+export interface ConfigureChannelInstallationRequest {
+    orgId: string;
+    realmId: string;
+    channelId: string;
+    expectedVersion: bigint;
+    /** Zero for initial setup; otherwise the currently observed generation. */
+    expectedCredentialGeneration: bigint;
+    /**
+     * Write-only: Telegram/Discord bot_token; Slack bot_token + signing_secret;
+     * Teams client_secret. Public workspace/application IDs belong in the
+     * channel configuration. Provider APIs verify immutable bot ownership.
+     */
+    credentials: {
+        [key: string]: string;
+    };
+}
+export interface ConfigureChannelInstallationRequest_CredentialsEntry {
+    key: string;
+    value: string;
+}
+export interface RevokeChannelInstallationRequest {
+    orgId: string;
+    realmId: string;
+    channelId: string;
+    expectedVersion: bigint;
+    expectedCredentialGeneration: bigint;
+}
+export interface CreateChannelRequest {
+    orgId: string;
+    realmId: string;
+    channel: Channel | undefined;
+}
+export interface UpdateChannelRequest {
+    orgId: string;
+    realmId: string;
+    id: string;
+    channel: Channel | undefined;
+    expectedVersion: bigint;
+}
+export interface GetChannelRequest {
+    orgId: string;
+    realmId: string;
+    id: string;
+}
+export interface DeleteChannelRequest {
+    orgId: string;
+    realmId: string;
+    id: string;
+    expectedVersion: bigint;
+}
+export interface ListChannelsRequest {
+    orgId: string;
+    realmId: string;
+    pageSize: number;
+    pageToken: string;
+}
+export interface ListChannelsResponse {
+    items: Channel[];
+    nextPageToken: string;
+}
+export interface ConversationBinding {
+    id: string;
+    orgId: string;
+    realmId: string;
+    /** active, suspended, revoked, or provisioning; validated by resource kind. */
+    status: string;
+    /** Optimistic concurrency version, managed by the server. */
+    version: bigint;
+    createdAt: Date | undefined;
+    updatedAt: Date | undefined;
+    channelId: string;
+    providerWorkspaceId: string;
+    providerConversationId: string;
+    subjectId: string;
+    agentId: string;
+    /** personal or shared. */
+    kind: string;
+}
+export interface CreateConversationBindingRequest {
+    orgId: string;
+    realmId: string;
+    conversationBinding: ConversationBinding | undefined;
+}
+export interface UpdateConversationBindingRequest {
+    orgId: string;
+    realmId: string;
+    id: string;
+    conversationBinding: ConversationBinding | undefined;
+    expectedVersion: bigint;
+}
+export interface GetConversationBindingRequest {
+    orgId: string;
+    realmId: string;
+    id: string;
+}
+export interface DeleteConversationBindingRequest {
+    orgId: string;
+    realmId: string;
+    id: string;
+    expectedVersion: bigint;
+}
+export interface ListConversationBindingsRequest {
+    orgId: string;
+    realmId: string;
+    pageSize: number;
+    pageToken: string;
+}
+export interface ListConversationBindingsResponse {
+    items: ConversationBinding[];
+    nextPageToken: string;
+}
+export declare const Channel: MessageFns<Channel>;
+export declare const ChannelInstallation: MessageFns<ChannelInstallation>;
+export declare const GetChannelInstallationRequest: MessageFns<GetChannelInstallationRequest>;
+export declare const ConfigureChannelInstallationRequest: MessageFns<ConfigureChannelInstallationRequest>;
+export declare const ConfigureChannelInstallationRequest_CredentialsEntry: MessageFns<ConfigureChannelInstallationRequest_CredentialsEntry>;
+export declare const RevokeChannelInstallationRequest: MessageFns<RevokeChannelInstallationRequest>;
+export declare const CreateChannelRequest: MessageFns<CreateChannelRequest>;
+export declare const UpdateChannelRequest: MessageFns<UpdateChannelRequest>;
+export declare const GetChannelRequest: MessageFns<GetChannelRequest>;
+export declare const DeleteChannelRequest: MessageFns<DeleteChannelRequest>;
+export declare const ListChannelsRequest: MessageFns<ListChannelsRequest>;
+export declare const ListChannelsResponse: MessageFns<ListChannelsResponse>;
+export declare const ConversationBinding: MessageFns<ConversationBinding>;
+export declare const CreateConversationBindingRequest: MessageFns<CreateConversationBindingRequest>;
+export declare const UpdateConversationBindingRequest: MessageFns<UpdateConversationBindingRequest>;
+export declare const GetConversationBindingRequest: MessageFns<GetConversationBindingRequest>;
+export declare const DeleteConversationBindingRequest: MessageFns<DeleteConversationBindingRequest>;
+export declare const ListConversationBindingsRequest: MessageFns<ListConversationBindingsRequest>;
+export declare const ListConversationBindingsResponse: MessageFns<ListConversationBindingsResponse>;
+export type ChannelsServiceDefinition = typeof ChannelsServiceDefinition;
+export declare const ChannelsServiceDefinition: {
+    readonly name: "ChannelsService";
+    readonly fullName: "tarka.channels.v1.ChannelsService";
+    readonly methods: {
+        readonly getChannelInstallation: {
+            readonly name: "GetChannelInstallation";
+            readonly requestType: typeof GetChannelInstallationRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof ChannelInstallation;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly configureChannelInstallation: {
+            readonly name: "ConfigureChannelInstallation";
+            readonly requestType: typeof ConfigureChannelInstallationRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof ChannelInstallation;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly revokeChannelInstallation: {
+            readonly name: "RevokeChannelInstallation";
+            readonly requestType: typeof RevokeChannelInstallationRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof ChannelInstallation;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly createChannel: {
+            readonly name: "CreateChannel";
+            readonly requestType: typeof CreateChannelRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof Channel;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly updateChannel: {
+            readonly name: "UpdateChannel";
+            readonly requestType: typeof UpdateChannelRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof Channel;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly getChannel: {
+            readonly name: "GetChannel";
+            readonly requestType: typeof GetChannelRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof Channel;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly deleteChannel: {
+            readonly name: "DeleteChannel";
+            readonly requestType: typeof DeleteChannelRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof Empty;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly listChannels: {
+            readonly name: "ListChannels";
+            readonly requestType: typeof ListChannelsRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof ListChannelsResponse;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly createConversationBinding: {
+            readonly name: "CreateConversationBinding";
+            readonly requestType: typeof CreateConversationBindingRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof ConversationBinding;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly updateConversationBinding: {
+            readonly name: "UpdateConversationBinding";
+            readonly requestType: typeof UpdateConversationBindingRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof ConversationBinding;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly getConversationBinding: {
+            readonly name: "GetConversationBinding";
+            readonly requestType: typeof GetConversationBindingRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof ConversationBinding;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly deleteConversationBinding: {
+            readonly name: "DeleteConversationBinding";
+            readonly requestType: typeof DeleteConversationBindingRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof Empty;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+        readonly listConversationBindings: {
+            readonly name: "ListConversationBindings";
+            readonly requestType: typeof ListConversationBindingsRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof ListConversationBindingsResponse;
+            readonly responseStream: false;
+            readonly options: {
+                readonly _unknownFields: {
+                    readonly 578365826: readonly [Buffer<ArrayBufferLike>];
+                };
+            };
+        };
+    };
+};
+type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
+export type DeepPartial<T> = T extends bigint ? string | number | bigint : T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {
+    $case: string;
+    value: unknown;
+} ? {
+    $case: T["$case"];
+    value?: DeepPartial<T["value"]>;
+} : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create(base?: DeepPartial<T>): T;
+    fromPartial(object: DeepPartial<T>): T;
+}
+export {};