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

package/src/cache.ts

@@ -4,7 +4,7 @@ import { createClient, type Client, type Interceptor } from "@connectrpc/connect
 import { createGrpcTransport } from "@connectrpc/connect-node";
 
 import { Cache as CacheService } from "./internal/gen/v1/cache_pb.ts";
-import { RuntimeProvider, type RuntimeProviderOptions } from "./provider.ts";
+import { ProviderBase, type ProviderBaseOptions } from "./provider.ts";
 import type { MaybePromise } from "./api.ts";
 
 /** Base environment variable for discovering cache runtime sockets. */
@@ -33,7 +33,7 @@ export interface CacheSetOptions {
 /**
  * Runtime hooks required to implement a Gestalt cache provider.
  */
-export interface CacheProviderOptions extends RuntimeProviderOptions {
+export interface CacheProviderOptions extends ProviderBaseOptions {
   get: (key: string) => MaybePromise<Uint8Array | null | undefined>;
   set: (
     key: string,
@@ -139,7 +139,8 @@ export class Cache {
       ...(transportOptions.nodeOptions
         ? {
             nodeOptions: {
-              createConnection: () => connect(transportOptions.nodeOptions!.path),
+              createConnection: () =>
+                connect({ path: transportOptions.nodeOptions!.path }),
             },
           }
         : {}),
@@ -223,7 +224,7 @@ export class Cache {
 /**
  * Cache provider implementation consumed by the Gestalt runtime.
  */
-export class CacheProvider extends RuntimeProvider {
+export class CacheProvider extends ProviderBase {
   readonly kind = "cache" as const;
 
   private readonly getHandler: CacheProviderOptions["get"];

package/src/catalog.ts

@@ -15,6 +15,16 @@ export interface CatalogParameter {
   default?: unknown;
 }
 
+/**
+ * Optional host hints attached to a catalog operation.
+ */
+export interface OperationAnnotations {
+  readOnlyHint?: boolean;
+  idempotentHint?: boolean;
+  destructiveHint?: boolean;
+  openWorldHint?: boolean;
+}
+
 /**
  * JSON-schema-like description used in provider catalogs.
  */
@@ -38,9 +48,12 @@ export interface CatalogOperation {
   parameters?: CatalogParameter[];
   inputSchema?: CatalogSchema;
   outputSchema?: CatalogSchema;
+  annotations?: OperationAnnotations;
+  requiredScopes?: string[];
   tags?: string[];
   readOnly?: boolean;
   visible?: boolean;
+  transport?: string;
   allowedRoles?: string[];
 }
 
@@ -182,6 +195,12 @@ function toCatalogJsonObject(
       if (operation.outputSchema !== undefined) {
         serialized.outputSchema = operation.outputSchema;
       }
+      if (operation.annotations !== undefined) {
+        serialized.annotations = operation.annotations;
+      }
+      if (operation.requiredScopes && operation.requiredScopes.length > 0) {
+        serialized.requiredScopes = operation.requiredScopes;
+      }
       if (operation.tags && operation.tags.length > 0) {
         serialized.tags = operation.tags;
       }
@@ -191,6 +210,9 @@ function toCatalogJsonObject(
       if (operation.visible !== undefined) {
         serialized.visible = operation.visible;
       }
+      if (operation.transport) {
+        serialized.transport = operation.transport;
+      }
       if (operation.allowedRoles && operation.allowedRoles.length > 0) {
         serialized.allowedRoles = operation.allowedRoles;
       }

package/src/http-subject.ts

@@ -1,4 +1,11 @@
-import type { Access, Credential, MaybePromise, Subject } from "./api.ts";
+import type {
+  Access,
+  Credential,
+  Host,
+  MaybePromise,
+  Subject,
+  SubjectInput,
+} from "./api.ts";
 
 /**
  * Verified hosted HTTP request metadata passed into optional plugin-local
@@ -26,6 +33,7 @@ export interface HTTPSubjectResolutionContext {
   subject: Subject;
   credential: Credential;
   access: Access;
+  host: Host;
   workflow: Record<string, unknown>;
 }
 
@@ -59,7 +67,7 @@ export function httpSubjectError(
 export type HTTPSubjectResolver = (
   request: HTTPSubjectRequest,
   context: HTTPSubjectResolutionContext,
-) => MaybePromise<Subject | null | undefined>;
+) => MaybePromise<SubjectInput | null | undefined>;
 
 export function cloneHTTPSubjectRequest(
   input: HTTPSubjectRequest,
@@ -96,6 +104,9 @@ export function cloneHTTPSubjectResolutionContext(
     access: {
       ...input.access,
     },
+    host: {
+      ...input.host,
+    },
     workflow: {
       ...input.workflow,
     },

package/src/index.ts

@@ -29,21 +29,79 @@
  * ```
  */
 export {
+  AGENT_SESSION_ACTION_EDIT,
+  AGENT_SESSION_ACTION_VIEW,
+  AGENT_SESSION_RELATION_EDITOR,
+  AGENT_SESSION_RESOURCE_TYPE,
   Authorization,
   AuthorizationClient,
+  AuthorizationProvider,
+  AUTHORIZATION_SUBJECT_TYPE_SUBJECT,
   ENV_AUTHORIZATION_SOCKET,
   ENV_AUTHORIZATION_SOCKET_TOKEN,
-  type AuthorizationActionSearchMessage,
-  type AuthorizationDecisionMessage,
+  agentSessionAuthorizationResource,
+  agentSessionEditorRelationship,
+  agentSessionEditorWriteRequest,
+  authorizationAction,
+  createAuthorizationProviderService,
+  defineAuthorizationProvider,
+  authorizationRelationship,
+  authorizationRelationshipKeyWithTarget,
+  authorizationRelationshipKey,
+  authorizationRelationshipWithTarget,
+  authorizationResource,
+  authorizationResourceTarget,
+  authorizationSubject,
+  authorizationSubjectSet,
+  authorizationSubjectSetTarget,
+  authorizationSubjectTarget,
+  isAuthorizationProvider,
+  type AuthorizationAction,
+  type AuthorizationActionSearch,
+  type AuthorizationDecision,
   type AuthorizationEvaluateInput,
-  type AuthorizationMetadataMessage,
+  type AuthorizationEvaluateManyInput,
+  type AuthorizationEvaluationsResponse,
+  type AuthorizationEffectiveSearchSubjectsInput,
+  type AuthorizationEffectiveSubjectSearch,
+  type AuthorizationExpandInput,
+  type AuthorizationExpand,
+  type AuthorizationExpandNode,
+  type AuthorizationGetActiveModel,
+  type AuthorizationListModelsInput,
+  type AuthorizationListModels,
+  type AuthorizationMetadata,
+  type AuthorizationModel,
+  type AuthorizationModelAction,
+  type AuthorizationModelAllowedTarget,
+  type AuthorizationModelAllowedTargetKind,
+  type AuthorizationModelComputedUserset,
+  type AuthorizationModelRef,
+  type AuthorizationModelRelation,
+  type AuthorizationModelResourceType,
+  type AuthorizationModelRewrite,
+  type AuthorizationModelRewriteKind,
+  type AuthorizationModelRewriteThis,
+  type AuthorizationModelRewriteUnion,
+  type AuthorizationModelSubjectSetTarget,
+  type AuthorizationModelTupleToUserset,
+  type AuthorizationProviderOptions,
   type AuthorizationReadRelationshipsInput,
-  type AuthorizationReadRelationshipsMessage,
-  type AuthorizationResourceSearchMessage,
+  type AuthorizationReadRelationships,
+  type AuthorizationRelationship,
+  type AuthorizationRelationshipKey,
+  type AuthorizationRelationshipTarget,
+  type AuthorizationRelationshipTargetKind,
+  type AuthorizationResource,
+  type AuthorizationSubjectSet,
+  type AuthorizationResourceSearch,
   type AuthorizationSearchActionsInput,
   type AuthorizationSearchResourcesInput,
   type AuthorizationSearchSubjectsInput,
-  type AuthorizationSubjectSearchMessage,
+  type AuthorizationSubject,
+  type AuthorizationSubjectSearch,
+  type AuthorizationWriteRelationshipsInput,
+  type AuthorizationWriteModelInput,
 } from "./authorization.ts";
 export {
   connectionParam,
@@ -52,12 +110,15 @@ export {
   responseBrand,
   request,
   type Access,
+  type Host,
   type MaybePromise,
   type Credential,
+  type ExternalIdentity,
   type OperationResult,
   type Request,
   type Response,
   type Subject,
+  type SubjectInput,
 } from "./api.ts";
 export {
   type HTTPSubjectRequest,
@@ -76,6 +137,7 @@ export {
   type CatalogOperation,
   type CatalogParameter,
   type CatalogSchema,
+  type OperationAnnotations,
 } from "./catalog.ts";
 export {
   buildProviderBinary,
@@ -106,18 +168,20 @@ export {
   type AgentManagerListTurnsInput,
   type AgentManagerResolveInteractionInput,
   type AgentManagerUpdateSessionInput,
+  type AgentManagerWorkspace,
+  type AgentManagerWorkspaceGitCheckout,
 } from "./agent-manager.ts";
 export {
   ENV_WORKFLOW_MANAGER_SOCKET,
   ENV_WORKFLOW_MANAGER_SOCKET_TOKEN,
   WorkflowManager,
-  type ManagedWorkflowEventTriggerMessage,
-  type ManagedWorkflowScheduleMessage,
-  type WorkflowEventMessage,
+  type WorkflowManagerCreateDefinitionInput,
   type WorkflowManagerCreateTriggerInput,
   type WorkflowManagerCreateScheduleInput,
+  type WorkflowManagerDeleteDefinitionInput,
   type WorkflowManagerDeleteTriggerInput,
   type WorkflowManagerDeleteScheduleInput,
+  type WorkflowManagerGetDefinitionInput,
   type WorkflowManagerGetTriggerInput,
   type WorkflowManagerGetScheduleInput,
   type WorkflowManagerPauseTriggerInput,
@@ -125,6 +189,10 @@ export {
   type WorkflowManagerPublishEventInput,
   type WorkflowManagerResumeTriggerInput,
   type WorkflowManagerResumeScheduleInput,
+  type WorkflowManagerSignalOrStartRunInput,
+  type WorkflowManagerSignalRunInput,
+  type WorkflowManagerStartRunInput,
+  type WorkflowManagerUpdateDefinitionInput,
   type WorkflowManagerUpdateTriggerInput,
   type WorkflowManagerUpdateScheduleInput,
 } from "./workflow-manager.ts";
@@ -135,7 +203,7 @@ export {
   RuntimeLogHost,
   type RuntimeLogAppendInput,
   type RuntimeLogAppendLogsInput,
-  type RuntimeLogAppendResponseMessage,
+  type RuntimeLogAppendResponse,
   type RuntimeLogStreamInput,
   type RuntimeLogStreamName,
   type RuntimeLogWriterOptions,
@@ -187,15 +255,15 @@ export {
   type SessionCatalogHandler,
 } from "./plugin.ts";
 export {
-  RuntimeProvider,
-  isRuntimeProvider,
+  ProviderBase,
+  isProviderBase,
   slugName,
   type CloseHandler,
   type ConfigureHandler,
   type HealthCheckHandler,
   type ProviderKind,
   type ProviderMetadata,
-  type RuntimeProviderOptions,
+  type ProviderBaseOptions,
   type StartHandler,
   type WarningsHandler,
 } from "./provider.ts";
@@ -208,9 +276,17 @@ export {
   type GetPluginRuntimeSessionRequest,
   type HostedPlugin,
   type ListPluginRuntimeSessionsRequest,
+  type PluginRuntimeAgentWorkspace,
+  type PluginRuntimeAgentWorkspaceGitCheckout,
+  type PluginRuntimeImagePullAuth,
+  type PluginRuntimePreparedAgentWorkspace,
   type PluginRuntimeProviderOptions,
   type PluginRuntimeSession,
+  type PluginRuntimeSessionLifecycle,
   type PluginRuntimeSupport,
+  type PreparePluginRuntimeWorkspaceRequest,
+  type PreparePluginRuntimeWorkspaceResponse,
+  type RemovePluginRuntimeWorkspaceRequest,
   type StartHostedPluginRequest,
   type StartPluginRuntimeSessionRequest,
   type StopPluginRuntimeSessionRequest,
@@ -331,22 +407,28 @@ export {
   defineAgentProvider,
   isAgentProvider,
   type AgentActor,
+  type AgentHostExecuteToolInput,
+  type AgentHostListToolsInput,
+  type AgentHostResolveConnectionInput,
   type AgentInteraction,
   type AgentMessage,
   type AgentMessagePart,
   type AgentMessagePartImageRef,
   type AgentMessagePartToolCall,
   type AgentMessagePartToolResult,
+  type AgentPreparedWorkspace,
   type AgentProviderCapabilities,
   type AgentProviderOptions,
   type AgentSession,
+  type AgentSessionStartConfig,
+  type AgentSessionStartHook,
+  type AgentSessionStartHookOutput,
+  type AgentSubjectContext,
+  type AgentToolAnnotations,
   type AgentToolRef,
   type AgentTurn,
   type AgentTurnDisplay,
-  type AgentTurnDisplayInit,
-  type AgentTurnDisplayValue,
   type AgentTurnEvent,
-  type AgentTurnEventInit,
   type CancelAgentProviderTurnRequest,
   type CreateAgentProviderSessionRequest,
   type CreateAgentProviderTurnRequest,
@@ -359,46 +441,141 @@ export {
   type ListAgentToolsRequest,
   type ListAgentToolsResponse,
   type ListAgentProviderInteractionsRequest,
+  type ListAgentProviderInteractionsResponse,
   type ListAgentProviderSessionsRequest,
+  type ListAgentProviderSessionsResponse,
   type ListAgentProviderTurnEventsRequest,
+  type ListAgentProviderTurnEventsResponse,
   type ListAgentProviderTurnsRequest,
+  type ListAgentProviderTurnsResponse,
   type ListedAgentTool,
+  type ResolveAgentConnectionRequest,
   type ResolveAgentProviderInteractionRequest,
+  type ResolvedAgentConnection,
   type ResolvedAgentTool,
   type UpdateAgentProviderSessionRequest,
 } from "./agent.ts";
 export {
   ENV_WORKFLOW_HOST_SOCKET,
+  ENV_WORKFLOW_HOST_SOCKET_TOKEN,
   WorkflowHost,
   WorkflowProvider,
   WorkflowRunStatus,
+  boundWorkflowAgentTarget,
+  boundWorkflowAgentTargetInputFromTarget,
+  boundWorkflowEventTrigger,
+  boundWorkflowEventTriggerFromTrigger,
+  boundWorkflowEventTriggerInputFromTrigger,
+  boundWorkflowPluginTarget,
+  boundWorkflowPluginTargetInputFromTarget,
+  boundWorkflowRun,
+  boundWorkflowRunFromRun,
+  boundWorkflowRunInputFromRun,
+  boundWorkflowSchedule,
+  boundWorkflowScheduleFromSchedule,
+  boundWorkflowScheduleInputFromSchedule,
+  boundWorkflowTarget,
+  boundWorkflowTargetFromTarget,
+  boundWorkflowTargetInputFromTarget,
   createWorkflowProviderService,
   defineWorkflowProvider,
   isWorkflowProvider,
+  workflowAccessPermission,
+  workflowAccessPermissionInputFromPermission,
+  workflowActor,
+  workflowActorInputFromActor,
+  workflowEvent,
+  workflowEventFromEvent,
+  workflowEventInputFromEvent,
+  workflowEventMatch,
+  workflowEventMatchInputFromMatch,
+  workflowEventTriggerInvocation,
+  workflowExecutionReference,
+  workflowExecutionReferenceFromReference,
+  workflowExecutionReferenceInputFromReference,
+  workflowOutputBinding,
+  workflowOutputBindingInputFromBinding,
+  workflowOutputDelivery,
+  workflowOutputDeliveryInputFromDelivery,
+  workflowOutputValueSource,
+  workflowOutputValueSourceInputFromSource,
+  workflowRunAsSubject,
+  workflowRunAsSubjectInputFromSubject,
+  workflowRunTrigger,
+  workflowRunTriggerFromTrigger,
+  workflowRunTriggerInputFromTrigger,
+  workflowScheduleTrigger,
+  workflowSignal,
+  workflowSignalFromSignal,
+  workflowSignalInputFromSignal,
+  type BoundWorkflowAgentTarget,
+  type BoundWorkflowAgentTargetInput,
   type BoundWorkflowEventTrigger,
+  type BoundWorkflowEventTriggerInput,
+  type BoundWorkflowPluginTarget,
+  type BoundWorkflowPluginTargetInput,
   type BoundWorkflowRun,
+  type BoundWorkflowRunInput,
   type BoundWorkflowSchedule,
+  type BoundWorkflowScheduleInput,
+  type BoundWorkflowTarget,
+  type BoundWorkflowTargetInput,
   type CancelWorkflowProviderRunRequest,
   type DeleteWorkflowProviderEventTriggerRequest,
   type DeleteWorkflowProviderScheduleRequest,
+  type GetWorkflowExecutionReferenceRequest,
   type GetWorkflowProviderEventTriggerRequest,
   type GetWorkflowProviderRunRequest,
   type GetWorkflowProviderScheduleRequest,
-  type InvokeWorkflowOperationRequest,
+  type InvokeWorkflowOperationInput,
   type InvokeWorkflowOperationResponse,
+  type ListWorkflowExecutionReferencesRequest,
   type ListWorkflowProviderEventTriggersRequest,
   type ListWorkflowProviderRunsRequest,
   type ListWorkflowProviderSchedulesRequest,
+  type ManagedWorkflowDefinition,
+  type ManagedWorkflowEventTrigger,
+  type ManagedWorkflowRun,
+  type ManagedWorkflowRunSignal,
+  type ManagedWorkflowSchedule,
   type PauseWorkflowProviderEventTriggerRequest,
   type PauseWorkflowProviderScheduleRequest,
   type PublishWorkflowProviderEventRequest,
+  type PutWorkflowExecutionReferenceRequest,
   type ResumeWorkflowProviderEventTriggerRequest,
   type ResumeWorkflowProviderScheduleRequest,
+  type SignalOrStartWorkflowProviderRunRequest,
+  type SignalWorkflowProviderRunRequest,
+  type SignalWorkflowRunResponse,
   type StartWorkflowProviderRunRequest,
   type UpsertWorkflowProviderEventTriggerRequest,
   type UpsertWorkflowProviderScheduleRequest,
+  type WorkflowAccessPermission,
+  type WorkflowAccessPermissionInput,
+  type WorkflowActor,
+  type WorkflowActorInput,
   type WorkflowEvent,
+  type WorkflowEventInput,
+  type WorkflowEventMatch,
+  type WorkflowEventMatchInput,
+  type WorkflowEventTriggerInvocationInput,
+  type WorkflowExecutionReference,
+  type WorkflowExecutionReferenceInput,
+  type WorkflowOutputBinding,
+  type WorkflowOutputBindingInput,
+  type WorkflowOutputDelivery,
+  type WorkflowOutputDeliveryInput,
+  type WorkflowOutputValueSource,
+  type WorkflowOutputValueSourceInput,
   type WorkflowProviderOptions,
+  type WorkflowRunAsSubject,
+  type WorkflowRunAsSubjectInput,
+  type WorkflowRunTriggerInput,
+  type WorkflowRunTrigger,
+  type WorkflowScheduleTrigger,
+  type WorkflowScheduleTriggerInput,
+  type WorkflowSignal,
+  type WorkflowSignalInput,
 } from "./workflow.ts";
 export {
   GENAI_OPERATION_CHAT,

package/src/indexeddb.ts

@@ -8,6 +8,7 @@ import {
   TransactionMode as ProtoTransactionMode,
   TransactionDurabilityHint as ProtoTransactionDurabilityHint,
 } from "./internal/gen/v1/datastore_pb";
+import { dateFromTimestamp, timestampFromDate } from "./protocol.ts";
 
 const ENV_INDEXEDDB_SOCKET = "GESTALT_INDEXEDDB_SOCKET";
 const INDEXEDDB_SOCKET_TOKEN_SUFFIX = "_TOKEN";
@@ -536,7 +537,8 @@ export class IndexedDB {
       ...(transportOptions.nodeOptions
         ? {
             nodeOptions: {
-              createConnection: () => connect(transportOptions.nodeOptions!.path),
+              createConnection: () =>
+                connect({ path: transportOptions.nodeOptions!.path }),
             },
           }
         : {}),
@@ -1276,7 +1278,7 @@ function toProtoTypedValue(v: unknown): any {
     return { kind: { case: "floatValue", value: v } };
   }
   if (typeof v === "string") return { kind: { case: "stringValue", value: v } };
-  if (v instanceof Date) return { kind: { case: "timeValue", value: toProtoTimestamp(v) } };
+  if (v instanceof Date) return { kind: { case: "timeValue", value: timestampFromDate(v) } };
   if (v instanceof Uint8Array) return { kind: { case: "bytesValue", value: v } };
   if (v instanceof ArrayBuffer) return { kind: { case: "bytesValue", value: new Uint8Array(v) } };
   return { kind: { case: "jsonValue", value: toProtoJsonValue(v) } };
@@ -1296,7 +1298,7 @@ function fromProtoTypedValue(v: any): unknown {
     case "boolValue":
       return v.kind.value;
     case "timeValue":
-      return fromProtoTimestamp(v.kind.value);
+      return dateFromTimestamp(v.kind.value);
     case "bytesValue":
       return new Uint8Array(v.kind.value);
     case "jsonValue":
@@ -1315,19 +1317,6 @@ function toProtoKeyRange(kr: KeyRange): any {
   };
 }
 
-function toProtoTimestamp(value: Date): any {
-  const millis = value.getTime();
-  const seconds = Math.trunc(millis / 1000);
-  const nanos = Math.trunc((millis % 1000) * 1_000_000);
-  return { seconds: BigInt(seconds), nanos };
-}
-
-function fromProtoTimestamp(value: any): Date {
-  const seconds = Number(value?.seconds ?? 0n);
-  const nanos = Number(value?.nanos ?? 0);
-  return new Date((seconds * 1000) + Math.trunc(nanos / 1_000_000));
-}
-
 function toJsInt(value: bigint): number | bigint {
   const asNumber = Number(value);
   return Number.isSafeInteger(asNumber) ? asNumber : value;