@mastra/server 1.47.0-alpha.2 → 1.47.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,96 @@
 # @mastra/server
 
+## 1.47.0-alpha.3
+
+### Minor Changes
+
+- Enrich the harness HTTP session surface so a client can render a status line, ([#18446](https://github.com/mastra-ai/mastra/pull/18446))
+  read behavior settings, and scope threads per working directory.
+
+  `GET /harness/:harnessId/sessions/:resourceId` now also returns:
+  - `omProgress` — the status-line slice of observational-memory progress
+    (pending tokens vs. observation threshold, accumulated observations vs.
+    reflection threshold, plus projected message removal / reflection savings)
+  - `tokenUsage` — cumulative token usage for the current thread
+  - `settings` — agent behavior settings (`yolo`, `thinkingLevel`,
+    `notifications`, `smartEditing`)
+
+  `GET /harness/:harnessId/sessions/:resourceId/threads` accepts an optional
+  `tags` query param (a JSON-encoded object). A single resourceId can be shared
+  across git worktrees of the same repo (the id is derived from the git URL), so
+  passing `tags` scopes the list to threads matching every tag (e.g.
+  `{ projectPath }` for the working directory). Each returned thread now also
+  includes the scoping `tags` it was stamped with at creation.
+
+  The session event stream route (`.../stream`) now enqueues raw event objects
+  and lets the server adapter handle SSE framing, fixing a double-framing bug
+  where events were wrapped twice (`data: "data: {...}\n\n"\n\n`) and could not be
+  parsed by clients.
+
+  `@mastra/client-js` gains the matching types and reads:
+  - `HarnessOMProgress` and `HarnessSessionSettings`, surfaced on
+    `HarnessSessionState` (`omProgress`, `tokenUsage`, `settings`)
+  - a `display_state_changed` event in `KnownHarnessEvent` carrying the
+    status-line figures
+  - `HarnessSession.listThreads()` now accepts either a number (back-compat) or
+    `{ limit?, tags? }`
+
+  Example:
+
+  ```ts
+  const session = client.getHarness('code').session(resourceId);
+
+  // Scope a worktree's thread list (and resumed session) to its own threads.
+  await session.create({ tags: { projectPath: '/repo/worktree-a' } });
+  const threads = await session.listThreads({ tags: { projectPath: '/repo/worktree-a' } });
+
+  // Read the status-line figures and agent settings.
+  const state = await session.state();
+  state.omProgress; // observational-memory progress
+  state.tokenUsage; // cumulative token usage
+  state.settings; // { yolo, thinkingLevel, notifications, smartEditing }
+  ```
+
+- Scope harness session creation with tags so sessions sharing a resourceId can ([#18446](https://github.com/mastra-ai/mastra/pull/18446))
+  each resume their own thread.
+
+  `harness.createSession()` now accepts an optional `tags` record. The tags are
+  (a) seeded into the new session's state, (b) stamped onto every thread the
+  session creates (so thread listings can be filtered back to the session's
+  scope), and (c) used to filter initial thread selection: a thread is a resume
+  candidate only when its metadata matches every provided tag. Previously, initial
+  thread selection only consulted the
+  harness-global `initialState.projectPath`; on a multi-session server (where one
+  Harness serves many scopes) a session could resume the most recently updated
+  thread from a _different_ scope that shared the resourceId. Using a generic tag
+  record (e.g. `{ projectPath }`) keeps room for future scoping dimensions without
+  further API changes.
+
+  The `@mastra/client-js` `HarnessSession.create()` method accepts `{ tags }`, and
+  the `POST /harness/:id/sessions` route accepts a `tags` body field.
+
+  ```ts
+  // before: initial thread chosen by resourceId only
+  const session = await harness.createSession({ resourceId, id, ownerId });
+
+  // after: initial thread scoped to this worktree via a tag
+  const session = await harness.createSession({
+    resourceId,
+    id,
+    ownerId,
+    tags: { projectPath: '/repo/worktree-a' },
+  });
+  ```
+
+### Patch Changes
+
+- Fixed conditional workflows so that re-running or rehydrating a run (time travel) no longer leaves the wrong branch marked as active. When a paused or replayed run lands on a conditional, arms whose condition does not evaluate truthy are now correctly recorded as skipped instead of staying stuck in a running state. ([#18228](https://github.com/mastra-ai/mastra/pull/18228))
+
+  The server workflow and schedule run-status response schemas now include the `'skipped'` status so they stay in sync with core's `WorkflowRunStatus`.
+
+- Updated dependencies [[`bf3fe49`](https://github.com/mastra-ai/mastra/commit/bf3fe49f9467dbbdb8f9eaf74e0f7971ffb19559), [`24ceaea`](https://github.com/mastra-ai/mastra/commit/24ceaea0bdd8609cabbab764380608ca6621a194), [`6ccf67b`](https://github.com/mastra-ai/mastra/commit/6ccf67bf075753754927a57bc2e1734ba2c820c5), [`825d8de`](https://github.com/mastra-ai/mastra/commit/825d8def9fa64c2bcc3d8dd6b49e09342c3ac5c7), [`ffa09e7`](https://github.com/mastra-ai/mastra/commit/ffa09e772a5c92270eabe2090fc42d45bd8ec4b7), [`461a7c5`](https://github.com/mastra-ai/mastra/commit/461a7c501449295287f4f0ee4b0b42344f39fcf8), [`4211472`](https://github.com/mastra-ai/mastra/commit/4211472a5a2bd319c60cd2e42d9109c3eef7ac1c), [`9e45902`](https://github.com/mastra-ai/mastra/commit/9e4590208e745055cecca202e2db0e5c65e17d3c), [`5c0df77`](https://github.com/mastra-ai/mastra/commit/5c0df776c40efa420f8c07a2f3ee66010296618e)]:
+  - @mastra/core@1.47.0-alpha.3
+
 ## 1.47.0-alpha.2
 
 ### Patch Changes

package/dist/{api-schema-manifest-YB7LBQHE.js → api-schema-manifest-OQOZ53HZ.js}

@@ -1,4 +1,4 @@
-import { SERVER_ROUTES } from './chunk-6UL3DHZP.js';
+import { SERVER_ROUTES } from './chunk-M43CP74T.js';
 import { schemaToJsonSchema } from './chunk-BRC4XSFG.js';
 
 // src/server/server-adapter/api-schema-manifest.ts
@@ -52,5 +52,5 @@ function buildApiSchemaManifest(routes = SERVER_ROUTES) {
 }
 
 export { buildApiSchemaManifest };
-//# sourceMappingURL=api-schema-manifest-YB7LBQHE.js.map
-//# sourceMappingURL=api-schema-manifest-YB7LBQHE.js.map
+//# sourceMappingURL=api-schema-manifest-OQOZ53HZ.js.map
+//# sourceMappingURL=api-schema-manifest-OQOZ53HZ.js.map

package/dist/{api-schema-manifest-YB7LBQHE.js.map → api-schema-manifest-OQOZ53HZ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/server-adapter/api-schema-manifest.ts"],"names":[],"mappings":";;;;AA2BA,SAAS,cAAc,MAAA,EAA4D;AACjF,EAAA,OAAO,MAAA,GAAS,kBAAA,CAAmB,MAAM,CAAA,GAAI,MAAA;AAC/C;AAEA,SAAS,aAAa,KAAA,EAAyC;AAC7D,EAAA,OAAO,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,IAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAK,KAAA,GAAwB,MAAA;AAChG;AAEA,SAAS,WAAW,MAAA,EAAkE;AACpF,EAAA,MAAM,OAAO,MAAA,EAAQ,IAAA;AACrB,EAAA,OAAO,MAAM,OAAA,CAAQ,IAAI,IAAI,IAAA,CAAK,IAAA,CAAK,OAAO,CAAA,GAAI,IAAA;AACpD;AAEA,SAAS,mBAAmB,cAAA,EAAiE;AAC3F,EAAA,IAAI,CAAC,cAAA,EAAgB,OAAO,EAAE,MAAM,SAAA,EAAU;AAE9C,EAAA,MAAM,IAAA,GAAO,WAAW,cAAc,CAAA;AACtC,EAAA,IAAI,IAAA,KAAS,OAAA,EAAS,OAAO,EAAE,MAAM,OAAA,EAAQ;AAC7C,EAAA,IAAI,IAAA,KAAS,QAAA,EAAU,OAAO,EAAE,MAAM,QAAA,EAAS;AAE/C,EAAA,MAAM,UAAA,GACJ,cAAA,CAAe,UAAA,IAAc,CAAC,KAAA,CAAM,OAAA,CAAQ,cAAA,CAAe,UAAU,CAAA,GAAI,cAAA,CAAe,UAAA,GAAa,EAAC;AACxG,EAAA,MAAM,aAAA,GAAgB,MAAA,CAAO,IAAA,CAAK,UAAU,CAAA;AAC5C,EAAA,MAAM,qBAAqB,MAAA,IAAU,UAAA,GAAa,MAAA,GAAS,YAAA,IAAgB,aAAa,YAAA,GAAe,MAAA;AACvG,EAAA,MAAM,YAAA,GAAe,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,CAAE,IAAA;AAAA,IAC9C,CAAC,GAAG,QAAQ,MAAM,UAAA,CAAW,YAAA,CAAa,QAAQ,CAAC,CAAA,KAAM;AAAA,MACvD,CAAC,CAAA;AAEL,EAAA,IAAI,YAAA,KAAiB,kBAAA,IAAsB,aAAA,CAAc,MAAA,IAAU,CAAA,CAAA,EAAI;AACrE,IAAA,OAAO,EAAE,IAAA,EAAM,iBAAA,EAAmB,YAAA,EAAc,kBAAA,EAAmB;AAAA,EACrE;AACA,EAAA,IAAI,cAAA,CAAe,wBAAwB,aAAA,CAAc,MAAA,KAAW,GAAG,OAAO,EAAE,MAAM,QAAA,EAAS;AAC/F,EAAA,OAAO,EAAE,MAAM,QAAA,EAAS;AAC1B;AAEA,SAAS,gBAAgB,KAAA,EAA6B;AACpD,EAAA,OAAO,KAAA,CAAM,YAAA,KAAiB,MAAA,IAAU,CAAC,KAAA,CAAM,UAAA;AACjD;AAEO,SAAS,sBAAA,CAAuB,SAAiC,aAAA,EAAkC;AACxG,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,CAAA;AAAA,IACT,QAAQ,MAAA,CAAO,MAAA,CAAO,eAAe,CAAA,CAAE,IAAI,CAAA,KAAA,KAAS;AAClD,MAAA,MAAM,cAAA,GAAiB,aAAA,CAAc,KAAA,CAAM,cAAc,CAAA;AACzD,MAAA,OAAO;AAAA,QACL,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,MAAM,KAAA,CAAM,IAAA;AAAA,QACZ,cAAc,KAAA,CAAM,YAAA;AAAA,QACpB,eAAA,EAAiB,aAAA,CAAc,KAAA,CAAM,eAAe,CAAA;AAAA,QACpD,gBAAA,EAAkB,aAAA,CAAc,KAAA,CAAM,gBAAgB,CAAA;AAAA,QACtD,UAAA,EAAY,aAAA,CAAc,KAAA,CAAM,UAAU,CAAA;AAAA,QAC1C,cAAA;AAAA,QACA,aAAA,EAAe,mBAAmB,cAAc;AAAA,OAClD;AAAA,IACF,CAAC;AAAA,GACH;AACF","file":"api-schema-manifest-YB7LBQHE.js","sourcesContent":["import type { JSONSchema7 } from '@mastra/schema-compat';\nimport { schemaToJsonSchema } from './openapi-utils';\nimport { SERVER_ROUTES } from './routes/index';\nimport type { ServerRoute } from './routes/index';\n\nexport interface ApiSchemaResponseShape {\n  kind: 'array' | 'record' | 'object-property' | 'single' | 'unknown';\n  listProperty?: string;\n  paginationProperty?: string;\n}\n\nexport interface ApiSchemaManifestRoute {\n  method: string;\n  path: string;\n  responseType: string;\n  pathParamSchema?: JSONSchema7;\n  queryParamSchema?: JSONSchema7;\n  bodySchema?: JSONSchema7;\n  responseSchema?: JSONSchema7;\n  responseShape: ApiSchemaResponseShape;\n}\n\nexport interface ApiSchemaManifest {\n  version: 1;\n  routes: ApiSchemaManifestRoute[];\n}\n\nfunction convertSchema(schema: ServerRoute['bodySchema']): JSONSchema7 | undefined {\n  return schema ? schemaToJsonSchema(schema) : undefined;\n}\n\nfunction asJsonSchema(value: unknown): JSONSchema7 | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value) ? (value as JSONSchema7) : undefined;\n}\n\nfunction schemaType(schema: JSONSchema7 | undefined): JSONSchema7['type'] | undefined {\n  const type = schema?.type;\n  return Array.isArray(type) ? type.find(Boolean) : type;\n}\n\nfunction inferResponseShape(responseSchema: JSONSchema7 | undefined): ApiSchemaResponseShape {\n  if (!responseSchema) return { kind: 'unknown' };\n\n  const type = schemaType(responseSchema);\n  if (type === 'array') return { kind: 'array' };\n  if (type !== 'object') return { kind: 'single' };\n\n  const properties =\n    responseSchema.properties && !Array.isArray(responseSchema.properties) ? responseSchema.properties : {};\n  const propertyNames = Object.keys(properties);\n  const paginationProperty = 'page' in properties ? 'page' : 'pagination' in properties ? 'pagination' : undefined;\n  const listProperty = Object.entries(properties).find(\n    ([, property]) => schemaType(asJsonSchema(property)) === 'array',\n  )?.[0];\n\n  if (listProperty && (paginationProperty || propertyNames.length <= 2)) {\n    return { kind: 'object-property', listProperty, paginationProperty };\n  }\n  if (responseSchema.additionalProperties && propertyNames.length === 0) return { kind: 'record' };\n  return { kind: 'single' };\n}\n\nfunction isManifestRoute(route: ServerRoute): boolean {\n  return route.responseType === 'json' && !route.deprecated;\n}\n\nexport function buildApiSchemaManifest(routes: readonly ServerRoute[] = SERVER_ROUTES): ApiSchemaManifest {\n  return {\n    version: 1,\n    routes: routes.filter(isManifestRoute).map(route => {\n      const responseSchema = convertSchema(route.responseSchema);\n      return {\n        method: route.method,\n        path: route.path,\n        responseType: route.responseType,\n        pathParamSchema: convertSchema(route.pathParamSchema),\n        queryParamSchema: convertSchema(route.queryParamSchema),\n        bodySchema: convertSchema(route.bodySchema),\n        responseSchema,\n        responseShape: inferResponseShape(responseSchema),\n      };\n    }),\n  };\n}\n"]}
+{"version":3,"sources":["../src/server/server-adapter/api-schema-manifest.ts"],"names":[],"mappings":";;;;AA2BA,SAAS,cAAc,MAAA,EAA4D;AACjF,EAAA,OAAO,MAAA,GAAS,kBAAA,CAAmB,MAAM,CAAA,GAAI,MAAA;AAC/C;AAEA,SAAS,aAAa,KAAA,EAAyC;AAC7D,EAAA,OAAO,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,IAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAK,KAAA,GAAwB,MAAA;AAChG;AAEA,SAAS,WAAW,MAAA,EAAkE;AACpF,EAAA,MAAM,OAAO,MAAA,EAAQ,IAAA;AACrB,EAAA,OAAO,MAAM,OAAA,CAAQ,IAAI,IAAI,IAAA,CAAK,IAAA,CAAK,OAAO,CAAA,GAAI,IAAA;AACpD;AAEA,SAAS,mBAAmB,cAAA,EAAiE;AAC3F,EAAA,IAAI,CAAC,cAAA,EAAgB,OAAO,EAAE,MAAM,SAAA,EAAU;AAE9C,EAAA,MAAM,IAAA,GAAO,WAAW,cAAc,CAAA;AACtC,EAAA,IAAI,IAAA,KAAS,OAAA,EAAS,OAAO,EAAE,MAAM,OAAA,EAAQ;AAC7C,EAAA,IAAI,IAAA,KAAS,QAAA,EAAU,OAAO,EAAE,MAAM,QAAA,EAAS;AAE/C,EAAA,MAAM,UAAA,GACJ,cAAA,CAAe,UAAA,IAAc,CAAC,KAAA,CAAM,OAAA,CAAQ,cAAA,CAAe,UAAU,CAAA,GAAI,cAAA,CAAe,UAAA,GAAa,EAAC;AACxG,EAAA,MAAM,aAAA,GAAgB,MAAA,CAAO,IAAA,CAAK,UAAU,CAAA;AAC5C,EAAA,MAAM,qBAAqB,MAAA,IAAU,UAAA,GAAa,MAAA,GAAS,YAAA,IAAgB,aAAa,YAAA,GAAe,MAAA;AACvG,EAAA,MAAM,YAAA,GAAe,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,CAAE,IAAA;AAAA,IAC9C,CAAC,GAAG,QAAQ,MAAM,UAAA,CAAW,YAAA,CAAa,QAAQ,CAAC,CAAA,KAAM;AAAA,MACvD,CAAC,CAAA;AAEL,EAAA,IAAI,YAAA,KAAiB,kBAAA,IAAsB,aAAA,CAAc,MAAA,IAAU,CAAA,CAAA,EAAI;AACrE,IAAA,OAAO,EAAE,IAAA,EAAM,iBAAA,EAAmB,YAAA,EAAc,kBAAA,EAAmB;AAAA,EACrE;AACA,EAAA,IAAI,cAAA,CAAe,wBAAwB,aAAA,CAAc,MAAA,KAAW,GAAG,OAAO,EAAE,MAAM,QAAA,EAAS;AAC/F,EAAA,OAAO,EAAE,MAAM,QAAA,EAAS;AAC1B;AAEA,SAAS,gBAAgB,KAAA,EAA6B;AACpD,EAAA,OAAO,KAAA,CAAM,YAAA,KAAiB,MAAA,IAAU,CAAC,KAAA,CAAM,UAAA;AACjD;AAEO,SAAS,sBAAA,CAAuB,SAAiC,aAAA,EAAkC;AACxG,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,CAAA;AAAA,IACT,QAAQ,MAAA,CAAO,MAAA,CAAO,eAAe,CAAA,CAAE,IAAI,CAAA,KAAA,KAAS;AAClD,MAAA,MAAM,cAAA,GAAiB,aAAA,CAAc,KAAA,CAAM,cAAc,CAAA;AACzD,MAAA,OAAO;AAAA,QACL,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,MAAM,KAAA,CAAM,IAAA;AAAA,QACZ,cAAc,KAAA,CAAM,YAAA;AAAA,QACpB,eAAA,EAAiB,aAAA,CAAc,KAAA,CAAM,eAAe,CAAA;AAAA,QACpD,gBAAA,EAAkB,aAAA,CAAc,KAAA,CAAM,gBAAgB,CAAA;AAAA,QACtD,UAAA,EAAY,aAAA,CAAc,KAAA,CAAM,UAAU,CAAA;AAAA,QAC1C,cAAA;AAAA,QACA,aAAA,EAAe,mBAAmB,cAAc;AAAA,OAClD;AAAA,IACF,CAAC;AAAA,GACH;AACF","file":"api-schema-manifest-OQOZ53HZ.js","sourcesContent":["import type { JSONSchema7 } from '@mastra/schema-compat';\nimport { schemaToJsonSchema } from './openapi-utils';\nimport { SERVER_ROUTES } from './routes/index';\nimport type { ServerRoute } from './routes/index';\n\nexport interface ApiSchemaResponseShape {\n  kind: 'array' | 'record' | 'object-property' | 'single' | 'unknown';\n  listProperty?: string;\n  paginationProperty?: string;\n}\n\nexport interface ApiSchemaManifestRoute {\n  method: string;\n  path: string;\n  responseType: string;\n  pathParamSchema?: JSONSchema7;\n  queryParamSchema?: JSONSchema7;\n  bodySchema?: JSONSchema7;\n  responseSchema?: JSONSchema7;\n  responseShape: ApiSchemaResponseShape;\n}\n\nexport interface ApiSchemaManifest {\n  version: 1;\n  routes: ApiSchemaManifestRoute[];\n}\n\nfunction convertSchema(schema: ServerRoute['bodySchema']): JSONSchema7 | undefined {\n  return schema ? schemaToJsonSchema(schema) : undefined;\n}\n\nfunction asJsonSchema(value: unknown): JSONSchema7 | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value) ? (value as JSONSchema7) : undefined;\n}\n\nfunction schemaType(schema: JSONSchema7 | undefined): JSONSchema7['type'] | undefined {\n  const type = schema?.type;\n  return Array.isArray(type) ? type.find(Boolean) : type;\n}\n\nfunction inferResponseShape(responseSchema: JSONSchema7 | undefined): ApiSchemaResponseShape {\n  if (!responseSchema) return { kind: 'unknown' };\n\n  const type = schemaType(responseSchema);\n  if (type === 'array') return { kind: 'array' };\n  if (type !== 'object') return { kind: 'single' };\n\n  const properties =\n    responseSchema.properties && !Array.isArray(responseSchema.properties) ? responseSchema.properties : {};\n  const propertyNames = Object.keys(properties);\n  const paginationProperty = 'page' in properties ? 'page' : 'pagination' in properties ? 'pagination' : undefined;\n  const listProperty = Object.entries(properties).find(\n    ([, property]) => schemaType(asJsonSchema(property)) === 'array',\n  )?.[0];\n\n  if (listProperty && (paginationProperty || propertyNames.length <= 2)) {\n    return { kind: 'object-property', listProperty, paginationProperty };\n  }\n  if (responseSchema.additionalProperties && propertyNames.length === 0) return { kind: 'record' };\n  return { kind: 'single' };\n}\n\nfunction isManifestRoute(route: ServerRoute): boolean {\n  return route.responseType === 'json' && !route.deprecated;\n}\n\nexport function buildApiSchemaManifest(routes: readonly ServerRoute[] = SERVER_ROUTES): ApiSchemaManifest {\n  return {\n    version: 1,\n    routes: routes.filter(isManifestRoute).map(route => {\n      const responseSchema = convertSchema(route.responseSchema);\n      return {\n        method: route.method,\n        path: route.path,\n        responseType: route.responseType,\n        pathParamSchema: convertSchema(route.pathParamSchema),\n        queryParamSchema: convertSchema(route.queryParamSchema),\n        bodySchema: convertSchema(route.bodySchema),\n        responseSchema,\n        responseShape: inferResponseShape(responseSchema),\n      };\n    }),\n  };\n}\n"]}

package/dist/{api-schema-manifest-UURVUNXQ.cjs → api-schema-manifest-SYCCXMOC.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkMIIC4RAA_cjs = require('./chunk-MIIC4RAA.cjs');
+var chunkTPZFGGU4_cjs = require('./chunk-TPZFGGU4.cjs');
 var chunkG54X6VE6_cjs = require('./chunk-G54X6VE6.cjs');
 
 // src/server/server-adapter/api-schema-manifest.ts
@@ -34,7 +34,7 @@ function inferResponseShape(responseSchema) {
 function isManifestRoute(route) {
   return route.responseType === "json" && !route.deprecated;
 }
-function buildApiSchemaManifest(routes = chunkMIIC4RAA_cjs.SERVER_ROUTES) {
+function buildApiSchemaManifest(routes = chunkTPZFGGU4_cjs.SERVER_ROUTES) {
   return {
     version: 1,
     routes: routes.filter(isManifestRoute).map((route) => {
@@ -54,5 +54,5 @@ function buildApiSchemaManifest(routes = chunkMIIC4RAA_cjs.SERVER_ROUTES) {
 }
 
 exports.buildApiSchemaManifest = buildApiSchemaManifest;
-//# sourceMappingURL=api-schema-manifest-UURVUNXQ.cjs.map
-//# sourceMappingURL=api-schema-manifest-UURVUNXQ.cjs.map
+//# sourceMappingURL=api-schema-manifest-SYCCXMOC.cjs.map
+//# sourceMappingURL=api-schema-manifest-SYCCXMOC.cjs.map

package/dist/{api-schema-manifest-UURVUNXQ.cjs.map → api-schema-manifest-SYCCXMOC.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/server-adapter/api-schema-manifest.ts"],"names":["schemaToJsonSchema","SERVER_ROUTES"],"mappings":";;;;;;AA2BA,SAAS,cAAc,MAAA,EAA4D;AACjF,EAAA,OAAO,MAAA,GAASA,oCAAA,CAAmB,MAAM,CAAA,GAAI,MAAA;AAC/C;AAEA,SAAS,aAAa,KAAA,EAAyC;AAC7D,EAAA,OAAO,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,IAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAK,KAAA,GAAwB,MAAA;AAChG;AAEA,SAAS,WAAW,MAAA,EAAkE;AACpF,EAAA,MAAM,OAAO,MAAA,EAAQ,IAAA;AACrB,EAAA,OAAO,MAAM,OAAA,CAAQ,IAAI,IAAI,IAAA,CAAK,IAAA,CAAK,OAAO,CAAA,GAAI,IAAA;AACpD;AAEA,SAAS,mBAAmB,cAAA,EAAiE;AAC3F,EAAA,IAAI,CAAC,cAAA,EAAgB,OAAO,EAAE,MAAM,SAAA,EAAU;AAE9C,EAAA,MAAM,IAAA,GAAO,WAAW,cAAc,CAAA;AACtC,EAAA,IAAI,IAAA,KAAS,OAAA,EAAS,OAAO,EAAE,MAAM,OAAA,EAAQ;AAC7C,EAAA,IAAI,IAAA,KAAS,QAAA,EAAU,OAAO,EAAE,MAAM,QAAA,EAAS;AAE/C,EAAA,MAAM,UAAA,GACJ,cAAA,CAAe,UAAA,IAAc,CAAC,KAAA,CAAM,OAAA,CAAQ,cAAA,CAAe,UAAU,CAAA,GAAI,cAAA,CAAe,UAAA,GAAa,EAAC;AACxG,EAAA,MAAM,aAAA,GAAgB,MAAA,CAAO,IAAA,CAAK,UAAU,CAAA;AAC5C,EAAA,MAAM,qBAAqB,MAAA,IAAU,UAAA,GAAa,MAAA,GAAS,YAAA,IAAgB,aAAa,YAAA,GAAe,MAAA;AACvG,EAAA,MAAM,YAAA,GAAe,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,CAAE,IAAA;AAAA,IAC9C,CAAC,GAAG,QAAQ,MAAM,UAAA,CAAW,YAAA,CAAa,QAAQ,CAAC,CAAA,KAAM;AAAA,MACvD,CAAC,CAAA;AAEL,EAAA,IAAI,YAAA,KAAiB,kBAAA,IAAsB,aAAA,CAAc,MAAA,IAAU,CAAA,CAAA,EAAI;AACrE,IAAA,OAAO,EAAE,IAAA,EAAM,iBAAA,EAAmB,YAAA,EAAc,kBAAA,EAAmB;AAAA,EACrE;AACA,EAAA,IAAI,cAAA,CAAe,wBAAwB,aAAA,CAAc,MAAA,KAAW,GAAG,OAAO,EAAE,MAAM,QAAA,EAAS;AAC/F,EAAA,OAAO,EAAE,MAAM,QAAA,EAAS;AAC1B;AAEA,SAAS,gBAAgB,KAAA,EAA6B;AACpD,EAAA,OAAO,KAAA,CAAM,YAAA,KAAiB,MAAA,IAAU,CAAC,KAAA,CAAM,UAAA;AACjD;AAEO,SAAS,sBAAA,CAAuB,SAAiCC,+BAAA,EAAkC;AACxG,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,CAAA;AAAA,IACT,QAAQ,MAAA,CAAO,MAAA,CAAO,eAAe,CAAA,CAAE,IAAI,CAAA,KAAA,KAAS;AAClD,MAAA,MAAM,cAAA,GAAiB,aAAA,CAAc,KAAA,CAAM,cAAc,CAAA;AACzD,MAAA,OAAO;AAAA,QACL,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,MAAM,KAAA,CAAM,IAAA;AAAA,QACZ,cAAc,KAAA,CAAM,YAAA;AAAA,QACpB,eAAA,EAAiB,aAAA,CAAc,KAAA,CAAM,eAAe,CAAA;AAAA,QACpD,gBAAA,EAAkB,aAAA,CAAc,KAAA,CAAM,gBAAgB,CAAA;AAAA,QACtD,UAAA,EAAY,aAAA,CAAc,KAAA,CAAM,UAAU,CAAA;AAAA,QAC1C,cAAA;AAAA,QACA,aAAA,EAAe,mBAAmB,cAAc;AAAA,OAClD;AAAA,IACF,CAAC;AAAA,GACH;AACF","file":"api-schema-manifest-UURVUNXQ.cjs","sourcesContent":["import type { JSONSchema7 } from '@mastra/schema-compat';\nimport { schemaToJsonSchema } from './openapi-utils';\nimport { SERVER_ROUTES } from './routes/index';\nimport type { ServerRoute } from './routes/index';\n\nexport interface ApiSchemaResponseShape {\n  kind: 'array' | 'record' | 'object-property' | 'single' | 'unknown';\n  listProperty?: string;\n  paginationProperty?: string;\n}\n\nexport interface ApiSchemaManifestRoute {\n  method: string;\n  path: string;\n  responseType: string;\n  pathParamSchema?: JSONSchema7;\n  queryParamSchema?: JSONSchema7;\n  bodySchema?: JSONSchema7;\n  responseSchema?: JSONSchema7;\n  responseShape: ApiSchemaResponseShape;\n}\n\nexport interface ApiSchemaManifest {\n  version: 1;\n  routes: ApiSchemaManifestRoute[];\n}\n\nfunction convertSchema(schema: ServerRoute['bodySchema']): JSONSchema7 | undefined {\n  return schema ? schemaToJsonSchema(schema) : undefined;\n}\n\nfunction asJsonSchema(value: unknown): JSONSchema7 | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value) ? (value as JSONSchema7) : undefined;\n}\n\nfunction schemaType(schema: JSONSchema7 | undefined): JSONSchema7['type'] | undefined {\n  const type = schema?.type;\n  return Array.isArray(type) ? type.find(Boolean) : type;\n}\n\nfunction inferResponseShape(responseSchema: JSONSchema7 | undefined): ApiSchemaResponseShape {\n  if (!responseSchema) return { kind: 'unknown' };\n\n  const type = schemaType(responseSchema);\n  if (type === 'array') return { kind: 'array' };\n  if (type !== 'object') return { kind: 'single' };\n\n  const properties =\n    responseSchema.properties && !Array.isArray(responseSchema.properties) ? responseSchema.properties : {};\n  const propertyNames = Object.keys(properties);\n  const paginationProperty = 'page' in properties ? 'page' : 'pagination' in properties ? 'pagination' : undefined;\n  const listProperty = Object.entries(properties).find(\n    ([, property]) => schemaType(asJsonSchema(property)) === 'array',\n  )?.[0];\n\n  if (listProperty && (paginationProperty || propertyNames.length <= 2)) {\n    return { kind: 'object-property', listProperty, paginationProperty };\n  }\n  if (responseSchema.additionalProperties && propertyNames.length === 0) return { kind: 'record' };\n  return { kind: 'single' };\n}\n\nfunction isManifestRoute(route: ServerRoute): boolean {\n  return route.responseType === 'json' && !route.deprecated;\n}\n\nexport function buildApiSchemaManifest(routes: readonly ServerRoute[] = SERVER_ROUTES): ApiSchemaManifest {\n  return {\n    version: 1,\n    routes: routes.filter(isManifestRoute).map(route => {\n      const responseSchema = convertSchema(route.responseSchema);\n      return {\n        method: route.method,\n        path: route.path,\n        responseType: route.responseType,\n        pathParamSchema: convertSchema(route.pathParamSchema),\n        queryParamSchema: convertSchema(route.queryParamSchema),\n        bodySchema: convertSchema(route.bodySchema),\n        responseSchema,\n        responseShape: inferResponseShape(responseSchema),\n      };\n    }),\n  };\n}\n"]}
+{"version":3,"sources":["../src/server/server-adapter/api-schema-manifest.ts"],"names":["schemaToJsonSchema","SERVER_ROUTES"],"mappings":";;;;;;AA2BA,SAAS,cAAc,MAAA,EAA4D;AACjF,EAAA,OAAO,MAAA,GAASA,oCAAA,CAAmB,MAAM,CAAA,GAAI,MAAA;AAC/C;AAEA,SAAS,aAAa,KAAA,EAAyC;AAC7D,EAAA,OAAO,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,IAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAK,KAAA,GAAwB,MAAA;AAChG;AAEA,SAAS,WAAW,MAAA,EAAkE;AACpF,EAAA,MAAM,OAAO,MAAA,EAAQ,IAAA;AACrB,EAAA,OAAO,MAAM,OAAA,CAAQ,IAAI,IAAI,IAAA,CAAK,IAAA,CAAK,OAAO,CAAA,GAAI,IAAA;AACpD;AAEA,SAAS,mBAAmB,cAAA,EAAiE;AAC3F,EAAA,IAAI,CAAC,cAAA,EAAgB,OAAO,EAAE,MAAM,SAAA,EAAU;AAE9C,EAAA,MAAM,IAAA,GAAO,WAAW,cAAc,CAAA;AACtC,EAAA,IAAI,IAAA,KAAS,OAAA,EAAS,OAAO,EAAE,MAAM,OAAA,EAAQ;AAC7C,EAAA,IAAI,IAAA,KAAS,QAAA,EAAU,OAAO,EAAE,MAAM,QAAA,EAAS;AAE/C,EAAA,MAAM,UAAA,GACJ,cAAA,CAAe,UAAA,IAAc,CAAC,KAAA,CAAM,OAAA,CAAQ,cAAA,CAAe,UAAU,CAAA,GAAI,cAAA,CAAe,UAAA,GAAa,EAAC;AACxG,EAAA,MAAM,aAAA,GAAgB,MAAA,CAAO,IAAA,CAAK,UAAU,CAAA;AAC5C,EAAA,MAAM,qBAAqB,MAAA,IAAU,UAAA,GAAa,MAAA,GAAS,YAAA,IAAgB,aAAa,YAAA,GAAe,MAAA;AACvG,EAAA,MAAM,YAAA,GAAe,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,CAAE,IAAA;AAAA,IAC9C,CAAC,GAAG,QAAQ,MAAM,UAAA,CAAW,YAAA,CAAa,QAAQ,CAAC,CAAA,KAAM;AAAA,MACvD,CAAC,CAAA;AAEL,EAAA,IAAI,YAAA,KAAiB,kBAAA,IAAsB,aAAA,CAAc,MAAA,IAAU,CAAA,CAAA,EAAI;AACrE,IAAA,OAAO,EAAE,IAAA,EAAM,iBAAA,EAAmB,YAAA,EAAc,kBAAA,EAAmB;AAAA,EACrE;AACA,EAAA,IAAI,cAAA,CAAe,wBAAwB,aAAA,CAAc,MAAA,KAAW,GAAG,OAAO,EAAE,MAAM,QAAA,EAAS;AAC/F,EAAA,OAAO,EAAE,MAAM,QAAA,EAAS;AAC1B;AAEA,SAAS,gBAAgB,KAAA,EAA6B;AACpD,EAAA,OAAO,KAAA,CAAM,YAAA,KAAiB,MAAA,IAAU,CAAC,KAAA,CAAM,UAAA;AACjD;AAEO,SAAS,sBAAA,CAAuB,SAAiCC,+BAAA,EAAkC;AACxG,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,CAAA;AAAA,IACT,QAAQ,MAAA,CAAO,MAAA,CAAO,eAAe,CAAA,CAAE,IAAI,CAAA,KAAA,KAAS;AAClD,MAAA,MAAM,cAAA,GAAiB,aAAA,CAAc,KAAA,CAAM,cAAc,CAAA;AACzD,MAAA,OAAO;AAAA,QACL,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,MAAM,KAAA,CAAM,IAAA;AAAA,QACZ,cAAc,KAAA,CAAM,YAAA;AAAA,QACpB,eAAA,EAAiB,aAAA,CAAc,KAAA,CAAM,eAAe,CAAA;AAAA,QACpD,gBAAA,EAAkB,aAAA,CAAc,KAAA,CAAM,gBAAgB,CAAA;AAAA,QACtD,UAAA,EAAY,aAAA,CAAc,KAAA,CAAM,UAAU,CAAA;AAAA,QAC1C,cAAA;AAAA,QACA,aAAA,EAAe,mBAAmB,cAAc;AAAA,OAClD;AAAA,IACF,CAAC;AAAA,GACH;AACF","file":"api-schema-manifest-SYCCXMOC.cjs","sourcesContent":["import type { JSONSchema7 } from '@mastra/schema-compat';\nimport { schemaToJsonSchema } from './openapi-utils';\nimport { SERVER_ROUTES } from './routes/index';\nimport type { ServerRoute } from './routes/index';\n\nexport interface ApiSchemaResponseShape {\n  kind: 'array' | 'record' | 'object-property' | 'single' | 'unknown';\n  listProperty?: string;\n  paginationProperty?: string;\n}\n\nexport interface ApiSchemaManifestRoute {\n  method: string;\n  path: string;\n  responseType: string;\n  pathParamSchema?: JSONSchema7;\n  queryParamSchema?: JSONSchema7;\n  bodySchema?: JSONSchema7;\n  responseSchema?: JSONSchema7;\n  responseShape: ApiSchemaResponseShape;\n}\n\nexport interface ApiSchemaManifest {\n  version: 1;\n  routes: ApiSchemaManifestRoute[];\n}\n\nfunction convertSchema(schema: ServerRoute['bodySchema']): JSONSchema7 | undefined {\n  return schema ? schemaToJsonSchema(schema) : undefined;\n}\n\nfunction asJsonSchema(value: unknown): JSONSchema7 | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value) ? (value as JSONSchema7) : undefined;\n}\n\nfunction schemaType(schema: JSONSchema7 | undefined): JSONSchema7['type'] | undefined {\n  const type = schema?.type;\n  return Array.isArray(type) ? type.find(Boolean) : type;\n}\n\nfunction inferResponseShape(responseSchema: JSONSchema7 | undefined): ApiSchemaResponseShape {\n  if (!responseSchema) return { kind: 'unknown' };\n\n  const type = schemaType(responseSchema);\n  if (type === 'array') return { kind: 'array' };\n  if (type !== 'object') return { kind: 'single' };\n\n  const properties =\n    responseSchema.properties && !Array.isArray(responseSchema.properties) ? responseSchema.properties : {};\n  const propertyNames = Object.keys(properties);\n  const paginationProperty = 'page' in properties ? 'page' : 'pagination' in properties ? 'pagination' : undefined;\n  const listProperty = Object.entries(properties).find(\n    ([, property]) => schemaType(asJsonSchema(property)) === 'array',\n  )?.[0];\n\n  if (listProperty && (paginationProperty || propertyNames.length <= 2)) {\n    return { kind: 'object-property', listProperty, paginationProperty };\n  }\n  if (responseSchema.additionalProperties && propertyNames.length === 0) return { kind: 'record' };\n  return { kind: 'single' };\n}\n\nfunction isManifestRoute(route: ServerRoute): boolean {\n  return route.responseType === 'json' && !route.deprecated;\n}\n\nexport function buildApiSchemaManifest(routes: readonly ServerRoute[] = SERVER_ROUTES): ApiSchemaManifest {\n  return {\n    version: 1,\n    routes: routes.filter(isManifestRoute).map(route => {\n      const responseSchema = convertSchema(route.responseSchema);\n      return {\n        method: route.method,\n        path: route.path,\n        responseType: route.responseType,\n        pathParamSchema: convertSchema(route.pathParamSchema),\n        queryParamSchema: convertSchema(route.queryParamSchema),\n        bodySchema: convertSchema(route.bodySchema),\n        responseSchema,\n        responseShape: inferResponseShape(responseSchema),\n      };\n    }),\n  };\n}\n"]}

package/dist/{chunk-PWU43QJA.js → chunk-3WE5YAL5.js}

@@ -3,6 +3,9 @@ import { createRoute } from './chunk-BRC4XSFG.js';
 import { HTTPException } from './chunk-6QWQZI4Q.js';
 import { z } from 'zod/v4';
 
+function isReservedThreadMetadataKey(key) {
+  return key === "currentModelId" || key === "currentModeId" || key === "observerModelId" || key === "reflectorModelId" || key === "observationThreshold" || key === "reflectionThreshold" || key === "tokenUsage" || key.startsWith("modeModelId_");
+}
 function getHarnessOrThrow(mastra, harnessId) {
   const harness = mastra.getHarness(harnessId);
   if (!harness) {
@@ -10,13 +13,16 @@ function getHarnessOrThrow(mastra, harnessId) {
   }
   return harness;
 }
-async function getSession(harness, resourceId) {
+async function getSession(harness, resourceId, tags) {
   await harness.init();
-  return harness.createSession({ resourceId, id: resourceId, ownerId: harness.id });
+  return harness.createSession({ resourceId, id: resourceId, ownerId: harness.id, tags });
 }
 var harnessIdPathParams = z.object({ harnessId: z.string() });
 var sessionPathParams = z.object({ harnessId: z.string(), resourceId: z.string() });
-var createSessionBodySchema = z.object({ resourceId: z.string() });
+var createSessionBodySchema = z.object({
+  resourceId: z.string(),
+  tags: z.record(z.string(), z.string()).optional()
+});
 var sendMessageBodySchema = z.object({ message: z.string() });
 var steerBodySchema = z.object({ message: z.string() });
 var toolApprovalBodySchema = z.object({
@@ -45,7 +51,17 @@ var cloneThreadBodySchema = z.object({
   title: z.string().optional()
 });
 var listMessagesQuerySchema = z.object({ limit: z.coerce.number().optional() });
-var listThreadsQuerySchema = z.object({ limit: z.coerce.number().optional() });
+var listThreadsQuerySchema = z.object({
+  limit: z.coerce.number().optional(),
+  tags: z.preprocess((value) => {
+    if (typeof value !== "string" || value.length === 0) return void 0;
+    try {
+      return JSON.parse(value);
+    } catch {
+      return void 0;
+    }
+  }, z.record(z.string(), z.string()).optional()).optional()
+});
 var followUpBodySchema = z.object({ message: z.string() });
 var sendNotificationBodySchema = z.object({
   source: z.string(),
@@ -68,12 +84,34 @@ var createSessionResponseSchema = z.object({
   threadId: z.string().optional()
 });
 var ackResponseSchema = z.object({ ok: z.boolean() });
+var omProgressSummarySchema = z.object({
+  status: z.string(),
+  pendingTokens: z.number(),
+  threshold: z.number(),
+  thresholdPercent: z.number(),
+  observationTokens: z.number(),
+  reflectionThreshold: z.number(),
+  reflectionThresholdPercent: z.number(),
+  /** Tokens the next observation will remove from the message window. */
+  projectedMessageRemoval: z.number(),
+  /** Tokens the next reflection is projected to save. */
+  projectedReflectionSavings: z.number()
+});
+var sessionSettingsSchema = z.object({
+  yolo: z.boolean(),
+  thinkingLevel: z.enum(["off", "low", "medium", "high", "xhigh"]),
+  notifications: z.enum(["off", "bell", "system", "both"]),
+  smartEditing: z.boolean()
+});
 var sessionStateResponseSchema = z.object({
   harnessId: z.string(),
   resourceId: z.string(),
   threadId: z.string().optional(),
   modeId: z.string(),
-  modelId: z.string()
+  modelId: z.string(),
+  omProgress: omProgressSummarySchema.optional(),
+  tokenUsage: z.record(z.string(), z.unknown()).optional(),
+  settings: sessionSettingsSchema.optional()
 });
 var listModesResponseSchema = z.object({
   modes: z.array(z.object({ id: z.string(), name: z.string().optional() }))
@@ -83,7 +121,9 @@ var listThreadsResponseSchema = z.object({
     z.object({
       id: z.string(),
       title: z.string().optional(),
-      updatedAt: z.string().optional()
+      updatedAt: z.string().optional(),
+      /** The session scoping tags stamped on this thread (e.g. `{ projectPath }`). */
+      tags: z.record(z.string(), z.string()).optional()
     })
   )
 });
@@ -170,10 +210,10 @@ var CREATE_HARNESS_SESSION_ROUTE = createRoute({
   tags: ["Harness"],
   requiresAuth: true,
   requiresPermission: "harness:execute",
-  handler: async ({ mastra, harnessId, resourceId }) => {
+  handler: async ({ mastra, harnessId, resourceId, tags }) => {
     try {
       const harness = getHarnessOrThrow(mastra, harnessId);
-      const session = await getSession(harness, resourceId);
+      const session = await getSession(harness, resourceId, tags);
       return {
         harnessId,
         resourceId,
@@ -241,9 +281,7 @@ var STREAM_HARNESS_SESSION_ROUTE = createRoute({
           unsubscribe = session.subscribe((event) => {
             if (cleanedUp) return;
             try {
-              controller.enqueue(`data: ${JSON.stringify(event)}
-
-`);
+              controller.enqueue(event);
               scheduleHeartbeat();
             } catch {
               cleanup();
@@ -460,12 +498,35 @@ var GET_HARNESS_SESSION_STATE_ROUTE = createRoute({
     try {
       const harness = getHarnessOrThrow(mastra, harnessId);
       const session = await getSession(harness, resourceId);
+      const ds = session.displayState.get();
+      const om = ds.omProgress;
+      const reflectionSavings = om.buffered.reflection.inputObservationTokens - om.buffered.reflection.observationTokens;
+      const st = session.state.get();
+      const oneOf = (value, allowed, fallback) => allowed.includes(value) ? value : fallback;
       return {
         harnessId,
         resourceId,
         threadId: session.thread.getId() ?? void 0,
         modeId: session.mode.get(),
-        modelId: session.model.get()
+        modelId: session.model.get(),
+        omProgress: {
+          status: om.status,
+          pendingTokens: om.pendingTokens,
+          threshold: om.threshold,
+          thresholdPercent: om.thresholdPercent,
+          observationTokens: om.observationTokens,
+          reflectionThreshold: om.reflectionThreshold,
+          reflectionThresholdPercent: om.reflectionThresholdPercent,
+          projectedMessageRemoval: om.buffered.observations.projectedMessageRemoval,
+          projectedReflectionSavings: reflectionSavings > 0 ? reflectionSavings : 0
+        },
+        tokenUsage: ds.tokenUsage,
+        settings: {
+          yolo: st.yolo === true,
+          thinkingLevel: oneOf(st.thinkingLevel, ["off", "low", "medium", "high", "xhigh"], "off"),
+          notifications: oneOf(st.notifications, ["off", "bell", "system", "both"], "off"),
+          smartEditing: st.smartEditing !== false
+        }
       };
     } catch (error) {
       return handleError(error, "error reading harness session state");
@@ -502,25 +563,42 @@ var LIST_HARNESS_THREADS_ROUTE = createRoute({
   queryParamSchema: listThreadsQuerySchema,
   responseSchema: listThreadsResponseSchema,
   summary: "List session threads",
-  description: "Lists the threads for the session\u2019s resource, most-recently-updated first. Pass `limit` to return only the newest N (e.g. for a sidebar).",
+  description: "Lists the threads for the session\u2019s resource, most-recently-updated first. Pass `limit` to return only the newest N (e.g. for a sidebar). Pass `tags` (a JSON-encoded object) to scope the list to threads matching every tag \u2014 e.g. `{ projectPath }` so git worktrees sharing a resourceId each see only their own threads.",
   tags: ["Harness"],
   requiresAuth: true,
   requiresPermission: "harness:read",
-  handler: async ({ mastra, harnessId, resourceId, limit }) => {
+  handler: async ({ mastra, harnessId, resourceId, limit, tags }) => {
     try {
       const harness = getHarnessOrThrow(mastra, harnessId);
       const session = await getSession(harness, resourceId);
       const threads = await session.thread.list();
+      const getTags = (t) => {
+        const metadata = t.metadata ?? {};
+        const result = {};
+        for (const [key, value] of Object.entries(metadata)) {
+          if (typeof value === "string" && !isReservedThreadMetadataKey(key)) result[key] = value;
+        }
+        return result;
+      };
+      const tagEntries = tags ? Object.entries(tags).filter(([key]) => !isReservedThreadMetadataKey(key)) : [];
+      const scoped = tagEntries.length > 0 ? threads.filter((t) => {
+        const metadata = t.metadata ?? {};
+        return tagEntries.every(([key, value]) => metadata[key] === value);
+      }) : threads;
       const toTime = (t) => (t.updatedAt ?? t.createdAt)?.getTime() ?? 0;
-      const sorted = [...threads].sort((a, b) => toTime(b) - toTime(a));
+      const sorted = [...scoped].sort((a, b) => toTime(b) - toTime(a));
       const max = Number(limit);
       const limited = Number.isFinite(max) && max > 0 ? sorted.slice(0, max) : sorted;
       return {
-        threads: limited.map((t) => ({
-          id: t.id,
-          title: t.title,
-          updatedAt: t.updatedAt instanceof Date ? t.updatedAt.toISOString() : void 0
-        }))
+        threads: limited.map((t) => {
+          const threadTags = getTags(t);
+          return {
+            id: t.id,
+            title: t.title,
+            tags: Object.keys(threadTags).length > 0 ? threadTags : void 0,
+            updatedAt: t.updatedAt instanceof Date ? t.updatedAt.toISOString() : void 0
+          };
+        })
       };
     } catch (error) {
       return handleError(error, "error listing harness threads");
@@ -1099,5 +1177,5 @@ var SET_HARNESS_SESSION_STATE_ROUTE = createRoute({
 });
 
 export { ABORT_HARNESS_SESSION_ROUTE, CLEAR_HARNESS_GOAL_ROUTE, CLONE_HARNESS_THREAD_ROUTE, CREATE_HARNESS_SESSION_ROUTE, CREATE_HARNESS_THREAD_ROUTE, DELETE_HARNESS_THREAD_ROUTE, FOLLOW_UP_HARNESS_SESSION_ROUTE, GET_HARNESS_GOAL_ROUTE, GET_HARNESS_OM_RECORD_ROUTE, GET_HARNESS_PERMISSIONS_ROUTE, GET_HARNESS_RESOURCE_IDS_ROUTE, GET_HARNESS_SESSION_STATE_ROUTE, GET_HARNESS_WORKSPACE_STATUS_ROUTE, HARNESS_TOOL_APPROVAL_ROUTE, HARNESS_TOOL_SUSPENSION_ROUTE, LIST_HARNESSES_ROUTE, LIST_HARNESS_MODELS_ROUTE, LIST_HARNESS_MODES_ROUTE, LIST_HARNESS_THREADS_ROUTE, LIST_HARNESS_THREAD_MESSAGES_ROUTE, RENAME_HARNESS_THREAD_ROUTE, SEND_HARNESS_MESSAGE_ROUTE, SEND_HARNESS_NOTIFICATION_ROUTE, SET_HARNESS_CATEGORY_PERMISSION_ROUTE, SET_HARNESS_GOAL_ROUTE, SET_HARNESS_RESOURCE_ID_ROUTE, SET_HARNESS_SESSION_STATE_ROUTE, SET_HARNESS_TOOL_PERMISSION_ROUTE, STEER_HARNESS_SESSION_ROUTE, STREAM_HARNESS_SESSION_ROUTE, SWITCH_HARNESS_MODEL_ROUTE, SWITCH_HARNESS_MODE_ROUTE, SWITCH_HARNESS_THREAD_ROUTE, UPDATE_HARNESS_GOAL_ROUTE };
-//# sourceMappingURL=chunk-PWU43QJA.js.map
-//# sourceMappingURL=chunk-PWU43QJA.js.map
+//# sourceMappingURL=chunk-3WE5YAL5.js.map
+//# sourceMappingURL=chunk-3WE5YAL5.js.map