buckyos 0.7.136 → 0.7.138

package/cli/modules/ai.ts

@@ -27,7 +27,7 @@ const GROUPS = [
 export function createAiModule(): CommandModule {
   return {
     name: 'ai',
-    summary: 'Read AI provider, routing, and usage state of the AICC service',
+    summary: 'Read AI provider, routing, usage and token quota state of the AICC service',
     commands: [
       readCommand({
         verb: 'providers',
@@ -43,10 +43,39 @@ export function createAiModule(): CommandModule {
         description: 'An empty routing object means the default routing of the model catalog.',
       }),
       usageCommand(),
+      quotaCommand(),
     ],
   }
 }
 
+function quotaCommand(): CommandDefinition {
+  return {
+    verb: 'quota',
+    summary: "Show the token quota rules that limit the caller's AI calls and what is left",
+    description:
+      'Admin rules on the caller and the caller\'s Apps, shared App rules, and the caller\'s own App limits, each with its current window or total account. A refused call returns quota_exhausted / quota_budget_exceeded with the blocking rules.',
+    options: [
+      { name: 'app', description: 'Only the rules that apply to calls of this App (an AppId or AgentId)', type: 'string' },
+    ],
+    inputSchema: {
+      type: 'object',
+      properties: { app: { type: 'string', minLength: 1 } },
+      additionalProperties: false,
+    },
+    outputSchema: OBJECT_OUTPUT,
+    resultSchemaVersion: 1,
+    access: { mode: 'fixed', level: 'read' },
+    asyncMode: 'sync',
+    requiresSession: true,
+    examples: ['buckyos ai quota', 'buckyos ai quota --app aiworkspace'],
+    handler: async (ctx, input) =>
+      expectObject(
+        await callService(ctx, AICC, 'quota.query', inputString(input, 'app') ? { app_id: inputString(input, 'app') } : {}),
+        'quota.query',
+      ),
+  }
+}
+
 function readCommand(options: {
   verb: string
   summary: string

package/cli/version.ts

@@ -1,5 +1,5 @@
 // Generated by scripts/generate-cli-version.mjs. Do not edit.
-export const PACKAGE_VERSION = '0.7.136'
+export const PACKAGE_VERSION = '0.7.138'
 export const TOOL_VERSION = PACKAGE_VERSION
 export const SDK_VERSION = PACKAGE_VERSION
 export const PROTOCOL_VERSION = '1'

package/dist/aicc_client.d.ts

@@ -21,9 +21,8 @@ export declare const AICC_AI_METHODS: {
     readonly AUDIO_ASR: "audio.asr";
     readonly AUDIO_MUSIC: "audio.music";
     readonly AUDIO_ENHANCE: "audio.enhance";
-    readonly VIDEO_TXT2VIDEO: "video.txt2video";
-    readonly VIDEO_IMG2VIDEO: "video.img2video";
-    readonly VIDEO_VIDEO2VIDEO: "video.video2video";
+    readonly VIDEO_GENERATE: "video.generate";
+    readonly VIDEO_EDIT: "video.edit";
     readonly VIDEO_EXTEND: "video.extend";
     readonly VIDEO_UPSCALE: "video.upscale";
     readonly AGENT_COMPUTER_USE: "agent.computer_use";
@@ -32,6 +31,7 @@ export declare const AICC_CORE_METHODS: {
     readonly ROUTE_RESOLVE: "route.resolve";
     readonly HELPER_LLM_CHAT: "helper.llm_chat";
     readonly HELPER_TEXT_TO_IMAGE: "helper.text_to_image";
+    readonly HELPER_VIDEO_GENERATE: "helper.video_generate";
     readonly CANCEL: "cancel";
 };
 export declare const AICC_MANAGEMENT_METHODS: {
@@ -55,7 +55,34 @@ export declare const AICC_MANAGEMENT_METHODS: {
     readonly DRIVER_METADATA_UPDATE_GET: "driver_metadata_update.get";
     readonly DRIVER_METADATA_UPDATE_SET: "driver_metadata_update.set";
 };
+/** Token quota and resource visibility (product/ai_center/AI_Center_Quota_PRD.md). */
+export declare const AICC_QUOTA_METHODS: {
+    readonly RULE_LIST: "quota.rule.list";
+    readonly RULE_GET: "quota.rule.get";
+    readonly RULE_PREVIEW: "quota.rule.preview";
+    readonly RULE_CREATE: "quota.rule.create";
+    readonly RULE_UPDATE: "quota.rule.update";
+    readonly RULE_DELETE: "quota.rule.delete";
+    readonly ACCOUNT_GET: "quota.account.get";
+    readonly ACCOUNT_RECHARGE: "quota.account.recharge";
+    readonly RECHARGE_GET: "quota.recharge.get";
+    readonly VISIBILITY_GET: "visibility.get";
+    readonly VISIBILITY_UPDATE: "visibility.update";
+    readonly VISIBILITY_PREVIEW: "visibility.preview";
+};
 export declare const AICC_METHODS: {
+    readonly RULE_LIST: "quota.rule.list";
+    readonly RULE_GET: "quota.rule.get";
+    readonly RULE_PREVIEW: "quota.rule.preview";
+    readonly RULE_CREATE: "quota.rule.create";
+    readonly RULE_UPDATE: "quota.rule.update";
+    readonly RULE_DELETE: "quota.rule.delete";
+    readonly ACCOUNT_GET: "quota.account.get";
+    readonly ACCOUNT_RECHARGE: "quota.account.recharge";
+    readonly RECHARGE_GET: "quota.recharge.get";
+    readonly VISIBILITY_GET: "visibility.get";
+    readonly VISIBILITY_UPDATE: "visibility.update";
+    readonly VISIBILITY_PREVIEW: "visibility.preview";
     readonly SERVICE_RELOAD_SETTINGS: "service.reload_settings";
     readonly QUOTA_QUERY: "quota.query";
     readonly USAGE_QUERY: "usage.query";
@@ -78,6 +105,7 @@ export declare const AICC_METHODS: {
     readonly ROUTE_RESOLVE: "route.resolve";
     readonly HELPER_LLM_CHAT: "helper.llm_chat";
     readonly HELPER_TEXT_TO_IMAGE: "helper.text_to_image";
+    readonly HELPER_VIDEO_GENERATE: "helper.video_generate";
     readonly CANCEL: "cancel";
     readonly CHAT_COMPLETIONS_CREATE: "chat.completions.create";
     readonly IMAGES_GENERATE: "images.generate";
@@ -97,9 +125,8 @@ export declare const AICC_METHODS: {
     readonly AUDIO_ASR: "audio.asr";
     readonly AUDIO_MUSIC: "audio.music";
     readonly AUDIO_ENHANCE: "audio.enhance";
-    readonly VIDEO_TXT2VIDEO: "video.txt2video";
-    readonly VIDEO_IMG2VIDEO: "video.img2video";
-    readonly VIDEO_VIDEO2VIDEO: "video.video2video";
+    readonly VIDEO_GENERATE: "video.generate";
+    readonly VIDEO_EDIT: "video.edit";
     readonly VIDEO_EXTEND: "video.extend";
     readonly VIDEO_UPSCALE: "video.upscale";
     readonly AGENT_COMPUTER_USE: "agent.computer_use";
@@ -109,7 +136,7 @@ export type AiccMethod = typeof AICC_METHODS[keyof typeof AICC_METHODS];
 export type JsonValue = null | boolean | number | string | JsonValue[] | {
     [key: string]: JsonValue;
 };
-export type ApiType = 'llm' | 'embedding.text' | 'embedding.multimodal' | 'decision' | 'rerank' | 'image.txt2img' | 'image.img2img' | 'image.inpaint' | 'image.upscale' | 'image.bg_remove' | 'vision.ocr' | 'vision.caption' | 'vision.detect' | 'vision.segment' | 'audio.tts' | 'audio.asr' | 'audio.music' | 'audio.enhance' | 'video.txt2video' | 'video.img2video' | 'video.video2video' | 'video.extend' | 'video.upscale' | 'agent.computer_use';
+export type ApiType = 'llm' | 'embedding.text' | 'embedding.multimodal' | 'decision' | 'rerank' | 'image.txt2img' | 'image.img2img' | 'image.inpaint' | 'image.upscale' | 'image.bg_remove' | 'vision.ocr' | 'vision.caption' | 'vision.detect' | 'vision.segment' | 'audio.tts' | 'audio.asr' | 'audio.music' | 'audio.enhance' | 'video.generate' | 'video.edit' | 'video.extend' | 'video.upscale' | 'agent.computer_use';
 export type Capability = 'llm' | 'embedding' | 'decision' | 'rerank' | 'image' | 'vision' | 'audio' | 'video' | 'agent';
 export type Feature = string;
 export declare const AICC_FEATURES: {
@@ -196,6 +223,9 @@ export interface AiUsage {
     output_tokens?: number;
     total_tokens?: number;
     request_units?: number;
+    video_seconds?: number;
+    reference_images?: number;
+    reported_cost?: number;
 }
 export interface Money {
     amount: number;
@@ -208,7 +238,17 @@ export interface AiArtifact {
     mime?: string;
     metadata?: JsonValue;
 }
-export type AiccErrorCode = 'invalid_request' | 'invalid_method' | 'schema_validation_failed' | 'invalid_model_name' | 'resource_invalid' | 'no_provider_available' | 'no_candidate_model' | 'fallback_not_allowed' | 'provider_start_failed' | 'provider_error' | 'unsupported_execution_mode' | 'timeout' | 'budget_exceeded' | 'policy_denied' | 'idempotency_conflict' | 'settings_revision_conflict' | 'cancelled' | 'internal_error';
+export type AiccErrorCode = 'invalid_request' | 'invalid_method' | 'schema_validation_failed' | 'invalid_model_name' | 'resource_invalid' | 'no_provider_available' | 'no_candidate_model' | 'fallback_not_allowed' | 'provider_start_failed' | 'provider_error' | 'unsupported_execution_mode' | 'timeout' | 'budget_exceeded' | 'policy_denied' | 'idempotency_conflict' | 'settings_revision_conflict' | 'cancelled' | 'internal_error' | 
+/** An enabled token quota rule has nothing left (`details`: QuotaDenialDetails). */
+'quota_exhausted' | 
+/** Tokens are left but fewer than the call reserves; lower the budget (`details`: QuotaDenialDetails). */
+'quota_budget_exceeded' | 
+/** A configured rule could not be read or reserved; retry later, never treat it as unlimited. */
+'quota_unavailable' | 
+/** The Provider / model is not permitted to the caller (hidden identities are not disclosed). */
+'resource_not_permitted' | 
+/** The AICC user of a delegated run cannot be determined. */
+'attribution_unavailable';
 export interface AiccError {
     code: AiccErrorCode;
     message: string;
@@ -216,6 +256,10 @@ export interface AiccError {
     retriable?: boolean;
     details?: JsonValue;
 }
+/** Token quota and resource policy refusals: they reach the client as a detailed kRPC error. */
+export declare const AICC_POLICY_REFUSAL_CODES: readonly AiccErrorCode[];
+/** The AICC error of a refused call (its `code` and `details`), read from the structured kRPC error. */
+export declare function aiccRefusalOf(error: unknown): AiccError | undefined;
 export interface SettingsRevisionConflictDetails {
     expected_revision: number;
     actual_revision: number;
@@ -257,8 +301,9 @@ export interface ModelRequirement {
     vision?: boolean;
     image_generation?: boolean;
     min_context_tokens?: number;
+    video?: VideoGenerationRequirement;
 }
-export interface ModelDisable extends Omit<ModelRequirement, "decision"> {
+export interface ModelDisable extends Omit<ModelRequirement, "decision" | "video"> {
 }
 export interface HelperModelRequirement extends Omit<ModelRequirement, "decision"> {
 }
@@ -809,31 +854,87 @@ export interface AudioEnhanceResponse extends InferenceResponse {
     audio?: ResourceRef;
     stems?: ResourceRef[];
 }
-export interface VideoTextToVideoRequest extends InferenceRequest {
-    prompt: string;
+export interface TimeRange {
+    start_seconds: number;
+    end_seconds: number;
+}
+/** Video generation inputs (doc/aicc/video_generation.md); `id` is referenced from the prompt as `@{id}`. */
+export type KeyframePosition = 'start' | 'end';
+export type VideoCondition = {
+    type: 'reference_image';
+    id: string;
+    resource: ResourceRef;
+} | {
+    type: 'reference_video';
+    id: string;
+    resource: ResourceRef;
+    time_range?: TimeRange;
+    include_audio?: boolean;
+} | {
+    type: 'reference_audio';
+    id: string;
+    resource: ResourceRef;
+    time_range?: TimeRange;
+} | {
+    type: 'keyframe';
+    id: string;
+    resource: ResourceRef;
+    position: KeyframePosition;
+};
+export type VideoConditionKind = VideoCondition['type'];
+export type VideoSize = {
+    short_edge: number;
+} | {
+    width: number;
+    height: number;
+};
+export type VideoAudioMode = 'auto' | 'generate' | 'none';
+export interface VideoOutputSpec {
     duration_seconds?: number;
     aspect_ratio?: string;
-    resolution?: string;
-    generate_audio?: boolean;
+    size?: VideoSize;
+    fps?: number;
+    audio?: VideoAudioMode;
+    media_type?: string;
+}
+/** What a video request demands of a model; used by `route.resolve`, helpers and routing alike. */
+export interface VideoGenerationRequirement {
+    prompt?: boolean;
+    negative_prompt?: boolean;
+    seed?: boolean;
+    reference_images?: number;
+    reference_videos?: number;
+    reference_audios?: number;
+    keyframes?: KeyframePosition[];
+    reference_video_audio?: boolean;
+    time_ranges?: boolean;
+    output?: VideoOutputSpec;
+}
+interface VideoGenerationFields {
+    prompt?: string;
+    negative_prompt?: string;
+    conditions?: VideoCondition[];
+    output?: VideoOutputSpec;
     seed?: number;
-    output?: AiOutputOptions;
 }
-export interface VideoImageToVideoRequest extends InferenceRequest {
-    image: ResourceRef;
-    prompt: string;
-    duration_seconds?: number;
-    aspect_ratio?: string;
-    resolution?: string;
+export interface VideoGenerateRequest extends InferenceRequest, VideoGenerationFields {
 }
-export interface TimeRange {
-    start_seconds: number;
-    end_seconds: number;
+export interface VideoGenerateHelperRequest extends VideoGenerationFields {
+    logical_model: string;
+    requirements?: HelperModelRequirement;
+    trace_id?: string;
+    execution_mode?: AiccExecutionMode;
+    disable?: ModelDisable;
+    policy?: RoutePolicy;
+    idempotency_key?: string;
+    task_options?: AiTaskOptions;
+    session_overlay?: AiccRouteOverlay;
+    session_id?: string;
 }
-export interface VideoToVideoRequest extends InferenceRequest {
+export interface VideoEditRequest extends InferenceRequest {
     video: ResourceRef;
     prompt: string;
-    preserve_motion?: boolean;
-    time_range?: TimeRange;
+    output?: VideoOutputSpec;
 }
 export interface VideoExtendRequest extends InferenceRequest {
     video: ResourceRef;
@@ -849,12 +950,33 @@ export interface VideoUpscaleRequest extends InferenceRequest {
     sharpen?: number;
     output?: AiOutputOptions;
 }
+export interface VideoMetadata {
+    duration_seconds?: number;
+    width?: number;
+    height?: number;
+    fps?: number;
+    has_audio?: boolean;
+}
+export interface VideoDeviation {
+    field: string;
+    requested: JsonValue;
+    actual: JsonValue;
+    source: 'provider' | 'measured';
+}
+/** `provider_metadata` is what the Provider reported; `measured_metadata` is read from the file by AICC when it had the bytes. */
+export interface GeneratedVideo {
+    resource: ResourceRef;
+    media_type?: string;
+    provider_metadata: VideoMetadata;
+    measured_metadata?: VideoMetadata;
+    last_frame?: ResourceRef;
+    deviations?: VideoDeviation[];
+}
 export interface VideoResponse extends InferenceResponse {
-    video?: ResourceRef;
+    videos?: GeneratedVideo[];
 }
-export type VideoTextToVideoResponse = VideoResponse;
-export type VideoImageToVideoResponse = VideoResponse;
-export type VideoToVideoResponse = VideoResponse;
+export type VideoGenerateResponse = VideoResponse;
+export type VideoEditResponse = VideoResponse;
 export type VideoExtendResponse = VideoResponse;
 export type VideoUpscaleResponse = VideoResponse;
 export interface ComputerEnvironment {
@@ -898,7 +1020,11 @@ export interface ComputerUseResponse extends InferenceResponse {
 export type EmptyRequest = Record<string, never>;
 export type ServiceReloadSettingsRequest = EmptyRequest;
 export type RoutingGetRequest = EmptyRequest;
-export type ListModelsRequest = EmptyRequest;
+/** `use` (default): what the caller may use; `manage` (admin): the whole inventory, each model marked `accessible`. */
+export type AiccListView = 'use' | 'manage';
+export interface ListModelsRequest {
+    view?: AiccListView;
+}
 export type ProviderCatalogRequest = EmptyRequest;
 export type ProtocolAdapterListRequest = EmptyRequest;
 export type DriverMetadataUpdateGetReq = EmptyRequest;
@@ -909,18 +1035,235 @@ export interface ServiceReloadSettingsResponse {
     ok: boolean;
     settings_revision: number;
 }
-export interface QuotaQueryRequest {
-    capability?: Capability;
-    method?: string;
+export type QuotaRuleSource = 'admin' | 'user';
+export type QuotaObject = {
+    type: 'user';
+    user_id: string;
+} | {
+    type: 'app';
+    app_id: string;
+} | {
+    type: 'user_app';
+    user_id: string;
+    app_id: string;
+};
+export type QuotaResource = {
+    type: 'all';
+} | {
+    type: 'provider';
+    provider_instance_name: string;
+} | {
+    type: 'model';
+    exact_model: string;
+} | {
+    type: 'hidden';
+};
+export type QuotaPeriod = '4h' | '24h' | '72h' | 'week';
+export type QuotaKind = 'periodic' | 'total';
+export type QuotaStatus = 'normal' | 'near_limit' | 'exhausted' | 'forbidden' | 'disabled' | 'resource_unavailable';
+export interface QuotaPendingPeriod {
+    period: QuotaPeriod;
+    effective_at_ms: number;
+    conflict?: boolean;
+}
+export interface QuotaRule {
+    rule_id: string;
+    source: QuotaRuleSource;
+    object: QuotaObject;
+    resource: QuotaResource;
+    kind: QuotaKind;
+    period?: QuotaPeriod;
+    limit_tokens?: number;
+    account_id?: string;
+    enabled: boolean;
+    deleted?: boolean;
+    pending_period?: QuotaPendingPeriod;
+    version: number;
+    created_by: string;
+    created_at_ms: number;
+    updated_by: string;
+    updated_at_ms: number;
+}
+export interface QuotaUsageState {
+    status: QuotaStatus;
+    window_start_ms?: number;
+    window_end_ms?: number;
+    reset_at_ms: number | null;
+    limit_tokens?: number;
+    granted_tokens?: number;
+    account_start_ms?: number;
+    settled_tokens: number;
+    reserved_tokens: number;
+    pending_tokens: number;
+    available_tokens: number;
+    debt_tokens: number;
+    updated_at_ms: number;
+}
+export interface QuotaRuleView {
+    rule: QuotaRule;
+    state: QuotaUsageState;
+    editable: boolean;
 }
-export interface QuotaView {
-    state: 'normal' | 'near_limit' | 'exhausted';
-    remaining_request_units?: number;
-    remaining_cost?: Money;
-    reset_at?: string;
+export interface QuotaQueryRequest {
+    app_id?: string;
 }
 export interface QuotaQueryResponse {
-    quota: QuotaView;
+    user_id: string;
+    rules: QuotaRuleView[];
+    near_limit_count: number;
+    exhausted_count: number;
+}
+export interface QuotaRuleListRequest {
+    scope?: 'mine' | 'manage';
+    include_deleted?: boolean;
+}
+export interface QuotaRuleListResponse {
+    rules: QuotaRuleView[];
+}
+export interface QuotaAuditRecord {
+    audit_id: string;
+    target_type: string;
+    target_id: string;
+    action: string;
+    operator: string;
+    before?: JsonValue;
+    after?: JsonValue;
+    created_at_ms: number;
+}
+export interface QuotaGrantRecord {
+    grant_id: string;
+    account_id: string;
+    kind: 'initial' | 'recharge';
+    amount_tokens: number;
+    operator: string;
+    note?: string;
+    created_at_ms: number;
+}
+export interface QuotaAccountView {
+    account_id: string;
+    object: QuotaObject;
+    resource: QuotaResource;
+    granted_tokens: number;
+    settled_tokens: number;
+    reserved_tokens: number;
+    pending_tokens: number;
+    available_tokens: number;
+    debt_tokens: number;
+    start_at_ms: number;
+    version: number;
+    updated_at_ms: number;
+    enforced: boolean;
+}
+export interface QuotaRuleDetail {
+    rule: QuotaRuleView;
+    constraints: QuotaRuleView[];
+    blocking_rule_ids: string[];
+    account?: QuotaAccountView;
+    grants?: QuotaGrantRecord[];
+    audit?: QuotaAuditRecord[];
+}
+export interface QuotaRuleDraft {
+    source?: QuotaRuleSource;
+    object: QuotaObject;
+    resource: QuotaResource;
+    kind: QuotaKind;
+    period?: QuotaPeriod;
+    limit_tokens?: number;
+    initial_tokens?: number;
+}
+export interface QuotaRulePreviewResponse {
+    state: QuotaUsageState;
+    existing_account?: QuotaAccountView;
+    conflict_rule_id?: string;
+    other_constraints: QuotaRuleView[];
+}
+export interface QuotaRuleUpdateRequest {
+    rule_id: string;
+    expected_version: number;
+    limit_tokens?: number;
+    period?: QuotaPeriod;
+    enabled?: boolean;
+    cancel_pending_period?: boolean;
+}
+export interface QuotaRechargeRequest {
+    account_id: string;
+    recharge_id: string;
+    amount_tokens: number;
+    note?: string;
+}
+export interface QuotaRechargeResponse {
+    recharge: QuotaGrantRecord;
+    account: QuotaAccountView;
+    replayed: boolean;
+}
+export interface QuotaBlockingRule {
+    rule_id: string;
+    source: QuotaRuleSource;
+    object: QuotaObject;
+    resource: QuotaResource;
+    kind: QuotaKind;
+    period?: QuotaPeriod;
+    state: QuotaUsageState;
+    recoverable: boolean;
+}
+/** `details` of `quota_exhausted` / `quota_budget_exceeded`. */
+export interface QuotaDenialDetails {
+    required_tokens: number;
+    max_allowed_tokens: number;
+    provider_instance_name: string;
+    exact_model: string;
+    blocking: QuotaBlockingRule[];
+    reset_at_ms: number | null;
+}
+export type VisibilityEntry = {
+    type: 'all_providers';
+} | {
+    type: 'provider_all_models';
+    provider_instance_name: string;
+} | {
+    type: 'provider_models';
+    provider_instance_name: string;
+    exact_models: string[];
+};
+export interface VisibilitySubjectPolicy {
+    subject: string;
+    entries: VisibilityEntry[];
+    updated_by: string;
+    updated_at_ms: number;
+}
+export interface VisibilityGetResponse {
+    revision: number;
+    subjects: VisibilitySubjectPolicy[];
+    providers: {
+        provider_instance_name: string;
+        enabled: boolean;
+        exact_models: string[];
+    }[];
+    unexposed_models: string[];
+}
+export interface VisibilityUpdateRequest {
+    expected_revision: number;
+    subject: string;
+    entries: VisibilityEntry[];
+}
+export interface VisibilityPreviewRequest {
+    user_id?: string;
+    draft?: {
+        subject: string;
+        entries: VisibilityEntry[];
+    };
+}
+export interface VisibilityPreviewResponse {
+    user_id: string;
+    grants: {
+        provider_instance_name: string;
+        exact_model?: string;
+        sources: string[];
+    }[];
+    added?: string[];
+    removed?: string[];
+    affected_users?: string[];
+    caller_loses?: string[];
 }
 export interface ProviderCatalogEntry {
     provider_profile_id: string;
@@ -1024,6 +1367,7 @@ export interface ProviderRefreshModelsResponse {
 }
 export interface ProviderListRequest {
     method?: string;
+    view?: AiccListView;
 }
 export type ProviderInstanceAuthMode = 'api_key' | 'dynamic_login';
 export interface ProviderInstanceAuthView {
@@ -1116,6 +1460,8 @@ export interface QueryUsageRequest {
     output_mode?: 'summary' | 'events' | 'summary_and_events';
     limit?: number;
     cursor?: string;
+    /** Admins only: every user of the Zone instead of the caller alone. */
+    zone_wide?: boolean;
 }
 export interface UsageAggregate {
     total_requests: number;
@@ -1145,6 +1491,8 @@ export interface AiccUsageEvent {
     request_units?: number;
     usage_json: AiUsage;
     finance_snapshot_json?: JsonValue;
+    operator_id?: string;
+    attribution?: JsonValue;
     created_at_ms: number;
 }
 export interface UsageGroupedRow {
@@ -1292,9 +1640,9 @@ export declare class AiccClient {
     audioSpeechRecognition(r: AudioSpeechRecognitionRequest): Promise<AudioSpeechRecognitionResponse>;
     audioMusic(r: AudioMusicRequest): Promise<AudioMusicResponse>;
     audioEnhance(r: AudioEnhanceRequest): Promise<AudioEnhanceResponse>;
-    videoTextToVideo(r: VideoTextToVideoRequest): Promise<VideoResponse>;
-    videoImageToVideo(r: VideoImageToVideoRequest): Promise<VideoResponse>;
-    videoToVideo(r: VideoToVideoRequest): Promise<VideoResponse>;
+    videoGenerate(r: VideoGenerateRequest): Promise<VideoResponse>;
+    helperVideoGenerate(r: VideoGenerateHelperRequest): Promise<VideoResponse>;
+    videoEdit(r: VideoEditRequest): Promise<VideoResponse>;
     videoExtend(r: VideoExtendRequest): Promise<VideoResponse>;
     videoUpscale(r: VideoUpscaleRequest): Promise<VideoResponse>;
     computerUse(r: ComputerUseRequest): Promise<ComputerUseResponse>;
@@ -1315,12 +1663,48 @@ export declare class AiccClient {
     updateProvider(r: ProviderUpdateRequest): Promise<ProviderUpdateResponse>;
     deleteProvider(r: ProviderDeleteRequest): Promise<ProviderDeleteResponse>;
     refreshProviderModels(r: ProviderRefreshModelsRequest): Promise<ProviderRefreshModelsResponse>;
-    listModels(): Promise<JsonValue>;
+    listModels(r?: ListModelsRequest): Promise<JsonValue>;
+    listQuotaRules(r?: QuotaRuleListRequest): Promise<QuotaRuleListResponse>;
+    getQuotaRule(ruleId: string): Promise<QuotaRuleDetail>;
+    previewQuotaRule(draft: QuotaRuleDraft): Promise<QuotaRulePreviewResponse>;
+    createQuotaRule(draft: QuotaRuleDraft): Promise<QuotaRuleView>;
+    updateQuotaRule(r: QuotaRuleUpdateRequest): Promise<QuotaRuleView>;
+    deleteQuotaRule(ruleId: string, expectedVersion: number): Promise<{
+        ok: boolean;
+        rule_id: string;
+    }>;
+    getQuotaAccount(accountId: string): Promise<{
+        account: QuotaAccountView;
+        grants: QuotaGrantRecord[];
+    }>;
+    rechargeQuotaAccount(r: QuotaRechargeRequest): Promise<QuotaRechargeResponse>;
+    getQuotaRecharge(rechargeId: string): Promise<{
+        recharge?: QuotaGrantRecord | undefined;
+        account?: QuotaAccountView | undefined;
+    }>;
+    getVisibility(): Promise<VisibilityGetResponse>;
+    updateVisibility(r: VisibilityUpdateRequest): Promise<VisibilityGetResponse>;
+    previewVisibility(r?: VisibilityPreviewRequest): Promise<VisibilityPreviewResponse>;
     getDriverMetadataUpdate(): Promise<DriverMetadataUpdateView>;
     setDriverMetadataUpdate(r: DriverMetadataUpdateSetReq): Promise<DriverMetadataUpdateSetResponse>;
 }
 export declare function decisionRequirements(request: Pick<DecisionEvaluateRequest, 'state' | 'questions'>): ModelRequirement;
 export declare function validateDecisionRequest(request: DecisionEvaluateRequest): void;
 export declare function validateDecisionAnswers(request: DecisionEvaluateRequest, answers: DecisionAnswer[]): void;
+export type VideoPromptSegment = {
+    text: string;
+} | {
+    reference: string;
+};
+/** Splits a prompt into text and `@{id}` references; `@@` is a literal `@`, any other `@` stays as written. */
+export declare function parseVideoPrompt(prompt: string): VideoPromptSegment[];
+export declare function validateVideoOutput(output: unknown, field?: string): asserts output is VideoOutputSpec;
+/** Client-side check of the `video.generate` / `helper.video_generate` body, matching the server's validation. */
+export declare function validateVideoGeneration(request: VideoGenerationFields): void;
+export declare function validateVideoEdit(request: VideoEditRequest): void;
+/** The model requirement a video request implies, merged with a helper's `requirements.video` (which can only tighten it). */
+export declare function videoGenerationRequirement(request: VideoGenerationFields & {
+    requirements?: HelperModelRequirement;
+}): VideoGenerationRequirement;
 export {};
 //# sourceMappingURL=aicc_client.d.ts.map