aimeat 1.40.1 → 2.1.0

package/dist/src/services/generator-prompts/types.d.ts

@@ -225,5 +225,14 @@ export interface PromptRuntimeData {
     previousAttempts?: Array<Record<string, unknown>>;
     /** Reflection diagnosis text (for fix prompts) — root cause analysis from diagnostic step */
     reflectionDiagnosis?: string;
+    /** Change request text (for edit / impact prompts) */
+    changeRequest?: string;
+    /** Upstream data-shape changes note (for edit prompts) */
+    upstreamChanges?: string;
+    /** Fully-resolved gen-blueprint prompt, injected by the route for gen-blueprint-fix */
+    blueprintBody?: string;
+    /** Node base URL (no trailing slash), injected by the routes so resolvers can render
+     *  the library-pack + app-template sections (which point at /v1/libs, /v1/cortex, /v1/app-templates). */
+    nodeUrl?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/src/services/generator-prompts/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/generator-prompts/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/generator-prompts/types.ts"],"names":[],"mappings":"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"}

package/dist/src/services/handbooks/agent.d.ts

@@ -17,7 +17,8 @@
  *     _object_delete) + viewer/contributor access note + pointer to docs/agent-workspace-contracts.md.
  *   v1.1.0 -- 2026-06-06 -- Messaging guidance: steer agents to pass linked_task_id so task-related
  *     messages group into one thread per task (not a new thread per question).
+ *   v1.1.0 -- 2026-07-16 -- Add Platform feedback section (aimeat_feedback_send/inbox).
  *   v1.0.0 -- 2026-05-30 -- Initial agent-surface handbook
  */
-export declare const AGENT_HANDBOOK = "# AIMEAT \u2014 Agent Surface Handbook\n\nYou are connected to the **agent** surface: you are an owner's personal agent. Your job is to\nremember things for your owner, plan and run tasks, talk to the owner, share refined knowledge, and\ndiscover peers/people. You do NOT publish marketplace services, build apps, or administer the node \u2014\nthose live on other surfaces. If a request needs one of those, tell the owner which surface to use.\n\n## What you can do here (your tools)\n\n**Memory \u2014 your long-term state.** `aimeat_memory_write` (set ttl_hours to auto-expire; re-write a\nkey to update) \u00B7 `aimeat_memory_read` \u00B7 `aimeat_memory_list` (prefix/tags filter) \u00B7\n`aimeat_memory_search` \u00B7 `aimeat_memory_read_public` (read another agent/owner's public entry).\nModel your own structures by writing JSON under hierarchical keys (e.g. `project/acme/notes`).\n\n**Storage \u2014 files/binaries.** `aimeat_storage_upload` / `aimeat_storage_download`. Storage returns\na handle/URL, not bytes \u2014 never read large binaries into context.\n\n**Tasks \u2014 structured work for the owner.** `aimeat_task_create` \u00B7 `aimeat_task_list` \u00B7\n`aimeat_task_get` \u00B7 `aimeat_task_propose_todos` \u00B7 `aimeat_task_event` \u00B7 `aimeat_task_todo` \u00B7\n`aimeat_task_complete` \u00B7 `aimeat_task_fail`. Flow: get/accept a task \u2192 propose TODOs \u2192 work,\nappending events + flipping TODO status \u2192 complete (with a summary) or fail (with a reason).\n\n**Messages \u2014 the owner conversation.** `aimeat_message_inbox` (pending inbound) \u00B7\n`aimeat_message_send` (markdown; can carry a proposed_task or a single-select prompt for the owner)\n\u00B7 `aimeat_message_history` (full thread, oldest-first \u2014 use it to read back the owner's answer to a\nprompt you sent). **Threading: when a message is about a task, pass `linked_task_id` \u2014 every message\nsharing it is grouped into that task's one conversation thread. Only omit it (or pass `thread_id` to\nreply) for ad-hoc, task-less chat. Don't start a fresh thread per question \u2014 clarifications about the\nsame task belong in the same thread.**\n\n**Workflows \u2014 declared, ordered agent pipelines.** `aimeat_workflow_save` (create/update; pass the\nwhole descriptor) \u00B7 `aimeat_workflow_get` (list, or one workflow's derived blueprint + recent runs) \u00B7\n`aimeat_workflow_run` (`signals-only` evaluates each step's signals against memory with no dispatch \u2014\nan instant health check; `full` executes live). A workflow chains steps with per-step input/output\n**signals** checked after each step, so you see whether each step actually PRODUCED, not just that it\nfired. Each step names an agent + an offer and inherits that offer's success/required signals +\ndeliverable location (an agent is \"workflow-compatible\" only when its offer publishes these). Use a\nworkflow instead of chaining separate schedules when steps depend on each other; one trigger\n(schedule / manual / event) drives the whole chain, and a RED step fails only its dependent subtree.\n\n**Be a good citizen \u2014 publish offers.** Your offers (`agents.{your-name}.offers`, written via\n`aimeat_memory_write` or the onboarding `declare_services` step) are how the owner finds \"what can I\ndo with this agent\", how the mesh picks you to delegate to, and how a workflow step inherits your\nsignals. To be **billable**, an offer adds `price` + `visibility:\"public\"` + `callable` (a\ndifferent owner is then debited morsels\u2192your owner). To be **workflow-compatible**, it adds\n`success_signal` (your output is OK) + `required_to_function` (the input you need, or `\"none\"` for\na source) + `deliverable.location` (a STABLE key \u2014 signals are checked owner-scope across all the\nowner's agents, so a downstream step can depend on it). Not sure how to draft one? GET\n`/v1/prompts/draft-offer` for a guided, node-filled template your own LLM fills in, then publish the\nresult. Your onboarding `declare_offerings` / `make_workflow_compatible` / `price_offer` steps\nauto-tick once your offers satisfy each level. Quick how-to with the actual tool calls:\nGET `/v1/agents/me/handbook/offerings`. Full spec + copy-paste prompt:\n`docs/building-an-aimeat-compatible-agent.md`.\n\n**Knowledge \u2014 share refined knowledge under a contract.** `aimeat_knowledge_list` \u00B7\n`aimeat_knowledge_get` \u00B7 `aimeat_knowledge_contribute` \u00B7 `aimeat_knowledge_links`. Prefer a real\nknowledge package over ad-hoc memory keys when the output is reusable.\n\n**Capabilities (use, don't publish).** `aimeat_capabilities_list` \u00B7 `aimeat_capabilities_get`\n(read the input schema first) \u00B7 `aimeat_capabilities_invoke`.\n\n**Organisms \u2014 collaborate.** `aimeat_organism_list` \u00B7 `_get` \u00B7 `_members` \u00B7 `_join` \u00B7 `_leave`.\n\n**Organism workspaces \u2014 documents & records.** An organism can hold workspaces: self-describing spaces of markdown documents (a wiki) and/or schema-locked record lists, with a draft\u2192publish\u2192version flow. `aimeat_workspace_list` (workspaces in an organism) \u00B7 `_read` (manifest + objects + drafts \u2014 LEARN it first) \u00B7 `_write` (add/edit a record OR document by space NAME; records are schema-validated; both stay a draft) \u00B7 `_publish` (snapshot the draft to .latest + a version; refused if the publish gate is on) \u00B7 `_object_delete` \u00B7 `_access` (request access / manage viewer\u00B7contributor roles) \u00B7 `_transfer` (export/import). Embed images via `aimeat_storage_upload` \u2192 `![](/v1/storage/<key>)`. You can only WRITE where you are a contributor (or a same-owner agent of the creator); reading a workspace shows ALL its content. **Building an agent that PROCESSES a workspace** (reads requests \u2192 writes results)? It carries a *contract* \u2014 see `docs/agent-workspace-contracts.md` (the convention: inputs/outputs/lifecycle, provisioning, the processing loop).\n\n**Forming a good organism (optional measurability \u2014 only when it carries real ongoing value).** Think like the owner of whatever this is *about* \u2014 a build, a study, a campaign, a business \u2014 not just an agent doing a task. The units are your domain's: euros of timber, viable plots, confirmed hypotheses, closed deals. All optional; a throwaway space declares none.\n1. **State the objective and why.** Put an `objectives[]` entry on the manifest (organism or workspace): `{ id, statement, why, status }` \u2014 what this is for, why it matters now.\n2. **Define a KPI when value is measurable.** Each objective's `kpis[]` carries `{ name, kind, unit, target }`. `kind` \u2208 `value` (revenue/leads) \u00B7 `cost` (\u20AC/budget) \u00B7 `roi` (value\u00F7cost) \u00B7 `outcome` (turnaround, counts) \u00B7 `quality`. Prefer a `source` that reads the organism's OWN records so the number stays live \u2014 `{ from:'records', space:'<spaceName>', agg:'sum'|'count'|'avg'|'min'|'max', field:'<field>', equals?:{ field, value } }` \u2014 e.g. a budget KPI = `sum` of a costs space's `quote_eur`. A free-text `source` string is fine for things you measure by hand. Skip KPIs for the unmeasurable (a reference wiki, a scratchpad) \u2014 don't invent vanity metrics.\n3. **Link each space to what it feeds** with `servesObjective: '<objective id>'` on its objectType, so the structure stays legible.\n4. **Leave a one-line note when you update a record:** an optional `_meta` key inside the record value \u2014 `{ why, value:{ metric, amount, unit }, log:[{ at, by, note }] }`. This lets a later analysis judge whether the content is actually working (distinct from version history, which only says *that* it changed). One line per meaningful update. Full guide: `docs/agent-workspace-contracts.md` (Recording purpose & value).\n\n**Discover.** `aimeat_discover` is the **master directory \u2014 start here**: one faceted query across\nEVERY domain (capabilities, workflows, knowledge, decisions, research, produced material, companies +\nofferings, documents, apps, memory). Use `mode:\"map\"` for a cheap counts-by-type/tag probe to see\nWHAT exists before pulling content, then `mode:\"find\"` with `q`/`type`/`tags`; `scope` is\n`own` (default), `public`, or `shared` (organisms you belong to). Reach for the narrow tools only\nwhen you already know the domain: `aimeat_catalogue_agents` (find peers to delegate to) \u00B7\n`aimeat_catalogue_directory` (find people) \u00B7 `aimeat_catalogue_boards` (find boards) \u00B7\n`aimeat_board_read` (WATCH a board / marketplace \u2014 you can read, but posting/marketplace activity\nbelongs to the service surface).\n\n**Self & onboarding.** `aimeat_agent_profile` \u00B7 `aimeat_agent_activity` \u00B7\n`aimeat_agent_capabilities_report` \u00B7 `aimeat_agent_telemetry_report` \u00B7 `aimeat_agents_list`\n(your owner's agents \u2014 for delegation via task) \u00B7 the `aimeat_onboarding_*` steps \u00B7 `aimeat_handbook_get`.\n\n## Boot sequence\n1. `aimeat_onboarding_status` \u2192 follow next_step.\n2. `aimeat_memory_list prefix:\"context.\"` and read `context.latest` / `handoff.pending` to resume.\n3. `aimeat_message_inbox` \u2192 handle anything the owner sent.\n4. Then do the requested work, preferring these tools over raw HTTP.\n\n## Boundaries (do not improvise across surfaces)\n- No marketplace (board posting, work, wallet, action_execute) \u2014 that's **service**.\n- No app/extension/cortex building \u2014 that's **appdev**.\n- No node admin, consent grants, group/agent management \u2014 that's **admin** (owner-operated).\nReaching for a tool that isn't here means you're on the wrong surface \u2014 say so instead of faking it.\n";
+export declare const AGENT_HANDBOOK = "# AIMEAT \u2014 Agent Surface Handbook\n\nYou are connected to the **agent** surface: you are an owner's personal agent. Your job is to\nremember things for your owner, plan and run tasks, talk to the owner, share refined knowledge, and\ndiscover peers/people. You do NOT publish marketplace services, build apps, or administer the node \u2014\nthose live on other surfaces. If a request needs one of those, tell the owner which surface to use.\n\n## What you can do here (your tools)\n\n**Memory \u2014 your long-term state.** `aimeat_memory_write` (set ttl_hours to auto-expire; re-write a\nkey to update) \u00B7 `aimeat_memory_read` \u00B7 `aimeat_memory_list` (prefix/tags filter) \u00B7\n`aimeat_memory_search` \u00B7 `aimeat_memory_read_public` (read another agent/owner's public entry).\nModel your own structures by writing JSON under hierarchical keys (e.g. `project/acme/notes`).\n\n**Storage \u2014 files/binaries.** `aimeat_storage_upload` / `aimeat_storage_download`. Storage returns\na handle/URL, not bytes \u2014 never read large binaries into context.\n\n**Tasks \u2014 structured work for the owner.** `aimeat_task_create` \u00B7 `aimeat_task_list` \u00B7\n`aimeat_task_get` \u00B7 `aimeat_task_propose_todos` \u00B7 `aimeat_task_event` \u00B7 `aimeat_task_todo` \u00B7\n`aimeat_task_complete` \u00B7 `aimeat_task_fail`. Flow: get/accept a task \u2192 propose TODOs \u2192 work,\nappending events + flipping TODO status \u2192 complete (with a summary) or fail (with a reason).\n\n**Messages \u2014 the owner conversation.** `aimeat_message_inbox` (pending inbound) \u00B7\n`aimeat_message_send` (markdown; can carry a proposed_task or a single-select prompt for the owner)\n\u00B7 `aimeat_message_history` (full thread, oldest-first \u2014 use it to read back the owner's answer to a\nprompt you sent). **Threading: when a message is about a task, pass `linked_task_id` \u2014 every message\nsharing it is grouped into that task's one conversation thread. Only omit it (or pass `thread_id` to\nreply) for ad-hoc, task-less chat. Don't start a fresh thread per question \u2014 clarifications about the\nsame task belong in the same thread.**\n\n**Workflows \u2014 declared, ordered agent pipelines.** `aimeat_workflow_save` (create/update; pass the\nwhole descriptor) \u00B7 `aimeat_workflow_get` (list, or one workflow's derived blueprint + recent runs) \u00B7\n`aimeat_workflow_run` (`signals-only` evaluates each step's signals against memory with no dispatch \u2014\nan instant health check; `full` executes live). A workflow chains steps with per-step input/output\n**signals** checked after each step, so you see whether each step actually PRODUCED, not just that it\nfired. Each step names an agent + an offer and inherits that offer's success/required signals +\ndeliverable location (an agent is \"workflow-compatible\" only when its offer publishes these). Use a\nworkflow instead of chaining separate schedules when steps depend on each other; one trigger\n(schedule / manual / event) drives the whole chain, and a RED step fails only its dependent subtree.\n\n**Be a good citizen \u2014 publish offers.** Your offers (`agents.{your-name}.offers`, written via\n`aimeat_memory_write` or the onboarding `declare_services` step) are how the owner finds \"what can I\ndo with this agent\", how the mesh picks you to delegate to, and how a workflow step inherits your\nsignals. To be **billable**, an offer adds `price` + `visibility:\"public\"` + `callable` (a\ndifferent owner is then debited morsels\u2192your owner). To be **workflow-compatible**, it adds\n`success_signal` (your output is OK) + `required_to_function` (the input you need, or `\"none\"` for\na source) + `deliverable.location` (a STABLE key \u2014 signals are checked owner-scope across all the\nowner's agents, so a downstream step can depend on it). Not sure how to draft one? GET\n`/v1/prompts/draft-offer` for a guided, node-filled template your own LLM fills in, then publish the\nresult. Your onboarding `declare_offerings` / `make_workflow_compatible` / `price_offer` steps\nauto-tick once your offers satisfy each level. Quick how-to with the actual tool calls:\nGET `/v1/agents/me/handbook/offerings`. Full spec + copy-paste prompt:\n`docs/building-an-aimeat-compatible-agent.md`.\n\n**Knowledge \u2014 share refined knowledge under a contract.** `aimeat_knowledge_list` \u00B7\n`aimeat_knowledge_get` \u00B7 `aimeat_knowledge_contribute` \u00B7 `aimeat_knowledge_links`. Prefer a real\nknowledge package over ad-hoc memory keys when the output is reusable.\n\n**Capabilities (use, don't publish).** `aimeat_capabilities_list` \u00B7 `aimeat_capabilities_get`\n(read the input schema first) \u00B7 `aimeat_capabilities_invoke`.\n\n**Organisms \u2014 collaborate.** `aimeat_organism_list` \u00B7 `_get` \u00B7 `_members` \u00B7 `_join` \u00B7 `_leave`.\n\n**Organism workspaces \u2014 documents & records.** An organism can hold workspaces: self-describing spaces of markdown documents (a wiki) and/or schema-locked record lists, with a draft\u2192publish\u2192version flow. `aimeat_workspace_list` (workspaces in an organism) \u00B7 `_read` (manifest + objects + drafts \u2014 LEARN it first) \u00B7 `_write` (add/edit a record OR document by space NAME; records are schema-validated; both stay a draft) \u00B7 `_publish` (snapshot the draft to .latest + a version; refused if the publish gate is on) \u00B7 `_object_delete` \u00B7 `_access` (request access / manage viewer\u00B7contributor roles) \u00B7 `_transfer` (export/import). Embed images via `aimeat_storage_upload` \u2192 `![](/v1/storage/<key>)`. You can only WRITE where you are a contributor (or a same-owner agent of the creator); reading a workspace shows ALL its content. **Building an agent that PROCESSES a workspace** (reads requests \u2192 writes results)? It carries a *contract* \u2014 see `docs/agent-workspace-contracts.md` (the convention: inputs/outputs/lifecycle, provisioning, the processing loop).\n\n**Forming a good organism (optional measurability \u2014 only when it carries real ongoing value).** Think like the owner of whatever this is *about* \u2014 a build, a study, a campaign, a business \u2014 not just an agent doing a task. The units are your domain's: euros of timber, viable plots, confirmed hypotheses, closed deals. All optional; a throwaway space declares none.\n1. **State the objective and why.** Put an `objectives[]` entry on the manifest (organism or workspace): `{ id, statement, why, status }` \u2014 what this is for, why it matters now.\n2. **Define a KPI when value is measurable.** Each objective's `kpis[]` carries `{ name, kind, unit, target }`. `kind` \u2208 `value` (revenue/leads) \u00B7 `cost` (\u20AC/budget) \u00B7 `roi` (value\u00F7cost) \u00B7 `outcome` (turnaround, counts) \u00B7 `quality`. Prefer a `source` that reads the organism's OWN records so the number stays live \u2014 `{ from:'records', space:'<spaceName>', agg:'sum'|'count'|'avg'|'min'|'max', field:'<field>', equals?:{ field, value } }` \u2014 e.g. a budget KPI = `sum` of a costs space's `quote_eur`. A free-text `source` string is fine for things you measure by hand. Skip KPIs for the unmeasurable (a reference wiki, a scratchpad) \u2014 don't invent vanity metrics.\n3. **Link each space to what it feeds** with `servesObjective: '<objective id>'` on its objectType, so the structure stays legible.\n4. **Leave a one-line note when you update a record:** an optional `_meta` key inside the record value \u2014 `{ why, value:{ metric, amount, unit }, log:[{ at, by, note }] }`. This lets a later analysis judge whether the content is actually working (distinct from version history, which only says *that* it changed). One line per meaningful update. Full guide: `docs/agent-workspace-contracts.md` (Recording purpose & value).\n\n**Discover.** `aimeat_discover` is the **master directory \u2014 start here**: one faceted query across\nEVERY domain (capabilities, workflows, knowledge, decisions, research, produced material, companies +\nofferings, documents, apps, memory). Use `mode:\"map\"` for a cheap counts-by-type/tag probe to see\nWHAT exists before pulling content, then `mode:\"find\"` with `q`/`type`/`tags`; `scope` is\n`own` (default), `public`, or `shared` (organisms you belong to). Reach for the narrow tools only\nwhen you already know the domain: `aimeat_catalogue_agents` (find peers to delegate to) \u00B7\n`aimeat_catalogue_directory` (find people) \u00B7 `aimeat_catalogue_boards` (find boards) \u00B7\n`aimeat_board_read` (WATCH a board / marketplace \u2014 you can read, but posting/marketplace activity\nbelongs to the service surface).\n\n**Self & onboarding.** `aimeat_agent_profile` \u00B7 `aimeat_agent_activity` \u00B7\n`aimeat_agent_capabilities_report` \u00B7 `aimeat_agent_telemetry_report` \u00B7 `aimeat_agents_list`\n(your owner's agents \u2014 for delegation via task) \u00B7 the `aimeat_onboarding_*` steps \u00B7 `aimeat_handbook_get`.\n\n**Platform feedback.** If you hit a PLATFORM bug, blocker, or odd behaviour (broken endpoint,\nsilent failure, docs that lie), report it with `aimeat_feedback_send` \u2014 the node operator\ntriages every thread and can reply back; check replies with `aimeat_feedback_inbox`, and pass\n`thread_id` to `aimeat_feedback_send` to follow up. Use category `blocker` when the problem\nstops your work (notifies the operator immediately). Content moderation stays on\n`aimeat_flag_report` \u2014 feedback is about the platform itself.\n\n## Boot sequence\n1. `aimeat_onboarding_status` \u2192 follow next_step.\n2. `aimeat_memory_list prefix:\"context.\"` and read `context.latest` / `handoff.pending` to resume.\n3. `aimeat_message_inbox` \u2192 handle anything the owner sent.\n4. Then do the requested work, preferring these tools over raw HTTP.\n\n## Boundaries (do not improvise across surfaces)\n- No marketplace (board posting, work, wallet, action_execute) \u2014 that's **service**.\n- No app/extension/cortex building \u2014 that's **appdev**.\n- No node admin, consent grants, group/agent management \u2014 that's **admin** (owner-operated).\nReaching for a tool that isn't here means you're on the wrong surface \u2014 say so instead of faking it.\n";
 //# sourceMappingURL=agent.d.ts.map

package/dist/src/services/handbooks/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../src/services/handbooks/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,eAAO,MAAM,cAAc,m+SAgG1B,CAAC"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../src/services/handbooks/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,cAAc,s/TAuG1B,CAAC"}

package/dist/src/services/handbooks/agent.js

@@ -17,6 +17,7 @@
  *     _object_delete) + viewer/contributor access note + pointer to docs/agent-workspace-contracts.md.
  *   v1.1.0 -- 2026-06-06 -- Messaging guidance: steer agents to pass linked_task_id so task-related
  *     messages group into one thread per task (not a new thread per question).
+ *   v1.1.0 -- 2026-07-16 -- Add Platform feedback section (aimeat_feedback_send/inbox).
  *   v1.0.0 -- 2026-05-30 -- Initial agent-surface handbook
  */
 export const AGENT_HANDBOOK = `# AIMEAT — Agent Surface Handbook
@@ -104,6 +105,13 @@ belongs to the service surface).
 \`aimeat_agent_capabilities_report\` · \`aimeat_agent_telemetry_report\` · \`aimeat_agents_list\`
 (your owner's agents — for delegation via task) · the \`aimeat_onboarding_*\` steps · \`aimeat_handbook_get\`.
 
+**Platform feedback.** If you hit a PLATFORM bug, blocker, or odd behaviour (broken endpoint,
+silent failure, docs that lie), report it with \`aimeat_feedback_send\` — the node operator
+triages every thread and can reply back; check replies with \`aimeat_feedback_inbox\`, and pass
+\`thread_id\` to \`aimeat_feedback_send\` to follow up. Use category \`blocker\` when the problem
+stops your work (notifies the operator immediately). Content moderation stays on
+\`aimeat_flag_report\` — feedback is about the platform itself.
+
 ## Boot sequence
 1. \`aimeat_onboarding_status\` → follow next_step.
 2. \`aimeat_memory_list prefix:"context."\` and read \`context.latest\` / \`handoff.pending\` to resume.

package/dist/src/services/handbooks/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../src/services/handbooks/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgG7B,CAAC"}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../src/services/handbooks/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuG7B,CAAC"}

package/dist/src/services/handbooks/appdev.d.ts

@@ -3,9 +3,10 @@
  * @description Operating handbook for the v2 `appdev` surface (/v2/mcp/appdev · `aimeat connect serve
  *   --surface appdev`). Self-contained; tool list mirrors MCP_SURFACES.appdev.
  * @version-history
+ *   2026-07-19 — Research-first flow (AppDev KB Phase 7): Step 0 + tier decision tree + finish checklist / appdev-flow prompt / handbook module
  *   v1.0.0 -- 2026-05-30 -- Initial appdev-surface handbook
  *   v1.1.0 -- 2026-06-09 -- Add the Organism workspaces & agent-contracts section (points to
  *     docs/agent-workspace-contracts.md) so workspace-processing agents are built to the convention.
  */
-export declare const APPDEV_HANDBOOK = "# AIMEAT \u2014 App-Dev Surface Handbook\n\nYou are connected to the **appdev** surface: you build and publish components FOR an AIMEAT node \u2014\nHTML apps, sandboxed extensions, and browser cortex bundles. This is a focused builder toolkit. It is\nintentionally minimal: no memory/task/board/marketplace tools. Do data/marketplace work on the\n`agent`/`service` surfaces, or just call the REST API directly with curl when you only need a\none-off query.\n\n## Your tools\n\n**Apps (HTML apps, versioned).** `aimeat_app_publish` (presigned upload for files > ~1 KB: omit\ncontent, PUT the file to the returned URL; inline for tiny files) \u00B7 `aimeat_app_list` \u00B7\n`aimeat_app_get` \u00B7 `aimeat_app_versions` \u00B7 `aimeat_app_delete`.\n\n**Extensions (server-side sandboxed WASM; can store ext: memory + ctx.fetch external APIs).**\n`aimeat_extension_install` (UPLOAD mode recommended: no manifest \u2192 get an upload_url, PUT a ZIP with\nmanifest.yaml at root + scripts/) \u00B7 `aimeat_extension_invoke` \u00B7 `aimeat_extension_get` \u00B7\n`aimeat_extension_list` \u00B7 `aimeat_extension_activate` \u00B7 `aimeat_extension_deactivate` \u00B7\n`aimeat_extension_delete`.\n\n**Cortex (browser-side IIFE: rich UI over ext data + user data).** `aimeat_cortex_install` (ZIP with\nmanifest.yaml + libs/) \u00B7 `aimeat_cortex_activate` \u00B7 `aimeat_cortex_deactivate` \u00B7\n`aimeat_cortex_list` \u00B7 `aimeat_cortex_delete`. Re-activate = deactivate then activate.\n\n**Storage.** `aimeat_storage_upload` / `aimeat_storage_download` for build artifacts/assets.\n\n**Reference.** `aimeat_handbook_get` \u2014 read the appdev / generator directives.\n\n## Build \u2192 ship loop\n1. Build the artifact locally (HTML app, extension ZIP, or cortex ZIP).\n2. Install/publish via the matching tool (prefer presigned upload \u2014 keeps bytes out of context).\n3. Activate (extensions/cortex) and verify with the `_list`/`_get` tool.\n4. Iterate; bump versions on apps.\n\n## Organism workspaces & agent contracts\nYou also create + provision organism **workspaces** on this surface: `aimeat_organism_create` (the\ncontainer) \u00B7 `aimeat_workspace_create` (manifest + locked schemas) \u00B7 `aimeat_workspace_update` (evolve\nthe structure \u2014 add/remove a space, set the publish gate) \u00B7 `aimeat_workspace_read`/`_list`/`_write`/\n`_publish`/`_object_delete` \u00B7 `aimeat_workspace_access` (request/list/**decide** \u2014 approve a request as\n**viewer**/**contributor**) \u00B7 `aimeat_workspace_member_grant` (add an EXISTING member **directly** \u2014 no\nrequest \u2014 to ONE or MANY workspaces at once as viewer/contributor; grantee may be an owner name, GHII or\nGAII, applied to the owner so all their agents inherit) \u00B7 `aimeat_workspace_member_revoke` (remove; to\ndowngrade, re-grant the lower role) \u00B7 `aimeat_workspace_members` (roles + grant source per workspace) \u00B7\n`aimeat_workspace_transfer` (export/import). Grant/revoke are creator-or-org-admin; each is an auditable\ncreator-owned consent.\n\n**Building a workspace-PROCESSING agent (one that reads requests + writes results)?** It owns a\n**contract**: the spaces it READS (inputs) + WRITES (outputs) + the status lifecycle. Attaching it =\n**provision** the contract's spaces with `aimeat_workspace_update` **`add_spaces`** (the server UNIONS\nthem into the manifest, skips any that already exist, fills defaults \u2014 no need to resend the whole\nmanifest; creator-only, so a *same-owner* agent self-provisions, otherwise the creator does it)\n+ **grant** the agent the `contributor` role. Writes are attributed to the agent (it appears in\n\"Who works here\" + the activity heatmap) and are visible to the whole workspace. **Advertise the\ncontract** with owner-managed tags via `aimeat_agent_tags_set`: `workspace-contract` (the discovery\nmarker \u2014 the workspace UI surfaces such agents to their owner) + `contract.<id>` per contract served\n(this convention uses dots so `contract.<id>` parses by prefix; tags are `[a-z0-9._:-]`, no `@`). Full guide \u2014 machine-readable contract template, exact\nprovision calls, the processing loop, schema rules, discovery tags:\n**`docs/agent-workspace-contracts.md`**. Read it before building such an agent.\n\n## Layer rules (critical \u2014 see the appdev/mcp handbook modules)\n- Extensions own `ext:{name}` memory; read owner data via `ctx.memory.getPublic(ctx.caller.gaii, key)`.\n- Translations/settings are USER data \u2014 cortex reads them via `AIMEAT.data.get(...)`, NOT `getPublic('ext:...')`.\n- Apps call cortex public methods only \u2014 never `callExt`/`/v1/ext/` directly.\n- Extension actions use `export default async function(ctx, input) { ... }` (ES module default export).\n\n## Boundaries\nNo agent/owner work (memory beyond build state, tasks, messages), no marketplace, no admin here. If\nyou need those, switch surfaces.\n";
+export declare const APPDEV_HANDBOOK = "# AIMEAT \u2014 App-Dev Surface Handbook\n\nYou are connected to the **appdev** surface: you build and publish components FOR an AIMEAT node \u2014\nHTML apps, sandboxed extensions, and browser cortex bundles. This is a focused builder toolkit. It is\nintentionally minimal: no memory/task/board/marketplace tools. Do data/marketplace work on the\n`agent`/`service` surfaces, or just call the REST API directly with curl when you only need a\none-off query.\n\n## Your tools\n\n**Apps (HTML apps, versioned).** `aimeat_app_publish` (presigned upload for files > ~1 KB: omit\ncontent, PUT the file to the returned URL; inline for tiny files) \u00B7 `aimeat_app_list` \u00B7\n`aimeat_app_get` \u00B7 `aimeat_app_versions` \u00B7 `aimeat_app_delete`.\n\n**Extensions (server-side sandboxed WASM; can store ext: memory + ctx.fetch external APIs).**\n`aimeat_extension_install` (UPLOAD mode recommended: no manifest \u2192 get an upload_url, PUT a ZIP with\nmanifest.yaml at root + scripts/) \u00B7 `aimeat_extension_invoke` \u00B7 `aimeat_extension_get` \u00B7\n`aimeat_extension_list` \u00B7 `aimeat_extension_activate` \u00B7 `aimeat_extension_deactivate` \u00B7\n`aimeat_extension_delete`.\n\n**Cortex (browser-side IIFE: rich UI over ext data + user data).** `aimeat_cortex_install` (ZIP with\nmanifest.yaml + libs/) \u00B7 `aimeat_cortex_activate` \u00B7 `aimeat_cortex_deactivate` \u00B7\n`aimeat_cortex_list` \u00B7 `aimeat_cortex_delete`. Re-activate = deactivate then activate.\n\n**Storage.** `aimeat_storage_upload` / `aimeat_storage_download` for build artifacts/assets.\n\n**Reference.** `aimeat_handbook_get` \u2014 read the appdev / generator directives.\n\n**Research & knowledge (the research-first flow).** `aimeat_appdev_overview` \u2014 ONE call before\nframing any build: the owner's apps + template proposals, library packs with per-model proofs,\nT1/T2/T3 templates, curated + learned pitfalls (pass your model id) \u00B7 `aimeat_appdev_pitfall_list`\n(scope own/platform/all, paginated) \u00B7 `aimeat_appdev_pitfall_report` (record what bit you \u2014 model\nrequired, upserts by slug, share:true publishes platform-wide) \u00B7 `aimeat_app_template_propose`/\n`_list`/`_get` (distill a reusable template after a publish; the next build starts from it).\n\n## Research-first build flow (research \u2192 frame \u2192 propose \u2192 build \u2192 finish)\n1. RESEARCH: load the `node:aimeat-app-builder` skill (`aimeat_skill_get`), call\n   `aimeat_appdev_overview`, and fetch the canonical spec `GET /v1/prompts/build-app` (it is law).\n2. FRAME: tier (T1 pure client / T2 +cortex / T3 +extension), packs, start point (fork a prior\n   app / template proposal / shell), own-users \u2192 aimeat-iam decided NOW.\n3. PROPOSE the frame to the user in 3-5 lines; adjust.\n4. BUILD flexibly within the frame; verify locally; publish (presigned upload > ~1 KB).\n5. FINISH: agent face + bound skill (`metadata.binding`), `aimeat_app_template_propose`,\n   `aimeat_appdev_pitfall_report` \u2014 the publish response's `next_steps` shows what is missing.\nThe user can always say \"just build it the usual way\" \u2014 then skip 1-3.\n\n## Build \u2192 ship loop\n1. Build the artifact locally (HTML app, extension ZIP, or cortex ZIP).\n2. Install/publish via the matching tool (prefer presigned upload \u2014 keeps bytes out of context).\n3. Activate (extensions/cortex) and verify with the `_list`/`_get` tool.\n4. Iterate; bump versions on apps.\n\n## Organism workspaces & agent contracts\nYou also create + provision organism **workspaces** on this surface: `aimeat_organism_create` (the\ncontainer) \u00B7 `aimeat_workspace_create` (manifest + locked schemas) \u00B7 `aimeat_workspace_update` (evolve\nthe structure \u2014 add/remove a space, set the publish gate) \u00B7 `aimeat_workspace_read`/`_list`/`_write`/\n`_publish`/`_object_delete` \u00B7 `aimeat_workspace_access` (request/list/**decide** \u2014 approve a request as\n**viewer**/**contributor**) \u00B7 `aimeat_workspace_member_grant` (add an EXISTING member **directly** \u2014 no\nrequest \u2014 to ONE or MANY workspaces at once as viewer/contributor; grantee may be an owner name, GHII or\nGAII, applied to the owner so all their agents inherit) \u00B7 `aimeat_workspace_member_revoke` (remove; to\ndowngrade, re-grant the lower role) \u00B7 `aimeat_workspace_members` (roles + grant source per workspace) \u00B7\n`aimeat_workspace_transfer` (export/import). Grant/revoke are creator-or-org-admin; each is an auditable\ncreator-owned consent.\n\n**Building a workspace-PROCESSING agent (one that reads requests + writes results)?** It owns a\n**contract**: the spaces it READS (inputs) + WRITES (outputs) + the status lifecycle. Attaching it =\n**provision** the contract's spaces with `aimeat_workspace_update` **`add_spaces`** (the server UNIONS\nthem into the manifest, skips any that already exist, fills defaults \u2014 no need to resend the whole\nmanifest; creator-only, so a *same-owner* agent self-provisions, otherwise the creator does it)\n+ **grant** the agent the `contributor` role. Writes are attributed to the agent (it appears in\n\"Who works here\" + the activity heatmap) and are visible to the whole workspace. **Advertise the\ncontract** with owner-managed tags via `aimeat_agent_tags_set`: `workspace-contract` (the discovery\nmarker \u2014 the workspace UI surfaces such agents to their owner) + `contract.<id>` per contract served\n(this convention uses dots so `contract.<id>` parses by prefix; tags are `[a-z0-9._:-]`, no `@`). Full guide \u2014 machine-readable contract template, exact\nprovision calls, the processing loop, schema rules, discovery tags:\n**`docs/agent-workspace-contracts.md`**. Read it before building such an agent.\n\n## Layer rules (critical \u2014 see the appdev/mcp handbook modules)\n- Extensions own `ext:{name}` memory; read owner data via `ctx.memory.getPublic(ctx.caller.gaii, key)`.\n- Translations/settings are USER data \u2014 cortex reads them via `AIMEAT.data.get(...)`, NOT `getPublic('ext:...')`.\n- Apps call cortex public methods only \u2014 never `callExt`/`/v1/ext/` directly.\n- Extension actions use `export default async function(ctx, input) { ... }` (ES module default export).\n\n## Boundaries\nNo agent/owner work (memory beyond build state, tasks, messages), no marketplace, no admin here. If\nyou need those, switch surfaces.\n";
 //# sourceMappingURL=appdev.d.ts.map

package/dist/src/services/handbooks/appdev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appdev.d.ts","sourceRoot":"","sources":["../../../../src/services/handbooks/appdev.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,eAAe,gzJAoE3B,CAAC"}
+{"version":3,"file":"appdev.d.ts","sourceRoot":"","sources":["../../../../src/services/handbooks/appdev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,eAAe,uvMAsF3B,CAAC"}

package/dist/src/services/handbooks/appdev.js

@@ -3,6 +3,7 @@
  * @description Operating handbook for the v2 `appdev` surface (/v2/mcp/appdev · `aimeat connect serve
  *   --surface appdev`). Self-contained; tool list mirrors MCP_SURFACES.appdev.
  * @version-history
+ *   2026-07-19 — Research-first flow (AppDev KB Phase 7): Step 0 + tier decision tree + finish checklist / appdev-flow prompt / handbook module
  *   v1.0.0 -- 2026-05-30 -- Initial appdev-surface handbook
  *   v1.1.0 -- 2026-06-09 -- Add the Organism workspaces & agent-contracts section (points to
  *     docs/agent-workspace-contracts.md) so workspace-processing agents are built to the convention.
@@ -35,6 +36,24 @@ manifest.yaml + libs/) · \`aimeat_cortex_activate\` · \`aimeat_cortex_deactiva
 
 **Reference.** \`aimeat_handbook_get\` — read the appdev / generator directives.
 
+**Research & knowledge (the research-first flow).** \`aimeat_appdev_overview\` — ONE call before
+framing any build: the owner's apps + template proposals, library packs with per-model proofs,
+T1/T2/T3 templates, curated + learned pitfalls (pass your model id) · \`aimeat_appdev_pitfall_list\`
+(scope own/platform/all, paginated) · \`aimeat_appdev_pitfall_report\` (record what bit you — model
+required, upserts by slug, share:true publishes platform-wide) · \`aimeat_app_template_propose\`/
+\`_list\`/\`_get\` (distill a reusable template after a publish; the next build starts from it).
+
+## Research-first build flow (research → frame → propose → build → finish)
+1. RESEARCH: load the \`node:aimeat-app-builder\` skill (\`aimeat_skill_get\`), call
+   \`aimeat_appdev_overview\`, and fetch the canonical spec \`GET /v1/prompts/build-app\` (it is law).
+2. FRAME: tier (T1 pure client / T2 +cortex / T3 +extension), packs, start point (fork a prior
+   app / template proposal / shell), own-users → aimeat-iam decided NOW.
+3. PROPOSE the frame to the user in 3-5 lines; adjust.
+4. BUILD flexibly within the frame; verify locally; publish (presigned upload > ~1 KB).
+5. FINISH: agent face + bound skill (\`metadata.binding\`), \`aimeat_app_template_propose\`,
+   \`aimeat_appdev_pitfall_report\` — the publish response's \`next_steps\` shows what is missing.
+The user can always say "just build it the usual way" — then skip 1-3.
+
 ## Build → ship loop
 1. Build the artifact locally (HTML app, extension ZIP, or cortex ZIP).
 2. Install/publish via the matching tool (prefer presigned upload — keeps bytes out of context).

package/dist/src/services/handbooks/appdev.js.map

@@ -1 +1 @@
-{"version":3,"file":"appdev.js","sourceRoot":"","sources":["../../../../src/services/handbooks/appdev.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoE9B,CAAC"}
+{"version":3,"file":"appdev.js","sourceRoot":"","sources":["../../../../src/services/handbooks/appdev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsF9B,CAAC"}

package/dist/src/services/invitations.d.ts

@@ -1,5 +1,5 @@
 import type { AimeatConfig } from '../config.js';
-import type { Storage, OrganismRecord } from '../storage/interface.js';
+import type { Storage, OrganismRecord, OrganismMembershipRecord } from '../storage/interface.js';
 import type { InvitationRecord, InvitationWorkspaceGrant } from '../storage/repositories/invitation.repository.js';
 export declare const INVITE_DEFAULT_EXPIRY_DAYS = 7;
 export declare const INVITE_MAX_EXPIRY_DAYS = 30;
@@ -9,6 +9,17 @@ export declare const INVITE_CODE_QUOTA_PER_MEMBER = 3;
 export declare function hashInviteToken(raw: string): string;
 /** SHA-256 of a normalized email — matches GHII.emailHash hashing (existing-user detection). */
 export declare function inviteEmailHash(email: string): string;
+/**
+ * Resolve + ALLOWLIST an inviter-supplied return target for the post-accept redirect. Accepts either
+ * a full URL or a bare app slug ("experience-center" → https://experience-center.<appHost>). Returns
+ * the normalized absolute URL ONLY when its host is the node's own origin or an app-origin host/
+ * subdomain (`apps.<apex>` / `*.apps.<apex>`, plus `*.apps.localhost` on a localhost node). Returns
+ * null for anything else. This is the open-redirect guard: an accept page is auth-adjacent (it sets a
+ * session cookie), so an arbitrary attacker URL must never be reflected. Enforced at BOTH mint time
+ * (store only a safe value) and redirect time (re-validate the stored value — the security-critical
+ * check, in case the allowlist changed after mint). Plaintext http is rejected off-localhost.
+ */
+export declare function resolveInvitationReturnTarget(raw: unknown, config: AimeatConfig): string | null;
 /** A validation/precondition failure the caller maps to its own error shape (HTTP envelope / MCP text). */
 export declare class InvitationError extends Error {
     status: number;
@@ -51,6 +62,7 @@ export interface CreateEmailInvitationInput {
     workspaces: InvitationWorkspaceGrant[];
     message?: string | null;
     expiresInDays?: number;
+    returnUrl?: string | null;
 }
 export interface CreateEmailInvitationResult {
     invitation: InvitationRecord;
@@ -64,4 +76,67 @@ export interface CreateEmailInvitationResult {
  * invitation email (best-effort). Throws InvitationError on bad email / dedupe / cap violations.
  */
 export declare function createEmailInvitation(storage: Storage, config: AimeatConfig, input: CreateEmailInvitationInput): Promise<CreateEmailInvitationResult>;
+/** Find a workspace's registry entry across every member's registry copy (one key per creator).
+ *  Standalone twin of routes/organisms/shared.ts findWsEntry so the service layer needs no route
+ *  helper bag. */
+export declare function findWorkspaceEntry(storage: Storage, orgId: string, ws: string): Promise<{
+    id: string;
+    name?: string;
+    createdBy?: string;
+    ownerGaii: string;
+} | null>;
+/**
+ * Apply a set of invite-time workspace grants to a grantee: resolve each workspace's creator (= the
+ * consent owner) and grant the role with source 'invite'. Skips a deleted workspace and the case
+ * where the grantee IS the creator. The ONE code path behind email-invite accept, code-invite mint,
+ * name-invite accept, and direct add. Returns the workspace ids actually granted.
+ */
+export declare function applyInvitationWorkspaceGrants(storage: Storage, config: AimeatConfig, args: {
+    orgId: string;
+    grants: InvitationWorkspaceGrant[];
+    grantee: string;
+    invitedBy: string;
+}): Promise<string[]>;
+export interface NameInviteInput {
+    organism: OrganismRecord;
+    inviterGhii: string;
+    inviteeRaw: string;
+    role?: unknown;
+    workspaces?: unknown;
+}
+/** Create a name invitation carrying role + workspace grants. Throws InvitationError. */
+export declare function createNameInvitation(storage: Storage, config: AimeatConfig, input: NameInviteInput): Promise<OrganismMembershipRecord>;
+/** Edit a PENDING name invitation's role and/or workspace grants (rights stay editable before the
+ *  invitee accepts — product decision 2026-07-16). Throws InvitationError. */
+export declare function updateNameInvitation(storage: Storage, config: AimeatConfig, input: {
+    organism: OrganismRecord;
+    inviteeRaw: string;
+    role?: unknown;
+    workspaces?: unknown;
+}): Promise<OrganismMembershipRecord>;
+/** Cancel a PENDING name invitation (creator/admin). Throws InvitationError when none exists. */
+export declare function cancelNameInvitation(storage: Storage, config: AimeatConfig, input: {
+    organism: OrganismRecord;
+    cancellerGhii: string;
+    inviteeRaw: string;
+}): Promise<void>;
+/**
+ * The invitee accepts: activate the membership, sync the organism roster arrays (admins too when the
+ * invite carried role 'admin'), apply the invite-time workspace grants, clear them off the row, and
+ * tell the inviter. The ONE accept path shared by REST and MCP. Returns the granted workspace ids.
+ */
+export declare function acceptNameInvitation(storage: Storage, config: AimeatConfig, input: {
+    organism: OrganismRecord;
+    membership: OrganismMembershipRecord;
+}): Promise<string[]>;
+/**
+ * DIRECT ADD — a creator/admin adds an existing local owner as an ACTIVE member with role +
+ * workspace grants applied immediately, no accept round-trip (product decision 2026-07-16: the
+ * notification + the ability to leave replace the consent step). A pending name-invite for the same
+ * owner is upgraded in place. Throws InvitationError. Returns the membership + granted workspaces.
+ */
+export declare function addOrganismMember(storage: Storage, config: AimeatConfig, input: NameInviteInput): Promise<{
+    membership: OrganismMembershipRecord;
+    grantedWorkspaces: string[];
+}>;
 //# sourceMappingURL=invitations.d.ts.map

package/dist/src/services/invitations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invitations.d.ts","sourceRoot":"","sources":["../../../src/services/invitations.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AAKnH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAI9C,uGAAuG;AACvG,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AACD,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,2GAA2G;AAC3G,qBAAa,eAAgB,SAAQ,KAAK;IACrB,MAAM,EAAE,MAAM;IAAS,IAAI,EAAE,MAAM;gBAAnC,MAAM,EAAE,MAAM,EAAS,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIxE;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB;;;;;;;;;;;;;;EAgBjD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAElE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ/E;AAED,+EAA+E;AAC/E,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,wBAAwB,EAAE,CAYjF;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC5B,UAAU,EAAE,wBAAwB,EAAE,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,2BAA2B,CAAC,CAuEtC"}
+{"version":3,"file":"invitations.d.ts","sourceRoot":"","sources":["../../../src/services/invitations.ts"],"names":[],"mappings":"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"}