ankka 0.7.1 → 0.9.0

package/dist/_proto/ankka/protocol/v1/wasm_pb.d.ts

@@ -0,0 +1,307 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Failure, Payload } from "./payload_pb.ts";
+import type { Kind, Spec } from "./discovery_pb.ts";
+import type { EventSourcedIn_Command, EventSourcedOut_Reply } from "./event_sourced_pb.ts";
+import type { KeyValueIn_Command, KeyValueOut_Reply } from "./key_value_pb.ts";
+import type { WorkflowIn_Command, WorkflowIn_RunStep, WorkflowOut_Reply, WorkflowOut_StepReply } from "./workflow_pb.ts";
+import type { StreamToken } from "./client_pb.ts";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ankka/protocol/v1/wasm.proto.
+ */
+export declare const file_ankka_protocol_v1_wasm: GenFile;
+/**
+ * What ankka1_discover answers.
+ *
+ * @generated from message ankka.protocol.v1.WasmSpec
+ */
+export type WasmSpec = Message<"ankka.protocol.v1.WasmSpec"> & {
+    /**
+     * @generated from field: ankka.protocol.v1.Spec spec = 1;
+     */
+    spec?: Spec | undefined;
+    /**
+     * component ids that keep their state between calls
+     *
+     * @generated from field: repeated string stateful = 2;
+     */
+    stateful: string[];
+    /**
+     * "1": must match the exports' prefix
+     *
+     * @generated from field: string abi_version = 3;
+     */
+    abiVersion: string;
+};
+/**
+ * Describes the message ankka.protocol.v1.WasmSpec.
+ * Use `create(WasmSpecSchema)` to create a new message.
+ */
+export declare const WasmSpecSchema: GenMessage<WasmSpec>;
+/**
+ * An entity or workflow command, with the state the runtime holds for it.
+ *
+ * @generated from message ankka.protocol.v1.HandleRequest
+ */
+export type HandleRequest = Message<"ankka.protocol.v1.HandleRequest"> & {
+    /**
+     * @generated from field: ankka.protocol.v1.Kind kind = 1;
+     */
+    kind: Kind;
+    /**
+     * @generated from field: string component_id = 2;
+     */
+    componentId: string;
+    /**
+     * @generated from field: string entity_id = 3;
+     */
+    entityId: string;
+    /**
+     * stateless: always, absent when fresh; stateful: first call after open
+     *
+     * @generated from field: optional ankka.protocol.v1.Payload state = 4;
+     */
+    state?: Payload | undefined;
+    /**
+     * @generated from oneof ankka.protocol.v1.HandleRequest.command
+     */
+    command: {
+        /**
+         * @generated from field: ankka.protocol.v1.EventSourcedIn.Command event_sourced = 10;
+         */
+        value: EventSourcedIn_Command;
+        case: "eventSourced";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.KeyValueIn.Command key_value = 11;
+         */
+        value: KeyValueIn_Command;
+        case: "keyValue";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.WorkflowIn.Command workflow = 12;
+         */
+        value: WorkflowIn_Command;
+        case: "workflow";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message ankka.protocol.v1.HandleRequest.
+ * Use `create(HandleRequestSchema)` to create a new message.
+ */
+export declare const HandleRequestSchema: GenMessage<HandleRequest>;
+/**
+ * @generated from message ankka.protocol.v1.HandleReply
+ */
+export type HandleReply = Message<"ankka.protocol.v1.HandleReply"> & {
+    /**
+     * @generated from oneof ankka.protocol.v1.HandleReply.reply
+     */
+    reply: {
+        /**
+         * @generated from field: ankka.protocol.v1.EventSourcedOut.Reply event_sourced = 10;
+         */
+        value: EventSourcedOut_Reply;
+        case: "eventSourced";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.KeyValueOut.Reply key_value = 11;
+         */
+        value: KeyValueOut_Reply;
+        case: "keyValue";
+    } | {
+        /**
+         * @generated from field: ankka.protocol.v1.WorkflowOut.Reply workflow = 12;
+         */
+        value: WorkflowOut_Reply;
+        case: "workflow";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    /**
+     * the state after the command, in both shapes
+     *
+     * @generated from field: optional ankka.protocol.v1.Payload state = 2;
+     */
+    state?: Payload | undefined;
+    /**
+     * a fault: nothing in the reply applies
+     *
+     * @generated from field: optional ankka.protocol.v1.Failure failure = 3;
+     */
+    failure?: Failure | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.HandleReply.
+ * Use `create(HandleReplySchema)` to create a new message.
+ */
+export declare const HandleReplySchema: GenMessage<HandleReply>;
+/**
+ * One journaled event applied to an event sourced entity's state, on replay. (A command's reply
+ * already carries the state after its events, so nothing else is folded.)
+ *
+ * @generated from message ankka.protocol.v1.FoldRequest
+ */
+export type FoldRequest = Message<"ankka.protocol.v1.FoldRequest"> & {
+    /**
+     * @generated from field: string component_id = 1;
+     */
+    componentId: string;
+    /**
+     * @generated from field: string entity_id = 2;
+     */
+    entityId: string;
+    /**
+     * @generated from field: optional ankka.protocol.v1.Payload state = 3;
+     */
+    state?: Payload | undefined;
+    /**
+     * @generated from field: ankka.protocol.v1.Payload event = 4;
+     */
+    event?: Payload | undefined;
+    /**
+     * @generated from field: int64 sequence = 5;
+     */
+    sequence: bigint;
+};
+/**
+ * Describes the message ankka.protocol.v1.FoldRequest.
+ * Use `create(FoldRequestSchema)` to create a new message.
+ */
+export declare const FoldRequestSchema: GenMessage<FoldRequest>;
+/**
+ * @generated from message ankka.protocol.v1.FoldReply
+ */
+export type FoldReply = Message<"ankka.protocol.v1.FoldReply"> & {
+    /**
+     * @generated from field: ankka.protocol.v1.Payload state = 1;
+     */
+    state?: Payload | undefined;
+    /**
+     * @generated from field: optional ankka.protocol.v1.Failure failure = 2;
+     */
+    failure?: Failure | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.FoldReply.
+ * Use `create(FoldReplySchema)` to create a new message.
+ */
+export declare const FoldReplySchema: GenMessage<FoldReply>;
+/**
+ * @generated from message ankka.protocol.v1.StepRequest
+ */
+export type StepRequest = Message<"ankka.protocol.v1.StepRequest"> & {
+    /**
+     * @generated from field: string component_id = 1;
+     */
+    componentId: string;
+    /**
+     * @generated from field: string entity_id = 2;
+     */
+    entityId: string;
+    /**
+     * @generated from field: optional ankka.protocol.v1.Payload state = 3;
+     */
+    state?: Payload | undefined;
+    /**
+     * @generated from field: ankka.protocol.v1.WorkflowIn.RunStep run_step = 4;
+     */
+    runStep?: WorkflowIn_RunStep | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.StepRequest.
+ * Use `create(StepRequestSchema)` to create a new message.
+ */
+export declare const StepRequestSchema: GenMessage<StepRequest>;
+/**
+ * @generated from message ankka.protocol.v1.StepReply
+ */
+export type StepReply = Message<"ankka.protocol.v1.StepReply"> & {
+    /**
+     * @generated from field: ankka.protocol.v1.WorkflowOut.StepReply reply = 1;
+     */
+    reply?: WorkflowOut_StepReply | undefined;
+    /**
+     * @generated from field: optional ankka.protocol.v1.Payload state = 2;
+     */
+    state?: Payload | undefined;
+    /**
+     * @generated from field: optional ankka.protocol.v1.Failure failure = 3;
+     */
+    failure?: Failure | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.StepReply.
+ * Use `create(StepReplySchema)` to create a new message.
+ */
+export declare const StepReplySchema: GenMessage<StepReply>;
+/**
+ * ankka1_close: a stateful guest drops what it holds for the instance.
+ *
+ * @generated from message ankka.protocol.v1.Passivate
+ */
+export type Passivate = Message<"ankka.protocol.v1.Passivate"> & {
+    /**
+     * @generated from field: string component_id = 1;
+     */
+    componentId: string;
+    /**
+     * @generated from field: string entity_id = 2;
+     */
+    entityId: string;
+};
+/**
+ * Describes the message ankka.protocol.v1.Passivate.
+ * Use `create(PassivateSchema)` to create a new message.
+ */
+export declare const PassivateSchema: GenMessage<Passivate>;
+/**
+ * The config import: one of the descriptor's variables. A reserved name answers absent.
+ *
+ * @generated from message ankka.protocol.v1.ConfigRequest
+ */
+export type ConfigRequest = Message<"ankka.protocol.v1.ConfigRequest"> & {
+    /**
+     * @generated from field: string name = 1;
+     */
+    name: string;
+};
+/**
+ * Describes the message ankka.protocol.v1.ConfigRequest.
+ * Use `create(ConfigRequestSchema)` to create a new message.
+ */
+export declare const ConfigRequestSchema: GenMessage<ConfigRequest>;
+/**
+ * @generated from message ankka.protocol.v1.ConfigReply
+ */
+export type ConfigReply = Message<"ankka.protocol.v1.ConfigReply"> & {
+    /**
+     * @generated from field: optional string value = 1;
+     */
+    value?: string | undefined;
+};
+/**
+ * Describes the message ankka.protocol.v1.ConfigReply.
+ * Use `create(ConfigReplySchema)` to create a new message.
+ */
+export declare const ConfigReplySchema: GenMessage<ConfigReply>;
+/**
+ * The invoke_stream import: a streaming reply, delivered whole.
+ *
+ * @generated from message ankka.protocol.v1.StreamTokens
+ */
+export type StreamTokens = Message<"ankka.protocol.v1.StreamTokens"> & {
+    /**
+     * @generated from field: repeated ankka.protocol.v1.StreamToken tokens = 1;
+     */
+    tokens: StreamToken[];
+};
+/**
+ * Describes the message ankka.protocol.v1.StreamTokens.
+ * Use `create(StreamTokensSchema)` to create a new message.
+ */
+export declare const StreamTokensSchema: GenMessage<StreamTokens>;

package/dist/_proto/ankka/protocol/v1/wasm_pb.js

@@ -0,0 +1,72 @@
+// The module mode's envelope. A WebAssembly module speaks the protocol's own messages across its
+// linear memory rather than over gRPC streams, and these are the few messages that mode needs on
+// top of them: the spec a module declares, and the requests and replies that carry the state the
+// runtime holds for it. WASM-ABI.md says how they cross and which export takes which.
+//
+// Additive: no message in the other files changes for this one, and a process never sees these.
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_ankka_protocol_v1_payload } from "./payload_pb.js";
+import { file_ankka_protocol_v1_discovery } from "./discovery_pb.js";
+import { file_ankka_protocol_v1_event_sourced } from "./event_sourced_pb.js";
+import { file_ankka_protocol_v1_key_value } from "./key_value_pb.js";
+import { file_ankka_protocol_v1_workflow } from "./workflow_pb.js";
+import { file_ankka_protocol_v1_client } from "./client_pb.js";
+/**
+ * Describes the file ankka/protocol/v1/wasm.proto.
+ */
+export const file_ankka_protocol_v1_wasm = /*@__PURE__*/ fileDesc("ChxhbmtrYS9wcm90b2NvbC92MS93YXNtLnByb3RvEhFhbmtrYS5wcm90b2NvbC52MSJYCghXYXNtU3BlYxIlCgRzcGVjGAEgASgLMhcuYW5ra2EucHJvdG9jb2wudjEuU3BlYxIQCghzdGF0ZWZ1bBgCIAMoCRITCgthYmlfdmVyc2lvbhgDIAEoCSLfAgoNSGFuZGxlUmVxdWVzdBIlCgRraW5kGAEgASgOMhcuYW5ra2EucHJvdG9jb2wudjEuS2luZBIUCgxjb21wb25lbnRfaWQYAiABKAkSEQoJZW50aXR5X2lkGAMgASgJEi4KBXN0YXRlGAQgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgBiAEBEkIKDWV2ZW50X3NvdXJjZWQYCiABKAsyKS5hbmtrYS5wcm90b2NvbC52MS5FdmVudFNvdXJjZWRJbi5Db21tYW5kSAASOgoJa2V5X3ZhbHVlGAsgASgLMiUuYW5ra2EucHJvdG9jb2wudjEuS2V5VmFsdWVJbi5Db21tYW5kSAASOQoId29ya2Zsb3cYDCABKAsyJS5hbmtrYS5wcm90b2NvbC52MS5Xb3JrZmxvd0luLkNvbW1hbmRIAEIJCgdjb21tYW5kQggKBl9zdGF0ZSLGAgoLSGFuZGxlUmVwbHkSQQoNZXZlbnRfc291cmNlZBgKIAEoCzIoLmFua2thLnByb3RvY29sLnYxLkV2ZW50U291cmNlZE91dC5SZXBseUgAEjkKCWtleV92YWx1ZRgLIAEoCzIkLmFua2thLnByb3RvY29sLnYxLktleVZhbHVlT3V0LlJlcGx5SAASOAoId29ya2Zsb3cYDCABKAsyJC5hbmtrYS5wcm90b2NvbC52MS5Xb3JrZmxvd091dC5SZXBseUgAEi4KBXN0YXRlGAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgBiAEBEjAKB2ZhaWx1cmUYAyABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5GYWlsdXJlSAKIAQFCBwoFcmVwbHlCCAoGX3N0YXRlQgoKCF9mYWlsdXJlIq0BCgtGb2xkUmVxdWVzdBIUCgxjb21wb25lbnRfaWQYASABKAkSEQoJZW50aXR5X2lkGAIgASgJEi4KBXN0YXRlGAMgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBEikKBWV2ZW50GAQgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZBIQCghzZXF1ZW5jZRgFIAEoA0IICgZfc3RhdGUidAoJRm9sZFJlcGx5EikKBXN0YXRlGAEgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZBIwCgdmYWlsdXJlGAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuRmFpbHVyZUgAiAEBQgoKCF9mYWlsdXJlIqkBCgtTdGVwUmVxdWVzdBIUCgxjb21wb25lbnRfaWQYASABKAkSEQoJZW50aXR5X2lkGAIgASgJEi4KBXN0YXRlGAMgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBEjcKCHJ1bl9zdGVwGAQgASgLMiUuYW5ra2EucHJvdG9jb2wudjEuV29ya2Zsb3dJbi5SdW5TdGVwQggKBl9zdGF0ZSK8AQoJU3RlcFJlcGx5EjcKBXJlcGx5GAEgASgLMiguYW5ra2EucHJvdG9jb2wudjEuV29ya2Zsb3dPdXQuU3RlcFJlcGx5Ei4KBXN0YXRlGAIgASgLMhouYW5ra2EucHJvdG9jb2wudjEuUGF5bG9hZEgAiAEBEjAKB2ZhaWx1cmUYAyABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5GYWlsdXJlSAGIAQFCCAoGX3N0YXRlQgoKCF9mYWlsdXJlIjQKCVBhc3NpdmF0ZRIUCgxjb21wb25lbnRfaWQYASABKAkSEQoJZW50aXR5X2lkGAIgASgJIh0KDUNvbmZpZ1JlcXVlc3QSDAoEbmFtZRgBIAEoCSIrCgtDb25maWdSZXBseRISCgV2YWx1ZRgBIAEoCUgAiAEBQggKBl92YWx1ZSI+CgxTdHJlYW1Ub2tlbnMSLgoGdG9rZW5zGAEgAygLMh4uYW5ra2EucHJvdG9jb2wudjEuU3RyZWFtVG9rZW5iBnByb3RvMw", [file_ankka_protocol_v1_payload, file_ankka_protocol_v1_discovery, file_ankka_protocol_v1_event_sourced, file_ankka_protocol_v1_key_value, file_ankka_protocol_v1_workflow, file_ankka_protocol_v1_client]);
+/**
+ * Describes the message ankka.protocol.v1.WasmSpec.
+ * Use `create(WasmSpecSchema)` to create a new message.
+ */
+export const WasmSpecSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_wasm, 0);
+/**
+ * Describes the message ankka.protocol.v1.HandleRequest.
+ * Use `create(HandleRequestSchema)` to create a new message.
+ */
+export const HandleRequestSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_wasm, 1);
+/**
+ * Describes the message ankka.protocol.v1.HandleReply.
+ * Use `create(HandleReplySchema)` to create a new message.
+ */
+export const HandleReplySchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_wasm, 2);
+/**
+ * Describes the message ankka.protocol.v1.FoldRequest.
+ * Use `create(FoldRequestSchema)` to create a new message.
+ */
+export const FoldRequestSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_wasm, 3);
+/**
+ * Describes the message ankka.protocol.v1.FoldReply.
+ * Use `create(FoldReplySchema)` to create a new message.
+ */
+export const FoldReplySchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_wasm, 4);
+/**
+ * Describes the message ankka.protocol.v1.StepRequest.
+ * Use `create(StepRequestSchema)` to create a new message.
+ */
+export const StepRequestSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_wasm, 5);
+/**
+ * Describes the message ankka.protocol.v1.StepReply.
+ * Use `create(StepReplySchema)` to create a new message.
+ */
+export const StepReplySchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_wasm, 6);
+/**
+ * Describes the message ankka.protocol.v1.Passivate.
+ * Use `create(PassivateSchema)` to create a new message.
+ */
+export const PassivateSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_wasm, 7);
+/**
+ * Describes the message ankka.protocol.v1.ConfigRequest.
+ * Use `create(ConfigRequestSchema)` to create a new message.
+ */
+export const ConfigRequestSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_wasm, 8);
+/**
+ * Describes the message ankka.protocol.v1.ConfigReply.
+ * Use `create(ConfigReplySchema)` to create a new message.
+ */
+export const ConfigReplySchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_wasm, 9);
+/**
+ * Describes the message ankka.protocol.v1.StreamTokens.
+ * Use `create(StreamTokensSchema)` to create a new message.
+ */
+export const StreamTokensSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_wasm, 10);

package/dist/autonomous.d.ts

@@ -0,0 +1,154 @@
+import type { ComponentClient } from "./client.ts";
+import type { GuardrailRef, ToolRef } from "./handlers.ts";
+import type { Schema } from "./schema.ts";
+type MaybePromise<T> = T | Promise<T>;
+export declare const COMPLETE_TASK = "complete_task";
+export declare const FAIL_TASK = "fail_task";
+export interface Accepted {
+    readonly verdict: "accepted";
+}
+export interface Rejected {
+    readonly verdict: "rejected";
+    readonly reason: string;
+}
+export declare const accepted: () => Accepted;
+export declare const rejected: (reason: string) => Rejected;
+/** A check a result must pass. Rules run in declaration order; the first rejection is reported. */
+export interface TaskRule<R> {
+    readonly name: string;
+    readonly check: (result: R) => MaybePromise<Accepted | Rejected>;
+}
+export declare function taskRule<R>(name: string, check: (result: R) => MaybePromise<Accepted | Rejected>): TaskRule<R>;
+/** A kind of work. `name` is the wire name, written into every task of this type. */
+export interface TaskType<R> {
+    readonly name: string;
+    readonly description: string;
+    /** The result's shape; absent, the result is text. */
+    readonly result: Schema<R> | undefined;
+    readonly rules: readonly TaskRule<R>[];
+}
+export declare function taskType<R = string>(name: string, description: string, options?: {
+    result?: Schema<R>;
+    rules?: readonly TaskRule<R>[];
+}): TaskType<R>;
+/** Decodes a stored result as the task type's. */
+export declare function decodeResult<R>(type: TaskType<R>, stored: string): R;
+export interface TaskAcceptance {
+    readonly taskType: TaskType<any>;
+    readonly maxIterations: number;
+}
+export declare function taskAcceptance(type: TaskType<any>, options?: {
+    maxIterations?: number;
+}): TaskAcceptance;
+export interface AutonomousSettings {
+    readonly approachingBudgetAt?: number;
+    readonly repeatedFailureAt?: number;
+    readonly maxConsecutiveFailures?: number;
+    readonly dependencyStuckAfterMillis?: number;
+}
+export declare abstract class AutonomousAgent {
+    #private;
+    /** The task a tool, a guardrail or a rule is running for. */
+    get taskId(): string;
+    get client(): ComponentClient;
+    /** @internal */
+    get _kind(): "autonomous-agent";
+    /** @internal */
+    _bind(sessionId: string, client: ComponentClient): void;
+}
+export interface AutonomousAgentClass<C extends AutonomousAgent = AutonomousAgent> {
+    new (): C;
+    readonly componentId: string;
+    readonly description: string;
+    readonly instructions?: string;
+    /** A model named in the sidecar's configuration; absent, its default. */
+    readonly model?: string;
+    readonly tools?: Readonly<Record<string, ToolRef<C, any>>>;
+    readonly guardrails?: Readonly<Record<string, GuardrailRef>>;
+    readonly accepts: readonly TaskAcceptance[];
+    readonly settings?: AutonomousSettings;
+}
+/** The discovery form of a result schema. */
+export declare function resultSchemaJson(type: TaskType<any>): string | undefined;
+export interface Attachment {
+    readonly name: string;
+    readonly contentType: string;
+    readonly content?: string;
+    readonly uri?: string;
+}
+export interface TaskSnapshot<R> {
+    readonly id: string;
+    readonly typeName: string;
+    readonly status: "pending" | "assigned" | "in-progress" | "result-rejected" | "completed" | "failed" | "cancelled";
+    readonly result: R | undefined;
+    readonly reason: string | undefined;
+    readonly iterations: number;
+    readonly assignee: {
+        readonly componentId: string;
+        readonly instanceId: string;
+    } | undefined;
+    readonly record: Record<string, unknown>;
+}
+export interface AgentState {
+    readonly phase: "idle" | "working" | "waiting" | "suspended" | "terminated";
+    readonly currentTask: string | undefined;
+    readonly iteration: number;
+    readonly queued: readonly string[];
+}
+/** One thing an instance did: `type` names it, and the rest of its fields are as sent. */
+export interface Notification {
+    readonly type: string;
+    readonly componentId: string;
+    readonly instanceId: string;
+    readonly taskId?: string;
+    readonly at: number;
+    readonly [field: string]: unknown;
+}
+/** Creates tasks: `await client.tasks.create(ANSWER, "How many?")` answers the new task's id. */
+export declare class Tasks {
+    #private;
+    constructor(client: ComponentClient);
+    /** A dependency that does not exist is refused before anything is written; one that has already ended cancels the new task. */
+    create(type: TaskType<any>, instructions: string, options?: {
+        id?: string;
+        attachments?: readonly Attachment[];
+        dependsOn?: readonly string[];
+    }): Promise<string>;
+}
+/** Calls about one task. */
+export declare class TaskCalls {
+    #private;
+    readonly taskId: string;
+    constructor(client: ComponentClient, taskId: string);
+    get<R = unknown>(type?: TaskType<R>): Promise<TaskSnapshot<R>>;
+    /** Waits until the task has completed, failed or been cancelled. */
+    wait<R = unknown>(type?: TaskType<R>, options?: {
+        timeoutMs?: number;
+    }): Promise<TaskSnapshot<R>>;
+    /** Cancels the task: at once when waiting, at the end of the current iteration when being worked. */
+    cancel(reason?: string): Promise<void>;
+}
+/** Calls to one instance of an autonomous agent, by the id the caller chose; with no id, only `runSingleTask`. */
+export declare class AutonomousAgentCalls {
+    #private;
+    readonly componentId: string;
+    readonly instanceId: string | undefined;
+    constructor(client: ComponentClient, componentId: string, instanceId: string | undefined);
+    /** Creates the task, starts an instance on it, and answers the task's id at once. */
+    runSingleTask(type: TaskType<any>, instructions: string, options?: Parameters<Tasks["create"]>[2]): Promise<string>;
+    assign(...taskIds: string[]): Promise<{
+        accepted: string[];
+        refused: Record<string, {
+            message: string;
+            code: string;
+        }>;
+    }>;
+    suspend(): Promise<void>;
+    resume(): Promise<void>;
+    /** Stops the instance for good; its tasks go back to pending for another to take. */
+    terminate(): Promise<void>;
+    state(): Promise<AgentState>;
+    /** What the instance does from now on, as it happens. Nothing is replayed. */
+    notifications(): AsyncIterable<Notification>;
+}
+export {};