@stigmer/sdk 0.0.36

package/src/gen/environment.ts

@@ -0,0 +1,86 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { wrapError } from "./errors";
+import { type DeleteResourceInput, type ResourceRef, type EnvVarInput } from "./types";
+import { create } from "@bufbuild/protobuf";
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { EnvironmentSchema, type Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
+import { EnvironmentCommandController } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/command_pb";
+import { EnvironmentQueryController } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/query_pb";
+import { EnvironmentSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/spec_pb";
+import { ApiResourceIdSchema, ApiResourceReferenceSchema, ApiResourceDeleteInputSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+
+/** Provides operations on environment resources. */
+export class EnvironmentClient {
+  private readonly command: Client<typeof EnvironmentCommandController>;
+  private readonly query: Client<typeof EnvironmentQueryController>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(EnvironmentCommandController, transport);
+    this.query = createClient(EnvironmentQueryController, transport);
+  }
+
+  async apply(input: EnvironmentInput): Promise<Environment> {
+    try {
+      return await this.command.apply(buildEnvironmentProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async create(input: EnvironmentInput): Promise<Environment> {
+    try {
+      return await this.command.create(buildEnvironmentProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async update(input: EnvironmentInput): Promise<Environment> {
+    try {
+      return await this.command.update(buildEnvironmentProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(input: DeleteResourceInput): Promise<Environment> {
+    try {
+      return await this.command.delete(create(ApiResourceDeleteInputSchema, {
+        resourceId: input.resourceId,
+        versionMessage: input.versionMessage,
+        force: input.force,
+      }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<Environment> {
+    try {
+      return await this.query.get(create(ApiResourceIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getByReference(ref: ResourceRef): Promise<Environment> {
+    try {
+      return await this.query.getByReference(create(ApiResourceReferenceSchema, ref));
+    } catch (e) { throw wrapError(e); }
+  }
+}
+
+/** Input for creating/updating a Environment. */
+export interface EnvironmentInput {
+  name: string;
+  org: string;
+  description?: string;
+  data?: Record<string, EnvVarInput>;
+}
+
+function buildEnvironmentProto(input: EnvironmentInput): Environment {
+  return Object.assign(create(EnvironmentSchema), {
+    apiVersion: "agentic.stigmer.ai/v1",
+    kind: "Environment",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      name: input.name,
+      org: input.org,
+    }),
+    spec: Object.assign(create(EnvironmentSpecSchema), {
+      description: input.description,
+      data: input.data,
+    }),
+  }) as Environment;
+}

package/src/gen/errors.ts

@@ -0,0 +1,74 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { ConnectError, Code } from "@connectrpc/connect";
+
+/** Error codes mapped from gRPC/Connect status codes. */
+export type ErrorCode =
+  | "unknown"
+  | "not-found"
+  | "permission-denied"
+  | "unauthenticated"
+  | "invalid-argument"
+  | "already-exists"
+  | "resource-exhausted"
+  | "failed-precondition"
+  | "internal"
+  | "unavailable"
+  | "cancelled";
+
+const CODE_MAP: Record<number, ErrorCode> = {
+  [Code.NotFound]: "not-found",
+  [Code.PermissionDenied]: "permission-denied",
+  [Code.Unauthenticated]: "unauthenticated",
+  [Code.InvalidArgument]: "invalid-argument",
+  [Code.AlreadyExists]: "already-exists",
+  [Code.ResourceExhausted]: "resource-exhausted",
+  [Code.FailedPrecondition]: "failed-precondition",
+  [Code.Internal]: "internal",
+  [Code.Unavailable]: "unavailable",
+  [Code.Canceled]: "cancelled",
+};
+
+/** Structured error type returned by all SDK operations. */
+export class StigmerError extends Error {
+  readonly code: ErrorCode;
+  readonly connectCode: number;
+
+  constructor(code: ErrorCode, message: string, connectCode: number) {
+    super(message);
+    this.name = "StigmerError";
+    this.code = code;
+    this.connectCode = connectCode;
+  }
+}
+
+/** @internal Convert any thrown value to a StigmerError. */
+export function wrapError(err: unknown): StigmerError {
+  if (err instanceof ConnectError) {
+    const code = CODE_MAP[err.code] ?? "unknown";
+    return new StigmerError(code, err.rawMessage || err.message, err.code);
+  }
+  if (err instanceof StigmerError) {
+    return err;
+  }
+  if (err instanceof Error) {
+    return new StigmerError("unknown", err.message, Code.Unknown);
+  }
+  return new StigmerError("unknown", String(err), Code.Unknown);
+}
+
+export function isNotFound(err: unknown): boolean {
+  return err instanceof StigmerError && err.code === "not-found";
+}
+
+export function isUnauthenticated(err: unknown): boolean {
+  return err instanceof StigmerError && err.code === "unauthenticated";
+}
+
+export function isPermissionDenied(err: unknown): boolean {
+  return err instanceof StigmerError && err.code === "permission-denied";
+}
+
+export function isRetryable(err: unknown): boolean {
+  return err instanceof StigmerError && (err.code === "internal" || err.code === "unavailable");
+}

package/src/gen/executioncontext.ts

@@ -0,0 +1,87 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { wrapError } from "./errors";
+import { type DeleteResourceInput, type ResourceRef, type EnvVarInput } from "./types";
+import { create } from "@bufbuild/protobuf";
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { ExecutionContextSchema, type ExecutionContext } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/api_pb";
+import { ExecutionContextCommandController } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/command_pb";
+import { ExecutionContextIdSchema, ExecutionContextExecutionIdInputSchema, type ExecutionContextExecutionIdInput } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/io_pb";
+import { ExecutionContextQueryController } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/query_pb";
+import { ExecutionContextSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/spec_pb";
+import { ApiResourceReferenceSchema, ApiResourceDeleteInputSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+
+/** Provides operations on executioncontext resources. */
+export class ExecutionContextClient {
+  private readonly command: Client<typeof ExecutionContextCommandController>;
+  private readonly query: Client<typeof ExecutionContextQueryController>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(ExecutionContextCommandController, transport);
+    this.query = createClient(ExecutionContextQueryController, transport);
+  }
+
+  async apply(input: ExecutionContextInput): Promise<ExecutionContext> {
+    try {
+      return await this.command.apply(buildExecutionContextProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async create(input: ExecutionContextInput): Promise<ExecutionContext> {
+    try {
+      return await this.command.create(buildExecutionContextProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(input: DeleteResourceInput): Promise<ExecutionContext> {
+    try {
+      return await this.command.delete(create(ApiResourceDeleteInputSchema, {
+        resourceId: input.resourceId,
+        versionMessage: input.versionMessage,
+        force: input.force,
+      }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<ExecutionContext> {
+    try {
+      return await this.query.get(create(ExecutionContextIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getByReference(ref: ResourceRef): Promise<ExecutionContext> {
+    try {
+      return await this.query.getByReference(create(ApiResourceReferenceSchema, ref));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getByExecutionId(input: ExecutionContextExecutionIdInput): Promise<ExecutionContext> {
+    try {
+      return await this.query.getByExecutionId(input);
+    } catch (e) { throw wrapError(e); }
+  }
+}
+
+/** Input for creating/updating a ExecutionContext. */
+export interface ExecutionContextInput {
+  name: string;
+  org: string;
+  executionId?: string;
+  data?: Record<string, EnvVarInput>;
+}
+
+function buildExecutionContextProto(input: ExecutionContextInput): ExecutionContext {
+  return Object.assign(create(ExecutionContextSchema), {
+    apiVersion: "agentic.stigmer.ai/v1",
+    kind: "ExecutionContext",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      name: input.name,
+      org: input.org,
+    }),
+    spec: Object.assign(create(ExecutionContextSpecSchema), {
+      executionId: input.executionId,
+      data: input.data,
+    }),
+  }) as ExecutionContext;
+}

package/src/gen/iampolicy.ts

@@ -0,0 +1,108 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { wrapError } from "./errors";
+import { create } from "@bufbuild/protobuf";
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { IamPolicySchema, type IamPolicy } from "@stigmer/protos/ai/stigmer/iam/iampolicy/v1/api_pb";
+import { IamPolicyCommandController } from "@stigmer/protos/ai/stigmer/iam/iampolicy/v1/command_pb";
+import { IamPolicyIdSchema, CheckAuthorizationInputSchema, CheckAuthorizationResultSchema, ListAuthorizedResourceIdsInputSchema, AuthorizedResourceIdsListSchema, ListAuthorizedPrincipalIdsInputSchema, AuthorizedPrincipalIdsListSchema, type CheckAuthorizationInput, type CheckAuthorizationResult, type ListAuthorizedResourceIdsInput, type AuthorizedResourceIdsList, type ListAuthorizedPrincipalIdsInput, type AuthorizedPrincipalIdsList } from "@stigmer/protos/ai/stigmer/iam/iampolicy/v1/io_pb";
+import { IamPolicyQueryController } from "@stigmer/protos/ai/stigmer/iam/iampolicy/v1/query_pb";
+import { ApiResourceRefSchema, IamPolicySpecSchema, type IamPolicySpec, type ApiResourceRef } from "@stigmer/protos/ai/stigmer/iam/iampolicy/v1/spec_pb";
+
+/** Provides operations on iampolicy resources. */
+export class IamPolicyClient {
+  private readonly command: Client<typeof IamPolicyCommandController>;
+  private readonly query: Client<typeof IamPolicyQueryController>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(IamPolicyCommandController, transport);
+    this.query = createClient(IamPolicyQueryController, transport);
+  }
+
+  async create(input: IamPolicySpec): Promise<IamPolicy> {
+    try {
+      return await this.command.create(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(input: IamPolicySpec): Promise<IamPolicy> {
+    try {
+      return await this.command.delete(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async createPlatformLink(input: IamPolicySpec): Promise<IamPolicy> {
+    try {
+      return await this.command.createPlatformLink(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async bootstrapPolicy(input: IamPolicySpec): Promise<IamPolicy> {
+    try {
+      return await this.command.bootstrapPolicy(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async cleanupResourcePolicies(input: ApiResourceRef): Promise<void> {
+    try {
+      await this.command.cleanupResourcePolicies(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<IamPolicy> {
+    try {
+      return await this.query.get(create(IamPolicyIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async checkAuthorization(input: CheckAuthorizationInput): Promise<CheckAuthorizationResult> {
+    try {
+      return await this.query.checkAuthorization(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async listAuthorizedResourceIds(input: ListAuthorizedResourceIdsInput): Promise<AuthorizedResourceIdsList> {
+    try {
+      return await this.query.listAuthorizedResourceIds(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async listAuthorizedPrincipalIds(input: ListAuthorizedPrincipalIdsInput): Promise<AuthorizedPrincipalIdsList> {
+    try {
+      return await this.query.listAuthorizedPrincipalIds(input);
+    } catch (e) { throw wrapError(e); }
+  }
+}
+
+/** Input for creating/updating a IamPolicy. */
+export interface IamPolicyInput {
+  name: string;
+  org: string;
+  principal: ApiResourceRefInput;
+  resource: ApiResourceRefInput;
+  relation: string;
+}
+
+/** SDK input type for ApiResourceRef. */
+export interface ApiResourceRefInput {
+  kind: string;
+  id: string;
+  relation?: string;
+}
+
+function buildIamPolicyProto(input: IamPolicyInput): IamPolicy {
+  return Object.assign(create(IamPolicySchema), {
+    apiVersion: "iam.stigmer.ai/v1",
+    kind: "IamPolicy",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      name: input.name,
+      org: input.org,
+    }),
+    spec: Object.assign(create(IamPolicySpecSchema), {
+      principal: input.principal,
+      resource: input.resource,
+      relation: input.relation,
+    }),
+  }) as IamPolicy;
+}

package/src/gen/identityaccount.ts

@@ -0,0 +1,115 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { wrapError } from "./errors";
+import { type ResourceRef } from "./types";
+import { create } from "@bufbuild/protobuf";
+import { EmptySchema } from "@bufbuild/protobuf/wkt";
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { type ApiResourceAuditActor } from "@stigmer/protos/ai/stigmer/commons/apiresource/status_pb";
+import { IdentityAccountSchema, type IdentityAccount } from "@stigmer/protos/ai/stigmer/iam/identityaccount/v1/api_pb";
+import { IdentityAccountCommandController } from "@stigmer/protos/ai/stigmer/iam/identityaccount/v1/command_pb";
+import { IdentityAccountProvisioningMode } from "@stigmer/protos/ai/stigmer/iam/identityaccount/v1/enum_pb";
+import { IdentityAccountIdSchema, IdentityAccountEmailSchema, IdpIdSchema, type IdentityAccountEmail } from "@stigmer/protos/ai/stigmer/iam/identityaccount/v1/io_pb";
+import { IdentityAccountQueryController } from "@stigmer/protos/ai/stigmer/iam/identityaccount/v1/query_pb";
+import { IdentityAccountSpecSchema } from "@stigmer/protos/ai/stigmer/iam/identityaccount/v1/spec_pb";
+
+/** Provides operations on identityaccount resources. */
+export class IdentityAccountClient {
+  private readonly command: Client<typeof IdentityAccountCommandController>;
+  private readonly query: Client<typeof IdentityAccountQueryController>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(IdentityAccountCommandController, transport);
+    this.query = createClient(IdentityAccountQueryController, transport);
+  }
+
+  async create(input: IdentityAccountInput): Promise<IdentityAccount> {
+    try {
+      return await this.command.create(buildIdentityAccountProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async update(input: IdentityAccountInput): Promise<IdentityAccount> {
+    try {
+      return await this.command.update(buildIdentityAccountProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(id: string): Promise<IdentityAccount> {
+    try {
+      return await this.command.delete(create(IdentityAccountIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async simulateSignupWebhook(input: IdentityAccountEmail): Promise<void> {
+    try {
+      await this.command.simulateSignupWebhook(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<IdentityAccount> {
+    try {
+      return await this.query.get(create(IdentityAccountIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async whoAmI(): Promise<IdentityAccount> {
+    try {
+      return await this.query.whoAmI(create(EmptySchema, {}));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getByEmail(input: IdentityAccountEmail): Promise<IdentityAccount> {
+    try {
+      return await this.query.getByEmail(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getByIdpId(id: string): Promise<IdentityAccount> {
+    try {
+      return await this.query.getByIdpId(create(IdpIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getActorInfo(id: string): Promise<ApiResourceAuditActor> {
+    try {
+      return await this.query.getActorInfo(create(IdentityAccountIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+}
+
+/** Input for creating/updating a IdentityAccount. */
+export interface IdentityAccountInput {
+  name: string;
+  org: string;
+  idpId: string;
+  email?: string;
+  firstName?: string;
+  lastName?: string;
+  pictureUrl?: string;
+  isMachineAccount?: boolean;
+  provisioningMode?: IdentityAccountProvisioningMode;
+  identityProviderRef?: ResourceRef;
+}
+
+function buildIdentityAccountProto(input: IdentityAccountInput): IdentityAccount {
+  return Object.assign(create(IdentityAccountSchema), {
+    apiVersion: "iam.stigmer.ai/v1",
+    kind: "IdentityAccount",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      name: input.name,
+      org: input.org,
+    }),
+    spec: Object.assign(create(IdentityAccountSpecSchema), {
+      idpId: input.idpId,
+      email: input.email,
+      firstName: input.firstName,
+      lastName: input.lastName,
+      pictureUrl: input.pictureUrl,
+      isMachineAccount: input.isMachineAccount,
+      provisioningMode: input.provisioningMode,
+      identityProviderRef: input.identityProviderRef,
+    }),
+  }) as IdentityAccount;
+}

package/src/gen/identityprovider.ts

@@ -0,0 +1,94 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { wrapError } from "./errors";
+import { type DeleteResourceInput, type ResourceRef } from "./types";
+import { create } from "@bufbuild/protobuf";
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { ApiResourceIdSchema, ApiResourceReferenceSchema, ApiResourceDeleteInputSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { IdentityProviderSchema, type IdentityProvider } from "@stigmer/protos/ai/stigmer/iam/identityprovider/v1/api_pb";
+import { IdentityProviderCommandController } from "@stigmer/protos/ai/stigmer/iam/identityprovider/v1/command_pb";
+import { IdentityProviderQueryController } from "@stigmer/protos/ai/stigmer/iam/identityprovider/v1/query_pb";
+import { IdentityProviderSpecSchema } from "@stigmer/protos/ai/stigmer/iam/identityprovider/v1/spec_pb";
+
+/** Provides operations on identityprovider resources. */
+export class IdentityProviderClient {
+  private readonly command: Client<typeof IdentityProviderCommandController>;
+  private readonly query: Client<typeof IdentityProviderQueryController>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(IdentityProviderCommandController, transport);
+    this.query = createClient(IdentityProviderQueryController, transport);
+  }
+
+  async apply(input: IdentityProviderInput): Promise<IdentityProvider> {
+    try {
+      return await this.command.apply(buildIdentityProviderProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async create(input: IdentityProviderInput): Promise<IdentityProvider> {
+    try {
+      return await this.command.create(buildIdentityProviderProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async update(input: IdentityProviderInput): Promise<IdentityProvider> {
+    try {
+      return await this.command.update(buildIdentityProviderProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(input: DeleteResourceInput): Promise<IdentityProvider> {
+    try {
+      return await this.command.delete(create(ApiResourceDeleteInputSchema, {
+        resourceId: input.resourceId,
+        versionMessage: input.versionMessage,
+        force: input.force,
+      }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<IdentityProvider> {
+    try {
+      return await this.query.get(create(ApiResourceIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getByReference(ref: ResourceRef): Promise<IdentityProvider> {
+    try {
+      return await this.query.getByReference(create(ApiResourceReferenceSchema, ref));
+    } catch (e) { throw wrapError(e); }
+  }
+}
+
+/** Input for creating/updating a IdentityProvider. */
+export interface IdentityProviderInput {
+  name: string;
+  org: string;
+  displayName?: string;
+  jwksUri?: string;
+  allowedIssuers?: string[];
+  expectedAudience?: string;
+  rateLimitBudget?: number;
+  userinfoEndpoint?: string;
+}
+
+function buildIdentityProviderProto(input: IdentityProviderInput): IdentityProvider {
+  return Object.assign(create(IdentityProviderSchema), {
+    apiVersion: "iam.stigmer.ai/v1",
+    kind: "IdentityProvider",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      name: input.name,
+      org: input.org,
+    }),
+    spec: Object.assign(create(IdentityProviderSpecSchema), {
+      displayName: input.displayName,
+      jwksUri: input.jwksUri,
+      allowedIssuers: input.allowedIssuers,
+      expectedAudience: input.expectedAudience,
+      rateLimitBudget: input.rateLimitBudget,
+      userinfoEndpoint: input.userinfoEndpoint,
+    }),
+  }) as IdentityProvider;
+}