useDocyrusAgentMemories

Backend glue for the DocyrusAgent memory manager — list, create, update and delete /v1/ai/memories with optimistic local state.

Edit on GitHubEditllms.txt

iOSAndroidExpo Go

Installation

pnpm dlx @docyrus/cli add @docyrus/rn-hooks-use-docyrus-agent-memories

A verbatim port of the web hook (no React Query — plain local state with optimistic updates). Feed its result into DocyrusAgentMemoriesView.

Usage

import { DocyrusAgentMemoriesView } from '@/components/docyrus-native/docyrus-agent';
import { useDocyrusAgentMemories } from '@/hooks/docyrus-native/use-docyrus-agent-memories';

const memories = useDocyrusAgentMemories({ client, agentId: AGENT_ID, userId: user?.id });

<DocyrusAgentMemoriesView
  memories={memories.memories}
  loading={memories.isLoading}
  saving={memories.isSaving}
  deletingId={memories.deletingId}
  error={memories.error}
  onCreate={memories.create}
  onUpdate={memories.update}
  onDelete={memories.remove} />

API Reference

UseDocyrusAgentMemoriesArgs

Option	Type	Default	Description
`client`	`DocyrusAgentMemoriesClient \| null \| undefined`	-	Client with `get` / `post` / `patch` / `delete`
`enabled`	`boolean`	`true`	Run the initial fetch
`agentId`	`string`	-	Agent scope of created memories
`projectId`	`string \| null`	`null`	Project scope of created memories
`userId`	`string \| null`	`null`	User scope of created memories
`listParams`	`Record<string, string \| number \| boolean \| null \| undefined>`	-	Extra query params for the list call

UseDocyrusAgentMemoriesResult

Field	Type	Description
`memories`	`ReadonlyArray<DocyrusAgentMemory>`	Current list
`isLoading` / `isSaving`	`boolean`	Fetch / save state
`deletingId`	`string \| null`	Memory being deleted
`error`	`string \| null`	Last error message
`refresh`	`() => Promise<void>`	Re-fetch `GET /v1/ai/memories`
`create`	`(form: DocyrusAgentMemoryFormState) => Promise<DocyrusAgentMemory \| null>`	`POST /v1/ai/memories`
`update`	`(memory, form) => Promise<DocyrusAgentMemory \| null>`	`PATCH /v1/ai/memories/{id}`
`remove`	`(memory) => Promise<boolean>`	`DELETE /v1/ai/memories/{id}`