@stigmer/sdk 0.0.36

package/src/gen/mcpserver.ts

@@ -0,0 +1,147 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { wrapError } from "./errors";
+import { type DeleteResourceInput, type ListParams, type ListResult, type EnvSpecInput, type ResourceRef } from "./types";
+import { create } from "@bufbuild/protobuf";
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { McpServerSchema, type McpServer } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
+import { McpServerCommandController } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/command_pb";
+import { UpdateDiscoveredCapabilitiesInputSchema, type UpdateDiscoveredCapabilitiesInput } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/io_pb";
+import { McpServerQueryController } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/query_pb";
+import { McpServerSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/spec_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_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";
+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 mcpserver resources. */
+export class McpServerClient {
+  private readonly command: Client<typeof McpServerCommandController>;
+  private readonly query: Client<typeof McpServerQueryController>;
+  private readonly search: Client<typeof SearchService>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(McpServerCommandController, transport);
+    this.query = createClient(McpServerQueryController, transport);
+    this.search = createClient(SearchService, transport);
+  }
+
+  async apply(input: McpServerInput): Promise<McpServer> {
+    try {
+      return await this.command.apply(buildMcpServerProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async create(input: McpServerInput): Promise<McpServer> {
+    try {
+      return await this.command.create(buildMcpServerProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async update(input: McpServerInput): Promise<McpServer> {
+    try {
+      return await this.command.update(buildMcpServerProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(input: DeleteResourceInput): Promise<McpServer> {
+    try {
+      return await this.command.delete(create(ApiResourceDeleteInputSchema, {
+        resourceId: input.resourceId,
+        versionMessage: input.versionMessage,
+        force: input.force,
+      }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async updateDiscoveredCapabilities(input: UpdateDiscoveredCapabilitiesInput): Promise<McpServer> {
+    try {
+      return await this.command.updateDiscoveredCapabilities(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<McpServer> {
+    try {
+      return await this.query.get(create(ApiResourceIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getByReference(ref: ResourceRef): Promise<McpServer> {
+    try {
+      return await this.query.getByReference(create(ApiResourceReferenceSchema, ref));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async list(params: ListParams): Promise<ListResult> {
+    try {
+      const resp = await this.search.search(create(SearchRequestSchema, {
+        kinds: [ApiResourceKind.mcp_server],
+        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); }
+  }
+}
+
+/** Input for creating/updating a McpServer. */
+export interface McpServerInput {
+  name: string;
+  org: string;
+  description?: string;
+  iconUrl?: string;
+  stdio?: StdioServerConfigInput;
+  http?: HttpServerConfigInput;
+  defaultEnabledTools?: string[];
+  envSpec?: EnvSpecInput;
+  defaultToolApprovals?: ToolApprovalPolicyInput[];
+}
+
+/** SDK input type for StdioServerConfig. */
+export interface StdioServerConfigInput {
+  command: string;
+  args?: string[];
+  workingDir?: string;
+}
+
+/** SDK input type for HttpServerConfig. */
+export interface HttpServerConfigInput {
+  url: string;
+  headers?: Record<string, string>;
+  queryParams?: Record<string, string>;
+  timeoutSeconds?: number;
+}
+
+/** SDK input type for ToolApprovalPolicy. */
+export interface ToolApprovalPolicyInput {
+  toolName?: string;
+  message?: string;
+}
+
+function buildMcpServerProto(input: McpServerInput): McpServer {
+  return Object.assign(create(McpServerSchema), {
+    apiVersion: "agentic.stigmer.ai/v1",
+    kind: "McpServer",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      name: input.name,
+      org: input.org,
+    }),
+    spec: Object.assign(create(McpServerSpecSchema), {
+      description: input.description,
+      iconUrl: input.iconUrl,
+      stdio: input.stdio,
+      http: input.http,
+      defaultEnabledTools: input.defaultEnabledTools,
+      envSpec: input.envSpec,
+      defaultToolApprovals: input.defaultToolApprovals,
+    }),
+  }) as McpServer;
+}

package/src/gen/organization.ts

@@ -0,0 +1,103 @@
+// 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 { type FindApiResourcesRequest } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { OrganizationSchema, type Organization } from "@stigmer/protos/ai/stigmer/tenancy/organization/v1/api_pb";
+import { OrganizationCommandController } from "@stigmer/protos/ai/stigmer/tenancy/organization/v1/command_pb";
+import { ManagementMode } from "@stigmer/protos/ai/stigmer/tenancy/organization/v1/enum_pb";
+import { OrganizationIdSchema, OrganizationListSchema, OrganizationsSchema, OrganizationExternalLookupSchema, type OrganizationList, type Organizations, type OrganizationExternalLookup } from "@stigmer/protos/ai/stigmer/tenancy/organization/v1/io_pb";
+import { OrganizationQueryController } from "@stigmer/protos/ai/stigmer/tenancy/organization/v1/query_pb";
+import { OrganizationSpecSchema } from "@stigmer/protos/ai/stigmer/tenancy/organization/v1/spec_pb";
+
+/** Provides operations on organization resources. */
+export class OrganizationClient {
+  private readonly command: Client<typeof OrganizationCommandController>;
+  private readonly query: Client<typeof OrganizationQueryController>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(OrganizationCommandController, transport);
+    this.query = createClient(OrganizationQueryController, transport);
+  }
+
+  async apply(input: OrganizationInput): Promise<Organization> {
+    try {
+      return await this.command.apply(buildOrganizationProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async create(input: OrganizationInput): Promise<Organization> {
+    try {
+      return await this.command.create(buildOrganizationProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async update(input: OrganizationInput): Promise<Organization> {
+    try {
+      return await this.command.update(buildOrganizationProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(id: string): Promise<Organization> {
+    try {
+      return await this.command.delete(create(OrganizationIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<Organization> {
+    try {
+      return await this.query.get(create(OrganizationIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async find(input: FindApiResourcesRequest): Promise<OrganizationList> {
+    try {
+      return await this.query.find(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async findMyOrganizations(): Promise<Organizations> {
+    try {
+      return await this.query.findMyOrganizations(create(EmptySchema, {}));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getByExternalOrgId(input: OrganizationExternalLookup): Promise<Organization> {
+    try {
+      return await this.query.getByExternalOrgId(input);
+    } catch (e) { throw wrapError(e); }
+  }
+}
+
+/** Input for creating/updating a Organization. */
+export interface OrganizationInput {
+  name: string;
+  org: string;
+  description?: string;
+  logoUrl?: string;
+  managementMode?: ManagementMode;
+  identityProviderRef?: ResourceRef;
+  externalOrgId?: string;
+}
+
+function buildOrganizationProto(input: OrganizationInput): Organization {
+  return Object.assign(create(OrganizationSchema), {
+    apiVersion: "tenancy.stigmer.ai/v1",
+    kind: "Organization",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      name: input.name,
+      org: input.org,
+    }),
+    spec: Object.assign(create(OrganizationSpecSchema), {
+      description: input.description,
+      logoUrl: input.logoUrl,
+      managementMode: input.managementMode,
+      identityProviderRef: input.identityProviderRef,
+      externalOrgId: input.externalOrgId,
+    }),
+  }) as Organization;
+}

package/src/gen/project.ts

@@ -0,0 +1,85 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { wrapError } from "./errors";
+import { type ResourceRef } from "./types";
+import { create } from "@bufbuild/protobuf";
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { ApiResourceReferenceSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { ProjectSchema, type Project } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/api_pb";
+import { ProjectCommandController } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/command_pb";
+import { ProjectIdSchema } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/io_pb";
+import { ProjectQueryController } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/query_pb";
+import { ProjectSpecSchema } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/spec_pb";
+
+/** Provides operations on project resources. */
+export class ProjectClient {
+  private readonly command: Client<typeof ProjectCommandController>;
+  private readonly query: Client<typeof ProjectQueryController>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(ProjectCommandController, transport);
+    this.query = createClient(ProjectQueryController, transport);
+  }
+
+  async apply(input: ProjectInput): Promise<Project> {
+    try {
+      return await this.command.apply(buildProjectProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async create(input: ProjectInput): Promise<Project> {
+    try {
+      return await this.command.create(buildProjectProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async update(input: ProjectInput): Promise<Project> {
+    try {
+      return await this.command.update(buildProjectProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(id: string): Promise<Project> {
+    try {
+      return await this.command.delete(create(ProjectIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<Project> {
+    try {
+      return await this.query.get(create(ProjectIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getByReference(ref: ResourceRef): Promise<Project> {
+    try {
+      return await this.query.getByReference(create(ApiResourceReferenceSchema, ref));
+    } catch (e) { throw wrapError(e); }
+  }
+}
+
+/** Input for creating/updating a Project. */
+export interface ProjectInput {
+  name: string;
+  org: string;
+  entryPoint?: string;
+  description?: string;
+  members?: ResourceRef[];
+}
+
+function buildProjectProto(input: ProjectInput): Project {
+  return Object.assign(create(ProjectSchema), {
+    apiVersion: "tenancy.stigmer.ai/v1",
+    kind: "Project",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      name: input.name,
+      org: input.org,
+    }),
+    spec: Object.assign(create(ProjectSpecSchema), {
+      entryPoint: input.entryPoint,
+      description: input.description,
+      members: input.members,
+    }),
+  }) as Project;
+}

package/src/gen/session.ts

@@ -0,0 +1,120 @@
+// 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 { SessionSchema, type Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+import { SessionCommandController } from "@stigmer/protos/ai/stigmer/agentic/session/v1/command_pb";
+import { SessionIdSchema, ListSessionsRequestSchema, SessionListSchema, ListSessionsByAgentRequestSchema, type ListSessionsRequest, type SessionList, type ListSessionsByAgentRequest } from "@stigmer/protos/ai/stigmer/agentic/session/v1/io_pb";
+import { SessionQueryController } from "@stigmer/protos/ai/stigmer/agentic/session/v1/query_pb";
+import { SessionSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/spec_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+
+/** Provides operations on session resources. */
+export class SessionClient {
+  private readonly command: Client<typeof SessionCommandController>;
+  private readonly query: Client<typeof SessionQueryController>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(SessionCommandController, transport);
+    this.query = createClient(SessionQueryController, transport);
+  }
+
+  async apply(input: SessionInput): Promise<Session> {
+    try {
+      return await this.command.apply(buildSessionProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async create(input: SessionInput): Promise<Session> {
+    try {
+      return await this.command.create(buildSessionProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async update(input: SessionInput): Promise<Session> {
+    try {
+      return await this.command.update(buildSessionProto(input));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(id: string): Promise<Session> {
+    try {
+      return await this.command.delete(create(SessionIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<Session> {
+    try {
+      return await this.query.get(create(SessionIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async list(input: ListSessionsRequest): Promise<SessionList> {
+    try {
+      return await this.query.list(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async listByAgent(input: ListSessionsByAgentRequest): Promise<SessionList> {
+    try {
+      return await this.query.listByAgent(input);
+    } catch (e) { throw wrapError(e); }
+  }
+}
+
+/** Input for creating/updating a Session. */
+export interface SessionInput {
+  name: string;
+  org: string;
+  agentInstanceId: string;
+  subject?: string;
+  threadId?: string;
+  sandboxId?: string;
+  metadata?: Record<string, string>;
+  workspaceEntries?: WorkspaceEntryInput[];
+}
+
+/** SDK input type for WorkspaceEntry. */
+export interface WorkspaceEntryInput {
+  name?: string;
+  source: WorkspaceSourceInput;
+}
+
+/** SDK input type for WorkspaceSource. */
+export interface WorkspaceSourceInput {
+  gitRepo?: GitRepoSourceInput;
+  localPath?: LocalPathSourceInput;
+}
+
+/** SDK input type for GitRepoSource. */
+export interface GitRepoSourceInput {
+  url: string;
+  branch?: string;
+  commit?: string;
+  depth?: number;
+}
+
+/** SDK input type for LocalPathSource. */
+export interface LocalPathSourceInput {
+  path?: string;
+}
+
+function buildSessionProto(input: SessionInput): Session {
+  return Object.assign(create(SessionSchema), {
+    apiVersion: "agentic.stigmer.ai/v1",
+    kind: "Session",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      name: input.name,
+      org: input.org,
+    }),
+    spec: Object.assign(create(SessionSpecSchema), {
+      agentInstanceId: input.agentInstanceId,
+      subject: input.subject,
+      threadId: input.threadId,
+      sandboxId: input.sandboxId,
+      metadata: input.metadata,
+      workspaceEntries: input.workspaceEntries,
+    }),
+  }) as Session;
+}

package/src/gen/skill.ts

@@ -0,0 +1,102 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import { wrapError } from "./errors";
+import { type ListParams, type ListResult, type ResourceRef } from "./types";
+import { create } from "@bufbuild/protobuf";
+import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { SkillSchema, type Skill } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/api_pb";
+import { SkillCommandController } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/command_pb";
+import { SkillIdSchema, PushSkillRequestSchema, GetArtifactRequestSchema, GetArtifactResponseSchema, type PushSkillRequest, type GetArtifactRequest, type GetArtifactResponse } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/io_pb";
+import { SkillQueryController } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/query_pb";
+import { SkillSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/skill/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 skill resources. */
+export class SkillClient {
+  private readonly command: Client<typeof SkillCommandController>;
+  private readonly query: Client<typeof SkillQueryController>;
+  private readonly search: Client<typeof SearchService>;
+
+  constructor(transport: Transport) {
+    this.command = createClient(SkillCommandController, transport);
+    this.query = createClient(SkillQueryController, transport);
+    this.search = createClient(SearchService, transport);
+  }
+
+  async push(input: PushSkillRequest): Promise<Skill> {
+    try {
+      return await this.command.push(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async delete(id: string): Promise<Skill> {
+    try {
+      return await this.command.delete(create(SkillIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async get(id: string): Promise<Skill> {
+    try {
+      return await this.query.get(create(SkillIdSchema, { value: id }));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getByReference(ref: ResourceRef): Promise<Skill> {
+    try {
+      return await this.query.getByReference(create(ApiResourceReferenceSchema, ref));
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async getArtifact(input: GetArtifactRequest): Promise<GetArtifactResponse> {
+    try {
+      return await this.query.getArtifact(input);
+    } catch (e) { throw wrapError(e); }
+  }
+
+  async list(params: ListParams): Promise<ListResult> {
+    try {
+      const resp = await this.search.search(create(SearchRequestSchema, {
+        kinds: [ApiResourceKind.skill],
+        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); }
+  }
+}
+
+/** Input for creating/updating a Skill. */
+export interface SkillInput {
+  name: string;
+  org: string;
+  skillMd?: string;
+  tag?: string;
+  description?: string;
+}
+
+function buildSkillProto(input: SkillInput): Skill {
+  return Object.assign(create(SkillSchema), {
+    apiVersion: "agentic.stigmer.ai/v1",
+    kind: "Skill",
+    metadata: Object.assign(create(ApiResourceMetadataSchema), {
+      name: input.name,
+      org: input.org,
+    }),
+    spec: Object.assign(create(SkillSpecSchema), {
+      skillMd: input.skillMd,
+      tag: input.tag,
+      description: input.description,
+    }),
+  }) as Skill;
+}

package/src/gen/types.ts

@@ -0,0 +1,51 @@
+// Code generated by stigmer-codegen. DO NOT EDIT.
+
+import type { SearchResult } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+
+/** Arguments for deleting a resource. */
+export interface DeleteResourceInput {
+  readonly resourceId: string;
+  readonly versionMessage?: string;
+  readonly force?: boolean;
+}
+
+/** Identifies an API resource by org, slug, and optional version. */
+export interface ResourceRef {
+  readonly org: string;
+  readonly slug: string;
+  readonly version?: string;
+  readonly kind?: number;
+}
+
+/** Offset-based pagination parameters. */
+export interface Page {
+  readonly num: number;
+  readonly size: number;
+}
+
+/** Parameters for SearchService-backed list queries. */
+export interface ListParams {
+  readonly org: string;
+  readonly query?: string;
+  readonly excludePublic?: boolean;
+  readonly page?: Page;
+}
+
+/** Response from a SearchService-backed list query. */
+export interface ListResult {
+  readonly entries: SearchResult[];
+  readonly totalCount: number;
+  readonly totalPages: number;
+}
+
+/** Environment variable configuration. */
+export interface EnvSpecInput {
+  readonly variables: Record<string, EnvVarInput>;
+}
+
+/** A single environment variable. */
+export interface EnvVarInput {
+  readonly value: string;
+  readonly isSecret?: boolean;
+  readonly description?: string;
+}