@smoothcodes/agent-client 0.0.0-stage → 0.1.0

package/dist/types/contract/events/ts/src/gen/known.d.ts

@@ -0,0 +1,117 @@
+export declare const KNOWN_EVENT_TYPES: readonly ["session.started", "chat.state", "run.started", "run.waiting", "run.completed", "usage.updated", "item.started", "item.delta", "item.updated", "item.completed", "item.retracted", "task.updated", "context.updated", "limits.updated", "agent.switched", "agent.switch_failed", "notice", "error"];
+export declare const KNOWN_ITEM_KINDS: readonly ["user_message", "text", "reasoning", "tool_call", "command", "file_change", "file_search", "web_search", "plan", "proposed_plan", "subagent", "notification", "timer", "approval", "question", "compaction", "handoff", "hook", "error"];
+export declare const KNOWN_ERROR_CODES: readonly ["unauthorized", "forbidden", "not_found", "invalid_request", "provider_not_connected", "provider_auth_expired", "provider_error", "usage_limit_reached", "plan_limit", "rate_limited", "box_unavailable", "conflict", "machine_offline", "request_expired", "no_run", "queue_full", "internal"];
+export declare const KNOWN_FAILURE_REASONS: readonly ["no_credit", "subscription_limit", "rate_limited", "out_of_memory", "context_window_exceeded", "auth_failed", "provider_crashed", "max_turns", "network", "request_expired", "grant_revoked", "unknown"];
+/** status HTTP de cada código de erro (§6) */
+export declare const ERROR_CODE_HTTP: {
+    readonly unauthorized: 401;
+    readonly forbidden: 403;
+    readonly not_found: 404;
+    readonly invalid_request: 400;
+    readonly provider_not_connected: 424;
+    readonly provider_auth_expired: 424;
+    readonly provider_error: 502;
+    readonly usage_limit_reached: 429;
+    readonly plan_limit: 402;
+    readonly rate_limited: 429;
+    readonly box_unavailable: 503;
+    readonly conflict: 409;
+    readonly machine_offline: 409;
+    readonly request_expired: 410;
+    readonly no_run: 409;
+    readonly queue_full: 429;
+    readonly internal: 500;
+};
+export declare const CONTRACT_VERSION = "0.1.0";
+/** M42: a tabela ÚNICA de capabilities por provedor (capabilities.json). fake = a linha do sabor dele. */
+export declare const PROVIDER_CAPABILITIES: {
+    readonly revision: 4;
+    readonly providers: {
+        readonly claude: {
+            readonly measuredOn: "2.1.310";
+            readonly contextWindow: {
+                readonly default: 200000;
+                readonly rules: readonly [{
+                    readonly suffix: "[1m]";
+                    readonly tokens: 1000000;
+                }];
+            };
+            readonly capabilities: {
+                readonly version: 1;
+                readonly reasoning: true;
+                readonly plans: true;
+                readonly approvals: false;
+                readonly questions: true;
+                readonly subagents: true;
+                readonly background: true;
+                readonly wakeTurns: true;
+                readonly taskStop: true;
+                readonly timers: false;
+                readonly fileChanges: true;
+                readonly images: true;
+                readonly contextUsage: true;
+                readonly usageLimits: true;
+                readonly costReporting: true;
+                readonly parallelTools: true;
+                readonly steering: "native";
+                readonly steerBoundary: "tool";
+                readonly steerRecall: true;
+                readonly steerInterrupts: "nothing";
+                readonly interrupt: "native";
+                readonly consumptionSignal: "echo";
+                readonly modelSwitchInSession: true;
+                readonly resume: true;
+                readonly effortSwitch: "live";
+                readonly handoffInject: "native_history";
+                readonly mcpSwitch: "live";
+            };
+        };
+        readonly codex: {
+            readonly measuredOn: "0.163.0";
+            readonly contextWindow: {
+                readonly default: 258400;
+                readonly rules: readonly [];
+            };
+            readonly capabilities: {
+                readonly version: 1;
+                readonly reasoning: true;
+                readonly reasoningSummary: true;
+                readonly plans: true;
+                readonly proposedPlans: true;
+                readonly approvals: true;
+                readonly questions: true;
+                readonly subagents: true;
+                readonly background: true;
+                readonly wakeTurns: false;
+                readonly taskStop: true;
+                readonly timers: false;
+                readonly fileChanges: true;
+                readonly images: true;
+                readonly boxFiles: false;
+                readonly contextUsage: true;
+                readonly usageLimits: true;
+                readonly costReporting: false;
+                readonly parallelTools: true;
+                readonly steering: "native";
+                readonly steerBoundary: "model_call";
+                readonly steerRecall: false;
+                readonly steerDuringCompaction: "waits_turn";
+                readonly steerInterrupts: "response";
+                readonly interrupt: "native";
+                readonly consumptionSignal: "echo";
+                readonly streaming: {
+                    readonly text: true;
+                    readonly reasoning: true;
+                    readonly toolInput: false;
+                    readonly commandOutput: true;
+                    readonly planText: true;
+                };
+                readonly modelSwitchInSession: true;
+                readonly effortSwitch: "live";
+                readonly resume: true;
+                readonly handoffInject: "native_history";
+                readonly mcpSwitch: "live";
+            };
+        };
+    };
+};

package/dist/types/contract/events/ts/src/reducer.d.ts

@@ -0,0 +1,21 @@
+import type { ChatState, Event, Item, Usage } from './gen/events.js';
+export interface ReducerConfig {
+    /** kinds que NÃO entram no histórico (o realtime deixa configurável). Padrão: nenhum. */
+    excludeKinds?: string[];
+}
+/** Predicado de "item de histórico": fechado, não retirado, kind não excluído. */
+export declare function isHistoryItem(item: Item, cfg?: ReducerConfig): boolean;
+export declare function emptyState(): ChatState;
+/** Aplica UM evento da timeline. Devolve o mesmo objeto (mutado) — copie antes se precisar do anterior. */
+export declare function apply(s: ChatState, ev: Event | {
+    seq?: unknown;
+    type?: unknown;
+}, problems?: string[], cfg?: ReducerConfig): ChatState;
+export declare function reduce(events: Iterable<unknown>, from?: ChatState, problems?: string[], cfg?: ReducerConfig): ChatState;
+/** O que o log guarda (keepDeltas=untilItemCompleted): de item fechado ficam started e completed; somem deltas e updates. */
+export declare function compactLog<T extends {
+    type?: unknown;
+    itemId?: unknown;
+}>(events: T[]): T[];
+/** Soma de dois Usage (pro uso do chat: snapshot + runs depois dele). */
+export declare function sumUsage(a: Usage, b: Usage): Usage;

package/dist/types/sdk/generated/ts-client/BaseClient.d.ts

@@ -0,0 +1,54 @@
+import { BearerAuthProvider } from "./auth/BearerAuthProvider.js";
+import * as core from "./core/index.js";
+import type * as environments from "./environments.js";
+export type AuthOption = false | core.AuthProvider["getAuthRequest"] | core.AuthProvider | BearerAuthProvider.AuthOptions;
+export type BaseClientOptions = {
+    environment?: core.Supplier<environments.SmoothAgentApiEnvironment | string>;
+    /** Specify a custom URL to connect the client to. */
+    baseUrl?: core.Supplier<string>;
+    /** Additional headers to include in requests. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    /** The default maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The default number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** Provide a custom fetch implementation. Useful for platforms that don't have a built-in fetch or need a custom implementation. */
+    fetch?: typeof fetch;
+    /** Configure logging for the client. */
+    logging?: core.logging.LogConfig | core.logging.Logger;
+    /** Default options for SSE stream reconnection behavior. Has no effect on non-resumable endpoints. */
+    stream?: {
+        reconnectionEnabled?: boolean;
+        maxReconnectionAttempts?: number;
+    };
+    /** Override auth. Pass false to disable, a function returning auth headers, an AuthProvider, or auth options. */
+    auth?: AuthOption;
+} & BearerAuthProvider.AuthOptions;
+export interface BaseRequestOptions {
+    /** The maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** A hook to abort the request. */
+    abortSignal?: AbortSignal;
+    /** Additional query string parameters to include in the request. */
+    queryParams?: Record<string, unknown>;
+    /** A dictionary containing additional parameters to spread into the request's body. */
+    additionalBodyParameters?: Record<string, unknown>;
+    /** Additional headers to include in the request. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    /** Options for SSE stream reconnection behavior. Has no effect on non-resumable endpoints. */
+    stream?: {
+        reconnectionEnabled?: boolean;
+        maxReconnectionAttempts?: number;
+    };
+}
+export type NormalizedClientOptions<T extends BaseClientOptions = BaseClientOptions> = T & {
+    logging: core.logging.Logger;
+    authProvider?: core.AuthProvider;
+};
+export type NormalizedClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions> = NormalizedClientOptions<T> & {
+    authProvider: core.AuthProvider;
+};
+export declare function normalizeClientOptions<T extends BaseClientOptions = BaseClientOptions>(options: T): NormalizedClientOptions<T>;
+export declare function normalizeClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions>(options: T): NormalizedClientOptionsWithAuth<T>;

package/dist/types/sdk/generated/ts-client/Client.d.ts

@@ -0,0 +1,41 @@
+import { AgentsClient } from "./api/resources/agents/client/Client.js";
+import { ChatsClient } from "./api/resources/chats/client/Client.js";
+import { FilesClient } from "./api/resources/files/client/Client.js";
+import { IdentityClient } from "./api/resources/identity/client/Client.js";
+import { MachinesClient } from "./api/resources/machines/client/Client.js";
+import { ProvidersClient } from "./api/resources/providers/client/Client.js";
+import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "./BaseClient.js";
+import * as core from "./core/index.js";
+export declare namespace SmoothAgentApiClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class SmoothAgentApiClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<SmoothAgentApiClient.Options>;
+    protected _agents: AgentsClient | undefined;
+    protected _chats: ChatsClient | undefined;
+    protected _files: FilesClient | undefined;
+    protected _machines: MachinesClient | undefined;
+    protected _identity: IdentityClient | undefined;
+    protected _providers: ProvidersClient | undefined;
+    constructor(options: SmoothAgentApiClient.Options);
+    get agents(): AgentsClient;
+    get chats(): ChatsClient;
+    get files(): FilesClient;
+    get machines(): MachinesClient;
+    get identity(): IdentityClient;
+    get providers(): ProvidersClient;
+    /**
+     * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
+     * This is useful for making requests to endpoints not yet supported in the SDK.
+     * The input can be a URL string, URL object, or Request object. Relative paths are resolved against the configured base URL.
+     *
+     * @param {Request | string | URL} input - The URL, path, or Request object.
+     * @param {RequestInit} init - Standard fetch RequestInit options.
+     * @param {core.PassthroughRequest.RequestOptions} requestOptions - Per-request overrides (timeout, retries, headers, abort signal).
+     * @returns {Promise<Response>} A standard Response object.
+     */
+    fetch(input: Request | string | URL, init?: RequestInit, requestOptions?: core.PassthroughRequest.RequestOptions): Promise<Response>;
+}

package/dist/types/sdk/generated/ts-client/api/errors/BadGatewayError.d.ts

@@ -0,0 +1,7 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
+export declare class BadGatewayError extends errors.SmoothAgentApiError {
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/BadRequestError.d.ts

@@ -0,0 +1,5 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+export declare class BadRequestError extends errors.SmoothAgentApiError {
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/ConflictError.d.ts

@@ -0,0 +1,5 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+export declare class ConflictError extends errors.SmoothAgentApiError {
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/FailedDependencyError.d.ts

@@ -0,0 +1,7 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
+export declare class FailedDependencyError extends errors.SmoothAgentApiError {
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/ForbiddenError.d.ts

@@ -0,0 +1,5 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+export declare class ForbiddenError extends errors.SmoothAgentApiError {
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/GoneError.d.ts

@@ -0,0 +1,7 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
+export declare class GoneError extends errors.SmoothAgentApiError {
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/InternalServerError.d.ts

@@ -0,0 +1,5 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+export declare class InternalServerError extends errors.SmoothAgentApiError {
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/NotFoundError.d.ts

@@ -0,0 +1,7 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
+export declare class NotFoundError extends errors.SmoothAgentApiError {
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/PaymentRequiredError.d.ts

@@ -0,0 +1,7 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
+export declare class PaymentRequiredError extends errors.SmoothAgentApiError {
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/ServiceUnavailableError.d.ts

@@ -0,0 +1,7 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
+export declare class ServiceUnavailableError extends errors.SmoothAgentApiError {
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/TooManyRequestsError.d.ts

@@ -0,0 +1,5 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+export declare class TooManyRequestsError extends errors.SmoothAgentApiError {
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/UnauthorizedError.d.ts

@@ -0,0 +1,5 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+export declare class UnauthorizedError extends errors.SmoothAgentApiError {
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/UnprocessableEntityError.d.ts

@@ -0,0 +1,7 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as SmoothAgentApi from "../index.js";
+export declare class UnprocessableEntityError extends errors.SmoothAgentApiError {
+    readonly body: SmoothAgentApi.Error_;
+    constructor(body: SmoothAgentApi.Error_, rawResponse?: core.RawResponse);
+}

package/dist/types/sdk/generated/ts-client/api/errors/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./BadGatewayError.js";
+export * from "./BadRequestError.js";
+export * from "./ConflictError.js";
+export * from "./FailedDependencyError.js";
+export * from "./ForbiddenError.js";
+export * from "./GoneError.js";
+export * from "./InternalServerError.js";
+export * from "./NotFoundError.js";
+export * from "./PaymentRequiredError.js";
+export * from "./ServiceUnavailableError.js";
+export * from "./TooManyRequestsError.js";
+export * from "./UnauthorizedError.js";
+export * from "./UnprocessableEntityError.js";

package/dist/types/sdk/generated/ts-client/api/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./errors/index.js";
+export * from "./resources/index.js";
+export * from "./types/index.js";

package/dist/types/sdk/generated/ts-client/api/resources/agents/client/Client.d.ts

@@ -0,0 +1,66 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as SmoothAgentApi from "../../../index.js";
+export declare namespace AgentsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class AgentsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AgentsClient.Options>;
+    constructor(options: AgentsClient.Options);
+    /**
+     * Chave: todos do workspace (ou o recorte da chave restrita). Usuário: os que pode usar (`AgentPublic`).
+     *
+     * @param {SmoothAgentApi.AgentsListRequest} request
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link SmoothAgentApi.BadRequestError}
+     * @throws {@link SmoothAgentApi.UnauthorizedError}
+     * @throws {@link SmoothAgentApi.PaymentRequiredError}
+     * @throws {@link SmoothAgentApi.ForbiddenError}
+     * @throws {@link SmoothAgentApi.NotFoundError}
+     * @throws {@link SmoothAgentApi.ConflictError}
+     * @throws {@link SmoothAgentApi.GoneError}
+     * @throws {@link SmoothAgentApi.UnprocessableEntityError}
+     * @throws {@link SmoothAgentApi.FailedDependencyError}
+     * @throws {@link SmoothAgentApi.TooManyRequestsError}
+     * @throws {@link SmoothAgentApi.InternalServerError}
+     * @throws {@link SmoothAgentApi.BadGatewayError}
+     * @throws {@link SmoothAgentApi.ServiceUnavailableError}
+     * @throws {@link errors.SmoothAgentApiError}
+     * @throws {@link errors.SmoothAgentApiTimeoutError}
+     *
+     * @example
+     *     await client.agents.list()
+     */
+    list(request?: SmoothAgentApi.AgentsListRequest, requestOptions?: AgentsClient.RequestOptions): Promise<core.Page<SmoothAgentApi.AgentsListResponse.Data.Item, SmoothAgentApi.AgentsListResponse>>;
+    /**
+     * @param {SmoothAgentApi.AgentsGetRequest} request
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link SmoothAgentApi.BadRequestError}
+     * @throws {@link SmoothAgentApi.UnauthorizedError}
+     * @throws {@link SmoothAgentApi.PaymentRequiredError}
+     * @throws {@link SmoothAgentApi.ForbiddenError}
+     * @throws {@link SmoothAgentApi.NotFoundError}
+     * @throws {@link SmoothAgentApi.ConflictError}
+     * @throws {@link SmoothAgentApi.GoneError}
+     * @throws {@link SmoothAgentApi.UnprocessableEntityError}
+     * @throws {@link SmoothAgentApi.FailedDependencyError}
+     * @throws {@link SmoothAgentApi.TooManyRequestsError}
+     * @throws {@link SmoothAgentApi.InternalServerError}
+     * @throws {@link SmoothAgentApi.BadGatewayError}
+     * @throws {@link SmoothAgentApi.ServiceUnavailableError}
+     * @throws {@link errors.SmoothAgentApiError}
+     * @throws {@link errors.SmoothAgentApiTimeoutError}
+     *
+     * @example
+     *     await client.agents.get({
+     *         id: "id"
+     *     })
+     */
+    get(request: SmoothAgentApi.AgentsGetRequest, requestOptions?: AgentsClient.RequestOptions): core.HttpResponsePromise<SmoothAgentApi.AgentsGetResponse>;
+    private __get;
+}

package/dist/types/sdk/generated/ts-client/api/resources/agents/client/index.d.ts

@@ -0,0 +1 @@
+export * from "./requests/index.js";

package/dist/types/sdk/generated/ts-client/api/resources/agents/client/requests/AgentsGetRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface AgentsGetRequest {
+    id: string;
+}

package/dist/types/sdk/generated/ts-client/api/resources/agents/client/requests/AgentsListRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {}
+ */
+export interface AgentsListRequest {
+    /** 1–100, padrão 20. */
+    limit?: number;
+    cursor?: string;
+    "SmoothAgent-Workspace"?: string;
+}

package/dist/types/sdk/generated/ts-client/api/resources/agents/client/requests/index.d.ts

@@ -0,0 +1,2 @@
+export type { AgentsGetRequest } from "./AgentsGetRequest.js";
+export type { AgentsListRequest } from "./AgentsListRequest.js";

package/dist/types/sdk/generated/ts-client/api/resources/agents/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client/index.js";
+export * from "./types/index.js";

package/dist/types/sdk/generated/ts-client/api/resources/agents/types/AgentsGetResponse.d.ts

@@ -0,0 +1,2 @@
+import type * as SmoothAgentApi from "../../../index.js";
+export type AgentsGetResponse = SmoothAgentApi.Agent | SmoothAgentApi.AgentPublic;

package/dist/types/sdk/generated/ts-client/api/resources/agents/types/AgentsListResponse.d.ts

@@ -0,0 +1,12 @@
+import type * as SmoothAgentApi from "../../../index.js";
+export interface AgentsListResponse {
+    data: AgentsListResponse.Data.Item[];
+    hasMore: boolean;
+    nextCursor: string | null;
+}
+export declare namespace AgentsListResponse {
+    type Data = Data.Item[];
+    namespace Data {
+        type Item = SmoothAgentApi.Agent | SmoothAgentApi.AgentPublic;
+    }
+}

package/dist/types/sdk/generated/ts-client/api/resources/agents/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./AgentsGetResponse.js";
+export * from "./AgentsListResponse.js";