@valon-technologies/gestalt 0.0.1-alpha.19 → 0.0.1-alpha.21

package/src/plugin.ts

@@ -507,9 +507,9 @@ function errorResult(status: number, message: string): OperationResult {
 }
 
 /**
- * Converts a connection mode into the shared protocol enum value.
+ * Encodes a connection mode for provider metadata.
  */
-export function connectionModeToProtoValue(mode: ConnectionMode): number {
+export function encodeConnectionMode(mode: ConnectionMode): number {
   switch (mode) {
     case "none":
       return 1;
@@ -524,9 +524,9 @@ export function connectionModeToProtoValue(mode: ConnectionMode): number {
 }
 
 /**
- * Converts a connection parameter definition into protocol wire metadata.
+ * Encodes a connection parameter definition for provider metadata.
  */
-export function connectionParamToProto(value: ConnectionParamDefinition): {
+export function encodeConnectionParam(value: ConnectionParamDefinition): {
   required?: boolean;
   description?: string;
   defaultValue?: string;

package/src/protocol.ts

@@ -145,7 +145,10 @@ function normalizeJsonValue(
   path: string,
   seen: WeakSet<object>,
 ): JsonValue {
-  if (value === null || typeof value === "string" || typeof value === "boolean") {
+  if (value === null) {
+    return null;
+  }
+  if (typeof value === "string" || typeof value === "boolean") {
     return value;
   }
   if (typeof value === "number") {

package/src/runtime.ts

@@ -80,7 +80,9 @@ import {
   AgentProvider,
   createAgentProviderService,
   isAgentProvider,
+  type AgentToolRef,
 } from "./agent.ts";
+import { agentToolRefFromProto } from "./agent-conversions.ts";
 import {
   AuthenticationProvider,
   isAuthenticationProvider,
@@ -103,8 +105,8 @@ import {
 import {
   type ConnectedToken,
   PluginProvider,
-  connectionModeToProtoValue,
-  connectionParamToProto,
+  encodeConnectionMode,
+  encodeConnectionParam,
   isPluginProvider,
 } from "./plugin.ts";
 import {
@@ -542,14 +544,14 @@ export function createProviderService(
           name: provider.name,
           displayName: provider.displayName,
           description: provider.description,
-          connectionMode: connectionModeToProtoValue(
+          connectionMode: encodeConnectionMode(
             provider.connectionMode,
           ) as ProviderConnectionMode,
           authTypes: [...provider.authTypes],
           connectionParams: Object.fromEntries(
             Object.entries(provider.connectionParams).map(([key, value]) => [
               key,
-              connectionParamToProto(value),
+              encodeConnectionParam(value),
             ]),
           ),
           staticCatalog: catalogToProto(provider.staticCatalog()),
@@ -616,6 +618,7 @@ export function createProviderService(
             subject: {
               id: subject.id,
               kind: subject.kind,
+              credentialSubjectId: subject.credentialSubjectId ?? "",
               displayName: subject.displayName,
               authSource: subject.authSource,
               email: subject.email ?? "",
@@ -859,6 +862,7 @@ function providerRequest(
     subject: {
       id: subject?.id ?? "",
       kind: subject?.kind ?? "",
+      credentialSubjectId: subject?.credentialSubjectId ?? "",
       displayName: subject?.displayName ?? "",
       authSource: subject?.authSource ?? "",
       email: subject?.email ?? "",
@@ -866,6 +870,7 @@ function providerRequest(
     agentSubject: {
       id: agentSubject?.id ?? "",
       kind: agentSubject?.kind ?? "",
+      credentialSubjectId: agentSubject?.credentialSubjectId ?? "",
       displayName: agentSubject?.displayName ?? "",
       authSource: agentSubject?.authSource ?? "",
       email: agentSubject?.email ?? "",
@@ -891,6 +896,8 @@ function providerRequest(
     workflow: {
       ...(requestContext?.workflow ?? {}),
     },
+    toolRefs: providerRequestToolRefs(requestContext),
+    toolRefsSet: requestContext?.toolRefsSet ?? false,
     host: {
       publicBaseUrl: host?.publicBaseUrl ?? "",
     },
@@ -899,6 +906,12 @@ function providerRequest(
   };
 }
 
+function providerRequestToolRefs(
+  requestContext?: ProtoRequestContext,
+): AgentToolRef[] {
+  return requestContext?.toolRefs.map(agentToolRefFromProto) ?? [];
+}
+
 function providerHTTPSubjectRequest(
   request?: ProtoHTTPSubjectRequest,
 ): HTTPSubjectRequest {

package/src/workflow-manager.ts

@@ -21,18 +21,14 @@ import {
   workflowEventToProto,
   workflowSignalToProto,
   type BoundWorkflowTarget,
-  type BoundWorkflowTargetInput,
   type ManagedWorkflowDefinition,
   type ManagedWorkflowEventTrigger,
   type ManagedWorkflowRun,
   type ManagedWorkflowRunSignal,
   type ManagedWorkflowSchedule,
   type WorkflowEvent,
-  type WorkflowEventInput,
   type WorkflowEventMatch,
-  type WorkflowEventMatchInput,
   type WorkflowSignal,
-  type WorkflowSignalInput,
 } from "./workflow.ts";
 
 /** Environment variable containing the workflow-manager host-service target. */
@@ -44,139 +40,139 @@ const WORKFLOW_MANAGER_RELAY_TOKEN_HEADER =
   "x-gestalt-host-service-relay-token";
 
 /** Shape accepted when starting a workflow run. */
-export interface WorkflowManagerStartRunInput {
+export interface WorkflowManagerStartRun {
   providerName: string;
-  target?: BoundWorkflowTarget | BoundWorkflowTargetInput | undefined;
+  target?: BoundWorkflowTarget | BoundWorkflowTarget | undefined;
   idempotencyKey?: string | undefined;
   workflowKey?: string | undefined;
   definitionId?: string | undefined;
 }
 
 /** Shape accepted when signaling an existing workflow run. */
-export interface WorkflowManagerSignalRunInput {
+export interface WorkflowManagerSignalRun {
   runId: string;
-  signal?: WorkflowSignal | WorkflowSignalInput | undefined;
+  signal?: WorkflowSignal | WorkflowSignal | undefined;
 }
 
 /** Shape accepted when signaling a run or starting it if missing. */
-export interface WorkflowManagerSignalOrStartRunInput {
+export interface WorkflowManagerSignalOrStartRun {
   providerName: string;
   workflowKey: string;
-  target?: BoundWorkflowTarget | BoundWorkflowTargetInput | undefined;
+  target?: BoundWorkflowTarget | BoundWorkflowTarget | undefined;
   idempotencyKey?: string | undefined;
-  signal?: WorkflowSignal | WorkflowSignalInput | undefined;
+  signal?: WorkflowSignal | WorkflowSignal | undefined;
   definitionId?: string | undefined;
 }
 
 /** Shape accepted when creating a workflow definition. */
-export interface WorkflowManagerCreateDefinitionInput {
+export interface WorkflowManagerCreateDefinition {
   providerName: string;
-  target?: BoundWorkflowTarget | BoundWorkflowTargetInput | undefined;
+  target?: BoundWorkflowTarget | BoundWorkflowTarget | undefined;
   idempotencyKey?: string | undefined;
 }
 
 /** Shape accepted when fetching a workflow definition. */
-export interface WorkflowManagerGetDefinitionInput {
+export interface WorkflowManagerGetDefinition {
   definitionId: string;
 }
 
 /** Shape accepted when updating a workflow definition. */
-export interface WorkflowManagerUpdateDefinitionInput {
+export interface WorkflowManagerUpdateDefinition {
   definitionId: string;
   providerName?: string | undefined;
-  target?: BoundWorkflowTarget | BoundWorkflowTargetInput | undefined;
+  target?: BoundWorkflowTarget | BoundWorkflowTarget | undefined;
 }
 
 /** Shape accepted when deleting a workflow definition. */
-export interface WorkflowManagerDeleteDefinitionInput {
+export interface WorkflowManagerDeleteDefinition {
   definitionId: string;
 }
 
 /** Shape accepted when creating a workflow schedule. */
-export interface WorkflowManagerCreateScheduleInput {
+export interface WorkflowManagerCreateSchedule {
   providerName: string;
   cron: string;
   timezone?: string | undefined;
-  target?: BoundWorkflowTarget | BoundWorkflowTargetInput | undefined;
+  target?: BoundWorkflowTarget | BoundWorkflowTarget | undefined;
   paused?: boolean | undefined;
   idempotencyKey?: string | undefined;
   definitionId?: string | undefined;
 }
 
 /** Shape accepted when creating an event trigger. */
-export interface WorkflowManagerCreateTriggerInput {
+export interface WorkflowManagerCreateTrigger {
   providerName: string;
-  match?: WorkflowEventMatch | WorkflowEventMatchInput | undefined;
-  target?: BoundWorkflowTarget | BoundWorkflowTargetInput | undefined;
+  match?: WorkflowEventMatch | WorkflowEventMatch | undefined;
+  target?: BoundWorkflowTarget | BoundWorkflowTarget | undefined;
   paused?: boolean | undefined;
   idempotencyKey?: string | undefined;
   definitionId?: string | undefined;
 }
 
 /** Shape accepted when fetching a workflow schedule. */
-export interface WorkflowManagerGetScheduleInput {
+export interface WorkflowManagerGetSchedule {
   scheduleId: string;
 }
 
 /** Shape accepted when fetching an event trigger. */
-export interface WorkflowManagerGetTriggerInput {
+export interface WorkflowManagerGetTrigger {
   triggerId: string;
 }
 
 /** Shape accepted when updating a workflow schedule. */
-export interface WorkflowManagerUpdateScheduleInput {
+export interface WorkflowManagerUpdateSchedule {
   scheduleId: string;
   providerName?: string | undefined;
   cron?: string | undefined;
   timezone?: string | undefined;
-  target?: BoundWorkflowTarget | BoundWorkflowTargetInput | undefined;
+  target?: BoundWorkflowTarget | BoundWorkflowTarget | undefined;
   paused?: boolean | undefined;
   definitionId?: string | undefined;
 }
 
 /** Shape accepted when updating an event trigger. */
-export interface WorkflowManagerUpdateTriggerInput {
+export interface WorkflowManagerUpdateTrigger {
   triggerId: string;
   providerName?: string | undefined;
-  match?: WorkflowEventMatch | WorkflowEventMatchInput | undefined;
-  target?: BoundWorkflowTarget | BoundWorkflowTargetInput | undefined;
+  match?: WorkflowEventMatch | WorkflowEventMatch | undefined;
+  target?: BoundWorkflowTarget | BoundWorkflowTarget | undefined;
   paused?: boolean | undefined;
   definitionId?: string | undefined;
 }
 
 /** Shape accepted when deleting a workflow schedule. */
-export interface WorkflowManagerDeleteScheduleInput {
+export interface WorkflowManagerDeleteSchedule {
   scheduleId: string;
 }
 
 /** Shape accepted when deleting an event trigger. */
-export interface WorkflowManagerDeleteTriggerInput {
+export interface WorkflowManagerDeleteTrigger {
   triggerId: string;
 }
 
 /** Shape accepted when pausing a workflow schedule. */
-export interface WorkflowManagerPauseScheduleInput {
+export interface WorkflowManagerPauseSchedule {
   scheduleId: string;
 }
 
 /** Shape accepted when pausing an event trigger. */
-export interface WorkflowManagerPauseTriggerInput {
+export interface WorkflowManagerPauseTrigger {
   triggerId: string;
 }
 
 /** Shape accepted when resuming a workflow schedule. */
-export interface WorkflowManagerResumeScheduleInput {
+export interface WorkflowManagerResumeSchedule {
   scheduleId: string;
 }
 
 /** Shape accepted when resuming an event trigger. */
-export interface WorkflowManagerResumeTriggerInput {
+export interface WorkflowManagerResumeTrigger {
   triggerId: string;
 }
 
 /** Shape accepted when publishing a workflow event. */
-export interface WorkflowManagerPublishEventInput {
-  event?: WorkflowEvent | WorkflowEventInput | undefined;
+export interface WorkflowManagerPublishEvent {
+  event?: WorkflowEvent | WorkflowEvent | undefined;
   providerName?: string | undefined;
 }
 
@@ -219,7 +215,7 @@ export class WorkflowManager {
 
   /** Starts a workflow run immediately. */
   async startRun(
-    request: WorkflowManagerStartRunInput,
+    request: WorkflowManagerStartRun,
   ): Promise<ManagedWorkflowRun> {
     return managedWorkflowRunFromProto(
       await this.client.startRun({
@@ -235,7 +231,7 @@ export class WorkflowManager {
 
   /** Signals an existing workflow run. */
   async signalRun(
-    request: WorkflowManagerSignalRunInput,
+    request: WorkflowManagerSignalRun,
   ): Promise<ManagedWorkflowRunSignal> {
     return managedWorkflowRunSignalFromProto(
       await this.client.signalRun({
@@ -248,7 +244,7 @@ export class WorkflowManager {
 
   /** Signals a workflow run, or starts it when no run exists for the key. */
   async signalOrStartRun(
-    request: WorkflowManagerSignalOrStartRunInput,
+    request: WorkflowManagerSignalOrStartRun,
   ): Promise<ManagedWorkflowRunSignal> {
     return managedWorkflowRunSignalFromProto(
       await this.client.signalOrStartRun({
@@ -265,7 +261,7 @@ export class WorkflowManager {
 
   /** Creates a reusable workflow definition. */
   async createDefinition(
-    request: WorkflowManagerCreateDefinitionInput,
+    request: WorkflowManagerCreateDefinition,
   ): Promise<ManagedWorkflowDefinition> {
     return managedWorkflowDefinitionFromProto(
       await this.client.createDefinition({
@@ -279,7 +275,7 @@ export class WorkflowManager {
 
   /** Fetches one workflow definition. */
   async getDefinition(
-    request: WorkflowManagerGetDefinitionInput,
+    request: WorkflowManagerGetDefinition,
   ): Promise<ManagedWorkflowDefinition> {
     return managedWorkflowDefinitionFromProto(
       await this.client.getDefinition({
@@ -291,7 +287,7 @@ export class WorkflowManager {
 
   /** Updates a workflow definition. */
   async updateDefinition(
-    request: WorkflowManagerUpdateDefinitionInput,
+    request: WorkflowManagerUpdateDefinition,
   ): Promise<ManagedWorkflowDefinition> {
     return managedWorkflowDefinitionFromProto(
       await this.client.updateDefinition({
@@ -305,7 +301,7 @@ export class WorkflowManager {
 
   /** Deletes a workflow definition. */
   async deleteDefinition(
-    request: WorkflowManagerDeleteDefinitionInput,
+    request: WorkflowManagerDeleteDefinition,
   ): Promise<void> {
     await this.client.deleteDefinition({
       definitionId: request.definitionId,
@@ -315,7 +311,7 @@ export class WorkflowManager {
 
   /** Creates a workflow schedule. */
   async createSchedule(
-    request: WorkflowManagerCreateScheduleInput,
+    request: WorkflowManagerCreateSchedule,
   ): Promise<ManagedWorkflowSchedule> {
     return managedWorkflowScheduleFromProto(
       await this.client.createSchedule({
@@ -333,7 +329,7 @@ export class WorkflowManager {
 
   /** Fetches one workflow schedule. */
   async getSchedule(
-    request: WorkflowManagerGetScheduleInput,
+    request: WorkflowManagerGetSchedule,
   ): Promise<ManagedWorkflowSchedule> {
     return managedWorkflowScheduleFromProto(
       await this.client.getSchedule({
@@ -345,7 +341,7 @@ export class WorkflowManager {
 
   /** Updates a workflow schedule. */
   async updateSchedule(
-    request: WorkflowManagerUpdateScheduleInput,
+    request: WorkflowManagerUpdateSchedule,
   ): Promise<ManagedWorkflowSchedule> {
     return managedWorkflowScheduleFromProto(
       await this.client.updateSchedule({
@@ -363,7 +359,7 @@ export class WorkflowManager {
 
   /** Deletes a workflow schedule. */
   async deleteSchedule(
-    request: WorkflowManagerDeleteScheduleInput,
+    request: WorkflowManagerDeleteSchedule,
   ): Promise<void> {
     await this.client.deleteSchedule({
       scheduleId: request.scheduleId,
@@ -373,7 +369,7 @@ export class WorkflowManager {
 
   /** Pauses a workflow schedule. */
   async pauseSchedule(
-    request: WorkflowManagerPauseScheduleInput,
+    request: WorkflowManagerPauseSchedule,
   ): Promise<ManagedWorkflowSchedule> {
     return managedWorkflowScheduleFromProto(
       await this.client.pauseSchedule({
@@ -385,7 +381,7 @@ export class WorkflowManager {
 
   /** Resumes a workflow schedule. */
   async resumeSchedule(
-    request: WorkflowManagerResumeScheduleInput,
+    request: WorkflowManagerResumeSchedule,
   ): Promise<ManagedWorkflowSchedule> {
     return managedWorkflowScheduleFromProto(
       await this.client.resumeSchedule({
@@ -397,7 +393,7 @@ export class WorkflowManager {
 
   /** Creates an event trigger. */
   async createTrigger(
-    request: WorkflowManagerCreateTriggerInput,
+    request: WorkflowManagerCreateTrigger,
   ): Promise<ManagedWorkflowEventTrigger> {
     return managedWorkflowEventTriggerFromProto(
       await this.client.createEventTrigger({
@@ -414,7 +410,7 @@ export class WorkflowManager {
 
   /** Fetches one event trigger. */
   async getTrigger(
-    request: WorkflowManagerGetTriggerInput,
+    request: WorkflowManagerGetTrigger,
   ): Promise<ManagedWorkflowEventTrigger> {
     return managedWorkflowEventTriggerFromProto(
       await this.client.getEventTrigger({
@@ -426,7 +422,7 @@ export class WorkflowManager {
 
   /** Updates an event trigger. */
   async updateTrigger(
-    request: WorkflowManagerUpdateTriggerInput,
+    request: WorkflowManagerUpdateTrigger,
   ): Promise<ManagedWorkflowEventTrigger> {
     return managedWorkflowEventTriggerFromProto(
       await this.client.updateEventTrigger({
@@ -443,7 +439,7 @@ export class WorkflowManager {
 
   /** Deletes an event trigger. */
   async deleteTrigger(
-    request: WorkflowManagerDeleteTriggerInput,
+    request: WorkflowManagerDeleteTrigger,
   ): Promise<void> {
     await this.client.deleteEventTrigger({
       triggerId: request.triggerId,
@@ -453,7 +449,7 @@ export class WorkflowManager {
 
   /** Pauses an event trigger. */
   async pauseTrigger(
-    request: WorkflowManagerPauseTriggerInput,
+    request: WorkflowManagerPauseTrigger,
   ): Promise<ManagedWorkflowEventTrigger> {
     return managedWorkflowEventTriggerFromProto(
       await this.client.pauseEventTrigger({
@@ -465,7 +461,7 @@ export class WorkflowManager {
 
   /** Resumes an event trigger. */
   async resumeTrigger(
-    request: WorkflowManagerResumeTriggerInput,
+    request: WorkflowManagerResumeTrigger,
   ): Promise<ManagedWorkflowEventTrigger> {
     return managedWorkflowEventTriggerFromProto(
       await this.client.resumeEventTrigger({
@@ -477,7 +473,7 @@ export class WorkflowManager {
 
   /** Publishes an event into the workflow manager. */
   async publishEvent(
-    request: WorkflowManagerPublishEventInput,
+    request: WorkflowManagerPublishEvent,
   ): Promise<WorkflowEvent> {
     const event = workflowEventFromProto(
       await this.client.publishEvent({