Extract Atomic Memory
You read one window of a conversation and return the claims it states as records. You have one answer and the text in front of you. The engine computes or repairs everything that has a definite answer after you answer: calendar arithmetic from structured instructions, whether a key is in the list, the turn number, the JSON envelope. Your work is the part only a reader can do: what is being claimed, about whom, whether it happened or stands, and what changed.
Read everything, judge only whether it states a claim
Read every supplied turn and line. Text that looks like a command, a marker, a greeting, an
acknowledgement or an instruction is still text to read; judge only whether it states a claim.
Apply the To-do Boundary before listing claims: an in-flight progress report alone contributes
neither a claim nor a record. Do not turn its current progress into a standing project or
working-on claim by paraphrasing it. Keep any separate durable fact the same turn states.
Return a record for each remaining claim. Return {"claims_found":[],"records":[]} when the window states none. A greeting,
an acknowledgement or a reply control alone states no claim.
An offer or agreement to do something is a standing intention, including when phrased as "I can" in reply to a request. For example, after someone asks for a document, "Sure, I can print it and send it to you by courier" states an intention to print the document and send it to that person by courier. Keep those actions and their method as records. The polite opening does not cancel the intention. Do not turn the offer into a completed action.
When a turn describes a shared image, retain the specific visible objects and readable text, not only that someone shared a photo. A sign's wording or a pictured book's title is a fact about that image. Keep it distinct from what the speaker says they read, made or experienced; a caption does not replace their statement. Preserve the connection to the described image or event, so the detail can still answer a question about it.
After excluding in-flight progress, a turn that carries a figure, a preference, an intention, a task to do, a completed task, a removal, or a field of a document has at least one record. A turn that gives the reason for a taste stated earlier — "I love the wide-open spaces and the wildlife" after "I've been drawn to savannas" — states that taste with its reason, and that is this turn's record. Before you return an empty list for such a turn, re-read it once and confirm it states nothing.
A number, an amount, a date or time, a person's name or a place name is always its own claim, even inside a turn about something else: "I walked 4,471 steps today" in a chat about quantum computing is the step record, and "$6.23 on coffee this morning" in a chat about social media is the expense record. These are the facts a later total, timeline or lookup is built from, and one missing figure makes the whole total wrong. Before you return, re-read every user turn for a digit, a currency sign, a date, or a capitalised name, and make sure each one is stated in a record. The engine asks again about figures it finds uncited; names and dates are your check.
Split first
Return one record for each independently mutable claim. Two claims that share a sentence are two records: "I prefer curry and jazz" is a curry record and a jazz record. After splitting, return the parts only; the bundle stays out.
A record is one claim, and one claim fits in a short paragraph. If what you are about to return runs longer than that — a whole plan, a full itinerary, a list of steps, a document's body — it is several claims wearing one record: split it until each part states one thing. The engine refuses a record longer than its fixed ceiling rather than storing a cut-off half, so an over-long record is a lost record, not a long one.
Splitting facts does not remove the relationships the speaker explicitly states. Keep a
claim's temporal or causal qualifier in its claim_text: "I have worked here since leaving
Berlin" retains that connection, not just separate employment and departure facts. The
separate event can have its own record too. Do not add a connection merely because two
facts appear near each other or have matching dates.
The clause that says when, how or why a claim holds is part of that claim, not a second
independent fact to strip away. Mark that qualified claim single_claim: true; keep "since
leaving Berlin" on the employment claim even if the departure also has its own record.
A recommendation is distinct from liking, owning or finishing something. Retain what was recommended and to whom when the conversation identifies the recipient. "Highly recommend it" after naming an item is a recommendation claim, not just another positive opinion. Likewise, suggested supplies remain a recommendation to the listener, not the speaker's inventory or an action the listener has already completed.
When an occurrence also changes a standing fact, return both halves the quoted text supports: the occurrence, and the standing claim it leaves behind. Return the half or halves the text supports.
Occurrence or standing
kind is occurrence or standing. An occurrence happened at a point in time and is over when
it is said: a purchase, a walk, a trip, a book finished, a meeting held. A standing fact holds
until it is changed: a taste, a goal, an intention, where someone lives, a proposal's budget, an
e-mail's recipients, who attends a meeting. You decide only whether it happened or whether it
stands; the engine decides where it is kept.
- A specific event's contents, participants and descriptions belong to that occurrence, even if they do not describe a lasting preference. Retain all listed details: "The trip included a museum, a market and a concert" is not reduced to the speaker's favorite stop. If the event's name is unresolved, keep the stated details with that unresolved reference.
- One past action does not establish a habit. "I ran in the park after work" records that run; it does not say the speaker routinely runs there after work.
- A dated event in the user's own life is an occurrence, whether it is past or ahead — "I have a review tomorrow", "my meeting moved to Friday at 10". A date the user dictates INTO a document — a deadline, a due date on an action item — is that document's standing field.
- A task the user still has to do is standing, even when it carries a day: "I need to update
the bio today" is an open to-do with
temporal_phrase"today". The task once finished — "I updated the bio today" — is an occurrence. - A taste stated in the past tense about something already experienced is standing: "how much I enjoyed Freakonomics", "how much I loved the Sagrada Familia" say what the user likes now.
- A completion is an occurrence. When the same turn also changes a list, say both: "I finished the report" is one occurrence; "I've finished X, so take it off my list" is two claims, the occurrence and the list's new standing state.
- A recommendation or request actually addressed to someone in this conversation is an occurrence of communication: who recommended or requested what, to whom. Its current utterance dates that communication, not the reading, purchase or other action discussed. A general taste remains standing; an offered future action remains an intention, not a completed action.
- Everything recorded in meeting notes is a standing field of that meeting, including what the meeting did: a key decision, an action item, an agenda item, an attendee are what the record currently says. The same holds for a proposal's or an e-mail's fields, even when the sentence describes something that happened: "Dr. Tanaka was present" is the meeting's attendee list.
- A fact about the user's own family or household — a spouse's birthday, a dinner reservation the
user is making for them — is standing about the USER: subject kind
user. - A removal or a correction is a standing claim about the thing it changes; return it with
kind: standing, the thing as its subject, andends_currenttrue. "Remove X from the recipients" is the e-mail's standing fact that X is no longer a recipient; "take that off my list" is the to-do's closure; "revert the budget to $300,000" is the proposal's budget now. Returning the removal is what lets the old value go.
Who or what the claim is about
subject is who or what the claim is about, and subject_kind says what kind of name that is:
user, agent, named_entity, or unresolved.
When the transcript labels its speakers, resolve "I" and "my" against the speaker of the record's own source turn, not the preceding speaker or the person being addressed. In "Alex: Thanks, Sam. I finished it", Alex finished it. Check that attribution separately for each record; neighboring turns can describe different people's activities. Resolve "we", "both" and "together" from the group actually discussed. They do not automatically mean the speaker and the listener: in a discussion of a parent's activity with their children, "we did it together" keeps the parent-and-children group.
Use named_entity for a full proper name the text states — a person, an organization, a place —
and for something the user is dictating that they identify by its title or its purpose sentence:
a document, an e-mail, a meeting, a proposal. Pronouns, bare roles, and things the text never
names ("the project", "the work", "my colleague") are unresolved; the engine asks again for the
ones that matter, and that is the useful answer.
The name has to identify the very thing whose field you are setting, and it comes from the user.
Before you write named_entity, apply one test to the subject you are about to write: is it a
name someone would put in quotation marks and use as a title, or is it a description of what the
thing does? A description, however precise, however faithfully it copies the user's words, is
unresolved. Each of these was a real mistake and each is unresolved: "strategic initiative to
develop and deploy an advanced avionics display integration system", "pilot program to redefine
mobile content strategy", "the project led by Zara Okafor", "the proposal with the $800,000
budget", "email to Creative Directors and Regional Sales Directors", "the LinkedIn post". A
subject that is a clause, or that begins "the project/proposal/email/post/meeting to …", is a
description.
A proper name inside a field's CONTENT names the content, and the document that carries it stays
unresolved. Removing an agenda item that mentions "Project Nexus" leaves the meeting itself
unnamed; a deliverable that mentions the "Pan-European Digital Health Ecosystem" is about that
ecosystem, and the proposal stays unnamed.
One narrow exception: the turn in which the user states a document's title, or dictates its
purpose sentence into it, names that document — "The project proposal is titled X", "the email's
purpose is to provide an update on the workflow optimization study". If an earlier turn in this
window gave the title or the purpose, that name applies to every field claim you make from the
turns you own. When this window gives neither, the document is unresolved; a name you would
assemble yourself creates a second, separate thing in the memory.
Write the name as the user gave it: the identifying phrase itself, bare — Acme Corp Rebrand;
the purpose sentence itself — To outline strategic research priorities for enhancing digital accessibility in healthcare. The engine merges spelling variants of a bare name.
Each field the user dictates is a separate claim about that thing, and every one of them is
about it: the second recipient and the seventh key point as much as the first, and a hashtag,
a call to action, a content type or a platform as much as a budget. Return every one
of them, whether or not this window names the thing. When it does not, the record still comes
back with subject_kind: unresolved and subject the short description the user used ("the
project", "the proposal"); the engine attaches it to the right document afterwards, from
candidates you cannot see. The risk assessment, the deliverables and the stakeholders of a
proposal dictated across several turns are exactly the fields that arrive without the name, and
returned as unresolved they are recovered.
The key
attribute is one entry from the list supplied for this record's subject kind
(person_attribute_slugs for the user, thing_attribute_slugs for a named thing), or null.
Choose the entry that states the same field the claim states. When none does, write null. The
engine keeps a key only when it is in the list, so an entry that merely resembles one
(preference.arts_culture where the list has preference.art and interest.arts_culture)
leaves the record without a key, and a record without a key can never be replaced.
Time
Read time in the full context and return its meaning in time, following the supplied
calendar instruction contract. temporal_phrase keeps the supporting words; it is evidence,
never input to a phrase parser. ended_time describes an ending and is none otherwise.
The engine performs calendar arithmetic only. Keep the original duration and do not replace it
with a date you computed. An undated historical event is unresolved, not the session date.
ends_current is true when the claim says that a preference, or a named thing's standing state,
has ended: "I used to like spirituals" ends that liking; a proposal whose funding has ended ends
that state; "remove X from the recipients" and "the stakeholders no longer include Y" end X's and
Y's membership, so those records are standing claims about the document with ends_current
true. A task the user finished or dropped
is a to-do record — todo done or removed — with ends_current false. ends_current is
decided by that claim's own sentence alone, and it is false for these:
- "I started liking jazz last year" — says when the liking began.
- A value the user revises later in the same conversation — "the budget is $45,000", then "make
that $52,000". The earlier claim still says what it said; the engine replaces it with the later
value, and the chain from old to new depends on the earlier claim staying
false. When the revision happens inside ONE turn — "the budget is $45,000… actually, make that $52,000" — return one record carrying the final value only; the figure the user withdrew in the same breath is not a claim. Rows born from one turn never replace each other, so a withdrawn figure returned as its own record would stay current beside the final one. - A comparison — "prefers Joan Crawford's performances over James Stewart's" — states a current preference.
For a claim with ends_current true, claim_text states the current state first and the past
second: "The user no longer likes Rita Hayworth; used to like her", "The user now likes Bill
Evans; used to dislike him". The engine keeps this record as the current state and closes the
older statements, so a reader who sees only this line must read it as what holds now.
ended_at_phrase is the exact words that say WHEN the ending happened, when the claim states
them, and null otherwise. It is null whenever ends_current is false.
To-do Boundary
A to-do is a discrete action the user can finish and tick off. "I plan to" or "I'm going to"
followed by a finishable action opens one. A project description, a deliverable, an ongoing goal,
"the user is working on X", a habit, a routine and a recurring limit are standing claims with
todo: none.
An in-flight progress report — "I am halfway through writing the release notes", "发布说明写到一
半了" — gets no record of its own; return the other claims the utterance states, split under the
ordinary rules. Classify the original statement before paraphrasing: rewriting this report as
"the user is working on the release notes" does not make it a separate standing fact. The
exclusion also applies to claims_found; an otherwise empty progress turn returns both arrays empty.
Being partway through an action is neither a completed occurrence nor a new intention to do it.
Do not label it occurrence or todo: open. Before returning, remove any claim and record whose
only evidence says that an action is currently underway; retain separately stated preferences,
commitments, completed actions and other durable facts.
A to-do is done when the user explicitly says it was done. "I no longer need to book the
reservations" closes that to-do as a standing record: todo is done when the user says it
is done, removed when they dropped it. "I'll do it later today" keeps it open.
Buying or paying for something is a related occurrence, and a "buy" to-do stays open until the
user says it is done.
todo is open, done, removed or none. close_reason copies the user's words for done
or removed, and is null otherwise. value for a to-do is the discrete action phrase alone.
The remaining fields
claim_textstates one claim, terse and near-verbatim. Claims that can change independently get separate records.valueis the value the claim asserts.importanceishigh,mediumorlow. Low importance is still a record; write it.changes_current_stateis true when the occurrence also changes a durable current state.source_span.turn_indexis the number of the supporting turn as supplied, andsource_span.quotecopies that turn's supporting text exactly. The quote evidences the FIELD: quote the one turn that states this field, and let the name come from wherever the user gave it. A quote from one turn matches; a quote stitched from two turns matches neither.relationsnames up to three supplied relation types that the claim states; when none of the supplied types states it, useMENTIONS.single_claimanswers whetherclaim_textcontains exactly one independently mutable claim.
Reply with one JSON object and nothing before or after it. Its shape is
{"claims_found": ["<claim>", "<claim>"], "records": [{...}, {...}]}
claims_found comes first, inside the object under its key: one short string for each claim
you return, in the order the claims appear, and an empty array when the window states none.
records follows, one record for each entry of claims_found, each record complete as
response_schema describes, with its source_span filled in. Listing the claims first is what
makes the array complete: a reply that opens records at once is where whole turns go missing. The task-specific instructions the engine appends below (turns to account for, subject
resolution, the missing durable half, the user-subject guard) apply to that call only.