@stigmer/sdk 0.0.36

package/errors.js

@@ -0,0 +1,163 @@
+import { ConnectError, Code } from "@connectrpc/connect";
+import { StigmerError } from "./gen/errors";
+// Re-export generated error types
+export { StigmerError, wrapError, isNotFound, isUnauthenticated, isPermissionDenied, isRetryable, } from "./gen/errors";
+const CONNECT_CODE_TO_CATEGORY = {
+    [Code.Unauthenticated]: "auth",
+    [Code.PermissionDenied]: "permission",
+    [Code.NotFound]: "not-found",
+    [Code.InvalidArgument]: "validation",
+    [Code.FailedPrecondition]: "validation",
+    [Code.OutOfRange]: "validation",
+    [Code.AlreadyExists]: "validation",
+    [Code.Aborted]: "validation",
+    [Code.Internal]: "server",
+    [Code.Unknown]: "server",
+    [Code.DataLoss]: "server",
+    [Code.Unimplemented]: "server",
+    [Code.Unavailable]: "unavailable",
+    [Code.DeadlineExceeded]: "unavailable",
+    [Code.ResourceExhausted]: "unavailable",
+    [Code.Canceled]: "cancelled",
+};
+const ERROR_CODE_TO_CATEGORY = {
+    unauthenticated: "auth",
+    "permission-denied": "permission",
+    "not-found": "not-found",
+    "invalid-argument": "validation",
+    "already-exists": "validation",
+    "failed-precondition": "validation",
+    "resource-exhausted": "unavailable",
+    internal: "server",
+    unavailable: "unavailable",
+    cancelled: "cancelled",
+    unknown: "server",
+};
+/**
+ * Narrow an unknown thrown value to {@link ConnectError}.
+ *
+ * Uses `ConnectError[Symbol.hasInstance]` which handles cross-package
+ * identity correctly (multiple copies of `@connectrpc/connect` in the
+ * dependency tree).
+ */
+export function isConnectError(error) {
+    return error instanceof ConnectError;
+}
+/**
+ * Map any thrown value to an {@link ErrorCategory}.
+ *
+ * Handles both {@link StigmerError} (thrown by SDK methods) and raw
+ * {@link ConnectError} (from direct transport usage). All other values
+ * are classified as `"unknown"`.
+ */
+export function classifyError(error) {
+    if (error instanceof StigmerError) {
+        return ERROR_CODE_TO_CATEGORY[error.code] ?? "unknown";
+    }
+    if (isConnectError(error)) {
+        return CONNECT_CODE_TO_CATEGORY[error.code] ?? "unknown";
+    }
+    return "unknown";
+}
+const RETRYABLE_CATEGORIES = new Set([
+    "server",
+    "unavailable",
+]);
+/**
+ * Whether the error represents a transient failure worth retrying.
+ *
+ * Only `server` and `unavailable` categories are retryable. Auth, permission,
+ * not-found, and validation errors are deterministic — the same request
+ * will produce the same failure.
+ */
+export function isRetryableError(error) {
+    return RETRYABLE_CATEGORIES.has(classifyError(error));
+}
+const CATEGORY_FALLBACKS = {
+    auth: "Your session has expired. Please sign in again.",
+    permission: "You do not have permission to perform this action.",
+    "not-found": "The requested resource was not found.",
+    validation: "The request contains invalid data.",
+    server: "An unexpected server error occurred. Please try again.",
+    unavailable: "The server is temporarily unavailable. Please try again in a moment.",
+    cancelled: "The request was cancelled.",
+    unknown: "An unexpected error occurred.",
+};
+const INFRA_NOISE_PATTERNS = [
+    [/no healthy upstream/i, "The server is temporarily unavailable."],
+    [/ECONNREFUSED/i, "Unable to connect to the server."],
+    [/ECONNRESET/i, "The connection to the server was lost."],
+    [/ETIMEDOUT/i, "The request timed out. Please try again."],
+    [/fetch failed/i, "Unable to reach the server. Check your connection."],
+    [/network error/i, "A network error occurred. Check your connection."],
+    [/failed to fetch/i, "Unable to reach the server. Check your connection."],
+    [/load balancer/i, "The server is temporarily unavailable."],
+];
+/**
+ * Extract a clean, user-appropriate error message from any thrown value.
+ *
+ * 1. For {@link StigmerError} or {@link ConnectError}, uses the raw message
+ *    (which excludes the `[code]` prefix added by Connect-RPC).
+ * 2. Sanitizes infrastructure noise (e.g., "no healthy upstream") into
+ *    readable text.
+ * 3. Falls back to a category-specific default when the raw message is
+ *    empty or is infrastructure noise.
+ *
+ * @param error    — the thrown value (typically from a catch block)
+ * @param fallback — optional override for the default fallback message
+ */
+export function getUserMessage(error, fallback) {
+    const raw = extractRawMessage(error);
+    const sanitized = sanitizeMessage(raw);
+    if (sanitized)
+        return sanitized;
+    const category = classifyError(error);
+    return fallback ?? CATEGORY_FALLBACKS[category];
+}
+function extractRawMessage(error) {
+    if (error instanceof StigmerError) {
+        return error.message;
+    }
+    if (isConnectError(error)) {
+        return error.rawMessage;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === "string") {
+        return error;
+    }
+    return "";
+}
+function sanitizeMessage(message) {
+    if (!message)
+        return "";
+    for (const [pattern, replacement] of INFRA_NOISE_PATTERNS) {
+        if (pattern.test(message))
+            return replacement;
+    }
+    return message;
+}
+const rpcMetadataStore = new WeakMap();
+/**
+ * Attach RPC call metadata to an error object.
+ *
+ * Called by the metadata interceptor — application code should use
+ * {@link getRpcMetadata} to read metadata, not this function.
+ *
+ * @internal
+ */
+export function annotateRpcError(error, metadata) {
+    rpcMetadataStore.set(error, metadata);
+}
+/**
+ * Retrieve RPC metadata previously attached by the metadata interceptor.
+ * Returns `undefined` if the error was not annotated.
+ */
+export function getRpcMetadata(error) {
+    if (error !== null && typeof error === "object") {
+        return rpcMetadataStore.get(error);
+    }
+    return undefined;
+}
+//# sourceMappingURL=errors.js.map

package/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/gen/agent.d.ts

@@ -0,0 +1,56 @@
+import { type ListParams, type ListResult, type EnvSpecInput, type ResourceRef } from "./types";
+import { type Transport } from "@connectrpc/connect";
+import { type Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+/** Provides operations on agent resources. */
+export declare class AgentClient {
+    private readonly command;
+    private readonly query;
+    private readonly search;
+    constructor(transport: Transport);
+    apply(input: AgentInput): Promise<Agent>;
+    create(input: AgentInput): Promise<Agent>;
+    update(input: AgentInput): Promise<Agent>;
+    delete(id: string): Promise<Agent>;
+    get(id: string): Promise<Agent>;
+    getByReference(ref: ResourceRef): Promise<Agent>;
+    list(params: ListParams): Promise<ListResult>;
+}
+/** Input for creating/updating a Agent. */
+export interface AgentInput {
+    name: string;
+    org: string;
+    description?: string;
+    iconUrl?: string;
+    instructions?: string;
+    mcpServerUsages?: McpServerUsageInput[];
+    skillRefs?: ResourceRef[];
+    subAgents?: SubAgentInput[];
+    envSpec?: EnvSpecInput;
+}
+/** SDK input type for McpServerUsage. */
+export interface McpServerUsageInput {
+    mcpServerRef: ResourceRef;
+    enabledTools?: string[];
+    toolApprovalOverrides?: ToolApprovalOverrideInput[];
+}
+/** SDK input type for ToolApprovalOverride. */
+export interface ToolApprovalOverrideInput {
+    toolName?: string;
+    requiresApproval?: boolean;
+    message?: string;
+}
+/** SDK input type for SubAgent. */
+export interface SubAgentInput {
+    name: string;
+    description?: string;
+    instructions?: string;
+    mcpAccess?: McpAccessInput[];
+    skillRefs?: ResourceRef[];
+    modelOverride?: string;
+}
+/** SDK input type for McpAccess. */
+export interface McpAccessInput {
+    mcpServer: string;
+    enabledTools?: string[];
+}
+//# sourceMappingURL=agent.d.ts.map

package/gen/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/gen/agent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhG,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAY7F,8CAA8C;AAC9C,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;gBAE1C,SAAS,EAAE,SAAS;IAM1B,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAMxC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAMzC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAMzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAMlC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAM/B,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;IAMhD,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAgBpD;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACxC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,yCAAyC;AACzC,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qBAAqB,CAAC,EAAE,yBAAyB,EAAE,CAAC;CACrD;AAED,+CAA+C;AAC/C,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/gen/agent.js

@@ -0,0 +1,113 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+import { wrapError } from "./errors";
+import { create } from "@bufbuild/protobuf";
+import { createClient } from "@connectrpc/connect";
+import { AgentSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import { AgentCommandController } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/command_pb";
+import { AgentIdSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/io_pb";
+import { AgentQueryController } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/query_pb";
+import { AgentSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/spec_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { ApiResourceReferenceSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { PageInfoSchema } from "@stigmer/protos/ai/stigmer/commons/rpc/pagination_pb";
+import { SearchRequestSchema } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+import { SearchService } from "@stigmer/protos/ai/stigmer/search/v1/query_pb";
+/** Provides operations on agent resources. */
+export class AgentClient {
+    command;
+    query;
+    search;
+    constructor(transport) {
+        this.command = createClient(AgentCommandController, transport);
+        this.query = createClient(AgentQueryController, transport);
+        this.search = createClient(SearchService, transport);
+    }
+    async apply(input) {
+        try {
+            return await this.command.apply(buildAgentProto(input));
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async create(input) {
+        try {
+            return await this.command.create(buildAgentProto(input));
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async update(input) {
+        try {
+            return await this.command.update(buildAgentProto(input));
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async delete(id) {
+        try {
+            return await this.command.delete(create(AgentIdSchema, { value: id }));
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async get(id) {
+        try {
+            return await this.query.get(create(AgentIdSchema, { value: id }));
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async getByReference(ref) {
+        try {
+            return await this.query.getByReference(create(ApiResourceReferenceSchema, ref));
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async list(params) {
+        try {
+            const resp = await this.search.search(create(SearchRequestSchema, {
+                kinds: [ApiResourceKind.agent],
+                query: params.query,
+                org: params.org,
+                excludePublic: params.excludePublic ?? false,
+                page: params.page ? create(PageInfoSchema, params.page) : undefined,
+            }));
+            return {
+                entries: resp.entries,
+                totalCount: resp.totalCount,
+                totalPages: resp.totalPages,
+            };
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+}
+function buildAgentProto(input) {
+    return Object.assign(create(AgentSchema), {
+        apiVersion: "agentic.stigmer.ai/v1",
+        kind: "Agent",
+        metadata: Object.assign(create(ApiResourceMetadataSchema), {
+            name: input.name,
+            org: input.org,
+        }),
+        spec: Object.assign(create(AgentSpecSchema), {
+            description: input.description,
+            iconUrl: input.iconUrl,
+            instructions: input.instructions,
+            mcpServerUsages: input.mcpServerUsages,
+            skillRefs: input.skillRefs,
+            subAgents: input.subAgents,
+            envSpec: input.envSpec,
+        }),
+    });
+}
+//# sourceMappingURL=agent.js.map

package/gen/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/gen/agent.ts"],"names":[],"mappings":"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"}

package/gen/agentexecution.d.ts

@@ -0,0 +1,68 @@
+import { type EnvVarInput } from "./types";
+import { type Transport } from "@connectrpc/connect";
+import { type AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { type AgentExecutionUpdateStatusInput, type SubmitApprovalInput, type CancelAgentExecutionInput, type TerminateAgentExecutionInput, type RecoverAgentExecutionInput, type PauseAgentExecutionInput, type ResumeAgentExecutionInput, type UploadAttachmentRequest, type UploadAttachmentResponse, type ListAgentExecutionsRequest, type AgentExecutionList, type ListAgentExecutionsBySessionRequest, type GetArtifactDownloadUrlRequest, type GetArtifactDownloadUrlResponse, type GetSessionUsageReportInput, type GetSessionUsageReportOutput, type GetAgentUsageReportInput, type GetAgentUsageReportOutput, type GetOrgUsageReportInput, type GetOrgUsageReportOutput } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+/** Provides operations on agentexecution resources. */
+export declare class AgentExecutionClient {
+    private readonly command;
+    private readonly query;
+    constructor(transport: Transport);
+    create(input: AgentExecutionInput): Promise<AgentExecution>;
+    update(input: AgentExecutionInput): Promise<AgentExecution>;
+    updateStatus(input: AgentExecutionUpdateStatusInput): Promise<AgentExecution>;
+    delete(id: string): Promise<AgentExecution>;
+    submitApproval(input: SubmitApprovalInput): Promise<AgentExecution>;
+    cancel(input: CancelAgentExecutionInput): Promise<AgentExecution>;
+    terminate(input: TerminateAgentExecutionInput): Promise<AgentExecution>;
+    recover(input: RecoverAgentExecutionInput): Promise<AgentExecution>;
+    pause(input: PauseAgentExecutionInput): Promise<AgentExecution>;
+    resume(input: ResumeAgentExecutionInput): Promise<AgentExecution>;
+    uploadAttachment(input: UploadAttachmentRequest): Promise<UploadAttachmentResponse>;
+    get(id: string): Promise<AgentExecution>;
+    list(input: ListAgentExecutionsRequest): Promise<AgentExecutionList>;
+    listBySession(input: ListAgentExecutionsBySessionRequest): Promise<AgentExecutionList>;
+    subscribe(id: string, signal?: AbortSignal): AsyncGenerator<AgentExecution>;
+    getArtifactDownloadUrl(input: GetArtifactDownloadUrlRequest): Promise<GetArtifactDownloadUrlResponse>;
+    getSessionUsageReport(input: GetSessionUsageReportInput): Promise<GetSessionUsageReportOutput>;
+    getAgentUsageReport(input: GetAgentUsageReportInput): Promise<GetAgentUsageReportOutput>;
+    getOrgUsageReport(input: GetOrgUsageReportInput): Promise<GetOrgUsageReportOutput>;
+}
+/** Input for creating/updating a AgentExecution. */
+export interface AgentExecutionInput {
+    name: string;
+    org: string;
+    sessionId?: string;
+    agentId?: string;
+    message?: string;
+    executionConfig?: ExecutionConfigInput;
+    runtimeEnv?: Record<string, EnvVarInput>;
+    callbackToken?: Uint8Array;
+    autoApproveAll?: boolean;
+    parentWorkflowId?: string;
+    attachments?: AttachmentInput[];
+    workspaceFileRefs?: string[];
+}
+/** SDK input type for ExecutionConfig. */
+export interface ExecutionConfigInput {
+    modelName?: string;
+    contextManagement?: ContextManagementConfigInput;
+    maxToolRounds?: number;
+    maxToolResultChars?: number;
+    maxCostUsd?: number;
+}
+/** SDK input type for ContextManagementConfig. */
+export interface ContextManagementConfigInput {
+    disableSummarization?: boolean;
+    customTriggerThreshold?: number;
+    customTargetTokens?: number;
+}
+/** SDK input type for Attachment. */
+export interface AttachmentInput {
+    filename?: string;
+    storageKey?: string;
+    mountPath?: string;
+    contentType?: string;
+    extract?: boolean;
+    localPath?: string;
+}
+//# sourceMappingURL=agentexecution.d.ts.map

package/gen/agentexecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentexecution.d.ts","sourceRoot":"","sources":["../../src/gen/agentexecution.ts"],"names":[],"mappings":"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"}

package/gen/agentexecution.js

@@ -0,0 +1,197 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+import { wrapError } from "./errors";
+import { create } from "@bufbuild/protobuf";
+import { createClient } from "@connectrpc/connect";
+import { AgentExecutionSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { AgentExecutionCommandController } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/command_pb";
+import { AgentExecutionIdSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { AgentExecutionQueryController } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/query_pb";
+import { AgentExecutionSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/spec_pb";
+import { ApiResourceIdSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+/** Provides operations on agentexecution resources. */
+export class AgentExecutionClient {
+    command;
+    query;
+    constructor(transport) {
+        this.command = createClient(AgentExecutionCommandController, transport);
+        this.query = createClient(AgentExecutionQueryController, transport);
+    }
+    async create(input) {
+        try {
+            return await this.command.create(buildAgentExecutionProto(input));
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async update(input) {
+        try {
+            return await this.command.update(buildAgentExecutionProto(input));
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async updateStatus(input) {
+        try {
+            return await this.command.updateStatus(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async delete(id) {
+        try {
+            return await this.command.delete(create(ApiResourceIdSchema, { value: id }));
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async submitApproval(input) {
+        try {
+            return await this.command.submitApproval(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async cancel(input) {
+        try {
+            return await this.command.cancel(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async terminate(input) {
+        try {
+            return await this.command.terminate(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async recover(input) {
+        try {
+            return await this.command.recover(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async pause(input) {
+        try {
+            return await this.command.pause(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async resume(input) {
+        try {
+            return await this.command.resume(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async uploadAttachment(input) {
+        try {
+            return await this.command.uploadAttachment(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async get(id) {
+        try {
+            return await this.query.get(create(AgentExecutionIdSchema, { value: id }));
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async list(input) {
+        try {
+            return await this.query.list(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async listBySession(input) {
+        try {
+            return await this.query.listBySession(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async *subscribe(id, signal) {
+        try {
+            for await (const msg of this.query.subscribe(create(AgentExecutionIdSchema, { value: id }), { signal })) {
+                yield msg;
+            }
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async getArtifactDownloadUrl(input) {
+        try {
+            return await this.query.getArtifactDownloadUrl(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async getSessionUsageReport(input) {
+        try {
+            return await this.query.getSessionUsageReport(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async getAgentUsageReport(input) {
+        try {
+            return await this.query.getAgentUsageReport(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+    async getOrgUsageReport(input) {
+        try {
+            return await this.query.getOrgUsageReport(input);
+        }
+        catch (e) {
+            throw wrapError(e);
+        }
+    }
+}
+function buildAgentExecutionProto(input) {
+    return Object.assign(create(AgentExecutionSchema), {
+        apiVersion: "agentic.stigmer.ai/v1",
+        kind: "AgentExecution",
+        metadata: Object.assign(create(ApiResourceMetadataSchema), {
+            name: input.name,
+            org: input.org,
+        }),
+        spec: Object.assign(create(AgentExecutionSpecSchema), {
+            sessionId: input.sessionId,
+            agentId: input.agentId,
+            message: input.message,
+            executionConfig: input.executionConfig,
+            runtimeEnv: input.runtimeEnv,
+            callbackToken: input.callbackToken,
+            autoApproveAll: input.autoApproveAll,
+            parentWorkflowId: input.parentWorkflowId,
+            attachments: input.attachments,
+            workspaceFileRefs: input.workspaceFileRefs,
+        }),
+    });
+}
+//# sourceMappingURL=agentexecution.js.map

package/gen/agentexecution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentexecution.js","sourceRoot":"","sources":["../../src/gen/agentexecution.ts"],"names":[],"mappings":"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"}

package/gen/agentinstance.d.ts

@@ -0,0 +1,26 @@
+import { type ResourceRef } from "./types";
+import { type Transport } from "@connectrpc/connect";
+import { type AgentInstance } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/api_pb";
+import { type GetAgentInstancesByAgentRequest, type AgentInstanceList } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/io_pb";
+/** Provides operations on agentinstance resources. */
+export declare class AgentInstanceClient {
+    private readonly command;
+    private readonly query;
+    constructor(transport: Transport);
+    apply(input: AgentInstanceInput): Promise<AgentInstance>;
+    create(input: AgentInstanceInput): Promise<AgentInstance>;
+    update(input: AgentInstanceInput): Promise<AgentInstance>;
+    delete(id: string): Promise<AgentInstance>;
+    get(id: string): Promise<AgentInstance>;
+    getByAgent(input: GetAgentInstancesByAgentRequest): Promise<AgentInstanceList>;
+    getByReference(ref: ResourceRef): Promise<AgentInstance>;
+}
+/** Input for creating/updating a AgentInstance. */
+export interface AgentInstanceInput {
+    name: string;
+    org: string;
+    agentId?: string;
+    description?: string;
+    environmentRefs?: ResourceRef[];
+}
+//# sourceMappingURL=agentinstance.d.ts.map