aimeat 1.2.0

package/dist/public/js/services/knowledge.js

@@ -0,0 +1,120 @@
+/**
+ * AIMEAT Knowledge Service
+ * Knowledge package import, CRUD, links, prompts, discovery.
+ */
+import { api, apiGet, apiPost, apiDelete } from '/js/api.js';
+
+/* ── Package Import ── */
+
+export async function importPackage(pkg, overrides = {}, entryData = null) {
+  const body = { package: pkg, overrides };
+  if (entryData) body.entry_data = entryData;
+  return apiPost('/v1/knowledge/import', body);
+}
+
+/* ── Package CRUD (via memory API) ── */
+
+export async function listMyPackages() {
+  const data = await apiGet('/v1/memory?prefix=packages/&tags=knowledge-package');
+  const items = data?.data?.items || data?.data?.entries || [];
+  return Array.isArray(items) ? items : [];
+}
+
+export async function getPackage(packageId) {
+  return apiGet(`/v1/knowledge/${encodeURIComponent(packageId)}`);
+}
+
+export async function deletePackage(ownerGaii, packageId) {
+  // Use admin endpoint for cascade delete (manifest + all entries)
+  return apiDelete(`/v1/admin/knowledge/${encodeURIComponent(packageId)}`);
+}
+
+/* ── Links ── */
+
+export async function listLinks(packageId, direction = 'both') {
+  return apiGet(`/v1/knowledge/${encodeURIComponent(packageId)}/links?direction=${direction}`);
+}
+
+export async function createLink(packageId, target, relation, description) {
+  return apiPost(`/v1/knowledge/${encodeURIComponent(packageId)}/link`, { target, relation, description });
+}
+
+export async function deleteLink(packageId, target) {
+  return apiDelete(`/v1/knowledge/${encodeURIComponent(packageId)}/link`, { target });
+}
+
+/* ── Prompt Templates ── */
+
+export async function getHumanPrompt() {
+  return apiGet('/v1/templates/knowledge-packager-human');
+}
+
+export async function getAgentPrompt() {
+  return apiGet('/v1/templates/knowledge-packager-agent');
+}
+
+/* ── Export ── */
+
+export async function exportPackage(packageId, format = 'json') {
+  return apiGet(`/v1/knowledge/${encodeURIComponent(packageId)}/export?format=${format}`);
+}
+
+/* ── Catalogue / Discovery ── */
+
+export async function discoverPackages(opts = {}) {
+  const params = new URLSearchParams();
+  if (opts.content_type) params.set('content_type', opts.content_type);
+  if (opts.tags) params.set('tags', opts.tags);
+  if (opts.language) params.set('language', opts.language);
+  if (opts.sort) params.set('sort', opts.sort);
+  if (opts.page) params.set('page', String(opts.page));
+  if (opts.limit) params.set('limit', String(opts.limit));
+  return apiGet(`/v1/catalogue/knowledge?${params.toString()}`);
+}
+
+/* ── Sharing Settings ── */
+
+export async function updateSharing(packageId, sharing) {
+  return api(`/v1/knowledge/${encodeURIComponent(packageId)}/sharing`, {
+    method: 'PATCH',
+    body: JSON.stringify(sharing),
+  });
+}
+
+export async function updateEntryVisibility(packageId, entryKey, visibility) {
+  return api(`/v1/knowledge/${encodeURIComponent(packageId)}/entries/${encodeURIComponent(entryKey)}/visibility`, {
+    method: 'PATCH',
+    body: JSON.stringify({ visibility }),
+  });
+}
+
+/* ── Clone ── */
+
+export async function clonePackage(packageId, targetPrefix, entries) {
+  return apiPost(`/v1/knowledge/${encodeURIComponent(packageId)}/clone`, {
+    target_prefix: targetPrefix,
+    entries,
+  });
+}
+
+/* ── Organism Knowledge ── */
+
+export async function listOrganismPackages(organismId) {
+  return apiGet(`/v1/knowledge/organism/${encodeURIComponent(organismId)}`);
+}
+
+export async function contributeToOrganism(packageId, organismId) {
+  return apiPost(`/v1/knowledge/${encodeURIComponent(packageId)}/contribute`, { organism_id: organismId });
+}
+
+/* ── Reputation ── */
+
+export async function getPackageReputation(packageId) {
+  return apiGet(`/v1/knowledge/${encodeURIComponent(packageId)}/reputation`);
+}
+
+/* ── Reviews ── */
+
+export async function getPackageReviews(packageId) {
+  return apiGet(`/v1/knowledge/${encodeURIComponent(packageId)}/reviews`);
+}

package/dist/public/js/services/memory.js

@@ -0,0 +1,112 @@
+/**
+ * AIMEAT Memory Service
+ * Key-value memory CRUD, search, file management.
+ */
+import { api, apiGet, apiPost, apiDelete } from '/js/api.js';
+
+/** List all memory entries. Returns array. Optional agentGaii to view another agent's memory. */
+export async function listMemories(agentGaii) {
+  const url = agentGaii ? `/v1/memory?agent=${encodeURIComponent(agentGaii)}` : '/v1/memory';
+  const data = await apiGet(url);
+  const list = data?.data?.items || data?.data?.entries || [];
+  return Array.isArray(list) ? list : [];
+}
+
+/** Search memory by query string. Returns array. Optional agentGaii. */
+export async function searchMemory(query, agentGaii) {
+  let url = `/v1/memory/search?q=${encodeURIComponent(query)}`;
+  if (agentGaii) url += `&agent=${encodeURIComponent(agentGaii)}`;
+  const data = await apiGet(url);
+  const list = data?.data?.results || data?.data || [];
+  return Array.isArray(list) ? list : [];
+}
+
+/** Create a new memory entry. */
+export async function createMemory(key, value, visibility, tags) {
+  const body = { key, value, visibility: visibility || 'private' };
+  if (tags) body.tags = Array.isArray(tags) ? tags : tags.split(',').map(t => t.trim()).filter(Boolean);
+  return api('/v1/memory', {
+    method: 'POST',
+    body: JSON.stringify(body),
+  });
+}
+
+/** Update (PUT) a memory entry value. */
+export async function updateMemory(key, value, version) {
+  return api(`/v1/memory/${encodeURIComponent(key)}`, {
+    method: 'PUT',
+    body: JSON.stringify({ value, version }),
+  });
+}
+
+/** Update multiple fields on a memory entry (must include version). */
+export async function updateMemoryFull(key, fields) {
+  return api(`/v1/memory/${encodeURIComponent(key)}`, {
+    method: 'PUT',
+    body: JSON.stringify(fields),
+  });
+}
+
+/** Update visibility on a memory entry. */
+export async function updateMemoryVisibility(key, visibility, version) {
+  return api(`/v1/memory/${encodeURIComponent(key)}`, {
+    method: 'PUT',
+    body: JSON.stringify({ visibility, version }),
+  });
+}
+
+/** Update tags on a memory entry. */
+export async function updateMemoryTags(key, tags, version) {
+  return api(`/v1/memory/${encodeURIComponent(key)}`, {
+    method: 'PUT',
+    body: JSON.stringify({ tags, version }),
+  });
+}
+
+/** Update tags on a file. */
+export async function updateFileTags(key, tags) {
+  return api(`/v1/memory/files/${encodeURIComponent(key)}`, {
+    method: 'PATCH',
+    body: JSON.stringify({ tags }),
+  });
+}
+
+/** Delete a memory entry. */
+export async function deleteMemory(key) {
+  return apiDelete(`/v1/memory/${encodeURIComponent(key)}`);
+}
+
+/** List files. Returns array. */
+export async function listFiles() {
+  const data = await apiGet('/v1/memory/files');
+  const list = data?.data?.files || data?.data || [];
+  return Array.isArray(list) ? list : [];
+}
+
+/** Upload a file (base64). */
+export async function uploadFile(key, base64Content, mimeType, visibility, tags) {
+  const body = {
+    key,
+    content: base64Content,
+    mime_type: mimeType || 'application/octet-stream',
+    visibility: visibility || 'private',
+  };
+  if (tags && tags.length > 0) body.tags = tags;
+  return api('/v1/memory/files', {
+    method: 'POST',
+    body: JSON.stringify(body),
+  });
+}
+
+/** Update visibility on a file. */
+export async function updateFileVisibility(key, visibility) {
+  return api(`/v1/memory/files/${encodeURIComponent(key)}/visibility`, {
+    method: 'PATCH',
+    body: JSON.stringify({ visibility }),
+  });
+}
+
+/** Delete a file. */
+export async function deleteFile(key) {
+  return apiDelete(`/v1/memory/files/${encodeURIComponent(key)}`);
+}

package/dist/public/js/services/nodes.js

@@ -0,0 +1,55 @@
+/**
+ * AIMEAT Nodes Service
+ * Personal node registration, detachment, visibility.
+ */
+import { apiGet, api } from '/js/api.js';
+
+/** Cached personal_nodes_enabled flag from bootstrap. */
+let _personalEnabled = null;
+
+async function isPersonalEnabled() {
+  if (_personalEnabled !== null) return _personalEnabled;
+  try {
+    const data = await apiGet('/');
+    _personalEnabled = !!data?.data?.this_node?.personal_nodes_enabled;
+  } catch { _personalEnabled = false; }
+  return _personalEnabled;
+}
+
+/** Load personal node status. Returns array (0 or 1 node). */
+export async function listNodes() {
+  try {
+    if (!(await isPersonalEnabled())) return [];
+    const data = await apiGet('/v1/personal/status');
+    return data?.data?.node_id ? [data.data] : [];
+  } catch { return []; }
+}
+
+/** Register (anchor) a personal node. */
+export async function registerNode(nodeId, ownerName, publicKey, agentGaiis, visibility) {
+  let nid = nodeId.trim();
+  if (!nid.startsWith('personal-')) nid = 'personal-' + nid;
+  return api('/v1/personal/anchor', {
+    method: 'POST',
+    body: JSON.stringify({
+      node_id: nid,
+      owner_name: ownerName,
+      public_key: publicKey || 'placeholder',
+      agent_gaiis: agentGaiis || [],
+      visibility: visibility || 'private',
+    }),
+  });
+}
+
+/** Detach (delete) a personal node. */
+export async function detachNode(nodeId) {
+  return api('/v1/personal/anchor/' + encodeURIComponent(nodeId), { method: 'DELETE' });
+}
+
+/** Update a node's visibility. */
+export async function setVisibility(nodeId, visibility) {
+  return api('/v1/personal/anchor/' + encodeURIComponent(nodeId), {
+    method: 'PATCH',
+    body: JSON.stringify({ visibility }),
+  });
+}

package/dist/public/js/services/organisms.js

@@ -0,0 +1,74 @@
+/**
+ * AIMEAT Organisms Service
+ * Organism CRUD, membership, join requests.
+ */
+import { api, apiGet, apiPost, apiDelete } from '/js/api.js';
+
+/** List organisms. */
+export async function listOrganisms(opts = {}) {
+  const params = new URLSearchParams();
+  if (opts.type) params.set('type', opts.type);
+  if (opts.city) params.set('city', opts.city);
+  if (opts.interest) params.set('interest', opts.interest);
+  if (opts.visibility) params.set('visibility', opts.visibility);
+  if (opts.member) params.set('member', opts.member);
+  return apiGet(`/v1/organisms?${params.toString()}`);
+}
+
+/** Get organism detail. */
+export async function getOrganism(id) {
+  return apiGet(`/v1/organisms/${encodeURIComponent(id)}`);
+}
+
+/** Create a new organism. */
+export async function createOrganism(data) {
+  return apiPost('/v1/organisms', data);
+}
+
+/** Update organism. */
+export async function updateOrganism(id, data) {
+  return api(`/v1/organisms/${encodeURIComponent(id)}`, {
+    method: 'PUT',
+    body: JSON.stringify(data),
+  });
+}
+
+/** Delete organism. */
+export async function deleteOrganism(id) {
+  return apiDelete(`/v1/organisms/${encodeURIComponent(id)}`);
+}
+
+/** Join an organism. */
+export async function joinOrganism(id, message) {
+  return apiPost(`/v1/organisms/${encodeURIComponent(id)}/join`, { message });
+}
+
+/** Leave an organism. */
+export async function leaveOrganism(id) {
+  return apiPost(`/v1/organisms/${encodeURIComponent(id)}/leave`, {});
+}
+
+/** List members. */
+export async function listMembers(id) {
+  return apiGet(`/v1/organisms/${encodeURIComponent(id)}/members`);
+}
+
+/** List join requests (admin only). */
+export async function listJoinRequests(id) {
+  return apiGet(`/v1/organisms/${encodeURIComponent(id)}/join-requests`);
+}
+
+/** Review join request (approve/reject). */
+export async function reviewJoinRequest(organismId, requestId, decision) {
+  return apiPost(`/v1/organisms/${encodeURIComponent(organismId)}/join-requests/${encodeURIComponent(requestId)}/review`, { decision });
+}
+
+/** Add admin. */
+export async function addAdmin(id, targetGhii) {
+  return apiPost(`/v1/organisms/${encodeURIComponent(id)}/admins`, { target_ghii: targetGhii });
+}
+
+/** Remove admin. */
+export async function removeAdmin(id, ghii) {
+  return apiDelete(`/v1/organisms/${encodeURIComponent(id)}/admins/${encodeURIComponent(ghii)}`);
+}

package/dist/public/js/services/packages.js

@@ -0,0 +1,97 @@
+/**
+ * @file packages.js
+ * @description API service layer for the AIMEAT packages, instances, and templates system.
+ *   Provides functions for CRUD operations on packages, package versions, instances
+ *   (install/update/remove), and template gallery listings including reviews and discussions.
+ * @structure
+ *   - Packages: listPackages, getPackage, getPackageVersions, createPackage, createVersion, updatePackage, archiveVersion
+ *   - Instances: listInstances, getInstance, getInstanceStatus, installPackage, checkUpdate, getMigrationPrompt, applyMigration, removeInstance
+ *   - Templates: listTemplates, getTemplate, createTemplate, updateTemplate, deleteTemplate, addReview, getReviews, addDiscussion, getDiscussions, toggleFeatured
+ *   - ZIP Import/Export: exportPackageZip, importPackageZip
+ *   - Template Proposals: proposeAsTemplate
+ * @usage
+ *   import * as pkgService from '/js/services/packages.js';
+ *   const res = await pkgService.listPackages({ status: 'published' });
+ * @version-history
+ *   v1.0.0 — 2026-03-15 — initial implementation (Phase 6)
+ *   v1.1.0 — 2026-03-20 — add exportPackageZip, importPackageZip, proposeAsTemplate
+ *   v1.2.0 — 2026-03-20 — add syncFederationTemplates, listFederationTemplates
+ */
+import { apiGet, apiPost, apiPatch, apiDelete } from '/js/api.js';
+
+// ── Packages ──
+export const listPackages = (params) => apiGet('/v1/packages' + buildQuery(params));
+export const getPackage = (groupId) => apiGet(`/v1/packages/${enc(groupId)}`);
+export const getPackageVersions = (groupId) => apiGet(`/v1/packages/${enc(groupId)}/versions`);
+export const createPackage = (data) => apiPost('/v1/packages', data);
+export const createVersion = (groupId, data) => apiPost(`/v1/packages/${enc(groupId)}/versions`, data);
+export const updatePackage = (groupId, data) => apiPatch(`/v1/packages/${enc(groupId)}`, data);
+export const archiveVersion = (groupId, version) => apiDelete(`/v1/packages/${enc(groupId)}/versions/${enc(version)}`);
+
+// ── Instances ──
+export const listInstances = (params) => apiGet('/v1/instances' + buildQuery(params));
+export const getInstance = (id) => apiGet(`/v1/instances/${enc(id)}`);
+export const getInstanceStatus = (id) => apiGet(`/v1/instances/${enc(id)}/status`);
+export const installPackage = (groupId, data) => apiPost(`/v1/packages/${enc(groupId)}/install`, data);
+export const checkUpdate = (id) => apiGet(`/v1/instances/${enc(id)}/check-update`);
+export const getMigrationPrompt = (id, data) => apiPost(`/v1/instances/${enc(id)}/migration-prompt`, data);
+export const applyMigration = (id, data) => apiPost(`/v1/instances/${enc(id)}/apply-migration`, data);
+export const removeInstance = (id, removeComponents) => apiDelete(`/v1/instances/${enc(id)}` + buildQuery({ removeComponents }));
+
+// ── Templates ──
+export const listTemplates = (params) => apiGet('/v1/templates' + buildQuery(params));
+export const getTemplate = (id) => apiGet(`/v1/templates/${enc(id)}`);
+export const createTemplate = (data) => apiPost('/v1/templates', data);
+export const updateTemplate = (id, data) => apiPatch(`/v1/templates/${enc(id)}`, data);
+export const deleteTemplate = (id) => apiDelete(`/v1/templates/${enc(id)}`);
+export const addReview = (id, data) => apiPost(`/v1/templates/${enc(id)}/review`, data);
+export const getReviews = (id, params) => apiGet(`/v1/templates/${enc(id)}/reviews` + buildQuery(params));
+export const addDiscussion = (id, data) => apiPost(`/v1/templates/${enc(id)}/discussion`, data);
+export const getDiscussions = (id, params) => apiGet(`/v1/templates/${enc(id)}/discussions` + buildQuery(params));
+export const toggleFeatured = (id, featured) => apiPatch(`/v1/templates/${enc(id)}/featured`, { featured });
+
+// ── ZIP Import/Export ──
+export async function exportPackageZip(groupId) {
+  const session = window.AIMEAT?.auth?.getSession?.();
+  const headers = {};
+  if (session?.jwt) headers['Authorization'] = `Bearer ${session.jwt}`;
+  const res = await fetch(`/v1/packages/${enc(groupId)}/export`, { headers });
+  if (!res.ok) throw new Error(`Export failed: ${res.status}`);
+  return res.blob();
+}
+
+export async function importPackageZip(file) {
+  const session = window.AIMEAT?.auth?.getSession?.();
+  const formData = new FormData();
+  formData.append('file', file);
+  const headers = {};
+  if (session?.jwt) headers['Authorization'] = `Bearer ${session.jwt}`;
+  const res = await fetch('/v1/packages/import', {
+    method: 'POST',
+    headers,
+    body: formData,
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.error?.message || `Import failed: ${res.status}`);
+  }
+  return res.json();
+}
+
+// ── Template Proposals ──
+export const proposeAsTemplate = (groupId) => apiPost(`/v1/packages/${enc(groupId)}/propose`, {});
+
+// ── Federation Templates ──
+export const syncFederationTemplates = () => apiPost('/v1/federation/templates/sync', {});
+export const listFederationTemplates = (params) => apiGet('/v1/federation/templates' + buildQuery(params));
+
+// ── Helpers ──
+const enc = (s) => encodeURIComponent(s);
+function buildQuery(params) {
+  if (!params) return '';
+  const qs = Object.entries(params)
+    .filter(([, v]) => v != null && v !== '')
+    .map(([k, v]) => `${k}=${encodeURIComponent(v)}`)
+    .join('&');
+  return qs ? `?${qs}` : '';
+}

package/dist/public/js/services/security.js

@@ -0,0 +1,67 @@
+/**
+ * AIMEAT Security Service
+ * GHII CORS and per-agent CORS management.
+ */
+import { apiGet, api } from '/js/api.js';
+
+/** Load GHII CORS settings. */
+export async function getGhiiCors() {
+  const data = await apiGet('/v1/ghii/cors');
+  return data?.data || {};
+}
+
+/** Update GHII CORS allowed origins. Pass null to allow all. */
+export async function setGhiiCors(origins) {
+  return api('/v1/ghii/cors', {
+    method: 'PUT',
+    body: JSON.stringify({ allowed_origins: origins }),
+  });
+}
+
+/** Load CORS settings for a specific agent. */
+export async function getAgentCors(agentName) {
+  const data = await apiGet('/v1/agents/' + encodeURIComponent(agentName) + '/cors');
+  return data?.data || {};
+}
+
+/** Update CORS settings for a specific agent. Pass null to allow all. */
+export async function setAgentCors(agentName, origins) {
+  return api('/v1/agents/' + encodeURIComponent(agentName) + '/cors', {
+    method: 'PUT',
+    body: JSON.stringify({ allowed_origins: origins }),
+  });
+}
+
+/** List active sessions for the authenticated owner. */
+export async function listSessions() {
+  const data = await apiGet('/v1/auth/sessions');
+  return data?.data?.sessions || [];
+}
+
+/** Revoke a specific session by ID. */
+export async function revokeSession(sessionId) {
+  return api('/v1/auth/sessions/' + encodeURIComponent(sessionId), { method: 'DELETE' });
+}
+
+/** Revoke all active JWT sessions for the authenticated owner. */
+export async function revokeAllSessions() {
+  return api('/v1/auth/sessions', { method: 'DELETE' });
+}
+
+/**
+ * Load full security data: GHII CORS + all agent CORS settings.
+ * @param {Array} agents - List of agent objects (must have .name)
+ */
+export async function loadAll(agents) {
+  const ghii = await getGhiiCors();
+  const agentsCors = [];
+  if (agents) {
+    for (const ag of agents) {
+      try {
+        const cors = await getAgentCors(ag.name);
+        agentsCors.push(cors);
+      } catch { /* skip */ }
+    }
+  }
+  return { ghii, agents: agentsCors };
+}

package/dist/public/js/services/stats.js

@@ -0,0 +1,11 @@
+/**
+ * AIMEAT Stats Service
+ * Node statistics.
+ */
+import { apiGet } from '/js/api.js';
+
+/** Load node-level stats. Returns stats object or null. */
+export async function getNodeStats() {
+  const data = await apiGet('/v1/stats');
+  return data?.data || null;
+}

package/dist/public/js/services/wallet.js

@@ -0,0 +1,24 @@
+/**
+ * AIMEAT Wallet Service
+ * Balance, transactions, morsel requests.
+ */
+import { apiGet, apiPost } from '/js/api.js';
+
+/** Get wallet balance and info. Returns wallet object or null. */
+export async function getWallet() {
+  const data = await apiGet('/v1/wallet');
+  return data?.data || null;
+}
+
+/** Get recent transactions. Returns array. */
+export async function getTransactions(limit = 20) {
+  const data = await apiGet(`/v1/wallet/transactions?per_page=${limit}`);
+  return data?.data?.transactions || data?.data || [];
+}
+
+/** Request morsels (daily allowance top-up). Returns response data or throws. */
+export async function requestMorsels(amount, reason) {
+  const data = await apiPost('/v1/wallet/request', { amount, reason });
+  if (data?.ok === false) throw new Error(data?.error?.message || 'Request failed');
+  return data?.data || data;
+}

package/dist/public/js/services/work.js

@@ -0,0 +1,51 @@
+/**
+ * AIMEAT Work Service
+ * Work inbox, sent items, and ratings.
+ */
+import { apiGet, api } from '/js/api.js';
+
+/** Load work inbox items. Returns array. */
+export async function listInbox() {
+  const data = await apiGet('/v1/work/inbox');
+  return data?.data?.items || data?.data || [];
+}
+
+/** Load sent work items. Returns array. */
+export async function listSent() {
+  const data = await apiGet('/v1/work/sent');
+  return data?.data?.items || data?.data || [];
+}
+
+/** Submit a rating for a completed work item. */
+export async function submitRating(workId, rating, comment) {
+  return api(`/v1/work/${encodeURIComponent(workId)}/rate`, {
+    method: 'POST',
+    body: JSON.stringify({ rating, comment }),
+  });
+}
+
+/** Accept a pending/offered work request. */
+export async function acceptWork(tc) {
+  return api(`/v1/work/${encodeURIComponent(tc)}/accept`, { method: 'POST' });
+}
+
+/** Reject a pending/offered work request. */
+export async function rejectWork(tc) {
+  return api(`/v1/work/${encodeURIComponent(tc)}/reject`, { method: 'POST' });
+}
+
+/** Deliver completed work with optional result. */
+export async function deliverWork(tc, result) {
+  return api(`/v1/work/${encodeURIComponent(tc)}/deliver`, {
+    method: 'POST',
+    body: JSON.stringify({ result }),
+  });
+}
+
+/** Update work progress. */
+export async function updateProgress(tc, progress, note) {
+  return api(`/v1/work/${encodeURIComponent(tc)}/progress`, {
+    method: 'POST',
+    body: JSON.stringify({ progress, note }),
+  });
+}