ticlawk 0.1.15 → 0.1.16-dev.2

package/src/adapters/ticlawk/api.mjs

@@ -150,26 +150,21 @@ export async function updateChannel(id, updates) {
 }
 
 export async function postRuntimeResult(body) {
+  // Activity-only: backend records the agent_event for UI trajectory
+  // display but does NOT project it into a chat message. The agent CLI's
+  // `ticlawk message send` is the only path that produces chat rows.
   const result = await apiFetch('/api/runtime-results', {
     method: 'POST',
     body: JSON.stringify(body),
     timeout: 30000,
   });
-  if (result?.matched === false) {
-    throw new Error('runtime result was not matched');
-  }
   return result;
 }
 
-// ── Messages ──
-
-export async function getPendingMessages() {
-  const { data } = await apiFetch('/api/messages/pending');
-  return data || [];
-}
+// ── Deliveries (replaces legacy message_jobs poll/ack) ──
 
-export async function claimPendingMessages(hostId, limit = 5, excludedAgentIds = []) {
-  const { data } = await apiFetch('/api/messages/claim-pending', {
+export async function claimPendingDeliveries(hostId, limit = 5, excludedAgentIds = []) {
+  const { data } = await apiFetch('/api/agent/deliveries/claim-pending', {
     method: 'POST',
     body: JSON.stringify(withTiclawkVersion({
       runtime_host_id: hostId,
@@ -180,41 +175,311 @@ export async function claimPendingMessages(hostId, limit = 5, excludedAgentIds =
   return data || [];
 }
 
-export async function syncMessages(rows) {
-  return apiFetch('/api/messages/sync', {
+export async function completeDelivery(deliveryId, hostId) {
+  return apiFetch(`/api/agent/deliveries/${deliveryId}/complete`, {
     method: 'POST',
-    body: JSON.stringify({ rows }),
+    body: JSON.stringify({ runtime_host_id: hostId }),
   });
 }
 
-export async function claimMessage(id, hostId) {
-  return apiFetch(`/api/messages/${id}/claim`, {
+export async function releaseDelivery(deliveryId, hostId, reason = null) {
+  return apiFetch(`/api/agent/deliveries/${deliveryId}/release`, {
     method: 'POST',
-    body: JSON.stringify(withTiclawkVersion({ runtime_host_id: hostId })),
+    body: JSON.stringify({ runtime_host_id: hostId, reason }),
   });
 }
 
-export async function releaseMessage(id, hostId) {
-  return apiFetch(`/api/messages/${id}/release`, {
+// ── Agent-facing CLI surface (group chat tool path) ──
+
+export async function sendAgentMessage({
+  actingAgentId,
+  conversationId,
+  text,
+  seenUpToSeq,
+  replyToMessageId,
+  runtimeHostId,
+  visibility,
+}) {
+  const { data } = await apiFetch('/api/agent/messages/send', {
     method: 'POST',
-    body: JSON.stringify({ runtime_host_id: hostId }),
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      conversation_id: conversationId,
+      text,
+      seen_up_to_seq: seenUpToSeq ?? null,
+      reply_to_message_id: replyToMessageId ?? null,
+      runtime_host_id: runtimeHostId ?? null,
+      visibility: visibility || null,
+    }),
   });
+  return data || null;
+}
+
+export async function readAgentMessages({
+  actingAgentId,
+  conversationId,
+  aroundMessageId,
+  beforeSeq,
+  limit,
+}) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  params.set('conversation_id', conversationId);
+  if (aroundMessageId) params.set('around_message_id', aroundMessageId);
+  if (beforeSeq != null) params.set('before_seq', String(beforeSeq));
+  if (limit != null) params.set('limit', String(limit));
+  const { data } = await apiFetch(`/api/agent/messages/read?${params}`);
+  return data || [];
 }
 
-export async function completeMessage(id, hostId) {
-  return apiFetch(`/api/messages/${id}/complete`, {
+export async function createAgentTask({ actingAgentId, conversationId, text, title }) {
+  return apiFetch('/api/agent/tasks/create', {
     method: 'POST',
-    body: JSON.stringify({ runtime_host_id: hostId }),
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      conversation_id: conversationId,
+      text,
+      title: title ?? null,
+    }),
+  });
+}
+
+export async function claimAgentTask({
+  actingAgentId, sourceMessageId, conversationId, number, leaseSeconds,
+}) {
+  return apiFetch('/api/agent/tasks/claim', {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      source_message_id: sourceMessageId ?? null,
+      conversation_id: conversationId ?? null,
+      number: number ?? null,
+      lease_seconds: leaseSeconds ?? null,
+    }),
+  });
+}
+
+export async function unclaimAgentTask({ actingAgentId, taskId }) {
+  return apiFetch('/api/agent/tasks/unclaim', {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      task_id: taskId,
+    }),
+  });
+}
+
+export async function reactToMessage({
+  actingAgentId, messageId, emoji, remove,
+}) {
+  return apiFetch(`/api/agent/messages/${encodeURIComponent(messageId)}/reactions`, {
+    method: remove ? 'DELETE' : 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      emoji,
+    }),
+  });
+}
+
+export async function updateAgentTask({ actingAgentId, taskId, status }) {
+  return apiFetch('/api/agent/tasks/update', {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      task_id: taskId,
+      status,
+    }),
+  });
+}
+
+export async function listAgentTasks({ actingAgentId, conversationId }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  if (conversationId) params.set('conversation_id', conversationId);
+  const { data } = await apiFetch(`/api/agent/tasks/list?${params}`);
+  return data || [];
+}
+
+export async function getConversationMembers({ actingAgentId, conversationId }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  const res = await apiFetch(`/api/agent/conversations/${conversationId}/members?${params}`);
+  return res || { data: [], conversation: null };
+}
+
+export async function getAgentServerInfo({ actingAgentId }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  return apiFetch(`/api/agent/server-info?${params}`);
+}
+
+// ── Reminders ──
+
+export async function scheduleAgentReminder({
+  actingAgentId, title, fireAt, anchorConversationId, anchorMessageId,
+}) {
+  return apiFetch('/api/agent/reminders', {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      title,
+      fire_at: fireAt,
+      anchor_conversation_id: anchorConversationId,
+      anchor_message_id: anchorMessageId ?? null,
+    }),
+  });
+}
+
+export async function listAgentReminders({ actingAgentId, status }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  if (status) params.set('status', status);
+  const { data } = await apiFetch(`/api/agent/reminders?${params}`);
+  return data || [];
+}
+
+export async function snoozeAgentReminder({ actingAgentId, reminderId, fireAt }) {
+  return apiFetch(`/api/agent/reminders/${encodeURIComponent(reminderId)}/snooze`, {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      fire_at: fireAt,
+    }),
+  });
+}
+
+export async function updateAgentReminder({
+  actingAgentId, reminderId, title, fireAt,
+}) {
+  return apiFetch(`/api/agent/reminders/${encodeURIComponent(reminderId)}`, {
+    method: 'PATCH',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      title: title ?? null,
+      fire_at: fireAt ?? null,
+    }),
+  });
+}
+
+export async function cancelAgentReminder({ actingAgentId, reminderId }) {
+  return apiFetch(`/api/agent/reminders/${encodeURIComponent(reminderId)}/cancel`, {
+    method: 'POST',
+    body: JSON.stringify({ acting_as_agent_id: actingAgentId }),
   });
 }
 
-export async function recoverClaimedMessages(hostId) {
-  return apiFetch('/api/messages/recover', {
+export async function getAgentReminderLog({ actingAgentId, reminderId }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  const { data } = await apiFetch(`/api/agent/reminders/${encodeURIComponent(reminderId)}/log?${params}`);
+  return data || [];
+}
+
+export async function fireDueReminders() {
+  // System call: no acting agent. Used by the daemon's tick.
+  return apiFetch('/api/agent/reminders/fire-due', {
     method: 'POST',
-    body: JSON.stringify(withTiclawkVersion({ runtime_host_id: hostId })),
+    body: '{}',
+  });
+}
+
+export async function checkAgentMessages({ actingAgentId, conversationId }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  if (conversationId) params.set('conversation_id', conversationId);
+  return apiFetch(`/api/agent/messages/check?${params}`);
+}
+
+export async function searchAgentMessages({
+  actingAgentId, query, conversationId, limit,
+}) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  params.set('q', query);
+  if (conversationId) params.set('conversation_id', conversationId);
+  if (limit != null) params.set('limit', String(limit));
+  const { data } = await apiFetch(`/api/agent/messages/search?${params}`);
+  return data || [];
+}
+
+export async function getAgentProfile({ actingAgentId, idOrHandle }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  return apiFetch(`/api/agent/profile/${encodeURIComponent(idOrHandle)}?${params}`);
+}
+
+export async function patchAgentProfile({
+  actingAgentId, displayName, description, avatarUrl,
+}) {
+  return apiFetch('/api/agent/profile', {
+    method: 'PATCH',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      display_name: displayName ?? null,
+      description: description ?? null,
+      avatar_url: avatarUrl ?? null,
+    }),
   });
 }
 
+export async function uploadAgentAttachment({
+  actingAgentId, filename, contentType, dataBase64,
+}) {
+  return apiFetch('/api/agent/attachments', {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      filename,
+      content_type: contentType,
+      data_base64: dataBase64,
+    }),
+  });
+}
+
+export async function viewAgentAttachment({ actingAgentId, assetId }) {
+  const params = new URLSearchParams();
+  params.set('acting_as_agent_id', actingAgentId);
+  return apiFetch(`/api/agent/attachments/${encodeURIComponent(assetId)}?${params}`);
+}
+
+export async function createAgentGroup({
+  actingAgentId, name, description, memberAgentIds,
+}) {
+  return apiFetch('/api/agent/groups', {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      name,
+      description: description ?? null,
+      member_agent_ids: memberAgentIds || [],
+    }),
+  });
+}
+
+export async function addAgentGroupMembers({
+  actingAgentId, conversationId, agentIds,
+}) {
+  return apiFetch(`/api/agent/groups/${encodeURIComponent(conversationId)}/members`, {
+    method: 'POST',
+    body: JSON.stringify({
+      acting_as_agent_id: actingAgentId,
+      agent_ids: agentIds,
+    }),
+  });
+}
+
+export async function removeAgentGroupMember({
+  actingAgentId, conversationId, agentId,
+}) {
+  return apiFetch(
+    `/api/agent/groups/${encodeURIComponent(conversationId)}/members/${encodeURIComponent(agentId)}`,
+    {
+      method: 'DELETE',
+      body: JSON.stringify({ acting_as_agent_id: actingAgentId }),
+    },
+  );
+}
+
 // ── Upload ──
 
 export async function uploadAsset(fileName, fileData, contentType, kind = 'chat_media') {
@@ -358,3 +623,15 @@ export async function getMe() {
   const { data } = await apiFetch('/api/me');
   return data || null;
 }
+
+export async function reportHostCapabilities({ hostId, hostLabel, runtimesHealth, daemonVersion }) {
+  return apiFetch('/api/hosts/capabilities', {
+    method: 'POST',
+    body: JSON.stringify({
+      host_id: hostId,
+      host_label: hostLabel || null,
+      runtimes_health: runtimesHealth || {},
+      daemon_version: daemonVersion || null,
+    }),
+  });
+}

package/src/adapters/ticlawk/credentials.mjs

@@ -6,13 +6,12 @@
  * using the connector-specific env name.
  */
 
-import { AF_ADAPTER_KEY, AF_CONFIG_PATH, persistConfig, TICLAWK_CONNECTOR_API_KEY } from '../../core/config.mjs';
+import { AF_CONFIG_PATH, persistConfig, TICLAWK_CONNECTOR_API_KEY } from '../../core/config.mjs';
 
 export function persistApiCredential(apiKey) {
   if (!apiKey || !apiKey.startsWith('tk_')) return;
 
   persistConfig({
-    [AF_ADAPTER_KEY]: 'ticlawk',
     [TICLAWK_CONNECTOR_API_KEY]: apiKey,
     TICLAWK_SETUP_CODE: '',
   });