@nuxtseo/protocol 0.2.0 → 0.3.0

package/dist/v1/account.d.ts

@@ -458,6 +458,7 @@ export declare const accountTokenDataSchema: import("./core.js").CompatibleRespo
         "audit:read": "audit:read";
         "content:read": "content:read";
         "content:write": "content:write";
+        "feedback:write": "feedback:write";
         "page:read": "page:read";
         "page:write": "page:write";
         "research:read": "research:read";
@@ -493,29 +494,8 @@ export declare const accountTokenDataSchema: import("./core.js").CompatibleRespo
         api_token: "api_token";
         session: "session";
     }>;
-    readonly role: z.ZodEnum<{
-        admin: "admin";
-        member: "member";
-        owner: "owner";
-        viewer: "viewer";
-    }>;
-    readonly scopes: z.ZodArray<z.ZodEnum<{
-        "account:read": "account:read";
-        "actions:read": "actions:read";
-        "actions:write": "actions:write";
-        "analytics:read": "analytics:read";
-        "audit:read": "audit:read";
-        "content:read": "content:read";
-        "content:write": "content:write";
-        "page:read": "page:read";
-        "page:write": "page:write";
-        "research:read": "research:read";
-        "research:write": "research:write";
-        "sites:read": "sites:read";
-        "sites:write": "sites:write";
-        "timeline:read": "timeline:read";
-        "timeline:write": "timeline:write";
-    }>>;
+    readonly role: z.ZodString;
+    readonly scopes: z.ZodArray<z.ZodString>;
     readonly team: z.ZodObject<{
         id: z.ZodString;
         name: z.ZodNullable<z.ZodString>;
@@ -558,6 +538,7 @@ export declare const accountTokenResponseSchema: import("./core.js").CompatibleR
             "audit:read": "audit:read";
             "content:read": "content:read";
             "content:write": "content:write";
+            "feedback:write": "feedback:write";
             "page:read": "page:read";
             "page:write": "page:write";
             "research:read": "research:read";
@@ -599,29 +580,8 @@ export declare const accountTokenResponseSchema: import("./core.js").CompatibleR
             api_token: "api_token";
             session: "session";
         }>;
-        readonly role: z.ZodEnum<{
-            admin: "admin";
-            member: "member";
-            owner: "owner";
-            viewer: "viewer";
-        }>;
-        readonly scopes: z.ZodArray<z.ZodEnum<{
-            "account:read": "account:read";
-            "actions:read": "actions:read";
-            "actions:write": "actions:write";
-            "analytics:read": "analytics:read";
-            "audit:read": "audit:read";
-            "content:read": "content:read";
-            "content:write": "content:write";
-            "page:read": "page:read";
-            "page:write": "page:write";
-            "research:read": "research:read";
-            "research:write": "research:write";
-            "sites:read": "sites:read";
-            "sites:write": "sites:write";
-            "timeline:read": "timeline:read";
-            "timeline:write": "timeline:write";
-        }>>;
+        readonly role: z.ZodString;
+        readonly scopes: z.ZodArray<z.ZodString>;
         readonly team: z.ZodObject<{
             id: z.ZodString;
             name: z.ZodNullable<z.ZodString>;
@@ -695,6 +655,7 @@ export declare const accountTokenOperation: {
                     "audit:read": "audit:read";
                     "content:read": "content:read";
                     "content:write": "content:write";
+                    "feedback:write": "feedback:write";
                     "page:read": "page:read";
                     "page:write": "page:write";
                     "research:read": "research:read";
@@ -736,29 +697,8 @@ export declare const accountTokenOperation: {
                     api_token: "api_token";
                     session: "session";
                 }>;
-                readonly role: z.ZodEnum<{
-                    admin: "admin";
-                    member: "member";
-                    owner: "owner";
-                    viewer: "viewer";
-                }>;
-                readonly scopes: z.ZodArray<z.ZodEnum<{
-                    "account:read": "account:read";
-                    "actions:read": "actions:read";
-                    "actions:write": "actions:write";
-                    "analytics:read": "analytics:read";
-                    "audit:read": "audit:read";
-                    "content:read": "content:read";
-                    "content:write": "content:write";
-                    "page:read": "page:read";
-                    "page:write": "page:write";
-                    "research:read": "research:read";
-                    "research:write": "research:write";
-                    "sites:read": "sites:read";
-                    "sites:write": "sites:write";
-                    "timeline:read": "timeline:read";
-                    "timeline:write": "timeline:write";
-                }>>;
+                readonly role: z.ZodString;
+                readonly scopes: z.ZodArray<z.ZodString>;
                 readonly team: z.ZodObject<{
                     id: z.ZodString;
                     name: z.ZodNullable<z.ZodString>;
@@ -897,6 +837,190 @@ export declare const accountTokenOperation: {
         }];
     };
 };
+export declare const accountFeedbackBodySchema: z.ZodObject<{
+    command: z.ZodString;
+    comment: z.ZodString;
+    agent: z.ZodString;
+    cliVersion: z.ZodString;
+    intent: z.ZodDefault<z.ZodEnum<{
+        bug: "bug";
+        improvement: "improvement";
+    }>>;
+    requestId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const accountFeedbackResponseSchema: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+    data: z.ZodObject<{
+        readonly id: z.ZodString;
+        readonly status: z.ZodLiteral<"new">;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodObject<{
+        readonly id: z.ZodString;
+        readonly status: z.ZodLiteral<"new">;
+    }, z.core.$strip>;
+    meta: z.ZodObject<{
+        requestId: z.ZodString;
+        version: z.ZodLiteral<"1.0">;
+    }, z.core.$loose>;
+}, z.core.$strip>>;
+export declare const accountFeedbackOperation: {
+    readonly id: 'account.feedback';
+    readonly method: 'POST';
+    readonly path: '/api/v1/account/feedback';
+    readonly visibility: 'public';
+    readonly semantics: {
+        readonly kind: 'mutation';
+        readonly sideEffects: 'state';
+        readonly retry: 'never';
+        readonly readConsistency: null;
+    };
+    readonly auth: {
+        readonly credentials: readonly ["session", "api_token"];
+        readonly scopes: readonly ["feedback:write"];
+        readonly minimumRole: 'viewer';
+        readonly ownership: 'team';
+    };
+    readonly request: {
+        readonly params: null;
+        readonly query: null;
+        readonly headers: null;
+        readonly body: z.ZodObject<{
+            command: z.ZodString;
+            comment: z.ZodString;
+            agent: z.ZodString;
+            cliVersion: z.ZodString;
+            intent: z.ZodDefault<z.ZodEnum<{
+                bug: "bug";
+                improvement: "improvement";
+            }>>;
+            requestId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    };
+    readonly responses: {
+        readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            data: z.ZodObject<{
+                readonly id: z.ZodString;
+                readonly status: z.ZodLiteral<"new">;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            data: z.ZodObject<{
+                readonly id: z.ZodString;
+                readonly status: z.ZodLiteral<"new">;
+            }, z.core.$strip>;
+            meta: z.ZodObject<{
+                requestId: z.ZodString;
+                version: z.ZodLiteral<"1.0">;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+    };
+    readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "rate_limited", "contract_violation", "internal_error"];
+    readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>;
+    }, z.core.$strip>, z.ZodObject<{
+        readonly error: z.ZodObject<{
+            code: z.ZodEnum<{
+                auth_expired: "auth_expired";
+                conflict: "conflict";
+                contract_violation: "contract_violation";
+                entitlement_required: "entitlement_required";
+                forbidden: "forbidden";
+                internal_error: "internal_error";
+                invalid_request: "invalid_request";
+                not_found: "not_found";
+                provider_unavailable: "provider_unavailable";
+                quota_exhausted: "quota_exhausted";
+                rate_limited: "rate_limited";
+                site_ambiguous: "site_ambiguous";
+                stale_evidence: "stale_evidence";
+                unauthorized: "unauthorized";
+            }>;
+            message: z.ZodString;
+            requestId: z.ZodString;
+            retryable: z.ZodBoolean;
+            details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$loose>;
+    }, z.core.$strip>>;
+    readonly resources: {
+        readonly reads: readonly [];
+        readonly changes: readonly [{
+            readonly type: 'account.feedback';
+            readonly idFrom: 'team.id';
+        }];
+    };
+    readonly policy: {
+        readonly rate: {
+            readonly name: 'cli-feedback';
+            readonly limit: 10;
+            readonly windowSeconds: 3600;
+        };
+        readonly idempotency: {
+            readonly _tag: 'none';
+        };
+        readonly entitlement: null;
+        readonly meter: null;
+    };
+    readonly lifecycle: {
+        readonly introduced: '1.0.0';
+    };
+    readonly docs: {
+        readonly summary: 'Submit CLI feedback';
+        readonly description: 'Stores an agent report in the existing feedback queue. Operators track fixes there and review unresolved reports during health checks. No Site or paid subscription is required. Send sanitized reproduction details only. This operation does not retry.';
+        readonly tags: readonly ["Account"];
+        readonly examples: readonly [{
+            readonly request: {
+                readonly body: {
+                    readonly command: 'search cohorts';
+                    readonly comment: 'Agent report by Codex. Expected a reason for missing data. Received an empty list.';
+                    readonly agent: 'Codex';
+                    readonly cliVersion: '0.2.1';
+                    readonly intent: 'bug';
+                };
+            };
+            readonly response: {
+                readonly status: 200;
+                readonly body: {
+                    readonly data: {
+                        readonly id: 'fb_01JXYZ';
+                        readonly status: 'new';
+                    };
+                    readonly meta: {
+                        readonly requestId: 'req_01JXYZ';
+                        readonly version: '1.0';
+                    };
+                };
+            };
+        }];
+    };
+};
 export declare const accountV1Registry: import("./core.js").PublicV1Registry<{
     readonly usage: {
         readonly id: 'account.usage';
@@ -1158,6 +1282,7 @@ export declare const accountV1Registry: import("./core.js").PublicV1Registry<{
                         "audit:read": "audit:read";
                         "content:read": "content:read";
                         "content:write": "content:write";
+                        "feedback:write": "feedback:write";
                         "page:read": "page:read";
                         "page:write": "page:write";
                         "research:read": "research:read";
@@ -1199,29 +1324,8 @@ export declare const accountV1Registry: import("./core.js").PublicV1Registry<{
                         api_token: "api_token";
                         session: "session";
                     }>;
-                    readonly role: z.ZodEnum<{
-                        admin: "admin";
-                        member: "member";
-                        owner: "owner";
-                        viewer: "viewer";
-                    }>;
-                    readonly scopes: z.ZodArray<z.ZodEnum<{
-                        "account:read": "account:read";
-                        "actions:read": "actions:read";
-                        "actions:write": "actions:write";
-                        "analytics:read": "analytics:read";
-                        "audit:read": "audit:read";
-                        "content:read": "content:read";
-                        "content:write": "content:write";
-                        "page:read": "page:read";
-                        "page:write": "page:write";
-                        "research:read": "research:read";
-                        "research:write": "research:write";
-                        "sites:read": "sites:read";
-                        "sites:write": "sites:write";
-                        "timeline:read": "timeline:read";
-                        "timeline:write": "timeline:write";
-                    }>>;
+                    readonly role: z.ZodString;
+                    readonly scopes: z.ZodArray<z.ZodString>;
                     readonly team: z.ZodObject<{
                         id: z.ZodString;
                         name: z.ZodNullable<z.ZodString>;
@@ -1360,4 +1464,158 @@ export declare const accountV1Registry: import("./core.js").PublicV1Registry<{
             }];
         };
     };
+    readonly feedback: {
+        readonly id: 'account.feedback';
+        readonly method: 'POST';
+        readonly path: '/api/v1/account/feedback';
+        readonly visibility: 'public';
+        readonly semantics: {
+            readonly kind: 'mutation';
+            readonly sideEffects: 'state';
+            readonly retry: 'never';
+            readonly readConsistency: null;
+        };
+        readonly auth: {
+            readonly credentials: readonly ["session", "api_token"];
+            readonly scopes: readonly ["feedback:write"];
+            readonly minimumRole: 'viewer';
+            readonly ownership: 'team';
+        };
+        readonly request: {
+            readonly params: null;
+            readonly query: null;
+            readonly headers: null;
+            readonly body: z.ZodObject<{
+                command: z.ZodString;
+                comment: z.ZodString;
+                agent: z.ZodString;
+                cliVersion: z.ZodString;
+                intent: z.ZodDefault<z.ZodEnum<{
+                    bug: "bug";
+                    improvement: "improvement";
+                }>>;
+                requestId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+        };
+        readonly responses: {
+            readonly 200: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly status: z.ZodLiteral<"new">;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$strict>;
+            }, z.core.$strip>, z.ZodObject<{
+                data: z.ZodObject<{
+                    readonly id: z.ZodString;
+                    readonly status: z.ZodLiteral<"new">;
+                }, z.core.$strip>;
+                meta: z.ZodObject<{
+                    requestId: z.ZodString;
+                    version: z.ZodLiteral<"1.0">;
+                }, z.core.$loose>;
+            }, z.core.$strip>>;
+        };
+        readonly errors: readonly ["invalid_request", "unauthorized", "auth_expired", "forbidden", "rate_limited", "contract_violation", "internal_error"];
+        readonly errorResponse: import("./core.js").CompatibleResponseSchema<z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strict>;
+        }, z.core.$strip>, z.ZodObject<{
+            readonly error: z.ZodObject<{
+                code: z.ZodEnum<{
+                    auth_expired: "auth_expired";
+                    conflict: "conflict";
+                    contract_violation: "contract_violation";
+                    entitlement_required: "entitlement_required";
+                    forbidden: "forbidden";
+                    internal_error: "internal_error";
+                    invalid_request: "invalid_request";
+                    not_found: "not_found";
+                    provider_unavailable: "provider_unavailable";
+                    quota_exhausted: "quota_exhausted";
+                    rate_limited: "rate_limited";
+                    site_ambiguous: "site_ambiguous";
+                    stale_evidence: "stale_evidence";
+                    unauthorized: "unauthorized";
+                }>;
+                message: z.ZodString;
+                requestId: z.ZodString;
+                retryable: z.ZodBoolean;
+                details: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$loose>;
+        }, z.core.$strip>>;
+        readonly resources: {
+            readonly reads: readonly [];
+            readonly changes: readonly [{
+                readonly type: 'account.feedback';
+                readonly idFrom: 'team.id';
+            }];
+        };
+        readonly policy: {
+            readonly rate: {
+                readonly name: 'cli-feedback';
+                readonly limit: 10;
+                readonly windowSeconds: 3600;
+            };
+            readonly idempotency: {
+                readonly _tag: 'none';
+            };
+            readonly entitlement: null;
+            readonly meter: null;
+        };
+        readonly lifecycle: {
+            readonly introduced: '1.0.0';
+        };
+        readonly docs: {
+            readonly summary: 'Submit CLI feedback';
+            readonly description: 'Stores an agent report in the existing feedback queue. Operators track fixes there and review unresolved reports during health checks. No Site or paid subscription is required. Send sanitized reproduction details only. This operation does not retry.';
+            readonly tags: readonly ["Account"];
+            readonly examples: readonly [{
+                readonly request: {
+                    readonly body: {
+                        readonly command: 'search cohorts';
+                        readonly comment: 'Agent report by Codex. Expected a reason for missing data. Received an empty list.';
+                        readonly agent: 'Codex';
+                        readonly cliVersion: '0.2.1';
+                        readonly intent: 'bug';
+                    };
+                };
+                readonly response: {
+                    readonly status: 200;
+                    readonly body: {
+                        readonly data: {
+                            readonly id: 'fb_01JXYZ';
+                            readonly status: 'new';
+                        };
+                        readonly meta: {
+                            readonly requestId: 'req_01JXYZ';
+                            readonly version: '1.0';
+                        };
+                    };
+                };
+            }];
+        };
+    };
 }>;

package/dist/v1/account.js

@@ -159,8 +159,10 @@ export const accountTokenDataSchema = defineResponseObject({
     user: accountTokenUserProducerSchema,
 }, {
     credential: accountTokenCredentialSchema,
-    role: schema.enum(PUBLIC_V1_ROLES),
-    scopes: schema.array(schema.enum(PUBLIC_V1_SCOPES)),
+    // The server grants new roles and scopes over time. A client shipped
+    // earlier only displays them, so an unknown value must not fail the read.
+    role: schema.string().min(1),
+    scopes: schema.array(schema.string().min(1)),
     team: accountTokenTeamClientSchema,
     token: accountTokenDetailClientSchema.nullable(),
     user: accountTokenUserClientSchema,
@@ -233,10 +235,69 @@ export const accountTokenOperation = defineOperation({
             }],
     },
 });
+export const accountFeedbackBodySchema = schema.strictObject({
+    command: schema.string().trim().min(1).max(200),
+    comment: schema.string().trim().min(1).max(2000),
+    agent: schema.string().trim().min(1).max(100),
+    cliVersion: schema.string().trim().min(1).max(64),
+    intent: schema.enum(['bug', 'improvement']).default('bug'),
+    requestId: schema.string().trim().min(1).max(128).optional(),
+});
+export const accountFeedbackResponseSchema = defineSuccessEnvelope(defineResponseObject({
+    id: schema.string().min(1),
+    status: schema.literal('new'),
+}));
+export const accountFeedbackOperation = defineOperation({
+    id: 'account.feedback',
+    method: 'POST',
+    path: '/api/v1/account/feedback',
+    visibility: 'public',
+    semantics: { kind: 'mutation', sideEffects: 'state', retry: 'never', readConsistency: null },
+    auth: {
+        credentials: ['session', 'api_token'],
+        scopes: ['feedback:write'],
+        minimumRole: 'viewer',
+        ownership: 'team',
+    },
+    request: { params: null, query: null, headers: null, body: accountFeedbackBodySchema },
+    responses: { 200: accountFeedbackResponseSchema },
+    errors: ['invalid_request', 'unauthorized', 'auth_expired', 'forbidden', 'rate_limited', 'contract_violation', 'internal_error'],
+    errorResponse: publicV1ErrorEnvelope,
+    resources: {
+        reads: [],
+        changes: [{ type: 'account.feedback', idFrom: 'team.id' }],
+    },
+    policy: {
+        rate: { name: 'cli-feedback', limit: 10, windowSeconds: 3600 },
+        idempotency: { _tag: 'none' },
+        entitlement: null,
+        meter: null,
+    },
+    lifecycle: { introduced: '1.0.0' },
+    docs: {
+        summary: 'Submit CLI feedback',
+        description: 'Stores an agent report in the existing feedback queue. Operators track fixes there and review unresolved reports during health checks. No Site or paid subscription is required. Send sanitized reproduction details only. This operation does not retry.',
+        tags: ['Account'],
+        examples: [{
+                request: { body: {
+                        command: 'search cohorts',
+                        comment: 'Agent report by Codex. Expected a reason for missing data. Received an empty list.',
+                        agent: 'Codex',
+                        cliVersion: '0.2.1',
+                        intent: 'bug',
+                    } },
+                response: { status: 200, body: {
+                        data: { id: 'fb_01JXYZ', status: 'new' },
+                        meta: { requestId: 'req_01JXYZ', version: '1.0' },
+                    } },
+            }],
+    },
+});
 export const accountV1Registry = defineRegistry({
     feature: 'account',
     operations: {
         usage: accountUsageOperation,
         token: accountTokenOperation,
+        feedback: accountFeedbackOperation,
     },
 });