@company-semantics/contracts 13.3.0 → 13.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "13.3.0",
+  "version": "13.4.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/api/generated-spec-hash.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Run pnpm generate:spec-hash to regenerate.
-export const SPEC_HASH = '4dd221ddc8fd' as const;
-export const SPEC_HASH_FULL = '4dd221ddc8fd1a1ff75153543db47c0e2c5a667d1f428e855026a035cdc3b3c6' as const;
+export const SPEC_HASH = '5961c9041966' as const;
+export const SPEC_HASH_FULL = '5961c9041966a739d90bd6f60228167aeccf4c1f28d37a28a924499eb452acd0' as const;

package/src/api/generated.ts

@@ -3843,6 +3843,20 @@ export interface components {
                         requiredScope?: string;
                     };
                 };
+                companyMd?: {
+                    transferOwnership: {
+                        /** @enum {string} */
+                        state: "allowed" | "blocked";
+                        requiredScope?: string;
+                    };
+                };
+                workItem?: {
+                    transferOwnership: {
+                        /** @enum {string} */
+                        state: "allowed" | "blocked";
+                        requiredScope?: string;
+                    };
+                };
             };
         };
         CompanyMdListResponse: {

package/src/content/index.ts

@@ -19,6 +19,10 @@ export type {
   CompanyMdContextBankResponse,
 } from "./schemas";
 
+// Work item response schema (PRD-00763)
+export { WorkItemDetailResponseSchema } from "./schemas";
+export type { WorkItemDetailResponse } from "./schemas";
+
 // Drive response schemas (PRD-00448)
 export {
   DriveFileListResponseSchema,

package/src/content/schemas.ts

@@ -102,6 +102,35 @@ export const CompanyMdDocResponseSchema = z.object({
   updatedAt: z.string(),
 });
 
+// ---------------------------------------------------------------------------
+// Work Item HTTP Response Schema
+// ---------------------------------------------------------------------------
+
+/**
+ * Response for GET /api/work-items/:id
+ *
+ * Models the work-item detail shape the backend returns (id, kind, title,
+ * markdown body, free-form metadata, timestamps). Hand-written and independent
+ * of the generated OpenAPI surface; the backend adapts to this schema
+ * (PRD-00760).
+ */
+export const WorkItemDetailResponseSchema = z.object({
+  id: z.string(),
+  kind: z.enum(["meeting", "comm", "doc"]),
+  title: z.string(),
+  content: z.string(),
+  /**
+   * When `true`, `content` is the redacted empty body (`''`) returned to a
+   * metadata-only (meta-tier) viewer who administers the work item but may not
+   * read its body (ADR-BE-245). Omitted/`false` on the normal full-content
+   * path. Keeping it optional preserves back-compat for full-content readers.
+   */
+  contentRedacted: z.boolean().optional(),
+  metadata: z.record(z.string(), z.unknown()),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+
 // ---------------------------------------------------------------------------
 // Company.md Sharing Sub-schemas
 // ---------------------------------------------------------------------------
@@ -207,6 +236,9 @@ export type CompanyMdShareResponse = z.infer<
 export type CompanyMdContextBankResponse = z.infer<
   typeof CompanyMdContextBankResponseSchema
 >;
+export type WorkItemDetailResponse = z.infer<
+  typeof WorkItemDetailResponseSchema
+>;
 export type DriveFileListResponse = z.infer<typeof DriveFileListResponseSchema>;
 export type DriveFileContentResponse = z.infer<
   typeof DriveFileContentResponseSchema

package/src/meetings/index.ts

@@ -16,6 +16,8 @@ export {
   RecordingEventSchema,
   TranscriptionSessionGrantSchema,
   MeetingMetadataProjectionSchema,
+  MeetingExportFormatSchema,
+  MeetingExportResponseSchema,
 } from "./schemas";
 
 export type {
@@ -31,4 +33,6 @@ export type {
   RecordingEvent,
   TranscriptionSessionGrant,
   MeetingMetadataProjection,
+  MeetingExportFormat,
+  MeetingExportResponse,
 } from "./schemas";

package/src/meetings/schemas.ts

@@ -291,3 +291,50 @@ export const MeetingMetadataProjectionSchema = z
 export type MeetingMetadataProjection = z.infer<
   typeof MeetingMetadataProjectionSchema
 >;
+
+// =============================================================================
+// Meeting export response (HTTP read model)
+// =============================================================================
+
+/**
+ * Export format the backend renders a finalized meeting transcript into.
+ * `markdown`/`text` are prose bodies; `vtt`/`srt` are timed-caption formats;
+ * `json` is the structured segment payload.
+ */
+export const MeetingExportFormatSchema = z
+  .enum(["markdown", "text", "vtt", "srt", "json"])
+  .meta({
+    description: "Rendered export format for a finalized meeting transcript.",
+  });
+export type MeetingExportFormat = z.infer<typeof MeetingExportFormatSchema>;
+
+/**
+ * Response for the meeting-export endpoint. Models the rendered export the
+ * backend returns for a finalized recording: the chosen `format`, the rendered
+ * `content` body, and the `segments` the export was assembled from. Hand-written
+ * and independent of the generated OpenAPI surface; the backend adapts to this
+ * schema (PRD-00763).
+ *
+ * Mirrors the meta-tier redaction contract of `WorkItemDetailResponseSchema`
+ * and `CompanyMdDocResponseSchema`.
+ */
+export const MeetingExportResponseSchema = z
+  .object({
+    recordingId: RecordingIdSchema,
+    format: MeetingExportFormatSchema,
+    content: z.string(),
+    /**
+     * When `true`, `content` is the redacted empty body (`''`) returned to a
+     * metadata-only (meta-tier) viewer who administers the meeting but may not
+     * read its transcript body (ADR-BE-245). Omitted/`false` on the normal
+     * full-content path. Keeping it optional preserves back-compat for
+     * full-content readers.
+     */
+    contentRedacted: z.boolean().optional(),
+    segments: z.array(SourceSegmentSchema),
+  })
+  .meta({
+    description:
+      "Rendered meeting-transcript export (format, content, segments) with optional meta-tier redaction flag.",
+  });
+export type MeetingExportResponse = z.infer<typeof MeetingExportResponseSchema>;