@hexis-ai/engram-server 0.7.0 → 0.8.0

package/dist/adapters/memory.d.ts

@@ -1,5 +1,5 @@
 import type { Session } from "@hexis-ai/engram-core";
-import type { AliasInfo, AliasUpsert, IdentityInfo, IdentityUpsert, PersonCreate, PersonInfo, PersonUpdate, SessionEvent, SessionInit } from "@hexis-ai/engram-sdk";
+import type { AliasInfo, AliasUpsert, IdentityInfo, IdentityUpsert, PersonCreate, PersonInfo, PersonUpdate, SessionEvent, SessionInit, SessionUpdate } from "@hexis-ai/engram-sdk";
 import { type StorageAdapter } from "../storage";
 export interface InMemoryAdapterOptions {
     /** Override for tests. Default: `p_${random}` with 8 chars. */
@@ -24,6 +24,7 @@ export declare class InMemoryAdapter implements StorageAdapter {
     }): Promise<void>;
     appendEvents(sessionId: string, events: SessionEvent[]): Promise<void>;
     getSession(sessionId: string): Promise<Session | null>;
+    updateSession(sessionId: string, patch: SessionUpdate): Promise<Session | null>;
     getSessionEvents(sessionId: string): Promise<SessionEvent[] | null>;
     listSessions(opts: {
         limit: number;

package/dist/adapters/memory.js

@@ -37,6 +37,16 @@ export class InMemoryAdapter {
                 participants,
                 viewable_by,
                 createdAt: init.createdAt,
+                // status defaults to 'active' to match the Postgres column default.
+                status: init.status ?? "active",
+                ...(init.summary != null ? { summary: init.summary } : {}),
+                ...(init.model != null ? { model: init.model } : {}),
+                ...(init.trigger_conversation_id != null
+                    ? { trigger_conversation_id: init.trigger_conversation_id }
+                    : {}),
+                ...(init.trigger_event_id != null
+                    ? { trigger_event_id: init.trigger_event_id }
+                    : {}),
             },
             events: new Map(),
         });
@@ -66,6 +76,56 @@ export class InMemoryAdapter {
             return null;
         return foldEvents(s.row, [...s.events.values()], new Date());
     }
+    async updateSession(sessionId, patch) {
+        const s = this.sessions.get(sessionId);
+        if (!s)
+            return null;
+        // Patch semantics: undefined = leave alone; null = clear; value = set.
+        // SessionRow optional fields use `string | undefined`, so a "null"
+        // request collapses to `undefined` storage-side.
+        const next = { ...s.row };
+        if (patch.title !== undefined) {
+            if (patch.title === null)
+                delete next.title;
+            else
+                next.title = patch.title;
+        }
+        if (patch.channel !== undefined) {
+            if (patch.channel === null)
+                delete next.channel;
+            else
+                next.channel = patch.channel;
+        }
+        if (patch.status !== undefined) {
+            next.status = patch.status;
+        }
+        if (patch.summary !== undefined) {
+            if (patch.summary === null)
+                delete next.summary;
+            else
+                next.summary = patch.summary;
+        }
+        if (patch.model !== undefined) {
+            if (patch.model === null)
+                delete next.model;
+            else
+                next.model = patch.model;
+        }
+        if (patch.trigger_conversation_id !== undefined) {
+            if (patch.trigger_conversation_id === null)
+                delete next.trigger_conversation_id;
+            else
+                next.trigger_conversation_id = patch.trigger_conversation_id;
+        }
+        if (patch.trigger_event_id !== undefined) {
+            if (patch.trigger_event_id === null)
+                delete next.trigger_event_id;
+            else
+                next.trigger_event_id = patch.trigger_event_id;
+        }
+        s.row = next;
+        return foldEvents(s.row, [...s.events.values()], new Date());
+    }
     async getSessionEvents(sessionId) {
         const s = this.sessions.get(sessionId);
         if (!s)

package/dist/adapters/postgres.d.ts

@@ -1,5 +1,5 @@
 import type { Session } from "@hexis-ai/engram-core";
-import type { AliasInfo, AliasUpsert, IdentityInfo, IdentityUpsert, PersonCreate, PersonInfo, PersonUpdate, SessionEvent, SessionInit } from "@hexis-ai/engram-sdk";
+import type { AliasInfo, AliasUpsert, IdentityInfo, IdentityUpsert, PersonCreate, PersonInfo, PersonUpdate, SessionEvent, SessionInit, SessionUpdate } from "@hexis-ai/engram-sdk";
 import { type StorageAdapter } from "../storage";
 /**
  * Minimal subset of `postgres` driver's tagged-template surface that this
@@ -37,6 +37,7 @@ export declare class PostgresAdapter implements StorageAdapter {
     }): Promise<void>;
     appendEvents(sessionId: string, events: SessionEvent[]): Promise<void>;
     getSession(sessionId: string): Promise<Session | null>;
+    updateSession(sessionId: string, patch: SessionUpdate): Promise<Session | null>;
     getSessionEvents(sessionId: string): Promise<SessionEvent[] | null>;
     listSessions(opts: {
         limit: number;

package/dist/adapters/postgres.js

@@ -38,8 +38,14 @@ export class PostgresAdapter {
         const viewableBy = init.viewable_by
             ? Array.from(new Set([...init.viewable_by, ...participants]))
             : [...participants];
+        // status defaults to 'active' server-side via the column default;
+        // a null value here is treated as "use the default" by NULL-fallback.
         await this.sql `
-      INSERT INTO engram_sessions (workspace_id, id, title, channel, participants, viewable_by, created_at)
+      INSERT INTO engram_sessions (
+        workspace_id, id, title, channel, participants, viewable_by,
+        created_at, status, summary, model,
+        trigger_conversation_id, trigger_event_id
+      )
       VALUES (
         ${this.workspaceId},
         ${init.id},
@@ -47,7 +53,12 @@ export class PostgresAdapter {
         ${init.channel ?? null},
         ${participants},
         ${viewableBy},
-        ${init.createdAt}
+        ${init.createdAt},
+        ${init.status ?? "active"},
+        ${init.summary ?? null},
+        ${init.model ?? null},
+        ${init.trigger_conversation_id ?? null},
+        ${init.trigger_event_id ?? null}
       )
       ON CONFLICT (workspace_id, id) DO NOTHING
     `;
@@ -87,28 +98,52 @@ export class PostgresAdapter {
     }
     async getSession(sessionId) {
         const rows = await this.sql `
-      SELECT id, title, channel, participants, viewable_by, created_at
+      SELECT id, title, channel, participants, viewable_by, created_at,
+             status, summary, model,
+             trigger_conversation_id, trigger_event_id
       FROM engram_sessions
       WHERE workspace_id = ${this.workspaceId} AND id = ${sessionId}
       LIMIT 1
     `;
         if (rows.length === 0)
             return null;
-        const r = rows[0];
         const events = await this.sql `
       SELECT payload FROM engram_events
       WHERE workspace_id = ${this.workspaceId} AND session_id = ${sessionId}
       ORDER BY seq
     `;
-        const row = {
-            id: r.id,
-            ...(r.title ? { title: r.title } : {}),
-            ...(r.channel ? { channel: r.channel } : {}),
-            participants: r.participants,
-            viewable_by: r.viewable_by,
-            createdAt: typeof r.created_at === "string" ? r.created_at : r.created_at.toISOString(),
-        };
-        return foldEvents(row, events.map((e) => e.payload), new Date());
+        return foldEvents(toSessionRow(rows[0]), events.map((e) => e.payload), new Date());
+    }
+    async updateSession(sessionId, patch) {
+        // Translate JS undefined → "no change" via a per-column "provided"
+        // flag the SQL evaluates with CASE WHEN. null in patch becomes a
+        // real null in the DB (clear), value becomes a set.
+        const titleProvided = patch.title !== undefined;
+        const channelProvided = patch.channel !== undefined;
+        const statusProvided = patch.status !== undefined;
+        const summaryProvided = patch.summary !== undefined;
+        const modelProvided = patch.model !== undefined;
+        const tcIdProvided = patch.trigger_conversation_id !== undefined;
+        const teIdProvided = patch.trigger_event_id !== undefined;
+        const rows = await this.sql `
+      UPDATE engram_sessions SET
+        title    = CASE WHEN ${titleProvided}    THEN ${patch.title ?? null}    ELSE title    END,
+        channel  = CASE WHEN ${channelProvided}  THEN ${patch.channel ?? null}  ELSE channel  END,
+        status   = CASE WHEN ${statusProvided}   THEN ${patch.status ?? "active"} ELSE status END,
+        summary  = CASE WHEN ${summaryProvided}  THEN ${patch.summary ?? null}  ELSE summary  END,
+        model    = CASE WHEN ${modelProvided}    THEN ${patch.model ?? null}    ELSE model    END,
+        trigger_conversation_id = CASE WHEN ${tcIdProvided}
+          THEN ${patch.trigger_conversation_id ?? null}
+          ELSE trigger_conversation_id END,
+        trigger_event_id = CASE WHEN ${teIdProvided}
+          THEN ${patch.trigger_event_id ?? null}
+          ELSE trigger_event_id END
+      WHERE workspace_id = ${this.workspaceId} AND id = ${sessionId}
+      RETURNING id
+    `;
+        if (rows.length === 0)
+            return null;
+        return this.getSession(sessionId);
     }
     async getSessionEvents(sessionId) {
         const rows = await this.sql `
@@ -358,6 +393,29 @@ function toPersonInfo(r) {
         updated_at: toIso(r.updated_at),
     };
 }
+function toSessionRow(r) {
+    return {
+        id: r.id,
+        ...(r.title ? { title: r.title } : {}),
+        ...(r.channel ? { channel: r.channel } : {}),
+        participants: r.participants,
+        viewable_by: r.viewable_by,
+        createdAt: typeof r.created_at === "string"
+            ? r.created_at
+            : r.created_at.toISOString(),
+        ...(r.status === "active" || r.status === "idle" || r.status === "completed"
+            ? { status: r.status }
+            : {}),
+        ...(r.summary !== null ? { summary: r.summary } : {}),
+        ...(r.model !== null ? { model: r.model } : {}),
+        ...(r.trigger_conversation_id !== null
+            ? { trigger_conversation_id: r.trigger_conversation_id }
+            : {}),
+        ...(r.trigger_event_id !== null
+            ? { trigger_event_id: r.trigger_event_id }
+            : {}),
+    };
+}
 function toAliasInfo(r) {
     const toIso = (v) => (typeof v === "string" ? v : v.toISOString());
     // last_used is a DATE column; postgres-js returns it as a Date at UTC

package/dist/migrations/0004-schema-completion.d.ts

@@ -0,0 +1,2 @@
+export declare const name = "0004-schema-completion";
+export declare const sql = "\n-- Wave 1 of the engram-as-sole-memory-source migration. Adds the\n-- richer columns monet needs to retire its in-tree memory tables, and\n-- tightens a few earlier schema choices before launch freezes the wire.\n\n-- Persons gain organizational fields. Previously engram was the\n-- retrieval primitive only, so role/team/source were intentionally\n-- absent (\"HR data belongs upstream\"). Now that engram is monet's\n-- canonical memory layer, those facts have to live here.\nALTER TABLE engram_persons ADD COLUMN IF NOT EXISTS role TEXT;\nALTER TABLE engram_persons ADD COLUMN IF NOT EXISTS team TEXT;\nALTER TABLE engram_persons ADD COLUMN IF NOT EXISTS source TEXT;\nUPDATE engram_persons SET source = 'auto' WHERE source IS NULL;\nALTER TABLE engram_persons ALTER COLUMN source SET DEFAULT 'auto';\nALTER TABLE engram_persons ALTER COLUMN source SET NOT NULL;\n\n-- Sessions gain monet-derived metadata so the host's conversation_*\n-- columns disappear.\nALTER TABLE engram_sessions ADD COLUMN IF NOT EXISTS status TEXT;\nUPDATE engram_sessions SET status = 'active' WHERE status IS NULL;\nALTER TABLE engram_sessions ALTER COLUMN status SET DEFAULT 'active';\nALTER TABLE engram_sessions ALTER COLUMN status SET NOT NULL;\nALTER TABLE engram_sessions ADD COLUMN IF NOT EXISTS summary TEXT;\nALTER TABLE engram_sessions ADD COLUMN IF NOT EXISTS model TEXT;\n-- A session can be triggered by another conversation (manual fan-out)\n-- or by an external event id (calendar event in monet, etc.). No FK on\n-- trigger_event_id \u2014 it crosses systems.\nALTER TABLE engram_sessions ADD COLUMN IF NOT EXISTS trigger_conversation_id TEXT;\nALTER TABLE engram_sessions ADD COLUMN IF NOT EXISTS trigger_event_id TEXT;\n\n-- Identities tightening \u2014 last chance to fix these before launch.\n--   is_primary: nullable BOOLEAN where null/false were ambiguous \u2192\n--     pin to NOT NULL DEFAULT false.\n--   unlinked_at: new \u2014 represents \"this external connection was\n--     revoked\", which the append-via-upsert model previously couldn't\n--     express. nullable; non-null means the identity is no longer\n--     authoritative.\n--   linked_at: was DATE (lossy). Widen to TIMESTAMPTZ to preserve\n--     full timing. The cast is a no-op when already TIMESTAMPTZ.\nUPDATE engram_identities SET is_primary = false WHERE is_primary IS NULL;\nALTER TABLE engram_identities ALTER COLUMN is_primary SET DEFAULT false;\nALTER TABLE engram_identities ALTER COLUMN is_primary SET NOT NULL;\nALTER TABLE engram_identities ADD COLUMN IF NOT EXISTS unlinked_at TIMESTAMPTZ;\nALTER TABLE engram_identities ALTER COLUMN linked_at TYPE TIMESTAMPTZ\n  USING linked_at::TIMESTAMPTZ;\n\n-- Index supporting \"active identities only\" queries \u2014 common after\n-- adding unlinked_at since most callers want non-revoked rows.\nCREATE INDEX IF NOT EXISTS idx_engram_identities_active_service_external\n  ON engram_identities (workspace_id, service, external_id)\n  WHERE unlinked_at IS NULL;\n";

package/dist/migrations/0004-schema-completion.js

@@ -0,0 +1,53 @@
+export const name = "0004-schema-completion";
+export const sql = `
+-- Wave 1 of the engram-as-sole-memory-source migration. Adds the
+-- richer columns monet needs to retire its in-tree memory tables, and
+-- tightens a few earlier schema choices before launch freezes the wire.
+
+-- Persons gain organizational fields. Previously engram was the
+-- retrieval primitive only, so role/team/source were intentionally
+-- absent ("HR data belongs upstream"). Now that engram is monet's
+-- canonical memory layer, those facts have to live here.
+ALTER TABLE engram_persons ADD COLUMN IF NOT EXISTS role TEXT;
+ALTER TABLE engram_persons ADD COLUMN IF NOT EXISTS team TEXT;
+ALTER TABLE engram_persons ADD COLUMN IF NOT EXISTS source TEXT;
+UPDATE engram_persons SET source = 'auto' WHERE source IS NULL;
+ALTER TABLE engram_persons ALTER COLUMN source SET DEFAULT 'auto';
+ALTER TABLE engram_persons ALTER COLUMN source SET NOT NULL;
+
+-- Sessions gain monet-derived metadata so the host's conversation_*
+-- columns disappear.
+ALTER TABLE engram_sessions ADD COLUMN IF NOT EXISTS status TEXT;
+UPDATE engram_sessions SET status = 'active' WHERE status IS NULL;
+ALTER TABLE engram_sessions ALTER COLUMN status SET DEFAULT 'active';
+ALTER TABLE engram_sessions ALTER COLUMN status SET NOT NULL;
+ALTER TABLE engram_sessions ADD COLUMN IF NOT EXISTS summary TEXT;
+ALTER TABLE engram_sessions ADD COLUMN IF NOT EXISTS model TEXT;
+-- A session can be triggered by another conversation (manual fan-out)
+-- or by an external event id (calendar event in monet, etc.). No FK on
+-- trigger_event_id — it crosses systems.
+ALTER TABLE engram_sessions ADD COLUMN IF NOT EXISTS trigger_conversation_id TEXT;
+ALTER TABLE engram_sessions ADD COLUMN IF NOT EXISTS trigger_event_id TEXT;
+
+-- Identities tightening — last chance to fix these before launch.
+--   is_primary: nullable BOOLEAN where null/false were ambiguous →
+--     pin to NOT NULL DEFAULT false.
+--   unlinked_at: new — represents "this external connection was
+--     revoked", which the append-via-upsert model previously couldn't
+--     express. nullable; non-null means the identity is no longer
+--     authoritative.
+--   linked_at: was DATE (lossy). Widen to TIMESTAMPTZ to preserve
+--     full timing. The cast is a no-op when already TIMESTAMPTZ.
+UPDATE engram_identities SET is_primary = false WHERE is_primary IS NULL;
+ALTER TABLE engram_identities ALTER COLUMN is_primary SET DEFAULT false;
+ALTER TABLE engram_identities ALTER COLUMN is_primary SET NOT NULL;
+ALTER TABLE engram_identities ADD COLUMN IF NOT EXISTS unlinked_at TIMESTAMPTZ;
+ALTER TABLE engram_identities ALTER COLUMN linked_at TYPE TIMESTAMPTZ
+  USING linked_at::TIMESTAMPTZ;
+
+-- Index supporting "active identities only" queries — common after
+-- adding unlinked_at since most callers want non-revoked rows.
+CREATE INDEX IF NOT EXISTS idx_engram_identities_active_service_external
+  ON engram_identities (workspace_id, service, external_id)
+  WHERE unlinked_at IS NULL;
+`;

package/dist/migrations/index.js

@@ -1,6 +1,7 @@
 import * as m0001 from "./0001-baseline";
 import * as m0002 from "./0002-aliases";
 import * as m0003 from "./0003-identities";
+import * as m0004 from "./0004-schema-completion";
 /**
  * Schema migrations, applied in array order. Add a new file under
  * `migrations/NNNN-<slug>.ts` exporting `name` and `sql`, then append it
@@ -12,4 +13,5 @@ export const MIGRATIONS = [
     { name: m0001.name, sql: m0001.sql },
     { name: m0002.name, sql: m0002.sql },
     { name: m0003.name, sql: m0003.sql },
+    { name: m0004.name, sql: m0004.sql },
 ];

package/dist/openapi.js

@@ -128,6 +128,17 @@ function buildPaths() {
                     "401": res("認証エラー"),
                 },
             },
+            patch: {
+                summary: "セッションのメタデータ（title / channel / status / summary / model / trigger_*）を部分更新する。",
+                parameters: [pathParam("id", "セッション id。")],
+                requestBody: jsonBody("SessionUpdate"),
+                responses: {
+                    "200": res("更新後のセッションのエンベロープ"),
+                    "400": res("リクエストボディが不正"),
+                    "404": res("セッションが見つからない"),
+                    "401": res("認証エラー"),
+                },
+            },
         }),
         "/v1/sessions/{id}/events": tagged("Sessions", {
             post: {

package/dist/routes/sessions.d.ts

@@ -3,10 +3,11 @@ import type { Env } from "../context";
 import { type RouteConfig } from "./helpers";
 /**
  * Session routes. Mount under `/v1`:
- *   POST /v1/sessions             create a session
- *   POST /v1/sessions/:id/events  append events
- *   GET  /v1/sessions/:id         fetch one session + its persons map
- *   GET  /v1/sessions/:id/events  fetch the raw, ordered event log
- *   GET  /v1/sessions             list recent sessions + persons map
+ *   POST  /v1/sessions             create a session
+ *   PATCH /v1/sessions/:id         update session-level metadata
+ *   POST  /v1/sessions/:id/events  append events
+ *   GET   /v1/sessions/:id         fetch one session + its persons map
+ *   GET   /v1/sessions/:id/events  fetch the raw, ordered event log
+ *   GET   /v1/sessions             list recent sessions + persons map
  */
 export declare function sessionsRoutes(cfg: RouteConfig): Hono<Env>;

package/dist/routes/sessions.js

@@ -1,13 +1,14 @@
 import { Hono } from "hono";
-import { eventBatchSchema, parseJsonBody, sessionInitSchema } from "../schemas";
+import { eventBatchSchema, parseJsonBody, sessionInitSchema, sessionUpdateSchema, } from "../schemas";
 import { clampLimit, resolvePersonMap } from "./helpers";
 /**
  * Session routes. Mount under `/v1`:
- *   POST /v1/sessions             create a session
- *   POST /v1/sessions/:id/events  append events
- *   GET  /v1/sessions/:id         fetch one session + its persons map
- *   GET  /v1/sessions/:id/events  fetch the raw, ordered event log
- *   GET  /v1/sessions             list recent sessions + persons map
+ *   POST  /v1/sessions             create a session
+ *   PATCH /v1/sessions/:id         update session-level metadata
+ *   POST  /v1/sessions/:id/events  append events
+ *   GET   /v1/sessions/:id         fetch one session + its persons map
+ *   GET   /v1/sessions/:id/events  fetch the raw, ordered event log
+ *   GET   /v1/sessions             list recent sessions + persons map
  */
 export function sessionsRoutes(cfg) {
     const app = new Hono();
@@ -33,6 +34,17 @@ export function sessionsRoutes(cfg) {
         }
         return c.body(null, 204);
     });
+    app.patch("/sessions/:id", async (c) => {
+        const id = c.req.param("id");
+        const body = await parseJsonBody(c, sessionUpdateSchema);
+        if (body instanceof Response)
+            return body;
+        const session = await c.var.ctx.storage.updateSession(id, body);
+        if (!session)
+            return c.json({ error: "session_not_found" }, 404);
+        const persons = await resolvePersonMap(c.var.ctx.storage, [session]);
+        return c.json({ session, persons });
+    });
     app.get("/sessions/:id", async (c) => {
         const id = c.req.param("id");
         const s = await c.var.ctx.storage.getSession(id);

package/dist/schemas.d.ts

@@ -15,6 +15,28 @@ export declare const sessionInitSchema: z.ZodObject<{
     channel: z.ZodOptional<z.ZodString>;
     participants: z.ZodOptional<z.ZodArray<z.ZodString>>;
     viewable_by: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        idle: "idle";
+        completed: "completed";
+    }>>;
+    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    trigger_conversation_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    trigger_event_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const sessionUpdateSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        idle: "idle";
+        completed: "completed";
+    }>>;
+    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    trigger_conversation_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    trigger_event_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export declare const sessionEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"step">;

package/dist/schemas.js

@@ -15,6 +15,20 @@ export const sessionInitSchema = z.object({
     channel: z.string().optional(),
     participants: z.array(z.string()).optional(),
     viewable_by: z.array(z.string()).optional(),
+    status: z.enum(["active", "idle", "completed"]).optional(),
+    summary: z.string().nullable().optional(),
+    model: z.string().nullable().optional(),
+    trigger_conversation_id: z.string().nullable().optional(),
+    trigger_event_id: z.string().nullable().optional(),
+});
+export const sessionUpdateSchema = z.object({
+    title: z.string().nullable().optional(),
+    channel: z.string().nullable().optional(),
+    status: z.enum(["active", "idle", "completed"]).optional(),
+    summary: z.string().nullable().optional(),
+    model: z.string().nullable().optional(),
+    trigger_conversation_id: z.string().nullable().optional(),
+    trigger_event_id: z.string().nullable().optional(),
 });
 const stepEventSchema = z.object({
     type: z.literal("step"),

package/dist/server.js

@@ -52,7 +52,7 @@ export function createServer(opts) {
         ok: true,
         routes: {
             sessions: "POST/GET /v1/sessions",
-            sessionById: "GET /v1/sessions/:id",
+            sessionById: "GET/PATCH /v1/sessions/:id",
             events: "POST /v1/sessions/:id/events",
             sessionEvents: "GET /v1/sessions/:id/events",
             search: "POST /v1/search",

package/dist/storage.d.ts

@@ -1,5 +1,5 @@
 import type { Session } from "@hexis-ai/engram-core";
-import type { AliasInfo, AliasUpsert, IdentityInfo, IdentityUpsert, PersonCreate, PersonInfo, PersonUpdate, SessionEvent, SessionInit } from "@hexis-ai/engram-sdk";
+import type { AliasInfo, AliasUpsert, IdentityInfo, IdentityUpsert, PersonCreate, PersonInfo, PersonUpdate, SessionEvent, SessionInit, SessionUpdate } from "@hexis-ai/engram-sdk";
 /**
  * Storage adapter interface. Each implementation owns persistence for
  * a single workspace's sessions and persons. Multi-tenancy is the host's
@@ -18,6 +18,13 @@ export interface StorageAdapter {
     appendEvents(sessionId: string, events: SessionEvent[]): Promise<void>;
     /** Materialize a session (events folded into Session shape). */
     getSession(sessionId: string): Promise<Session | null>;
+    /**
+     * Patch session-level metadata (title / channel / status / summary /
+     * model / trigger_*). Each field updates only when present in `patch`
+     * — `undefined` leaves the column alone, `null` clears it. Returns
+     * the materialized session post-update, or `null` if unknown.
+     */
+    updateSession(sessionId: string, patch: SessionUpdate): Promise<Session | null>;
     /**
      * Raw event log for a session, ordered by `seq`. Unlike `getSession`,
      * this does not fold events — callers get per-event timestamps and the
@@ -102,5 +109,10 @@ export interface SessionRow {
     participants: string[];
     viewable_by: string[];
     createdAt: string;
+    status?: "active" | "idle" | "completed";
+    summary?: string;
+    model?: string;
+    trigger_conversation_id?: string;
+    trigger_event_id?: string;
 }
 export declare function foldEvents(row: SessionRow, events: SessionEvent[], now: Date): Session;

package/dist/storage.js

@@ -21,9 +21,19 @@ export function foldEvents(row, events, now) {
     return {
         id: row.id,
         ...(title ? { title } : {}),
+        ...(row.channel ? { channel: row.channel } : {}),
         steps,
         daysAgo,
         ...(participants.size > 0 ? { participants: [...participants] } : {}),
         ...(viewableSet.size > 0 ? { viewable_by: [...viewableSet] } : {}),
+        ...(row.status ? { status: row.status } : {}),
+        ...(row.summary !== undefined ? { summary: row.summary } : {}),
+        ...(row.model !== undefined ? { model: row.model } : {}),
+        ...(row.trigger_conversation_id !== undefined
+            ? { trigger_conversation_id: row.trigger_conversation_id }
+            : {}),
+        ...(row.trigger_event_id !== undefined
+            ? { trigger_event_id: row.trigger_event_id }
+            : {}),
     };
 }

package/openapi.json

@@ -85,6 +85,54 @@
             "items": {
               "type": "string"
             }
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "active",
+              "idle",
+              "completed"
+            ]
+          },
+          "summary": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "model": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "trigger_conversation_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "trigger_event_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
           }
         },
         "additionalProperties": false
@@ -536,6 +584,47 @@
         "tags": [
           "Sessions"
         ]
+      },
+      "patch": {
+        "summary": "セッションのメタデータ（title / channel / status / summary / model / trigger_*）を部分更新する。",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "セッション id。"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SessionUpdate"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "更新後のセッションのエンベロープ"
+          },
+          "400": {
+            "description": "リクエストボディが不正"
+          },
+          "401": {
+            "description": "認証エラー"
+          },
+          "404": {
+            "description": "セッションが見つからない"
+          }
+        },
+        "tags": [
+          "Sessions"
+        ]
       }
     },
     "/v1/sessions/{id}/events": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexis-ai/engram-server",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Engram server: ingest agent session events, persist via a pluggable adapter, expose search.",
   "keywords": [
     "engram",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@hexis-ai/engram-core": "^0.1.5",
-    "@hexis-ai/engram-sdk": "^0.6.0",
+    "@hexis-ai/engram-sdk": "^0.7.0",
     "hono": "^4.6.0",
     "zod": "^4.0.0"
   },