@stigmer/sdk 3.6.0 → 3.8.0

package/src/gen/client.ts

@@ -91,9 +91,9 @@ export class GeneratedClient {
 export { AgentClient } from "./agent.js";
 export { type AgentInput, type McpServerUsageInput, type ToolApprovalOverrideInput, type SubAgentInput, type McpAccessInput, type EnvVarDeclarationInput, type DatastoreUsageInput } from "./agent.js";
 export { AgentChannelClient } from "./agentchannel.js";
-export { type AgentChannelInput, type SlackChannelConfigInput, type WhatsAppChannelConfigInput } from "./agentchannel.js";
+export { type AgentChannelInput, type SlackChannelConfigInput, type WhatsAppChannelConfigInput, type RunConfigInput } from "./agentchannel.js";
 export { AgentExecutionClient } from "./agentexecution.js";
-export { type AgentExecutionInput, type SessionSpecInput, type WorkspaceEntryInput, type WorkspaceSourceInput, type GitRepoSourceInput, type LocalPathSourceInput, type ExecutionConfigInput, type ContextManagementConfigInput, type AttachmentInput } from "./agentexecution.js";
+export { type AgentExecutionInput, type SessionSpecInput, type WorkspaceEntryInput, type WorkspaceSourceInput, type GitRepoSourceInput, type LocalPathSourceInput, type ExecutionConfigInput, type ContextManagementConfigInput, type AttachmentInput, type ConversationCatchupInput } from "./agentexecution.js";
 export { AgentInstanceClient } from "./agentinstance.js";
 export { type AgentInstanceInput } from "./agentinstance.js";
 export { AgentShareClient } from "./agentshare.js";
@@ -129,7 +129,7 @@ export { type PlatformClientInput } from "./platformclient.js";
 export { ProjectClient } from "./project.js";
 export { type ProjectInput } from "./project.js";
 export { ScheduleClient } from "./schedule.js";
-export { type ScheduleInput, type AgentTargetInput } from "./schedule.js";
+export { type ScheduleInput, type AgentInvocationInput } from "./schedule.js";
 export { SessionClient } from "./session.js";
 export { type SessionInput } from "./session.js";
 export { SkillClient } from "./skill.js";

package/src/gen/schedule.ts

@@ -5,11 +5,15 @@ import { stripUndefined } from "./proto-utils.js";
 import { type ResourceRef } from "./types.js";
 import { create } from "@bufbuild/protobuf";
 import { createClient, type Client, type Transport } from "@connectrpc/connect";
+import { ServiceTier } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { RunConfigSchema, AgentInvocationSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/invocation_pb";
 import { ScheduleSchema, type Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
 import { ScheduleCommandController } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/command_pb";
-import { ScheduleIdSchema, GetSchedulesByAgentRequestSchema, ScheduleListSchema, ListSchedulesRequestSchema, type GetSchedulesByAgentRequest, type ScheduleList, type ListSchedulesRequest } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/io_pb";
+import { ScheduleIdSchema, ScheduleTriggerResultSchema, GetSchedulesByAgentRequestSchema, ScheduleListSchema, ListSchedulesRequestSchema, ListScheduleRunsRequestSchema, ScheduleRunListSchema, type ScheduleTriggerResult, type GetSchedulesByAgentRequest, type ScheduleList, type ListSchedulesRequest, type ListScheduleRunsRequest, type ScheduleRunList } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/io_pb";
 import { ScheduleQueryController } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/query_pb";
-import { ScheduleSpecSchema, AgentTargetSchema } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/spec_pb";
+import { ScheduleSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/spec_pb";
+import { Harness, GitWriteBackMode } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
+import { GitRepoSourceSchema, LocalPathSourceSchema, WorkspaceSourceSchema, WorkspaceEntrySchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
 import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
 import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
 import { ApiResourceReferenceSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
@@ -55,7 +59,7 @@ export class ScheduleClient {
     } catch (e) { throw wrapError(e); }
   }
 
-  async trigger(id: string): Promise<Schedule> {
+  async trigger(id: string): Promise<ScheduleTriggerResult> {
     try {
       return await this.command.trigger(create(ScheduleIdSchema, { value: id }));
     } catch (e) { throw wrapError(e); }
@@ -84,6 +88,12 @@ export class ScheduleClient {
       return await this.query.list(input);
     } catch (e) { throw wrapError(e); }
   }
+
+  async listRuns(input: ListScheduleRunsRequest): Promise<ScheduleRunList> {
+    try {
+      return await this.query.listRuns(input);
+    } catch (e) { throw wrapError(e); }
+  }
 }
 
 /** Input for creating/updating a Schedule. */
@@ -96,19 +106,103 @@ export interface ScheduleInput {
   cron?: string;
   timeZone?: string;
   enabled?: boolean;
-  agent?: AgentTargetInput;
+  agent?: AgentInvocationInput;
 }
 
-/** SDK input type for AgentTarget. */
-export interface AgentTargetInput {
+/** SDK input type for AgentInvocation. */
+export interface AgentInvocationInput {
   agentRef: ResourceRef;
   message?: string;
+  harness?: Harness;
+  workspaceEntries?: WorkspaceEntryInput[];
+  environmentRefs?: ResourceRef[];
+  runConfig?: RunConfigInput;
+}
+
+/** 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;
+  writeBackMode?: GitWriteBackMode;
+}
+
+/** SDK input type for LocalPathSource. */
+export interface LocalPathSourceInput {
+  path?: string;
+}
+
+/** SDK input type for RunConfig. */
+export interface RunConfigInput {
+  modelName?: string;
+  maxCostUsd?: number;
+  maxToolRounds?: number;
+  serviceTier?: ServiceTier;
+}
+
+function buildGitRepoSourceProto(input: GitRepoSourceInput) {
+  return Object.assign(create(GitRepoSourceSchema), stripUndefined({
+    url: input.url,
+    branch: input.branch,
+    commit: input.commit,
+    depth: input.depth,
+    writeBackMode: input.writeBackMode,
+  }));
+}
+
+function buildLocalPathSourceProto(input: LocalPathSourceInput) {
+  return Object.assign(create(LocalPathSourceSchema), stripUndefined({
+    path: input.path,
+  }));
+}
+
+function buildWorkspaceSourceProto(input: WorkspaceSourceInput) {
+  const msg = create(WorkspaceSourceSchema);
+  if (input.gitRepo) {
+    msg.source = { case: "gitRepo", value: buildGitRepoSourceProto(input.gitRepo) };
+  } else if (input.localPath) {
+    msg.source = { case: "localPath", value: buildLocalPathSourceProto(input.localPath) };
+  }
+  return msg;
+}
+
+function buildWorkspaceEntryProto(input: WorkspaceEntryInput) {
+  const msg = create(WorkspaceEntrySchema);
+  if (input.name !== undefined) msg.name = input.name;
+  if (input.source) msg.source = buildWorkspaceSourceProto(input.source);
+  return msg;
+}
+
+function buildRunConfigProto(input: RunConfigInput) {
+  return Object.assign(create(RunConfigSchema), stripUndefined({
+    modelName: input.modelName,
+    maxCostUsd: input.maxCostUsd,
+    maxToolRounds: input.maxToolRounds,
+    serviceTier: input.serviceTier,
+  }));
 }
 
-function buildAgentTargetProto(input: AgentTargetInput) {
-  const msg = create(AgentTargetSchema);
+function buildAgentInvocationProto(input: AgentInvocationInput) {
+  const msg = create(AgentInvocationSchema);
   if (input.agentRef?.slug || input.agentRef?.org) msg.agentRef = create(ApiResourceReferenceSchema, { ...input.agentRef, kind: 40 });
   if (input.message !== undefined) msg.message = input.message;
+  if (input.harness !== undefined) msg.harness = input.harness;
+  if (input.workspaceEntries) msg.workspaceEntries = input.workspaceEntries.map(buildWorkspaceEntryProto);
+  if (input.environmentRefs) msg.environmentRefs = input.environmentRefs.map(r => create(ApiResourceReferenceSchema, { ...r, kind: 53 }));
+  if (input.runConfig) msg.runConfig = buildRunConfigProto(input.runConfig);
   return msg;
 }
 
@@ -119,7 +213,7 @@ export function buildScheduleProto(input: ScheduleInput): Schedule {
     enabled: input.enabled,
   }));
   if (input.agent) {
-    spec.target = { case: "agent", value: buildAgentTargetProto(input.agent) };
+    spec.target = { case: "agent", value: buildAgentInvocationProto(input.agent) };
   }
   return Object.assign(create(ScheduleSchema), {
     apiVersion: "agentic.stigmer.ai/v1",

package/src/iam-role.ts

@@ -6,6 +6,7 @@ const ROLE_STRINGS: Record<IamRole, string> = {
   [IamRole.admin]: "admin",
   [IamRole.member]: "member",
   [IamRole.viewer]: "viewer",
+  [IamRole.participant]: "participant",
 };
 
 const STRING_TO_ROLE: Record<string, IamRole> = {
@@ -13,6 +14,7 @@ const STRING_TO_ROLE: Record<string, IamRole> = {
   admin: IamRole.admin,
   member: IamRole.member,
   viewer: IamRole.viewer,
+  participant: IamRole.participant,
 };
 
 const ROLE_DISPLAY_NAMES: Record<IamRole, string> = {
@@ -21,6 +23,7 @@ const ROLE_DISPLAY_NAMES: Record<IamRole, string> = {
   [IamRole.admin]: "Admin",
   [IamRole.member]: "Member",
   [IamRole.viewer]: "Viewer",
+  [IamRole.participant]: "Participant",
 };
 
 const ROLE_DESCRIPTIONS: Record<IamRole, string> = {
@@ -29,6 +32,7 @@ const ROLE_DESCRIPTIONS: Record<IamRole, string> = {
   [IamRole.admin]: "Edit access and member management",
   [IamRole.member]: "Standard access to organization resources",
   [IamRole.viewer]: "Read-only access",
+  [IamRole.participant]: "Reply to customers and manage conversation takeover",
 };
 
 /**

package/src/index.ts

@@ -245,7 +245,8 @@ export {
   ScheduleClient,
   buildScheduleProto,
   type ScheduleInput,
-  type AgentTargetInput,
+  type AgentInvocationInput,
+  type RunConfigInput,
 } from "./gen/schedule.js";
 export {
   SessionClient,