@wix/auto_sdk_containers_project-jobs 1.0.0

package/build/internal/es/index.typings.d.mts

@@ -0,0 +1,1057 @@
+import * as _wix_sdk_types from '@wix/sdk-types';
+import { QuerySpec, Query, NonNullablePaths } from '@wix/sdk-types';
+
+interface ProjectJob {
+    /**
+     * ProjectJob ID.
+     * @format GUID
+     * @readonly
+     */
+    _id?: string | null;
+    /**
+     * ID of the parent ContainersProject this job belongs to.
+     * @format GUID
+     */
+    projectId?: string;
+    /** Type of code generation job. */
+    jobType?: JobTypeWithLiterals;
+    /** Platform intent for the job. */
+    platform?: PlatformWithLiterals;
+    /** Current execution status of the job. */
+    jobStatus?: JobStatusWithLiterals;
+    /**
+     * Prompt describing the code generation task.
+     * @minLength 1
+     * @maxLength 10000
+     */
+    prompt?: string;
+    /**
+     * Attachments such as Figma links or image URLs.
+     * @maxSize 20
+     */
+    attachments?: Attachment[];
+    /** Arbitrary metadata for extensibility. */
+    metadata?: Record<string, string>;
+    /**
+     * Coding agent session ID the AppSmith agent should resume for this job.
+     * @format GUID
+     */
+    codingAgentSessionId?: string;
+    /**
+     * Error details from the most recent failure.
+     * @readonly
+     * @maxLength 5000
+     */
+    failureReason?: string;
+    /**
+     * Date and time the job started processing.
+     * @readonly
+     */
+    startedDate?: Date | null;
+    /**
+     * Date and time the job completed or failed.
+     * @readonly
+     */
+    completedDate?: Date | null;
+    /**
+     * Revision number, which increments by 1 each time the ProjectJob is updated.
+     * @readonly
+     */
+    revision?: string | null;
+    /**
+     * Date and time the ProjectJob was created.
+     * @readonly
+     */
+    _createdDate?: Date | null;
+    /**
+     * Date and time the ProjectJob was last updated.
+     * @readonly
+     */
+    _updatedDate?: Date | null;
+    /**
+     * Public assistant answer, persisted when the agent reports AGENT_DONE.
+     * @readonly
+     * @maxLength 100000
+     */
+    assistantResponse?: string | null;
+    /**
+     * Whether this job's owner is exempt from AI credits, decided once at creation time.
+     * @readonly
+     */
+    creditsExempt?: boolean;
+    /**
+     * The AI-credits cost (in USD) resolved for this job at creation time. Charged unchanged when
+     * the job completes, regardless of any later config change.
+     * @readonly
+     * @maxLength 20
+     */
+    creditsCostUsd?: string;
+    /**
+     * Chat suggestion chips proposed by a GENERATE_SUGGESTIONS job. Empty for every other job type.
+     * Set only via UpdateProjectJobStatus, alongside AGENT_DONE — never at creation time.
+     * @readonly
+     * @maxSize 5
+     */
+    suggestions?: Suggestion[];
+}
+declare enum JobType {
+    INITIAL_GENERATION = "INITIAL_GENERATION",
+    USER_REQUEST = "USER_REQUEST",
+    /**
+     * Reads the current code and recent conversation to propose chat suggestion chips. Read-only —
+     * produces no code changes and no checkpoint.
+     */
+    GENERATE_SUGGESTIONS = "GENERATE_SUGGESTIONS"
+}
+/** @enumType */
+type JobTypeWithLiterals = JobType | 'INITIAL_GENERATION' | 'USER_REQUEST' | 'GENERATE_SUGGESTIONS';
+declare enum Platform {
+    IOS = "IOS",
+    ANDROID = "ANDROID",
+    REACT_NATIVE = "REACT_NATIVE",
+    /** Himalaya Mobile (Wix SDUI/OTA content package) — built headlessly on an on-demand remote machine. */
+    HIMALAYA_MOBILE = "HIMALAYA_MOBILE"
+}
+/** @enumType */
+type PlatformWithLiterals = Platform | 'IOS' | 'ANDROID' | 'REACT_NATIVE' | 'HIMALAYA_MOBILE';
+declare enum JobStatus {
+    PENDING = "PENDING",
+    IN_PROGRESS = "IN_PROGRESS",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    CANCELLED = "CANCELLED",
+    /**
+     * The agent finished coding; the job has not been charged or completed yet.
+     * Intermediate state between IN_PROGRESS and COMPLETED, orchestrated by containers-projects.
+     */
+    AGENT_DONE = "AGENT_DONE"
+}
+/** @enumType */
+type JobStatusWithLiterals = JobStatus | 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'AGENT_DONE';
+interface Attachment {
+    /** Type of attachment. */
+    type?: AttachmentTypeWithLiterals;
+    /**
+     * URL or reference to the attachment content.
+     * @maxLength 2000
+     */
+    url?: string;
+    /**
+     * Optional display name for the attachment.
+     * @maxLength 200
+     */
+    displayName?: string;
+}
+declare enum AttachmentType {
+    FIGMA = "FIGMA",
+    IMAGE = "IMAGE",
+    URL = "URL"
+}
+/** @enumType */
+type AttachmentTypeWithLiterals = AttachmentType | 'FIGMA' | 'IMAGE' | 'URL';
+interface Suggestion {
+    /**
+     * Short label shown on the suggestion chip.
+     * @maxLength 60
+     */
+    label?: string;
+    /**
+     * Prompt text inserted into the chat input when the chip is tapped.
+     * @maxLength 2000
+     */
+    prompt?: string;
+}
+interface CreateProjectJobRequest {
+    /** ProjectJob to be created. */
+    projectJob: ProjectJob;
+}
+interface CreateProjectJobResponse {
+    /** The created ProjectJob. */
+    projectJob?: ProjectJob;
+}
+interface GetProjectJobRequest {
+    /**
+     * ID of the ProjectJob to retrieve.
+     * @format GUID
+     */
+    projectJobId: string;
+}
+interface GetProjectJobResponse {
+    /** The requested ProjectJob. */
+    projectJob?: ProjectJob;
+}
+interface GetCurrentProjectJobRequest {
+    /**
+     * ID of the project to get the current job for.
+     * @format GUID
+     */
+    projectId: string;
+}
+interface GetCurrentProjectJobResponse {
+    /** The highest-priority job, or absent if no actionable job exists. */
+    projectJob?: ProjectJob;
+}
+interface UpdateProjectJobStatusRequest {
+    /**
+     * ID of the job to update.
+     * @format GUID
+     */
+    projectJobId: string;
+    /** New status for the job. */
+    jobStatus: JobStatusWithLiterals;
+    /** Current revision for optimistic locking. */
+    revision: string | null;
+    /**
+     * Failure reason (required when status is FAILED).
+     * @maxLength 5000
+     */
+    failureReason?: string;
+    /**
+     * Suggested next requests to show after the job finishes.
+     * @maxSize 5
+     */
+    suggestions?: Suggestion[];
+    /**
+     * Public assistant answer. Only supplied with AGENT_DONE; preserved on later transitions.
+     * @maxLength 100000
+     */
+    assistantResponse?: string | null;
+}
+interface UpdateProjectJobStatusResponse {
+    /** The updated job. */
+    projectJob?: ProjectJob;
+}
+interface QueryProjectJobsRequest {
+    /**
+     * ID of the project.
+     * @format GUID
+     */
+    projectId: string;
+    /** Cursor query with optional filter, sorting, and paging. */
+    query?: CursorQuery;
+}
+interface CursorQuery extends CursorQueryPagingMethodOneOf {
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
+    cursorPaging?: CursorPaging;
+    /**
+     * Filter object.
+     *
+     * Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
+     */
+    filter?: Record<string, any> | null;
+    /**
+     * Sort object.
+     *
+     * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
+     * @maxSize 5
+     */
+    sort?: Sorting[];
+}
+/** @oneof */
+interface CursorQueryPagingMethodOneOf {
+    /**
+     * Cursor paging options.
+     *
+     * Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+     */
+    cursorPaging?: CursorPaging;
+}
+interface Sorting {
+    /**
+     * Name of the field to sort by.
+     * @maxLength 512
+     */
+    fieldName?: string;
+    /** Sort order. */
+    order?: SortOrderWithLiterals;
+}
+declare enum SortOrder {
+    ASC = "ASC",
+    DESC = "DESC"
+}
+/** @enumType */
+type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
+interface CursorPaging {
+    /**
+     * Maximum number of items to return in the results.
+     * @max 100
+     */
+    limit?: number | null;
+    /**
+     * Pointer to the next or previous page in the list of results.
+     *
+     * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
+     * Not relevant for the first request.
+     * @maxLength 16000
+     */
+    cursor?: string | null;
+}
+interface QueryProjectJobsResponse {
+    /** Jobs matching the filter criteria. */
+    projectJobs?: ProjectJob[];
+    /** Paging metadata for cursor-based pagination. */
+    pagingMetadata?: CursorPagingMetadata;
+}
+interface CursorPagingMetadata {
+    /** Number of items returned in current page. */
+    count?: number | null;
+    /** Cursor strings that point to the next page, previous page, or both. */
+    cursors?: Cursors;
+    /**
+     * Whether there are more pages to retrieve following the current page.
+     *
+     * + `true`: Another page of results can be retrieved.
+     * + `false`: This is the last page.
+     */
+    hasNext?: boolean | null;
+}
+interface Cursors {
+    /**
+     * Cursor string pointing to the next page in the list of results.
+     * @maxLength 16000
+     */
+    next?: string | null;
+    /**
+     * Cursor pointing to the previous page in the list of results.
+     * @maxLength 16000
+     */
+    prev?: string | null;
+}
+interface ClearProjectJobAssistantResponseRequest {
+    /**
+     * ID of the job whose delivered answer should be dropped.
+     * @format GUID
+     */
+    projectJobId: string;
+}
+interface ClearProjectJobAssistantResponseResponse {
+    /** The job with no assistant answer left on it. */
+    projectJob?: ProjectJob;
+}
+interface CancelProjectJobRequest {
+    /**
+     * ID of the job to cancel.
+     * @format GUID
+     */
+    projectJobId: string;
+    /** Current revision for optimistic locking. */
+    revision: string | null;
+}
+interface CancelProjectJobResponse {
+    /** The cancelled job. */
+    projectJob?: ProjectJob;
+}
+interface GetLatestProjectJobRequest {
+    /**
+     * ID of the project to get the latest job for.
+     * @format GUID
+     */
+    projectId: string;
+}
+interface GetLatestProjectJobResponse {
+    /**
+     * The full ProjectJob (same entity shape as GetProjectJob/GetCurrentProjectJob), or absent
+     * if the project has no jobs yet.
+     */
+    projectJob?: ProjectJob;
+}
+interface CreateSuggestionsJobRequest {
+    /**
+     * ID of the project receiving the suggestions job.
+     * @format GUID
+     */
+    projectId: string;
+    /**
+     * ID of the conversation receiving the suggestions.
+     * @format GUID
+     */
+    conversationId: string;
+    /**
+     * ID of the job whose diff the suggestions should be grounded in — the build/edit job the client
+     * just observed complete. Omitted when there is no specific triggering job (e.g. reopening an
+     * existing, already-built project's conversation). A wrapper, not a plain string: proto3's
+     * string default ("") is indistinguishable on the wire from an explicitly-set empty string, and
+     * the format validator rejected that default as "not a valid GUID" for every legitimately
+     * omitted caller — confirmed by direct testing against a real client request.
+     * @format GUID
+     */
+    sinceJobId?: string | null;
+}
+interface CreateSuggestionsJobResponse {
+    /** The queued suggestions job. */
+    projectJob?: ProjectJob;
+}
+interface OpenProjectJobActivityRequest {
+    /**
+     * ID of the project job.
+     * @format GUID
+     */
+    projectJobId: string;
+    /**
+     * ID of the activity stream.
+     * @format GUID
+     */
+    streamId: string;
+}
+interface OpenProjectJobActivityResponse {
+    /**
+     * ID of the project job owning this activity.
+     * @format GUID
+     */
+    jobId?: string;
+    /**
+     * ID of the activity stream.
+     * @format GUID
+     */
+    streamId?: string;
+    /** Highest contiguous persisted batch sequence, or zero before the first batch. */
+    latestSequence?: string;
+}
+interface ReportProjectJobActivityRequest {
+    /**
+     * ID of the project job.
+     * @format GUID
+     */
+    projectJobId: string;
+    /** Semantic activity batch to persist. Its Base64-encoded protobuf must fit within 16,000 characters. */
+    batch: ActivityBatch;
+}
+interface ActivityBatch {
+    /**
+     * ID of the project job owning this activity.
+     * @format GUID
+     */
+    jobId?: string;
+    /**
+     * ID of the activity stream.
+     * @format GUID
+     */
+    streamId?: string;
+    /** Sequence within the stream; report batches start at one. */
+    batchSequence?: string;
+    /** Activity payload schema version; currently one. */
+    schemaVersion?: number;
+    /**
+     * Semantic reporting profile; currently semantic-progress-v1.
+     * @maxLength 64
+     */
+    reportingProfileVersion?: string;
+    /** Workflow that produced the activity. */
+    workflow?: ActivityWorkflowWithLiterals;
+    /**
+     * Ordered semantic progress events in this batch.
+     * @maxSize 16
+     */
+    events?: ActivityEvent[];
+}
+declare enum ActivityWorkflow {
+    ACTIVITY_WORKFLOW_UNKNOWN = "ACTIVITY_WORKFLOW_UNKNOWN",
+    ACTIVITY_INITIAL_GENERATION = "ACTIVITY_INITIAL_GENERATION",
+    ACTIVITY_USER_REQUEST = "ACTIVITY_USER_REQUEST"
+}
+/** @enumType */
+type ActivityWorkflowWithLiterals = ActivityWorkflow | 'ACTIVITY_WORKFLOW_UNKNOWN' | 'ACTIVITY_INITIAL_GENERATION' | 'ACTIVITY_USER_REQUEST';
+interface ActivityEvent {
+    /**
+     * ID of this activity event.
+     * @format GUID
+     */
+    eventId?: string;
+    /**
+     * Timestamp when the event occurred, in ISO 8601 format.
+     * @maxLength 40
+     */
+    occurredAt?: string;
+    /** Reported producer of the event. */
+    source?: ActivitySourceWithLiterals;
+    /** Semantic activity event type. */
+    type?: ActivityEventTypeWithLiterals;
+    /**
+     * Identifier linking updates to the same work item.
+     * @maxLength 128
+     */
+    activityId?: string;
+    /**
+     * Work-item category: feature, fix, integration, or design.
+     * @maxLength 32
+     */
+    category?: string;
+    /**
+     * Single-line progress summary.
+     * @maxLength 240
+     */
+    summary?: string;
+    /**
+     * Host phase: execution, build, validate, or publish.
+     * @maxLength 32
+     */
+    phase?: string;
+    /** Attempt number for a host phase. */
+    attempt?: number;
+}
+declare enum ActivitySource {
+    ACTIVITY_SOURCE_UNKNOWN = "ACTIVITY_SOURCE_UNKNOWN",
+    AGENT = "AGENT",
+    HOST = "HOST"
+}
+/** @enumType */
+type ActivitySourceWithLiterals = ActivitySource | 'ACTIVITY_SOURCE_UNKNOWN' | 'AGENT' | 'HOST';
+declare enum ActivityEventType {
+    ACTIVITY_EVENT_TYPE_UNKNOWN = "ACTIVITY_EVENT_TYPE_UNKNOWN",
+    WORK_ITEM_STARTED = "WORK_ITEM_STARTED",
+    WORK_ITEM_UPDATED = "WORK_ITEM_UPDATED",
+    WORK_ITEM_COMPLETED = "WORK_ITEM_COMPLETED",
+    NOTICE = "NOTICE",
+    PHASE_STARTED = "PHASE_STARTED",
+    PHASE_COMPLETED = "PHASE_COMPLETED",
+    PHASE_FAILED = "PHASE_FAILED",
+    ACTIVITY_COMPLETED = "ACTIVITY_COMPLETED",
+    ACTIVITY_INTERRUPTED = "ACTIVITY_INTERRUPTED"
+}
+/** @enumType */
+type ActivityEventTypeWithLiterals = ActivityEventType | 'ACTIVITY_EVENT_TYPE_UNKNOWN' | 'WORK_ITEM_STARTED' | 'WORK_ITEM_UPDATED' | 'WORK_ITEM_COMPLETED' | 'NOTICE' | 'PHASE_STARTED' | 'PHASE_COMPLETED' | 'PHASE_FAILED' | 'ACTIVITY_COMPLETED' | 'ACTIVITY_INTERRUPTED';
+interface ReportProjectJobActivityResponse {
+    /**
+     * ID of the project job owning this activity.
+     * @format GUID
+     */
+    jobId?: string;
+    /**
+     * ID of the activity stream.
+     * @format GUID
+     */
+    streamId?: string;
+    /** Sequence of the batch accepted by this request. */
+    acceptedSequence?: string;
+    /** Highest contiguous persisted batch sequence, or zero before the first batch. */
+    latestSequence?: string;
+}
+interface QueryProjectJobActivityRequest {
+    /**
+     * ID of the project job.
+     * @format GUID
+     */
+    projectJobId: string;
+    /**
+     * Omit or leave empty to query the latest stream. Non-empty UUIDs are validated by the service
+     * so the original string wire type can accept omission without GUID validation rejecting it.
+     * @maxLength 36
+     */
+    streamId?: string;
+    /** Return batches after this sequence; zero starts at the first batch. */
+    afterSequence?: string;
+    /** Maximum batches to return; defaults to 50 and is capped at 100. */
+    limit?: number;
+}
+interface QueryProjectJobActivityResponse {
+    /** Persisted batches in contiguous sequence order. */
+    batches?: ActivityBatch[];
+    /** Highest contiguous persisted batch sequence, or zero before the first batch. */
+    latestSequence?: string;
+    /** Sequence immediately after the last returned batch. */
+    nextSequence?: string;
+    /** Whether requested history has expired. */
+    historyExpired?: boolean;
+    /**
+     * ID of the project job owning this activity.
+     * @format GUID
+     */
+    jobId?: string;
+    /**
+     * ID of the activity stream.
+     * @format GUID
+     */
+    streamId?: string;
+    /**
+     * Configured Duplexer publisher application ID, when available.
+     * @format GUID
+     */
+    notificationAppDefId?: string;
+}
+interface DomainEvent extends DomainEventBodyOneOf {
+    createdEvent?: EntityCreatedEvent;
+    updatedEvent?: EntityUpdatedEvent;
+    deletedEvent?: EntityDeletedEvent;
+    actionEvent?: ActionEvent;
+    /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
+    _id?: string;
+    /**
+     * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
+     * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
+     */
+    entityFqdn?: string;
+    /**
+     * Event action name, placed at the top level to make it easier for users to dispatch messages.
+     * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
+     */
+    slug?: string;
+    /** ID of the entity associated with the event. */
+    entityId?: string;
+    /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
+    eventTime?: Date | null;
+    /**
+     * Whether the event was triggered as a result of a privacy regulation application
+     * (for example, GDPR).
+     */
+    triggeredByAnonymizeRequest?: boolean | null;
+    /** If present, indicates the action that triggered the event. */
+    originatedFrom?: string | null;
+    /**
+     * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at `16:00` and then again at `16:01`, the second update will always have a higher sequence number.
+     * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
+     */
+    entityEventSequence?: string | null;
+}
+/** @oneof */
+interface DomainEventBodyOneOf {
+    createdEvent?: EntityCreatedEvent;
+    updatedEvent?: EntityUpdatedEvent;
+    deletedEvent?: EntityDeletedEvent;
+    actionEvent?: ActionEvent;
+}
+interface EntityCreatedEvent {
+    entity?: string;
+}
+interface RestoreInfo {
+    deletedDate?: Date | null;
+}
+interface EntityUpdatedEvent {
+    /**
+     * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
+     * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
+     * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
+     */
+    currentEntity?: string;
+}
+interface EntityDeletedEvent {
+    /** Entity that was deleted. */
+    deletedEntity?: string | null;
+}
+interface ActionEvent {
+    body?: string;
+}
+interface MessageEnvelope {
+    /**
+     * App instance ID.
+     * @format GUID
+     */
+    instanceId?: string | null;
+    /**
+     * Event type.
+     * @maxLength 150
+     */
+    eventType?: string;
+    /** The identification type and identity data. */
+    identity?: IdentificationData;
+    /** Stringify payload. */
+    data?: string;
+    /** Details related to the account */
+    accountInfo?: AccountInfo;
+}
+interface IdentificationData extends IdentificationDataIdOneOf {
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
+    anonymousVisitorId?: string;
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
+    memberId?: string;
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
+    wixUserId?: string;
+    /**
+     * ID of an app.
+     * @format GUID
+     */
+    appId?: string;
+    /** @readonly */
+    identityType?: WebhookIdentityTypeWithLiterals;
+}
+/** @oneof */
+interface IdentificationDataIdOneOf {
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
+    anonymousVisitorId?: string;
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
+    memberId?: string;
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
+    wixUserId?: string;
+    /**
+     * ID of an app.
+     * @format GUID
+     */
+    appId?: string;
+}
+declare enum WebhookIdentityType {
+    UNKNOWN = "UNKNOWN",
+    ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
+    MEMBER = "MEMBER",
+    WIX_USER = "WIX_USER",
+    APP = "APP"
+}
+/** @enumType */
+type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
+interface AccountInfo {
+    /**
+     * ID of the Wix account associated with the event.
+     * @format GUID
+     */
+    accountId?: string | null;
+    /**
+     * ID of the parent Wix account. Only included when accountId belongs to a child account.
+     * @format GUID
+     */
+    parentAccountId?: string | null;
+    /**
+     * ID of the Wix site associated with the event. Only included when the event is tied to a specific site.
+     * @format GUID
+     */
+    siteId?: string | null;
+}
+/**
+ * Creates a new ProjectJob.
+ * @param projectJob - ProjectJob to be created.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField projectJob
+ * @requiredField projectJob.platform
+ * @requiredField projectJob.projectId
+ * @requiredField projectJob.prompt
+ * @permissionId containers:project_jobs:v1:project_job:create_project_job
+ * @returns The created ProjectJob.
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.CreateProjectJob
+ */
+declare function createProjectJob(projectJob: NonNullablePaths<ProjectJob, `platform` | `projectId` | `prompt`, 0>): Promise<NonNullablePaths<ProjectJob, `projectId` | `jobType` | `platform` | `jobStatus` | `prompt` | `attachments` | `attachments.${number}.type` | `attachments.${number}.url` | `attachments.${number}.displayName` | `codingAgentSessionId` | `failureReason` | `creditsExempt` | `creditsCostUsd` | `suggestions` | `suggestions.${number}.label` | `suggestions.${number}.prompt`, 2>>;
+/**
+ * Retrieves a ProjectJob by ID.
+ * @param projectJobId - ID of the ProjectJob to retrieve.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField projectJobId
+ * @permissionId containers:project_jobs:v1:project_job:get_project_job
+ * @returns The requested ProjectJob.
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.GetProjectJob
+ */
+declare function getProjectJob(projectJobId: string): Promise<NonNullablePaths<ProjectJob, `projectId` | `jobType` | `platform` | `jobStatus` | `prompt` | `attachments` | `attachments.${number}.type` | `attachments.${number}.url` | `attachments.${number}.displayName` | `codingAgentSessionId` | `failureReason` | `creditsExempt` | `creditsCostUsd` | `suggestions` | `suggestions.${number}.label` | `suggestions.${number}.prompt`, 2>>;
+/**
+ * Gets the highest-priority job that the agent should work on next.
+ * @param projectId - ID of the project to get the current job for.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField projectId
+ * @permissionId containers:project_jobs:v1:project_job:get_current_project_job
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.GetCurrentProjectJob
+ */
+declare function getCurrentProjectJob(projectId: string): Promise<NonNullablePaths<GetCurrentProjectJobResponse, `projectJob.projectId` | `projectJob.jobType` | `projectJob.platform` | `projectJob.jobStatus` | `projectJob.prompt` | `projectJob.attachments` | `projectJob.attachments.${number}.type` | `projectJob.attachments.${number}.url` | `projectJob.attachments.${number}.displayName` | `projectJob.codingAgentSessionId` | `projectJob.failureReason` | `projectJob.creditsExempt` | `projectJob.creditsCostUsd` | `projectJob.suggestions` | `projectJob.suggestions.${number}.label` | `projectJob.suggestions.${number}.prompt`, 3>>;
+/**
+ * Updates the status of a job with state-machine enforcement.
+ * @param projectJobId - ID of the job to update.
+ * @param jobStatus - New status for the job.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField jobStatus
+ * @requiredField options.revision
+ * @requiredField projectJobId
+ * @permissionId containers:project_jobs:v1:project_job:update_project_job_status
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.UpdateProjectJobStatus
+ */
+declare function updateProjectJobStatus(projectJobId: string, jobStatus: JobStatusWithLiterals, options?: NonNullablePaths<UpdateProjectJobStatusOptions, `revision`, 0>): Promise<NonNullablePaths<UpdateProjectJobStatusResponse, `projectJob.projectId` | `projectJob.jobType` | `projectJob.platform` | `projectJob.jobStatus` | `projectJob.prompt` | `projectJob.attachments` | `projectJob.attachments.${number}.type` | `projectJob.attachments.${number}.url` | `projectJob.attachments.${number}.displayName` | `projectJob.codingAgentSessionId` | `projectJob.failureReason` | `projectJob.creditsExempt` | `projectJob.creditsCostUsd` | `projectJob.suggestions` | `projectJob.suggestions.${number}.label` | `projectJob.suggestions.${number}.prompt`, 3>>;
+interface UpdateProjectJobStatusOptions {
+    /** Current revision for optimistic locking. */
+    revision: string | null;
+    /**
+     * Failure reason (required when status is FAILED).
+     * @maxLength 5000
+     */
+    failureReason?: string;
+    /**
+     * Suggested next requests to show after the job finishes.
+     * @maxSize 5
+     */
+    suggestions?: Suggestion[];
+    /**
+     * Public assistant answer. Only supplied with AGENT_DONE; preserved on later transitions.
+     * @maxLength 100000
+     */
+    assistantResponse?: string | null;
+}
+/**
+ * Queries jobs for a project with optional filtering.
+ * @internal
+ * @documentationMaturity preview
+ * @permissionId containers:project_jobs:v1:project_job:query_project_jobs
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.QueryProjectJobs
+ */
+declare function queryProjectJobs(options: QueryProjectJobsOptions): ProjectJobsQueryBuilder;
+interface QueryProjectJobsOptions {
+    /**
+     * ID of the project.
+     * @format GUID
+     */
+    projectId: string;
+}
+interface QueryCursorResult {
+    cursors: Cursors;
+    hasNext: () => boolean;
+    hasPrev: () => boolean;
+    length: number;
+    pageSize: number;
+}
+interface ProjectJobsQueryResult extends QueryCursorResult {
+    items: ProjectJob[];
+    query: ProjectJobsQueryBuilder;
+    next: () => Promise<ProjectJobsQueryResult>;
+    prev: () => Promise<ProjectJobsQueryResult>;
+}
+interface ProjectJobsQueryBuilder {
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    eq: (propertyName: '_id' | 'projectId' | 'jobStatus', value: any) => ProjectJobsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    ne: (propertyName: '_id' | 'projectId' | 'jobStatus', value: any) => ProjectJobsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    ge: (propertyName: '_id' | 'projectId', value: any) => ProjectJobsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    gt: (propertyName: '_id' | 'projectId', value: any) => ProjectJobsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    le: (propertyName: '_id' | 'projectId', value: any) => ProjectJobsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    lt: (propertyName: '_id' | 'projectId', value: any) => ProjectJobsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `string`.
+     * @param string - String to compare against. Case-insensitive.
+     * @documentationMaturity preview
+     */
+    startsWith: (propertyName: '_id' | 'projectId', value: string) => ProjectJobsQueryBuilder;
+    /** @documentationMaturity preview */
+    in: (propertyName: '_id' | 'projectId' | 'jobStatus', value: any) => ProjectJobsQueryBuilder;
+    /** @documentationMaturity preview */
+    exists: (propertyName: '_id' | 'projectId' | 'jobStatus', value: boolean) => ProjectJobsQueryBuilder;
+    /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
+     * @documentationMaturity preview
+     */
+    ascending: (...propertyNames: Array<'_id' | 'projectId' | 'jobStatus'>) => ProjectJobsQueryBuilder;
+    /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
+     * @documentationMaturity preview
+     */
+    descending: (...propertyNames: Array<'_id' | 'projectId' | 'jobStatus'>) => ProjectJobsQueryBuilder;
+    /** @param limit - Number of items to return, which is also the `pageSize` of the results object.
+     * @documentationMaturity preview
+     */
+    limit: (limit: number) => ProjectJobsQueryBuilder;
+    /** @param cursor - A pointer to specific record
+     * @documentationMaturity preview
+     */
+    skipTo: (cursor: string) => ProjectJobsQueryBuilder;
+    /** @documentationMaturity preview */
+    find: () => Promise<ProjectJobsQueryResult>;
+}
+/**
+ * @hidden
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.QueryProjectJobs
+ * @requiredField query
+ * @requiredField options
+ */
+declare function typedQueryProjectJobs(query: ProjectJobQuery, options: QueryProjectJobsOptions): Promise<NonNullablePaths<QueryProjectJobsResponse, `projectJobs` | `projectJobs.${number}.projectId` | `projectJobs.${number}.jobType` | `projectJobs.${number}.platform` | `projectJobs.${number}.jobStatus` | `projectJobs.${number}.prompt` | `projectJobs.${number}.codingAgentSessionId` | `projectJobs.${number}.failureReason` | `projectJobs.${number}.creditsExempt` | `projectJobs.${number}.creditsCostUsd`, 2>>;
+interface ProjectJobQuerySpec extends QuerySpec {
+    paging: 'cursor';
+    wql: [
+        {
+            fields: ['_id', 'jobStatus', 'projectId'];
+            operators: '*';
+            sort: 'BOTH';
+        }
+    ];
+}
+type CommonQueryWithEntityContext = Query<ProjectJob, ProjectJobQuerySpec>;
+type ProjectJobQuery = {
+    /**
+    Cursor paging options.
+  
+    Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
+    */
+    cursorPaging?: {
+        /**
+      Maximum number of items to return in the results.
+      @max: 100
+      */
+        limit?: NonNullable<CommonQueryWithEntityContext['cursorPaging']>['limit'] | null;
+        /**
+      Pointer to the next or previous page in the list of results.
+    
+      Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
+      Not relevant for the first request.
+      @maxLength: 16000
+      */
+        cursor?: NonNullable<CommonQueryWithEntityContext['cursorPaging']>['cursor'] | null;
+    };
+    /**
+    Filter object.
+  
+    Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
+    */
+    filter?: CommonQueryWithEntityContext['filter'] | null;
+    /**
+    Sort object.
+  
+    Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
+    @maxSize: 5
+    */
+    sort?: {
+        /**
+      Name of the field to sort by.
+      @maxLength: 512
+      */
+        fieldName?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['fieldName'];
+        /**
+      Sort order.
+      */
+        order?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['order'];
+    }[];
+};
+declare const utils: {
+    query: _wix_sdk_types.QueryHelpers<ProjectJob, ProjectJobQuerySpec, ProjectJobQuery>;
+};
+/**
+ * Drops a job's assistant answer once it has reached the conversation it was meant for. Called by
+ * containers-projects after a successful chat write, so the job does not keep a second, indefinite
+ * copy of user-visible text that Chat already stores under its own retention rules.
+ * @param projectJobId - ID of the job whose delivered answer should be dropped.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField projectJobId
+ * @permissionId containers:project_jobs:v1:project_job:clear_project_job_assistant_response
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.ClearProjectJobAssistantResponse
+ */
+declare function clearProjectJobAssistantResponse(projectJobId: string): Promise<NonNullablePaths<ClearProjectJobAssistantResponseResponse, `projectJob.projectId` | `projectJob.jobType` | `projectJob.platform` | `projectJob.jobStatus` | `projectJob.prompt` | `projectJob.attachments` | `projectJob.attachments.${number}.type` | `projectJob.attachments.${number}.url` | `projectJob.attachments.${number}.displayName` | `projectJob.codingAgentSessionId` | `projectJob.failureReason` | `projectJob.creditsExempt` | `projectJob.creditsCostUsd` | `projectJob.suggestions` | `projectJob.suggestions.${number}.label` | `projectJob.suggestions.${number}.prompt`, 3>>;
+/**
+ * Cancels a pending job.
+ * @param projectJobId - ID of the job to cancel.
+ * @param revision - Current revision for optimistic locking.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField projectJobId
+ * @requiredField revision
+ * @permissionId containers:project_jobs:v1:project_job:cancel_project_job
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.CancelProjectJob
+ */
+declare function cancelProjectJob(projectJobId: string, revision: string): Promise<NonNullablePaths<CancelProjectJobResponse, `projectJob.projectId` | `projectJob.jobType` | `projectJob.platform` | `projectJob.jobStatus` | `projectJob.prompt` | `projectJob.attachments` | `projectJob.attachments.${number}.type` | `projectJob.attachments.${number}.url` | `projectJob.attachments.${number}.displayName` | `projectJob.codingAgentSessionId` | `projectJob.failureReason` | `projectJob.creditsExempt` | `projectJob.creditsCostUsd` | `projectJob.suggestions` | `projectJob.suggestions.${number}.label` | `projectJob.suggestions.${number}.prompt`, 3>>;
+/**
+ * Gets the latest job for a project, for the project owner to poll build progress.
+ * @param projectId - ID of the project to get the latest job for.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField projectId
+ * @permissionId containers:project_jobs:v1:project_job:get_latest_project_job
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.GetLatestProjectJob
+ */
+declare function getLatestProjectJob(projectId: string): Promise<NonNullablePaths<GetLatestProjectJobResponse, `projectJob.projectId` | `projectJob.jobType` | `projectJob.platform` | `projectJob.jobStatus` | `projectJob.prompt` | `projectJob.attachments` | `projectJob.attachments.${number}.type` | `projectJob.attachments.${number}.url` | `projectJob.attachments.${number}.displayName` | `projectJob.codingAgentSessionId` | `projectJob.failureReason` | `projectJob.creditsExempt` | `projectJob.creditsCostUsd` | `projectJob.suggestions` | `projectJob.suggestions.${number}.label` | `projectJob.suggestions.${number}.prompt`, 3>>;
+/**
+ * Queues suggestions for the current project conversation.
+ * @param projectId - ID of the project receiving the suggestions job.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField options.conversationId
+ * @requiredField projectId
+ * @permissionId containers:project_jobs:v1:project_job:create_suggestions_job
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.CreateSuggestionsJob
+ */
+declare function createSuggestionsJob(projectId: string, options?: NonNullablePaths<CreateSuggestionsJobOptions, `conversationId`, 0>): Promise<NonNullablePaths<CreateSuggestionsJobResponse, `projectJob.projectId` | `projectJob.jobType` | `projectJob.platform` | `projectJob.jobStatus` | `projectJob.prompt` | `projectJob.attachments` | `projectJob.attachments.${number}.type` | `projectJob.attachments.${number}.url` | `projectJob.attachments.${number}.displayName` | `projectJob.codingAgentSessionId` | `projectJob.failureReason` | `projectJob.creditsExempt` | `projectJob.creditsCostUsd` | `projectJob.suggestions` | `projectJob.suggestions.${number}.label` | `projectJob.suggestions.${number}.prompt`, 3>>;
+interface CreateSuggestionsJobOptions {
+    /**
+     * ID of the conversation receiving the suggestions.
+     * @format GUID
+     */
+    conversationId: string;
+    /**
+     * ID of the job whose diff the suggestions should be grounded in — the build/edit job the client
+     * just observed complete. Omitted when there is no specific triggering job (e.g. reopening an
+     * existing, already-built project's conversation). A wrapper, not a plain string: proto3's
+     * string default ("") is indistinguishable on the wire from an explicitly-set empty string, and
+     * the format validator rejected that default as "not a valid GUID" for every legitimately
+     * omitted caller — confirmed by direct testing against a real client request.
+     * @format GUID
+     */
+    sinceJobId?: string | null;
+}
+/**
+ * Registers the activity stream for an active job owned by the caller.
+ * @param projectJobId - ID of the project job.
+ * @param streamId - ID of the activity stream.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField projectJobId
+ * @requiredField streamId
+ * @permissionId containers:project_jobs:v1:project_job:open_project_job_activity
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.OpenProjectJobActivity
+ */
+declare function openProjectJobActivity(projectJobId: string, streamId: string): Promise<NonNullablePaths<OpenProjectJobActivityResponse, `jobId` | `streamId` | `latestSequence`, 0>>;
+/**
+ * Persists an idempotent semantic activity batch for the registered stream.
+ * @param projectJobId - ID of the project job.
+ * @param batch - Semantic activity batch to persist. Its Base64-encoded protobuf must fit within 16,000 characters.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField batch
+ * @requiredField projectJobId
+ * @permissionId containers:project_jobs:v1:project_job:report_project_job_activity
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.ReportProjectJobActivity
+ */
+declare function reportProjectJobActivity(projectJobId: string, batch: ActivityBatch): Promise<NonNullablePaths<ReportProjectJobActivityResponse, `jobId` | `streamId` | `acceptedSequence` | `latestSequence`, 0>>;
+/**
+ * Replays persisted activity for the current owner, using the latest stream when omitted.
+ * @param projectJobId - ID of the project job.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField projectJobId
+ * @permissionId containers:project_jobs:v1:project_job:query_project_job_activity
+ * @fqn wix.containers.project.jobs.v1.ContainersProjectJobs.QueryProjectJobActivity
+ */
+declare function queryProjectJobActivity(projectJobId: string, options?: QueryProjectJobActivityOptions): Promise<NonNullablePaths<QueryProjectJobActivityResponse, `batches` | `batches.${number}.jobId` | `batches.${number}.streamId` | `batches.${number}.batchSequence` | `batches.${number}.schemaVersion` | `batches.${number}.reportingProfileVersion` | `batches.${number}.workflow` | `latestSequence` | `nextSequence` | `historyExpired` | `jobId` | `streamId` | `notificationAppDefId`, 2>>;
+interface QueryProjectJobActivityOptions {
+    /**
+     * Omit or leave empty to query the latest stream. Non-empty UUIDs are validated by the service
+     * so the original string wire type can accept omission without GUID validation rejecting it.
+     * @maxLength 36
+     */
+    streamId?: string;
+    /** Return batches after this sequence; zero starts at the first batch. */
+    afterSequence?: string;
+    /** Maximum batches to return; defaults to 50 and is capped at 100. */
+    limit?: number;
+}
+
+export { type AccountInfo, type ActionEvent, type ActivityBatch, type ActivityEvent, ActivityEventType, type ActivityEventTypeWithLiterals, ActivitySource, type ActivitySourceWithLiterals, ActivityWorkflow, type ActivityWorkflowWithLiterals, type Attachment, AttachmentType, type AttachmentTypeWithLiterals, type CancelProjectJobRequest, type CancelProjectJobResponse, type ClearProjectJobAssistantResponseRequest, type ClearProjectJobAssistantResponseResponse, type CommonQueryWithEntityContext, type CreateProjectJobRequest, type CreateProjectJobResponse, type CreateSuggestionsJobOptions, type CreateSuggestionsJobRequest, type CreateSuggestionsJobResponse, type CursorPaging, type CursorPagingMetadata, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, type DomainEvent, type DomainEventBodyOneOf, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type GetCurrentProjectJobRequest, type GetCurrentProjectJobResponse, type GetLatestProjectJobRequest, type GetLatestProjectJobResponse, type GetProjectJobRequest, type GetProjectJobResponse, type IdentificationData, type IdentificationDataIdOneOf, JobStatus, type JobStatusWithLiterals, JobType, type JobTypeWithLiterals, type MessageEnvelope, type OpenProjectJobActivityRequest, type OpenProjectJobActivityResponse, Platform, type PlatformWithLiterals, type ProjectJob, type ProjectJobQuery, type ProjectJobQuerySpec, type ProjectJobsQueryBuilder, type ProjectJobsQueryResult, type QueryProjectJobActivityOptions, type QueryProjectJobActivityRequest, type QueryProjectJobActivityResponse, type QueryProjectJobsOptions, type QueryProjectJobsRequest, type QueryProjectJobsResponse, type ReportProjectJobActivityRequest, type ReportProjectJobActivityResponse, type RestoreInfo, SortOrder, type SortOrderWithLiterals, type Sorting, type Suggestion, type UpdateProjectJobStatusOptions, type UpdateProjectJobStatusRequest, type UpdateProjectJobStatusResponse, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, cancelProjectJob, clearProjectJobAssistantResponse, createProjectJob, createSuggestionsJob, getCurrentProjectJob, getLatestProjectJob, getProjectJob, openProjectJobActivity, queryProjectJobActivity, queryProjectJobs, reportProjectJobActivity, typedQueryProjectJobs, updateProjectJobStatus, utils };