@liorium/youtube-omni-mcp 0.1.2 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.0 - 2026-05-14
+
+- Add five Creator Research tools: outlier video discovery, hook comparison, topic angle extraction, comment pain-point summarization, and video angle matrix generation.
+- Add governed operation tool foundations for metadata, upload, thumbnail, playlist, comment moderation, and community post workflows.
+- Keep operation tools hidden by default and dry-run-only when explicitly gated with `YOUTUBE_OMNI_ENABLE_WRITE_TOOLS=true` and `YOUTUBE_OMNI_DRY_RUN_WRITES=true`.
+- Add concrete MCP schemas for research and gated operation tools.
+- Update safety policy and capability reporting for the v0.2 phase.
+
 ## 0.1.2 - 2026-05-14
 
 - Add concrete MCP `inputSchema` definitions for all v0 tools so agents can pass required arguments reliably.

package/README.md

@@ -2,11 +2,11 @@
 
 `youtube-omni` is a full-scope YouTube Creator Intelligence + Operations + Analytics + Production MCP project.
 
-Current implementation phase: **v0 read-only foundation**.
+Current implementation phase: **v0.2 Creator Research + governed write foundation**.
 
-## v0 boundary
+## v0.2 default boundary
 
-Enabled in v0:
+Enabled by default:
 
 - public discovery/search
 - video details/comparison
@@ -14,6 +14,7 @@ Enabled in v0:
 - transcript segments/full text/structure analysis
 - comments read/summarize
 - research brief drafts
+- Creator Research synthesis tools
 - safety/capability reporting
 
 Locked for later phases, but part of final scope:
@@ -29,8 +30,9 @@ Locked for later phases, but part of final scope:
 
 ## Safety defaults
 
-- No write tools are exposed in v0.
-- No download tools are exposed in v0.
+- No write tools are exposed by default.
+- No download tools are exposed by default.
+- Operation tools are dry-run-only stubs when `YOUTUBE_OMNI_ENABLE_WRITE_TOOLS=true` and `YOUTUBE_OMNI_DRY_RUN_WRITES=true` are both set.
 - Secrets must be supplied via environment variables and are never committed.
 - Write/download/destructive namespaces remain environment-gated for later phases.
 
@@ -57,6 +59,7 @@ Use this shape in an `mcp.json`-style client configuration:
         "YOUTUBE_OMNI_MAX_RESULTS": "50",
         "YOUTUBE_OMNI_ENABLE_OUTLIER": "false",
         "YOUTUBE_OMNI_ENABLE_WRITE_TOOLS": "false",
+        "YOUTUBE_OMNI_DRY_RUN_WRITES": "false",
         "YOUTUBE_OMNI_ENABLE_DOWNLOAD_TOOLS": "false",
         "YOUTUBE_OMNI_ENABLE_DESTRUCTIVE_TOOLS": "false"
       }
@@ -69,7 +72,7 @@ For local development before publishing, use a packed tarball:
 
 ```bash
 npm pack
-npx -y ./liorium-youtube-omni-mcp-0.1.2.tgz
+npx -y ./liorium-youtube-omni-mcp-0.2.0.tgz
 ```
 
 ## Development
@@ -93,7 +96,7 @@ All research/specification documents are under `research/`. Implementation docs
 
 Key docs:
 
-- `docs/v0-spec.md` — current read-only boundary
-- `docs/tool-schema.md` — v0 tool contract
+- `docs/v0-spec.md` — original read-only foundation boundary
+- `docs/tool-schema.md` — v0.2 default and gated tool contract
 - `docs/safety-policy.md` — risk gates and default locks
-- `docs/v0.2-ac-plan.md` — next implementation plan for Creator Research + governed write foundations
+- `docs/v0.2-ac-plan.md` — implementation plan for Creator Research + governed write foundations

package/dist/src/config.d.ts

@@ -4,6 +4,8 @@ export interface YoutubeOmniConfig {
     mongoUri?: string;
     maxResults: number;
     enableWriteTools: boolean;
+    dryRunWrites: boolean;
+    approvalAuditPath?: string;
     enableDownloadTools: boolean;
 }
 export declare function loadConfig(env?: NodeJS.ProcessEnv): YoutubeOmniConfig;

package/dist/src/config.js

@@ -6,6 +6,8 @@ export function loadConfig(env = process.env) {
         mongoUri: env.YOUTUBE_OMNI_MONGO_URI,
         maxResults: Number(env.YOUTUBE_OMNI_MAX_RESULTS ?? 50),
         enableWriteTools: env.YOUTUBE_OMNI_ENABLE_WRITE_TOOLS === 'true',
+        dryRunWrites: env.YOUTUBE_OMNI_DRY_RUN_WRITES === 'true',
+        approvalAuditPath: env.YOUTUBE_OMNI_APPROVAL_AUDIT_PATH,
         enableDownloadTools: env.YOUTUBE_OMNI_ENABLE_DOWNLOAD_TOOLS === 'true'
     };
 }

package/dist/src/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWpD,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,OAAO;QACL,aAAa,EAAE,GAAG,CAAC,eAAe;QAClC,aAAa,EAAE,GAAG,CAAC,2BAA2B,KAAK,MAAM;QACzD,QAAQ,EAAE,GAAG,CAAC,sBAAsB;QACpC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC;QACtD,gBAAgB,EAAE,GAAG,CAAC,+BAA+B,KAAK,MAAM;QAChE,mBAAmB,EAAE,GAAG,CAAC,kCAAkC,KAAK,MAAM;KACvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAyB;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAapD,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,OAAO;QACL,aAAa,EAAE,GAAG,CAAC,eAAe;QAClC,aAAa,EAAE,GAAG,CAAC,2BAA2B,KAAK,MAAM;QACzD,QAAQ,EAAE,GAAG,CAAC,sBAAsB;QACpC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,wBAAwB,IAAI,EAAE,CAAC;QACtD,gBAAgB,EAAE,GAAG,CAAC,+BAA+B,KAAK,MAAM;QAChE,YAAY,EAAE,GAAG,CAAC,2BAA2B,KAAK,MAAM;QACxD,iBAAiB,EAAE,GAAG,CAAC,gCAAgC;QACvD,mBAAmB,EAAE,GAAG,CAAC,kCAAkC,KAAK,MAAM;KACvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAyB;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/src/core/errors.d.ts

@@ -35,6 +35,9 @@ export declare const YOUTUBE_OMNI_ERRORS: {
     readonly SAFETY_BLOCKED: {
         readonly retryable: false;
     };
+    readonly APPROVAL_REQUIRED_OR_WRITE_DISABLED: {
+        readonly retryable: false;
+    };
 };
 export type YoutubeOmniErrorCode = keyof typeof YOUTUBE_OMNI_ERRORS;
 export declare class YoutubeOmniError extends Error {

package/dist/src/core/errors.js

@@ -10,7 +10,8 @@ export const YOUTUBE_OMNI_ERRORS = {
     COMMENTS_DISABLED: { retryable: false },
     UNSUPPORTED_REGION: { retryable: false },
     PROVIDER_ERROR: { retryable: true },
-    SAFETY_BLOCKED: { retryable: false }
+    SAFETY_BLOCKED: { retryable: false },
+    APPROVAL_REQUIRED_OR_WRITE_DISABLED: { retryable: false }
 };
 export class YoutubeOmniError extends Error {
     code;

package/dist/src/core/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,gBAAgB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACtC,uBAAuB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IAC7C,aAAa,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACnC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACnC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACjC,eAAe,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACrC,iBAAiB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACvC,sBAAsB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5C,iBAAiB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACvC,kBAAkB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACxC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACnC,cAAc,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;CAC5B,CAAC;AAIX,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAC3B,SAAS,CAAU;IAE5B,YAAY,IAA0B,EAAE,OAAe;QACrD,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,gBAAgB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACtC,uBAAuB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IAC7C,aAAa,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACnC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACnC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACjC,eAAe,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACrC,iBAAiB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACvC,sBAAsB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5C,iBAAiB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACvC,kBAAkB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACxC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACnC,cAAc,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;IACpC,mCAAmC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;CACjD,CAAC;AAIX,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAC3B,SAAS,CAAU;IAE5B,YAAY,IAA0B,EAAE,OAAe;QACrD,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;CACF"}

package/dist/src/core/risk.d.ts

@@ -1,5 +1,7 @@
 export declare const V0_LOCKED_PATTERNS: readonly ["upload", "update_video", "delete", "set_thumbnail", "reply_to_comment", "moderate", "publish", "download_video", "clip_segment", "revenue"];
+export type RiskLabel = 'none' | 'low' | 'medium' | 'high' | 'destructive';
 export interface ActionRisk {
+    risk: RiskLabel;
     riskTier: 0 | 1 | 2 | 3 | 4 | 5;
     authTier: 'none' | 'api_key' | 'oauth_readonly' | 'oauth_write' | 'hosted' | 'experimental';
     allowedInV0: boolean;

package/dist/src/core/risk.js

@@ -13,19 +13,35 @@ export const V0_LOCKED_PATTERNS = [
 export function isAllowedInV0(action) {
     return !V0_LOCKED_PATTERNS.some((pattern) => action.includes(pattern));
 }
+function operationRisk(action) {
+    if (!action.includes('youtube.operations.'))
+        return undefined;
+    const destructive = ['delete_video', 'delete', 'remove'].some((pattern) => action.includes(pattern));
+    return {
+        risk: destructive ? 'destructive' : 'high',
+        riskTier: destructive ? 5 : 4,
+        authTier: 'oauth_write',
+        allowedInV0: false,
+        requiredControls: destructive ? ['approval', 'double_confirmation', 'audit'] : ['approval', 'preview', 'audit', 'dry_run']
+    };
+}
 export function classifyActionRisk(action) {
+    const operation = operationRisk(action);
+    if (operation)
+        return operation;
     if (!isAllowedInV0(action)) {
         const destructive = ['delete', 'download_video', 'clip_segment', 'revenue'].some((pattern) => action.includes(pattern));
         return {
+            risk: destructive ? 'destructive' : 'high',
             riskTier: destructive ? 5 : 4,
             authTier: action.includes('download') || action.includes('clip') ? 'experimental' : 'oauth_write',
             allowedInV0: false,
             requiredControls: destructive ? ['approval', 'double_confirmation', 'audit'] : ['approval', 'preview', 'audit']
         };
     }
-    if (action.includes('transcript') || action.includes('comments') || action.includes('planning')) {
-        return { riskTier: 1, authTier: 'api_key', allowedInV0: true, requiredControls: ['rate_limit', 'privacy_warning'] };
+    if (action.includes('transcript') || action.includes('comments') || action.includes('planning') || action.includes('research')) {
+        return { risk: 'low', riskTier: 1, authTier: 'api_key', allowedInV0: true, requiredControls: ['rate_limit', 'privacy_warning'] };
     }
-    return { riskTier: 0, authTier: 'api_key', allowedInV0: true, requiredControls: ['rate_limit'] };
+    return { risk: 'none', riskTier: 0, authTier: 'api_key', allowedInV0: true, requiredControls: ['rate_limit'] };
 }
 //# sourceMappingURL=risk.js.map

package/dist/src/core/risk.js.map

@@ -1 +1 @@
-{"version":3,"file":"risk.js","sourceRoot":"","sources":["../../../src/core/risk.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,cAAc;IACd,QAAQ;IACR,eAAe;IACf,kBAAkB;IAClB,UAAU;IACV,SAAS;IACT,gBAAgB;IAChB,cAAc;IACd,SAAS;CACD,CAAC;AASX,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACxH,OAAO;YACL,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa;YACjG,WAAW,EAAE,KAAK;YAClB,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC;SAChH,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAChG,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,YAAY,EAAE,iBAAiB,CAAC,EAAE,CAAC;IACtH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;AACnG,CAAC"}
+{"version":3,"file":"risk.js","sourceRoot":"","sources":["../../../src/core/risk.ts"],"names":[],"mappings":"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"}

package/dist/src/schemas/index.d.ts

@@ -5,3 +5,5 @@ export * from './channel.js';
 export * from './transcript.js';
 export * from './comments.js';
 export * from './planning.js';
+export * from './research.js';
+export * from './operations.js';

package/dist/src/schemas/index.js

@@ -5,4 +5,6 @@ export * from './channel.js';
 export * from './transcript.js';
 export * from './comments.js';
 export * from './planning.js';
+export * from './research.js';
+export * from './operations.js';
 //# sourceMappingURL=index.js.map

package/dist/src/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/src/schemas/operations.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+export declare const updateVideoMetadataSchema: z.ZodObject<{
+    approvalId: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    videoId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const scheduleUploadSchema: z.ZodObject<{
+    approvalId: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    filePath: z.ZodString;
+    title: z.ZodString;
+    scheduledAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const updateThumbnailSchema: z.ZodObject<{
+    approvalId: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    videoId: z.ZodString;
+    imagePath: z.ZodString;
+}, z.core.$strip>;
+export declare const updatePlaylistSchema: z.ZodObject<{
+    approvalId: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    playlistId: z.ZodString;
+    videoId: z.ZodOptional<z.ZodString>;
+    action: z.ZodDefault<z.ZodEnum<{
+        remove: "remove";
+        add: "add";
+        reorder: "reorder";
+    }>>;
+}, z.core.$strip>;
+export declare const moderateCommentSchema: z.ZodObject<{
+    approvalId: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    commentId: z.ZodString;
+    action: z.ZodEnum<{
+        hold: "hold";
+        approve: "approve";
+        reject: "reject";
+        report: "report";
+    }>;
+}, z.core.$strip>;
+export declare const createCommunityPostSchema: z.ZodObject<{
+    approvalId: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    channelId: z.ZodString;
+    text: z.ZodString;
+}, z.core.$strip>;

package/dist/src/schemas/operations.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { videoIdSchema } from './common.js';
+const governedOperationFields = {
+    approvalId: z.string().min(1).optional(),
+    dryRun: z.boolean().default(true)
+};
+export const updateVideoMetadataSchema = z.object({
+    videoId: videoIdSchema,
+    title: z.string().min(1).max(100).optional(),
+    description: z.string().max(5000).optional(),
+    tags: z.array(z.string().min(1)).max(50).optional(),
+    ...governedOperationFields
+});
+export const scheduleUploadSchema = z.object({
+    filePath: z.string().min(1),
+    title: z.string().min(1).max(100),
+    scheduledAt: z.string().min(1).optional(),
+    ...governedOperationFields
+});
+export const updateThumbnailSchema = z.object({
+    videoId: videoIdSchema,
+    imagePath: z.string().min(1),
+    ...governedOperationFields
+});
+export const updatePlaylistSchema = z.object({
+    playlistId: z.string().min(1),
+    videoId: videoIdSchema.optional(),
+    action: z.enum(['add', 'remove', 'reorder']).default('add'),
+    ...governedOperationFields
+});
+export const moderateCommentSchema = z.object({
+    commentId: z.string().min(1),
+    action: z.enum(['hold', 'approve', 'reject', 'report']),
+    ...governedOperationFields
+});
+export const createCommunityPostSchema = z.object({
+    channelId: z.string().min(1),
+    text: z.string().min(1).max(5000),
+    ...governedOperationFields
+});
+//# sourceMappingURL=operations.js.map

package/dist/src/schemas/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../src/schemas/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,uBAAuB,GAAG;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,aAAa;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC5C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACnD,GAAG,uBAAuB;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,GAAG,uBAAuB;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,aAAa;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,GAAG,uBAAuB;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3D,GAAG,uBAAuB;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACvD,GAAG,uBAAuB;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACjC,GAAG,uBAAuB;CAC3B,CAAC,CAAC"}

package/dist/src/schemas/research.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+export declare const outlierVideosSchema: z.ZodObject<{
+    query: z.ZodString;
+    maxResults: z.ZodDefault<z.ZodNumber>;
+    regionCode: z.ZodDefault<z.ZodString>;
+    minViewToChannelRatio: z.ZodDefault<z.ZodNumber>;
+    recency: z.ZodDefault<z.ZodEnum<{
+        any: "any";
+        pastWeek: "pastWeek";
+        pastMonth: "pastMonth";
+        pastQuarter: "pastQuarter";
+        pastYear: "pastYear";
+    }>>;
+}, z.core.$strip>;
+export declare const compareHooksSchema: z.ZodObject<{
+    videoIds: z.ZodArray<z.ZodString>;
+    lang: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const topicAnglesSchema: z.ZodObject<{
+    topic: z.ZodString;
+    regionCode: z.ZodDefault<z.ZodString>;
+    sampleSize: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const commentPainPointsSchema: z.ZodObject<{
+    videoId: z.ZodString;
+    maxComments: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const videoAngleMatrixSchema: z.ZodObject<{
+    topic: z.ZodString;
+    rows: z.ZodDefault<z.ZodNumber>;
+    regionCode: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type OutlierVideosInput = z.infer<typeof outlierVideosSchema>;
+export type CompareHooksInput = z.infer<typeof compareHooksSchema>;
+export type TopicAnglesInput = z.infer<typeof topicAnglesSchema>;
+export type CommentPainPointsInput = z.infer<typeof commentPainPointsSchema>;
+export type VideoAngleMatrixInput = z.infer<typeof videoAngleMatrixSchema>;

package/dist/src/schemas/research.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { maxResultsSchema, regionCodeSchema, videoIdSchema } from './common.js';
+export const outlierVideosSchema = z.object({
+    query: z.string().min(1),
+    maxResults: maxResultsSchema,
+    regionCode: regionCodeSchema,
+    minViewToChannelRatio: z.number().min(1).max(100).default(3),
+    recency: z.enum(['any', 'pastWeek', 'pastMonth', 'pastQuarter', 'pastYear']).default('pastQuarter')
+});
+export const compareHooksSchema = z.object({
+    videoIds: z.array(videoIdSchema).min(2).max(10),
+    lang: z.string().default('en')
+});
+export const topicAnglesSchema = z.object({
+    topic: z.string().min(1),
+    regionCode: regionCodeSchema,
+    sampleSize: maxResultsSchema
+});
+export const commentPainPointsSchema = z.object({
+    videoId: videoIdSchema,
+    maxComments: z.number().int().min(1).max(100).default(50)
+});
+export const videoAngleMatrixSchema = z.object({
+    topic: z.string().min(1),
+    rows: z.number().int().min(3).max(20).default(10),
+    regionCode: regionCodeSchema
+});
+//# sourceMappingURL=research.js.map

package/dist/src/schemas/research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.js","sourceRoot":"","sources":["../../../src/schemas/research.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE,gBAAgB;IAC5B,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;CACpG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE,gBAAgB;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,aAAa;IACtB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACjD,UAAU,EAAE,gBAAgB;CAC7B,CAAC,CAAC"}

package/dist/src/server.d.ts

@@ -1,87 +1,19 @@
+import { type YoutubeOmniConfig } from './config.js';
 import { ProviderRegistry } from './core/provider-registry.js';
-export declare const V0_TOOL_NAMES: readonly ["youtube.discovery.search_videos", "youtube.discovery.get_video_categories", "youtube.video.get_details", "youtube.video.compare", "youtube.channel.get_statistics", "youtube.channel.get_top_videos", "youtube.transcript.get_segments", "youtube.transcript.get_full_text", "youtube.transcript.analyze_structure", "youtube.comments.get", "youtube.comments.summarize", "youtube.planning.generate_research_brief", "youtube.safety.classify_action_risk", "youtube.safety.list_capabilities"];
+export declare const V0_TOOL_NAMES: readonly ["youtube.discovery.search_videos", "youtube.discovery.get_video_categories", "youtube.video.get_details", "youtube.video.compare", "youtube.channel.get_statistics", "youtube.channel.get_top_videos", "youtube.transcript.get_segments", "youtube.transcript.get_full_text", "youtube.transcript.analyze_structure", "youtube.comments.get", "youtube.comments.summarize", "youtube.planning.generate_research_brief", "youtube.research.find_outlier_videos", "youtube.research.compare_hooks", "youtube.research.extract_topic_angles", "youtube.research.summarize_comment_pain_points", "youtube.research.generate_video_angle_matrix", "youtube.safety.classify_action_risk", "youtube.safety.list_capabilities"];
+export declare const OPERATION_TOOL_NAMES: readonly ["youtube.operations.update_video_metadata", "youtube.operations.schedule_upload", "youtube.operations.update_thumbnail", "youtube.operations.update_playlist", "youtube.operations.moderate_comment", "youtube.operations.create_community_post"];
 export type V0ToolName = typeof V0_TOOL_NAMES[number];
+export type OperationToolName = typeof OPERATION_TOOL_NAMES[number];
+export type ToolName = V0ToolName | OperationToolName;
 type JsonSchema = Record<string, unknown>;
 type ToolDefinition = {
-    name: V0ToolName;
+    name: ToolName;
     description: string;
     inputSchema: JsonSchema;
 };
-export declare const V0_TOOL_INPUT_SCHEMAS: Record<V0ToolName, JsonSchema>;
-export declare function getToolDefinitions(): ToolDefinition[];
+export declare const V0_TOOL_INPUT_SCHEMAS: Record<string, JsonSchema>;
+export declare function getToolNames(config?: Pick<YoutubeOmniConfig, 'enableWriteTools' | 'dryRunWrites'>): ToolName[];
+export declare function getToolDefinitions(config?: Pick<YoutubeOmniConfig, 'enableWriteTools' | 'dryRunWrites'>): ToolDefinition[];
 export declare function createDefaultRegistry(): ProviderRegistry;
-export declare function createToolHandlers(registry?: ProviderRegistry): {
-    'youtube.discovery.search_videos': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        videos: any[];
-    }>>;
-    'youtube.discovery.get_video_categories': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        regionCode: string;
-        categories: any[];
-    }>>;
-    'youtube.video.get_details': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        videos: any[];
-    }>>;
-    'youtube.video.compare': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        comparison: {
-            rows: any[];
-            observations: string[];
-        };
-    }>>;
-    'youtube.channel.get_statistics': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        channels: any[];
-    }>>;
-    'youtube.channel.get_top_videos': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        channelId: string;
-        videos: any[];
-    }>>;
-    'youtube.transcript.get_segments': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        transcripts: any[];
-    }>>;
-    'youtube.transcript.get_full_text': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        videoId: string;
-        language: string;
-        text: string;
-        truncated: boolean;
-    }>>;
-    'youtube.transcript.analyze_structure': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        hook: string;
-        cta: string;
-        outline: string[];
-        claims: never[];
-        scriptPatterns: string[];
-    }>>;
-    'youtube.comments.get': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        videoId: string;
-        comments: any[];
-    }>>;
-    'youtube.comments.summarize': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        summary: string;
-        questions: string[];
-        contentRequests: string[];
-        sentimentSignal: {
-            positive: string;
-            negative: string;
-            mixed: boolean;
-        };
-    }>>;
-    'youtube.planning.generate_research_brief': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        brief: {
-            topic: string;
-            benchmarkVideos: any[];
-            benchmarkChannels: never[];
-            titlePatterns: string[];
-            hookPatterns: string[];
-            audienceQuestions: never[];
-            contentOpportunities: never[];
-            risks: string[];
-        };
-    }>>;
-    'youtube.safety.classify_action_risk': (input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<import("./core/risk.js").ActionRisk>>;
-    'youtube.safety.list_capabilities': (_input: unknown) => Promise<import("./core/envelope.js").ToolEnvelope<{
-        version: string;
-        phase: string;
-        enabledNamespaces: string[];
-        lockedNamespaces: string[];
-    }>>;
-};
+export declare function createToolHandlers(registry?: ProviderRegistry, config?: Pick<YoutubeOmniConfig, 'enableWriteTools' | 'dryRunWrites'>): Record<string, (input: unknown) => Promise<any>>;
 export {};

package/dist/src/server.js

@@ -1,3 +1,4 @@
+import { loadConfig } from './config.js';
 import { ProviderRegistry } from './core/provider-registry.js';
 import { MockYoutubeProvider } from './providers/mock-provider.js';
 import { searchVideos, getVideoCategories } from './tools/discovery.js';
@@ -7,6 +8,8 @@ import { getTranscriptSegments, getTranscriptFullText, analyzeTranscriptStructur
 import { getVideoComments, summarizeComments } from './tools/comments.js';
 import { generateResearchBrief } from './tools/planning.js';
 import { classifyActionRiskTool, listCapabilities } from './tools/safety.js';
+import { compareHooks, extractTopicAngles, findOutlierVideos, generateVideoAngleMatrix, summarizeCommentPainPoints } from './tools/research.js';
+import { createCommunityPost, moderateComment, scheduleUpload, updatePlaylist, updateThumbnail, updateVideoMetadata } from './tools/operations.js';
 export const V0_TOOL_NAMES = [
     'youtube.discovery.search_videos',
     'youtube.discovery.get_video_categories',
@@ -20,9 +23,22 @@ export const V0_TOOL_NAMES = [
     'youtube.comments.get',
     'youtube.comments.summarize',
     'youtube.planning.generate_research_brief',
+    'youtube.research.find_outlier_videos',
+    'youtube.research.compare_hooks',
+    'youtube.research.extract_topic_angles',
+    'youtube.research.summarize_comment_pain_points',
+    'youtube.research.generate_video_angle_matrix',
     'youtube.safety.classify_action_risk',
     'youtube.safety.list_capabilities'
 ];
+export const OPERATION_TOOL_NAMES = [
+    'youtube.operations.update_video_metadata',
+    'youtube.operations.schedule_upload',
+    'youtube.operations.update_thumbnail',
+    'youtube.operations.update_playlist',
+    'youtube.operations.moderate_comment',
+    'youtube.operations.create_community_post'
+];
 const stringSchema = (description, extra = {}) => ({ type: 'string', description, ...extra });
 const numberSchema = (description, minimum, maximum, defaultValue) => ({
     type: 'number',
@@ -117,14 +133,85 @@ export const V0_TOOL_INPUT_SCHEMAS = {
         includeTranscripts: booleanSchema('Include transcript signals where available.', true),
         includeComments: booleanSchema('Include comment signals where available.', true)
     }, ['topic']),
+    'youtube.research.find_outlier_videos': objectSchema({
+        query: stringSchema('Topic or niche to discover outlier videos for.', { minLength: 1 }),
+        maxResults: numberSchema('Maximum videos to inspect.', 1, 50, 10),
+        regionCode: stringSchema('Two-letter country code.', { pattern: '^[A-Z]{2}$', default: 'US' }),
+        minViewToChannelRatio: numberSchema('Minimum views-to-subscriber ratio considered outlier.', 1, 100, 3),
+        recency: enumSchema('Search recency window.', ['any', 'pastWeek', 'pastMonth', 'pastQuarter', 'pastYear'], 'pastQuarter')
+    }, ['query']),
+    'youtube.research.compare_hooks': objectSchema({
+        videoIds: stringArraySchema('YouTube video IDs whose hooks should be compared.', 2, 10),
+        lang: stringSchema('Transcript language code.', { default: 'en' })
+    }, ['videoIds']),
+    'youtube.research.extract_topic_angles': objectSchema({
+        topic: stringSchema('Topic or niche to extract content angles for.', { minLength: 1 }),
+        regionCode: stringSchema('Two-letter country code.', { pattern: '^[A-Z]{2}$', default: 'US' }),
+        sampleSize: numberSchema('Number of videos to sample.', 1, 50, 10)
+    }, ['topic']),
+    'youtube.research.summarize_comment_pain_points': objectSchema({
+        videoId: stringSchema('YouTube video ID.', { minLength: 1 }),
+        maxComments: numberSchema('Maximum comments to inspect.', 1, 100, 50)
+    }, ['videoId']),
+    'youtube.research.generate_video_angle_matrix': objectSchema({
+        topic: stringSchema('Topic or niche for angle matrix generation.', { minLength: 1 }),
+        rows: numberSchema('Number of matrix rows to generate.', 3, 20, 10),
+        regionCode: stringSchema('Two-letter country code.', { pattern: '^[A-Z]{2}$', default: 'US' })
+    }, ['topic']),
+    'youtube.operations.update_video_metadata': objectSchema({
+        videoId: stringSchema('YouTube video ID.', { minLength: 1 }),
+        title: stringSchema('Optional replacement title.', { minLength: 1, maxLength: 100 }),
+        description: stringSchema('Optional replacement description.', { maxLength: 5000 }),
+        tags: { type: 'array', description: 'Optional replacement tags.', items: { type: 'string', minLength: 1 }, maxItems: 50 },
+        approvalId: stringSchema('Optional approval identifier.', { minLength: 1 }),
+        dryRun: booleanSchema('Dry-run flag; live writes are unavailable in v0.2.', true)
+    }, ['videoId']),
+    'youtube.operations.schedule_upload': objectSchema({
+        filePath: stringSchema('Local path to the video file.', { minLength: 1 }),
+        title: stringSchema('Upload title.', { minLength: 1, maxLength: 100 }),
+        scheduledAt: stringSchema('Optional scheduled publish timestamp.'),
+        approvalId: stringSchema('Optional approval identifier.', { minLength: 1 }),
+        dryRun: booleanSchema('Dry-run flag; live writes are unavailable in v0.2.', true)
+    }, ['filePath', 'title']),
+    'youtube.operations.update_thumbnail': objectSchema({
+        videoId: stringSchema('YouTube video ID.', { minLength: 1 }),
+        imagePath: stringSchema('Local thumbnail image path.', { minLength: 1 }),
+        approvalId: stringSchema('Optional approval identifier.', { minLength: 1 }),
+        dryRun: booleanSchema('Dry-run flag; live writes are unavailable in v0.2.', true)
+    }, ['videoId', 'imagePath']),
+    'youtube.operations.update_playlist': objectSchema({
+        playlistId: stringSchema('YouTube playlist ID.', { minLength: 1 }),
+        videoId: stringSchema('YouTube video ID.', { minLength: 1 }),
+        action: enumSchema('Playlist mutation action.', ['add', 'remove', 'reorder'], 'add'),
+        approvalId: stringSchema('Optional approval identifier.', { minLength: 1 }),
+        dryRun: booleanSchema('Dry-run flag; live writes are unavailable in v0.2.', true)
+    }, ['playlistId']),
+    'youtube.operations.moderate_comment': objectSchema({
+        commentId: stringSchema('YouTube comment ID.', { minLength: 1 }),
+        action: enumSchema('Comment moderation action.', ['hold', 'approve', 'reject', 'report']),
+        approvalId: stringSchema('Optional approval identifier.', { minLength: 1 }),
+        dryRun: booleanSchema('Dry-run flag; live writes are unavailable in v0.2.', true)
+    }, ['commentId', 'action']),
+    'youtube.operations.create_community_post': objectSchema({
+        channelId: stringSchema('YouTube channel ID.', { minLength: 1 }),
+        text: stringSchema('Community post text.', { minLength: 1, maxLength: 5000 }),
+        approvalId: stringSchema('Optional approval identifier.', { minLength: 1 }),
+        dryRun: booleanSchema('Dry-run flag; live writes are unavailable in v0.2.', true)
+    }, ['channelId', 'text']),
     'youtube.safety.classify_action_risk': objectSchema({
         action: stringSchema('Action name to classify.', { minLength: 1 }),
         params: { type: 'object', description: 'Optional action parameters.', additionalProperties: true }
     }, ['action']),
     'youtube.safety.list_capabilities': objectSchema({})
 };
-export function getToolDefinitions() {
-    return V0_TOOL_NAMES.map((name) => ({
+function operationToolsEnabled(config) {
+    return config.enableWriteTools === true && config.dryRunWrites === true;
+}
+export function getToolNames(config = loadConfig()) {
+    return operationToolsEnabled(config) ? [...V0_TOOL_NAMES, ...OPERATION_TOOL_NAMES] : [...V0_TOOL_NAMES];
+}
+export function getToolDefinitions(config = loadConfig()) {
+    return getToolNames(config).map((name) => ({
         name,
         description: `YouTube Omni v0 read-only tool: ${name}`,
         inputSchema: V0_TOOL_INPUT_SCHEMAS[name]
@@ -133,8 +220,8 @@ export function getToolDefinitions() {
 export function createDefaultRegistry() {
     return new ProviderRegistry([new MockYoutubeProvider()]);
 }
-export function createToolHandlers(registry = createDefaultRegistry()) {
-    return {
+export function createToolHandlers(registry = createDefaultRegistry(), config = loadConfig()) {
+    const handlers = {
         'youtube.discovery.search_videos': (input) => searchVideos(input, registry),
         'youtube.discovery.get_video_categories': (input) => getVideoCategories(input, registry),
         'youtube.video.get_details': (input) => getVideoDetails(input, registry),
@@ -147,8 +234,22 @@ export function createToolHandlers(registry = createDefaultRegistry()) {
         'youtube.comments.get': (input) => getVideoComments(input, registry),
         'youtube.comments.summarize': (input) => summarizeComments(input, registry),
         'youtube.planning.generate_research_brief': (input) => generateResearchBrief(input, registry),
+        'youtube.research.find_outlier_videos': (input) => findOutlierVideos(input, registry),
+        'youtube.research.compare_hooks': (input) => compareHooks(input, registry),
+        'youtube.research.extract_topic_angles': (input) => extractTopicAngles(input, registry),
+        'youtube.research.summarize_comment_pain_points': (input) => summarizeCommentPainPoints(input, registry),
+        'youtube.research.generate_video_angle_matrix': (input) => generateVideoAngleMatrix(input, registry),
         'youtube.safety.classify_action_risk': (input) => classifyActionRiskTool(input),
         'youtube.safety.list_capabilities': (_input) => listCapabilities({})
     };
+    if (operationToolsEnabled(config)) {
+        handlers['youtube.operations.update_video_metadata'] = (input) => updateVideoMetadata(input);
+        handlers['youtube.operations.schedule_upload'] = (input) => scheduleUpload(input);
+        handlers['youtube.operations.update_thumbnail'] = (input) => updateThumbnail(input);
+        handlers['youtube.operations.update_playlist'] = (input) => updatePlaylist(input);
+        handlers['youtube.operations.moderate_comment'] = (input) => moderateComment(input);
+        handlers['youtube.operations.create_community_post'] = (input) => createCommunityPost(input);
+    }
+    return handlers;
 }
 //# sourceMappingURL=server.js.map

package/dist/src/server.js.map

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

package/dist/src/tools/operations.d.ts

@@ -0,0 +1,14 @@
+import type { ToolEnvelope } from '../core/envelope.js';
+type DryRunData = {
+    dryRun: true;
+    wouldCall: string;
+    approvalId?: string;
+    request: unknown;
+};
+export declare function updateVideoMetadata(input: unknown): Promise<ToolEnvelope<DryRunData>>;
+export declare function scheduleUpload(input: unknown): Promise<ToolEnvelope<DryRunData>>;
+export declare function updateThumbnail(input: unknown): Promise<ToolEnvelope<DryRunData>>;
+export declare function updatePlaylist(input: unknown): Promise<ToolEnvelope<DryRunData>>;
+export declare function moderateComment(input: unknown): Promise<ToolEnvelope<DryRunData>>;
+export declare function createCommunityPost(input: unknown): Promise<ToolEnvelope<DryRunData>>;
+export {};

package/dist/src/tools/operations.js

@@ -0,0 +1,38 @@
+import { createCommunityPostSchema, moderateCommentSchema, scheduleUploadSchema, updatePlaylistSchema, updateThumbnailSchema, updateVideoMetadataSchema } from '../schemas/operations.js';
+const MESSAGE = 'Write tools are disabled by default. Enable only with OAuth, approval, and audit configured.';
+function operationBlockedEnvelope(tool, wouldCall, request) {
+    return {
+        ok: false,
+        tool,
+        timestamp: new Date().toISOString(),
+        source: { provider: 'core', authTier: 'oauth_write' },
+        data: { dryRun: true, wouldCall, approvalId: request.approvalId, request },
+        warnings: ['Operation tool is dry-run-only in v0.2 and never performs live YouTube writes.'],
+        error: { code: 'APPROVAL_REQUIRED_OR_WRITE_DISABLED', message: MESSAGE, retryable: false }
+    };
+}
+export async function updateVideoMetadata(input) {
+    const parsed = updateVideoMetadataSchema.parse(input);
+    return operationBlockedEnvelope('youtube.operations.update_video_metadata', 'youtube.videos.update', parsed);
+}
+export async function scheduleUpload(input) {
+    const parsed = scheduleUploadSchema.parse(input);
+    return operationBlockedEnvelope('youtube.operations.schedule_upload', 'youtube.videos.insert', parsed);
+}
+export async function updateThumbnail(input) {
+    const parsed = updateThumbnailSchema.parse(input);
+    return operationBlockedEnvelope('youtube.operations.update_thumbnail', 'youtube.thumbnails.set', parsed);
+}
+export async function updatePlaylist(input) {
+    const parsed = updatePlaylistSchema.parse(input);
+    return operationBlockedEnvelope('youtube.operations.update_playlist', 'youtube.playlistItems.insert_or_delete', parsed);
+}
+export async function moderateComment(input) {
+    const parsed = moderateCommentSchema.parse(input);
+    return operationBlockedEnvelope('youtube.operations.moderate_comment', 'youtube.comments.setModerationStatus', parsed);
+}
+export async function createCommunityPost(input) {
+    const parsed = createCommunityPostSchema.parse(input);
+    return operationBlockedEnvelope('youtube.operations.create_community_post', 'youtube.communityPosts.insert', parsed);
+}
+//# sourceMappingURL=operations.js.map

package/dist/src/tools/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../src/tools/operations.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,0BAA0B,CAAC;AAElC,MAAM,OAAO,GAAG,8FAA8F,CAAC;AAS/G,SAAS,wBAAwB,CAAC,IAAY,EAAE,SAAiB,EAAE,OAAkD;IACnH,OAAO;QACL,EAAE,EAAE,KAAK;QACT,IAAI;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE;QACrD,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE;QAC1E,QAAQ,EAAE,CAAC,gFAAgF,CAAC;QAC5F,KAAK,EAAE,EAAE,IAAI,EAAE,qCAAqC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE;KAC3F,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAc;IACtD,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,wBAAwB,CAAC,0CAA0C,EAAE,uBAAuB,EAAE,MAAM,CAAC,CAAC;AAC/G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAc;IACjD,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,wBAAwB,CAAC,oCAAoC,EAAE,uBAAuB,EAAE,MAAM,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAc;IAClD,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,wBAAwB,CAAC,qCAAqC,EAAE,wBAAwB,EAAE,MAAM,CAAC,CAAC;AAC3G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAc;IACjD,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,wBAAwB,CAAC,oCAAoC,EAAE,wCAAwC,EAAE,MAAM,CAAC,CAAC;AAC1H,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAc;IAClD,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,wBAAwB,CAAC,qCAAqC,EAAE,sCAAsC,EAAE,MAAM,CAAC,CAAC;AACzH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAc;IACtD,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,wBAAwB,CAAC,0CAA0C,EAAE,+BAA+B,EAAE,MAAM,CAAC,CAAC;AACvH,CAAC"}

package/dist/src/tools/research.d.ts

@@ -0,0 +1,47 @@
+import type { ProviderRegistry } from '../core/provider-registry.js';
+export declare function findOutlierVideos(input: unknown, registry: ProviderRegistry): Promise<import("../core/envelope.js").ToolEnvelope<{
+    query: string;
+    outliers: {
+        videoId: any;
+        title: any;
+        channelId: any;
+        viewCount: number;
+        subscriberCount: number;
+        score: number;
+        reason: string;
+    }[];
+}>>;
+export declare function compareHooks(input: unknown, registry: ProviderRegistry): Promise<import("../core/envelope.js").ToolEnvelope<{
+    hooks: {
+        videoId: any;
+        hook: any;
+        pattern: string;
+        availability: any;
+    }[];
+}>>;
+export declare function extractTopicAngles(input: unknown, registry: ProviderRegistry): Promise<import("../core/envelope.js").ToolEnvelope<{
+    topic: string;
+    angles: {
+        angle: string;
+        evidence: any[];
+        sourceTitle: any;
+        channelTitle: any;
+    }[];
+}>>;
+export declare function summarizeCommentPainPoints(input: unknown, registry: ProviderRegistry): Promise<import("../core/envelope.js").ToolEnvelope<{
+    videoId: string;
+    painPoints: {
+        theme: string;
+        count: number;
+        examples: string[];
+    }[];
+}>>;
+export declare function generateVideoAngleMatrix(input: unknown, registry: ProviderRegistry): Promise<import("../core/envelope.js").ToolEnvelope<{
+    topic: string;
+    matrix: {
+        angle: string;
+        evidence: any[];
+        hypothesis: string;
+        suggestedHook: string;
+    }[];
+}>>;

package/dist/src/tools/research.js

@@ -0,0 +1,140 @@
+import { makeEnvelope } from '../core/envelope.js';
+import { commentPainPointsSchema, compareHooksSchema, outlierVideosSchema, topicAnglesSchema, videoAngleMatrixSchema } from '../schemas/research.js';
+function numberFrom(value, fallback = 0) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : fallback;
+}
+function patternForHook(hook) {
+    const lower = hook.toLowerCase();
+    if (lower.includes('?'))
+        return 'question';
+    if (lower.includes('secret') || lower.includes('hidden'))
+        return 'curiosity_gap';
+    if (lower.includes('mock') || lower.includes('this is'))
+        return 'direct_promise';
+    return 'statement';
+}
+function titleAngle(title, topic, index) {
+    const cleaned = title.replace(/\s+/g, ' ').trim();
+    if (cleaned.length > 0)
+        return cleaned;
+    return `${topic} angle ${index + 1}`;
+}
+function themeForComment(text) {
+    const lower = text.toLowerCase();
+    if (lower.includes('follow-up') || lower.includes('make'))
+        return 'follow-up requests';
+    if (lower.includes('?') || lower.includes('how') || lower.includes('why'))
+        return 'audience questions';
+    return 'positive feedback';
+}
+export async function findOutlierVideos(input, registry) {
+    const parsed = outlierVideosSchema.parse(input);
+    const searchProvider = registry.requireCapability('search');
+    const detailsProvider = registry.requireCapability('video_details');
+    const channelProvider = registry.requireCapability('channel_stats');
+    const search = await searchProvider.searchVideos({ query: parsed.query, maxResults: parsed.maxResults });
+    const videoIds = search.videos.map((video) => video.videoId).filter(Boolean);
+    const details = await detailsProvider.getVideoDetails({ videoIds, includeTags: false, descriptionDetail: 'snippet' });
+    const channelIds = [...new Set(details.videos.map((video) => video.channelId).filter(Boolean))];
+    const channels = await channelProvider.getChannelStatistics({ channelIds });
+    const subscriberByChannel = new Map(channels.channels.map((channel) => [channel.channelId, numberFrom(channel.subscriberCount, 1)]));
+    const outliers = details.videos.map((video) => {
+        const views = numberFrom(video.statistics?.viewCount);
+        const subscribers = Math.max(1, numberFrom(subscriberByChannel.get(video.channelId), 1));
+        const ratio = views / subscribers;
+        return {
+            videoId: video.videoId,
+            title: video.title,
+            channelId: video.channelId,
+            viewCount: views,
+            subscriberCount: subscribers,
+            score: Number(Math.max(ratio, ratio >= parsed.minViewToChannelRatio ? ratio * 2 : ratio).toFixed(4)),
+            reason: ratio >= parsed.minViewToChannelRatio ? 'views exceed configured channel-size ratio' : 'ranked by views-to-subscribers ratio'
+        };
+    }).sort((a, b) => b.score - a.score);
+    return makeEnvelope({
+        tool: 'youtube.research.find_outlier_videos',
+        provider: searchProvider.id,
+        authTier: searchProvider.authTier,
+        data: { query: parsed.query, outliers },
+        nextActions: ['youtube.research.compare_hooks', 'youtube.comments.summarize'],
+        quotaCost: searchProvider.authTier === 'api_key' ? 102 : 0
+    });
+}
+export async function compareHooks(input, registry) {
+    const parsed = compareHooksSchema.parse(input);
+    const provider = registry.requireCapability('transcript');
+    const data = await provider.getTranscriptSegments({ videoIds: parsed.videoIds, lang: parsed.lang, format: 'key_segments' });
+    const hooks = data.transcripts.map((transcript) => {
+        const hook = transcript.intro || '';
+        return { videoId: transcript.videoId, hook, pattern: patternForHook(hook), availability: transcript.availability ?? 'unknown' };
+    });
+    return makeEnvelope({
+        tool: 'youtube.research.compare_hooks',
+        provider: provider.id,
+        authTier: provider.authTier,
+        data: { hooks },
+        nextActions: ['youtube.research.generate_video_angle_matrix']
+    });
+}
+export async function extractTopicAngles(input, registry) {
+    const parsed = topicAnglesSchema.parse(input);
+    const provider = registry.requireCapability('search');
+    const data = await provider.searchVideos({ query: parsed.topic, maxResults: parsed.sampleSize });
+    const angles = data.videos.map((video, index) => ({
+        angle: titleAngle(video.title, parsed.topic, index),
+        evidence: [video.videoId].filter(Boolean),
+        sourceTitle: video.title,
+        channelTitle: video.channelTitle
+    }));
+    return makeEnvelope({
+        tool: 'youtube.research.extract_topic_angles',
+        provider: provider.id,
+        authTier: provider.authTier,
+        data: { topic: parsed.topic, angles },
+        nextActions: ['youtube.research.generate_video_angle_matrix']
+    });
+}
+export async function summarizeCommentPainPoints(input, registry) {
+    const parsed = commentPainPointsSchema.parse(input);
+    const provider = registry.requireCapability('comments');
+    const data = await provider.getVideoComments({ videoId: parsed.videoId, maxResults: parsed.maxComments, maxReplies: 0 });
+    const grouped = new Map();
+    for (const comment of data.comments) {
+        const text = String(comment.text ?? '');
+        const theme = themeForComment(text);
+        const existing = grouped.get(theme) ?? { theme, count: 0, examples: [] };
+        existing.count += 1;
+        if (existing.examples.length < 3)
+            existing.examples.push(text);
+        grouped.set(theme, existing);
+    }
+    const painPoints = [...grouped.values()].sort((a, b) => b.count - a.count);
+    return makeEnvelope({
+        tool: 'youtube.research.summarize_comment_pain_points',
+        provider: provider.id,
+        authTier: provider.authTier,
+        data: { videoId: parsed.videoId, painPoints },
+        nextActions: ['youtube.research.generate_video_angle_matrix']
+    });
+}
+export async function generateVideoAngleMatrix(input, registry) {
+    const parsed = videoAngleMatrixSchema.parse(input);
+    const provider = registry.requireCapability('search');
+    const data = await provider.searchVideos({ query: parsed.topic, maxResults: parsed.rows });
+    const matrix = data.videos.slice(0, parsed.rows).map((video, index) => ({
+        angle: titleAngle(video.title, parsed.topic, index),
+        evidence: [video.videoId].filter(Boolean),
+        hypothesis: `Use this angle to test demand for ${parsed.topic} with a clear hook and evidence-led payoff.`,
+        suggestedHook: `Why ${titleAngle(video.title, parsed.topic, index)} matters now`
+    }));
+    return makeEnvelope({
+        tool: 'youtube.research.generate_video_angle_matrix',
+        provider: provider.id,
+        authTier: provider.authTier,
+        data: { topic: parsed.topic, matrix },
+        nextActions: ['youtube.planning.generate_research_brief']
+    });
+}
+//# sourceMappingURL=research.js.map

package/dist/src/tools/research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.js","sourceRoot":"","sources":["../../../src/tools/research.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,SAAS,UAAU,CAAC,KAAc,EAAE,QAAQ,GAAG,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,eAAe,CAAC;IACjF,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACjF,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,KAAa,EAAE,KAAa;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACvC,OAAO,GAAG,KAAK,UAAU,KAAK,GAAG,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,oBAAoB,CAAC;IACvF,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,oBAAoB,CAAC;IACvG,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAc,EAAE,QAA0B;IAChF,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,eAAe,GAAG,QAAQ,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IACpE,MAAM,eAAe,GAAG,QAAQ,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,YAAa,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1G,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,eAAgB,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC,CAAC;IACvH,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAa,CAAC;IACjH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,oBAAqB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7E,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAY,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1I,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACzF,MAAM,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;QAClC,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK;YAChB,eAAe,EAAE,WAAW;YAC5B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACpG,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,sCAAsC;SACtI,CAAC;IACJ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAE/C,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,sCAAsC;QAC5C,QAAQ,EAAE,cAAc,CAAC,EAAE;QAC3B,QAAQ,EAAE,cAAc,CAAC,QAAQ;QACjC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE;QACvC,WAAW,EAAE,CAAC,gCAAgC,EAAE,4BAA4B,CAAC;QAC7E,SAAS,EAAE,cAAc,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAC3D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAc,EAAE,QAA0B;IAC3E,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,qBAAsB,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IAC7H,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAe,EAAE,EAAE;QACrD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;QACpC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,IAAI,SAAS,EAAE,CAAC;IAClI,CAAC,CAAC,CAAC;IACH,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,gCAAgC;QACtC,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,IAAI,EAAE,EAAE,KAAK,EAAE;QACf,WAAW,EAAE,CAAC,8CAA8C,CAAC;KAC9D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAc,EAAE,QAA0B;IACjF,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,YAAa,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAClG,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,KAAa,EAAE,EAAE,CAAC,CAAC;QAC7D,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;QACnD,QAAQ,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACzC,WAAW,EAAE,KAAK,CAAC,KAAK;QACxB,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC,CAAC,CAAC;IACJ,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,uCAAuC;QAC7C,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE;QACrC,WAAW,EAAE,CAAC,8CAA8C,CAAC;KAC9D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,KAAc,EAAE,QAA0B;IACzF,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,gBAAiB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1H,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgE,CAAC;IACxF,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACzE,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;QACpB,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3E,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,gDAAgD;QACtD,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE;QAC7C,WAAW,EAAE,CAAC,8CAA8C,CAAC;KAC9D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,KAAc,EAAE,QAA0B;IACvF,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,YAAa,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5F,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,KAAa,EAAE,EAAE,CAAC,CAAC;QACnF,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;QACnD,QAAQ,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACzC,UAAU,EAAE,qCAAqC,MAAM,CAAC,KAAK,6CAA6C;QAC1G,aAAa,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc;KACjF,CAAC,CAAC,CAAC;IACJ,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,8CAA8C;QACpD,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE;QACrC,WAAW,EAAE,CAAC,0CAA0C,CAAC;KAC1D,CAAC,CAAC;AACL,CAAC"}

package/dist/src/tools/safety.js

@@ -5,6 +5,6 @@ export async function classifyActionRiskTool(input) {
     return makeEnvelope({ tool: 'youtube.safety.classify_action_risk', provider: 'core', authTier: 'none', data: risk, warnings: risk.allowedInV0 ? [] : ['This action is part of the full scope but locked in v0.'] });
 }
 export async function listCapabilities(_input) {
-    return makeEnvelope({ tool: 'youtube.safety.list_capabilities', provider: 'core', authTier: 'none', data: { version: '0.0.0', phase: 'v0-read-only', enabledNamespaces: ['discovery', 'video', 'channel', 'transcript', 'comments', 'planning', 'safety'], lockedNamespaces: ['operations', 'community-write', 'analytics-oauth', 'reporting', 'media-download', 'shorts-render', 'music-private'] }, warnings: [] });
+    return makeEnvelope({ tool: 'youtube.safety.list_capabilities', provider: 'core', authTier: 'none', data: { version: '0.2.0', phase: 'v0.2-research-plus-governed-write-foundation', enabledNamespaces: ['discovery', 'video', 'channel', 'transcript', 'comments', 'planning', 'research', 'safety'], lockedNamespaces: ['operations', 'community-write', 'analytics-oauth', 'reporting', 'media-download', 'shorts-render', 'music-private'] }, warnings: [] });
 }
 //# sourceMappingURL=safety.js.map

package/dist/src/tools/safety.js.map

@@ -1 +1 @@
-{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../../src/tools/safety.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAA2D;IACtG,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,qCAAqC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,yDAAyD,CAAC,EAAE,CAAC,CAAC;AACtN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA6B;IAClE,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,kCAAkC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;AACxZ,CAAC"}
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../../src/tools/safety.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAA2D;IACtG,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,qCAAqC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,yDAAyD,CAAC,EAAE,CAAC,CAAC;AACtN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA6B;IAClE,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,kCAAkC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,8CAA8C,EAAE,iBAAiB,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;AACpc,CAAC"}

package/docs/safety-policy.md

@@ -1,5 +1,33 @@
 # Safety Policy
 
-Source of truth: `research/safety-policy-2026-05-13.md` and `research/approval-audit-governance-2026-05-13.md`.
+## Default posture
 
-v0 blocks write, destructive, private analytics, and download surfaces. These are full-scope features, but require approval/OAuth/audit/copyright guards in later phases.
+- Discovery, video, channel, transcript, comments, planning, research, and safety tools are read-only by default.
+- Operations, community-write, analytics OAuth, reporting, media-download, Shorts render, and private music namespaces remain locked by default.
+- Write/download/destructive tools must not be exposed unless explicit environment gates are enabled.
+
+## v0.2 governed write foundation
+
+v0.2 may expose operation tools only when both flags are enabled:
+
+```text
+YOUTUBE_OMNI_ENABLE_WRITE_TOOLS=true
+YOUTUBE_OMNI_DRY_RUN_WRITES=true
+```
+
+Even when exposed, operation tools are dry-run stubs. They return `APPROVAL_REQUIRED_OR_WRITE_DISABLED` and a `wouldCall` field instead of calling YouTube write APIs.
+
+Live writes require a later phase with all of these controls:
+
+- OAuth write credentials
+- human approval ID
+- preview/diff for the proposed mutation
+- audit log storage
+- double confirmation for destructive operations
+
+## Risk tiers
+
+- `none` / tier 0: public metadata reads
+- `low` / tier 1: transcript, comments, planning, research reads
+- `high` / tier 4: upload, metadata, thumbnail, playlist, comment/community writes
+- `destructive` / tier 5: delete/remove, download/clip, revenue/private data workflows

package/docs/tool-schema.md

@@ -2,4 +2,53 @@
 
 Source of truth: `research/tool-schema-draft-2026-05-13.md` and full-scope schema documents under `research/`.
 
-v0 exposes read-only tools only. Operations/analytics/media schemas are documented for later phases.
+## v0.2 default exposed tools
+
+v0.2 keeps all v0 read-only tools and adds Creator Research synthesis tools. Operations/analytics/media schemas are documented for later phases and remain gated.
+
+### Discovery
+
+- `youtube.discovery.search_videos`
+- `youtube.discovery.get_video_categories`
+
+### Video
+
+- `youtube.video.get_details`
+- `youtube.video.compare`
+
+### Channel
+
+- `youtube.channel.get_statistics`
+- `youtube.channel.get_top_videos`
+
+### Transcript
+
+- `youtube.transcript.get_segments`
+- `youtube.transcript.get_full_text`
+- `youtube.transcript.analyze_structure`
+
+### Comments
+
+- `youtube.comments.get`
+- `youtube.comments.summarize`
+
+### Planning
+
+- `youtube.planning.generate_research_brief`
+
+### Creator Research
+
+- `youtube.research.find_outlier_videos` — ranks videos by simple views-to-channel-size signal.
+- `youtube.research.compare_hooks` — compares transcript intro hooks and labels patterns.
+- `youtube.research.extract_topic_angles` — derives content angles from discovered videos.
+- `youtube.research.summarize_comment_pain_points` — groups audience questions/requests from comments.
+- `youtube.research.generate_video_angle_matrix` — generates evidence-backed angle rows for planning.
+
+### Safety
+
+- `youtube.safety.classify_action_risk`
+- `youtube.safety.list_capabilities`
+
+## Gated operation tools
+
+Operation tools are not exposed by default. v0.2 only permits dry-run operation stubs when explicit write and dry-run gates are enabled.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liorium/youtube-omni-mcp",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "YouTube Creator Intelligence, Analytics, Operations, and Production MCP server.",
   "type": "module",
   "license": "UNLICENSED",