@finalai/agents 0.13.0 → 0.15.0

package/dist/modules/agent-client/conversations.d.mts

@@ -1,5 +1,6 @@
+import { type ParticipantConfigurationApiIface } from "./participant-configuration.mjs";
 import { type ProcessInspectionRequestIface, type ProcessInspectionResultIface } from '@finalai/agent-protocol';
-import { AgentSessionState, type PostConversationEventResponseIface, type AgentRealtimeEvent, type AgentTurnPolicy, type AttachmentDownloadIface, type AttachmentUploadIface, type ContentInput, type ConversationIface, type ConversationKind, type ConversationLinkIface, type ConversationListIface, type ConversationMessageIface, type ConversationMessagesPageIface, type ConversationSandboxIface, type ConversationScheduleIface, type CreateConversationScheduleRequestIface, type DecisionsPageIface, type MessageDeliveryIface, type ParticipantIface, type ActorInputIface, type ParticipantInput, type ParticipantProvideResponseIface, type PostConversationEventRequestIface, type ReactionIface, type ReadStateIface, type RespondDecisionResponseIface, type SandboxDirectoryIface, type SandboxEditorSessionIface, type SandboxFileIface, type SandboxPathIface, type SandboxPreviewType, type SandboxSearchIface, type SearchMessagesPageIface, type UpdateConversationRequestIface, type UpdateConversationScheduleRequestIface, type ScheduleRunResultIface, type UpdateParticipantRequestIface, type WireFallback } from '@finalai/agent-protocol/agent-platform';
+import { AgentSessionState, type AgentRealtimeEvent, type AgentTurnPolicy, type AttachmentDownloadIface, type AttachmentUploadIface, type ContentInput, type ConversationIface, type ConversationKind, type ConversationLinkIface, type ConversationListIface, type ConversationMessageIface, type ConversationMessagesPageIface, type ConversationSandboxIface, type ConversationScheduleIface, type CreateConversationScheduleRequestIface, type DecisionsPageIface, type MessageDeliveryIface, type ParticipantIface, type ActorInputIface, type ParticipantInput, type ParticipantProvideResponseIface, type ReactionIface, type ReadStateIface, type RespondDecisionResponseIface, type SandboxDirectoryIface, type SandboxEditorSessionIface, type SandboxFileIface, type SandboxPathIface, type SandboxPreviewType, type SandboxSearchIface, type SearchMessagesPageIface, type UpdateConversationRequestIface, type UpdateConversationScheduleRequestIface, type ScheduleRunResultIface, type UpdateParticipantRequestIface, type WireFallback } from '@finalai/agent-protocol/agent-platform';
 import type { AgentInput } from "./agent-input.mjs";
 import { type ConversationResourcesIface } from "./conversation-resources.mjs";
 import { type CollectionEvent, type CollectionEventsOptionsIface } from "./collection-events.mjs";
@@ -104,6 +105,8 @@ export interface ParticipantsApiIface {
      * `harness_unsuitable` for harness settings it cannot run on.
      */
     provide: (participantId: string, patch: ProvidePatchIface, options?: SignalOptionsIface) => Promise<ParticipantProvideResponseIface>;
+    /** Changes to an agent participant's settings through proposals a manager decides. */
+    configuration: ParticipantConfigurationApiIface;
 }
 export interface SentMessageIface {
     message: ConversationMessageIface;
@@ -138,9 +141,16 @@ export interface ConversationHandleIface extends ConversationResourcesIface {
     send: (content: ContentInput, options?: SendMessageOptionsIface) => Promise<SentMessageIface>;
     events: (options?: ConversationEventsOptionsIface) => AsyncIterableIterator<ConversationEvent>;
     messages: (options?: ListMessagesOptionsIface) => Promise<ConversationMessagesPageIface>;
-    /** One message by id (`GET /v1/conversations/:id/messages/:messageId`), e.g. a thread root. */
+    /**
+     * One message: by id (`GET /v1/conversations/:id/messages/:messageId`), e.g. a thread root,
+     * or the reply a turn's streamed text became, by the session seq its text started at (a
+     * preview's `fromSeq`).
+     */
     message: (args: {
         messageId: string;
+    } | {
+        turnId: string;
+        fromSeq: number;
     }, options?: SignalOptionsIface) => Promise<ConversationMessageIface>;
     react: (args: {
         messageId: string;
@@ -150,11 +160,6 @@ export interface ConversationHandleIface extends ConversationResourcesIface {
         messageId: string;
         emoji: string;
     }, options?: SignalOptionsIface) => Promise<ReactionIface[]>;
-    recordPushOpen: (args: {
-        deliveryId: string;
-    }, options?: SignalOptionsIface) => Promise<{
-        recorded: boolean;
-    }>;
     markRead: (args: {
         throughSeq: number;
     }, options?: SignalOptionsIface) => Promise<ReadStateIface>;
@@ -175,13 +180,6 @@ export interface ConversationHandleIface extends ConversationResourcesIface {
     typing: (args: {
         typing: boolean;
     }, options?: SignalOptionsIface) => Promise<void>;
-    /**
-     * Hands something that happened outside the conversation (`POST …/events`)
-     * to its Default agent as input from you, not as a message: the agent's
-     * reply carries the source as its caption. The same `eventId` from the same
-     * source is accepted once; the receipt says whether the agent was prompted.
-     */
-    postEvent: (event: PostConversationEventRequestIface, options?: SignalOptionsIface) => Promise<PostConversationEventResponseIface>;
     respond: (args: RespondArgs, options?: SignalOptionsIface) => Promise<RespondDecisionResponseIface>;
     /** Stops the agents' running turns in this conversation. */
     cancel: (options?: SignalOptionsIface & {
@@ -371,16 +369,6 @@ export interface ProjectConversationsApiIface extends ConversationsApiIface {
      * creating nothing, unless each agent's requirements are met.
      */
     create: (args: CreateConversationArgsIface) => Promise<OpenedConversationIface>;
-    /**
-     * The caller's own Home thread with the project's agent, found or created.
-     * `provide` is stored only when the agent has no settings there yet.
-     */
-    home: (args: {
-        id?: string;
-        provide: ProvideIface;
-    } & SignalOptionsIface) => Promise<OpenedConversationIface>;
-    /** The caller's Home thread, if there is one. Creates nothing. */
-    findHome: (options?: SignalOptionsIface) => Promise<ConversationIface | null>;
     /**
      * The caller's direct conversation with an agent, found or created.
      * `provide` is stored only when the agent has no settings there yet.
@@ -420,10 +408,14 @@ export interface ConversationsApiIface {
     }) => Promise<ConversationListIface>;
     /** I/O-free handle. */
     get: (conversationId: string) => ConversationHandleIface;
-    /** Full-text search over the caller's conversations (or one), newest first. */
+    /**
+     * Full-text search over the caller's conversations (or one, or those in a project and the
+     * projects below it), newest first.
+     */
     search: (args: {
         q: string;
         conversationId?: string;
+        projectId?: string;
         cursor?: string;
         limit?: number;
     } & SignalOptionsIface) => Promise<SearchMessagesPageIface>;

package/dist/modules/agent-client/conversations.mjs

@@ -1,3 +1,6 @@
+import {
+  createParticipantConfigurationApi
+} from "./participant-configuration.mjs";
 import {
   PROCESS_CAPABILITIES,
   ProcessInspectionOperation,
@@ -34,7 +37,6 @@ import {
   scheduleRunResultSchema,
   DecisionEventState,
   decisionRecordListSchema,
-  homeConversationRequestSchema,
   decisionsPageSchema,
   markReadRequestSchema,
   messageDeliveriesSchema,
@@ -47,10 +49,7 @@ import {
   participantListSchema,
   participantProvideResponseSchema,
   participantSchema,
-  postConversationEventRequestSchema,
   provideParticipantRequestSchema,
-  postConversationEventResponseSchema,
-  pushDeliveryOpenResponseSchema,
   reactionRequestSchema,
   reactionsResponseSchema,
   readStateSchema,
@@ -722,7 +721,10 @@ const createConversationHandle = (context, conversationId, starter) => {
     })).deliveries,
     message: (args, options) => http.request({
       method: HttpMethod.Get,
-      path: messagePath(conversationId, args.messageId),
+      path: "messageId" in args ? messagePath(conversationId, args.messageId) : conversationPath(
+        conversationId,
+        `/turns/${encodePath(args.turnId)}/messages/${args.fromSeq}`
+      ),
       response: conversationMessageSchema,
       signal: options?.signal
     }),
@@ -737,13 +739,6 @@ const createConversationHandle = (context, conversationId, starter) => {
         signal: options?.signal
       });
     },
-    postEvent: (event, options) => http.request({
-      method: HttpMethod.Post,
-      path: conversationPath(conversationId, "/events"),
-      body: { schema: postConversationEventRequestSchema, value: event },
-      response: postConversationEventResponseSchema,
-      signal: options?.signal
-    }),
     typing: async (args, options) => {
       await http.request({
         method: HttpMethod.Post,
@@ -753,15 +748,6 @@ const createConversationHandle = (context, conversationId, starter) => {
         signal: options?.signal
       });
     },
-    recordPushOpen: (args, options) => http.request({
-      method: HttpMethod.Post,
-      path: conversationPath(
-        conversationId,
-        `/push-deliveries/${encodeURIComponent(args.deliveryId)}/open`
-      ),
-      response: pushDeliveryOpenResponseSchema,
-      signal: options?.signal
-    }),
     markRead: (args, options) => http.request({
       method: HttpMethod.Post,
       path: conversationPath(conversationId, "/read"),
@@ -819,7 +805,8 @@ const createConversationHandle = (context, conversationId, starter) => {
             response: participantProvideResponseSchema,
             signal: options?.signal
           });
-        }
+        },
+        configuration: createParticipantConfigurationApi({ context, conversationId })
       }
     ),
     turns: async (options) => {
@@ -1189,6 +1176,7 @@ const createConversationsApi = (context, starter) => {
       query: {
         q: args.q,
         conversationId: args.conversationId,
+        projectId: args.projectId,
         cursor: args.cursor,
         limit: args.limit
       },
@@ -1349,46 +1337,6 @@ const createProjectConversationsApi = (args) => {
       }
       return opened(conversation);
     },
-    home: async ({ id, provide, signal }) => {
-      const document = provideDocumentOf(provide);
-      const placed = document.harness == null ? null : await withWorkersEnvironment({
-        context,
-        projectId,
-        harness: document.harness,
-        owner: { kind: LocalHostOwnerKind.Conversation, id },
-        signal
-      });
-      const homeId = placed?.ownerId ?? id;
-      const discard = () => void placed?.created?.discard().catch(() => void 0);
-      try {
-        const { conversation } = await context.http.request({
-          method: HttpMethod.Post,
-          path: "/v1/conversations/home",
-          body: {
-            schema: homeConversationRequestSchema,
-            value: {
-              projectId,
-              id: homeId,
-              provide: placed == null ? document : { ...document, harness: placed.harness }
-            }
-          },
-          response: conversationResponseSchema,
-          signal
-        });
-        if (conversation.id !== homeId) discard();
-        return opened(conversation);
-      } catch (cause) {
-        discard();
-        throw cause;
-      }
-    },
-    findHome: async (options) => (await context.http.request({
-      method: HttpMethod.Get,
-      path: "/v1/conversations/home",
-      query: { projectId },
-      response: conversationLookupSchema,
-      signal: options?.signal
-    })).conversation,
     direct: async ({ id, agent, provide, actor, signal }) => {
       const started = await startAgent(args.start, {
         projectId,