@arbidocs/client 0.4.76 → 0.4.78

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -6336,7 +6336,7 @@ interface components {
6336
6336
  * @description What happened to a task, in the order a person reads its history.
6337
6337
  * @enum {string}
6338
6338
  */
6339
- ActivityKind: 'created' | 'run_started' | 'awaiting_access' | 'access_granted' | 'done' | 'reopened' | 'failed' | 'participant_joined' | 'assistant_responded' | 'assistant_stopped' | 'artifact_created' | 'artifact_edited' | 'document_added' | 'document_removed' | 'notified' | 'step_started' | 'step_done' | 'step_skipped' | 'step_failed' | 'step_signal' | 'step_ready' | 'step_reminded' | 'step_sent_back' | 'linked_run';
6339
+ ActivityKind: 'created' | 'run_started' | 'awaiting_access' | 'access_granted' | 'done' | 'reopened' | 'failed' | 'participant_joined' | 'assistant_responded' | 'assistant_stopped' | 'artifact_created' | 'artifact_edited' | 'document_added' | 'document_removed' | 'notified' | 'step_started' | 'step_done' | 'step_skipped' | 'step_failed' | 'step_signal' | 'step_ready' | 'step_reminded' | 'step_sent_back' | 'step_waiting' | 'step_progress' | 'linked_run';
6340
6340
  /**
6341
6341
  * ActivityResponse
6342
6342
  * @description One entry of ``GET /v1/conversation/{id}/activity``.
@@ -11369,6 +11369,36 @@ interface components {
11369
11369
  */
11370
11370
  skipped: components['schemas']['DriveSyncSkippedFile'][];
11371
11371
  };
11372
+ /**
11373
+ * EmailDraftAction
11374
+ * @description Prepare a draft in native mail, in the mailbox of the step's assignee (else the run's owner). It is never
11375
+ * sent automatically: the person sends it, and the step is done when they say so or when the draft is sent.
11376
+ * ``to``, ``cc``, ``subject`` and ``body_template`` are templates over the run's inputs and earlier steps'
11377
+ * outputs (``{{field}}``, ``{{step_id.key}}``, ``{{step_id.answer}}``).
11378
+ */
11379
+ EmailDraftAction: {
11380
+ /**
11381
+ * @description discriminator enum property added by openapi-typescript
11382
+ * @enum {string}
11383
+ */
11384
+ type: 'email_draft';
11385
+ /** To */
11386
+ to?: string[];
11387
+ /** Cc */
11388
+ cc?: string[];
11389
+ /**
11390
+ * Subject
11391
+ * @default
11392
+ */
11393
+ subject: string;
11394
+ /**
11395
+ * Body Template
11396
+ * @default
11397
+ */
11398
+ body_template: string;
11399
+ /** Attachments */
11400
+ attachments?: (string | components['schemas']['StepDocumentRef'])[];
11401
+ };
11372
11402
  /**
11373
11403
  * EmailNotificationSettings
11374
11404
  * @description Per-category email notification preferences. All default on; a master
@@ -16948,6 +16978,27 @@ interface components {
16948
16978
  */
16949
16979
  role: 'delegate' | 'write' | 'read' | 'read_basic' | 'freebusy';
16950
16980
  };
16981
+ /**
16982
+ * SignAction
16983
+ * @description Ask people to e-sign a document (``src/core/esign.py``). The step waits until every signer has signed (each
16984
+ * signs the document's latest version, so later signers counter-sign), then it is done with the signed version.
16985
+ * A signer who declines, or ``expires_after_hours`` passing, fails the step.
16986
+ */
16987
+ SignAction: {
16988
+ /**
16989
+ * @description discriminator enum property added by openapi-typescript
16990
+ * @enum {string}
16991
+ */
16992
+ type: 'sign';
16993
+ /** Document */
16994
+ document: string | components['schemas']['StepDocumentRef'];
16995
+ /** Signers */
16996
+ signers: components['schemas']['StepAssignee'][];
16997
+ /** Message */
16998
+ message?: string | null;
16999
+ /** Expires After Hours */
17000
+ expires_after_hours?: number | null;
17001
+ };
16951
17002
  /** SignDocumentRequest */
16952
17003
  SignDocumentRequest: {
16953
17004
  signer: components['schemas']['SignerDetails'];
@@ -17261,11 +17312,13 @@ interface components {
17261
17312
  * StepActionRequest
17262
17313
  * @description A person finishes a step of a workflow run (``POST /v1/conversation/{id}/step``).
17263
17314
  *
17264
- * ``complete`` finishes a form (``inputs`` merge into the run's inputs), an upload, or a review (the
17265
- * approval: whoever completes it is recorded, with what it approved). A step that declares ``fields`` checks
17266
- * ``inputs`` against them. ``skip`` passes over a step so what waits for it can go on. ``send_back`` returns the
17267
- * work to an earlier step (``to``, default the one this step waits for) with an optional ``note``: that step
17268
- * and everything after it are open again, and an agent step runs again with the note.
17315
+ * ``complete`` finishes a form (``inputs`` merge into the run's inputs), an upload (``documents``: the files
17316
+ * added; without them, the files the person added while the step waited), a review (the approval: whoever
17317
+ * completes it is recorded, with what it approved), or an email draft step (the email was sent). A step that
17318
+ * declares ``fields`` checks ``inputs`` against them. ``skip`` passes over a step so what waits for it can go on.
17319
+ * ``send_back`` returns the work to an earlier step (``to``, default the one this step waits for) with an
17320
+ * optional ``note``: that step and everything after it are open again, and an agent step runs again with the
17321
+ * note. ``decline`` is a signer refusing a signature step (with an optional ``note``): the step fails.
17269
17322
  */
17270
17323
  StepActionRequest: {
17271
17324
  /** Step */
@@ -17274,7 +17327,7 @@ interface components {
17274
17327
  * Action
17275
17328
  * @enum {string}
17276
17329
  */
17277
- action: 'complete' | 'skip' | 'send_back';
17330
+ action: 'complete' | 'skip' | 'send_back' | 'decline';
17278
17331
  /** Inputs */
17279
17332
  inputs?: {
17280
17333
  [key: string]: unknown;
@@ -17283,6 +17336,8 @@ interface components {
17283
17336
  to?: string | null;
17284
17337
  /** Note */
17285
17338
  note?: string | null;
17339
+ /** Documents */
17340
+ documents?: string[] | null;
17286
17341
  };
17287
17342
  /**
17288
17343
  * StepAssignee
@@ -17307,6 +17362,22 @@ interface components {
17307
17362
  /** Project Lead */
17308
17363
  project_lead?: true | null;
17309
17364
  };
17365
+ /**
17366
+ * StepDocumentRef
17367
+ * @description A document a step works on, named by where it comes from. Exactly one shape is set:
17368
+ *
17369
+ * - ``step``: the document(s) an earlier step produced or was given (an upload step's files, an agent step's
17370
+ * drafts, a signature step's signed copy, a document edit step's new version);
17371
+ * - ``input``: the document(s) one of the run's inputs names (a document pick, or a ``doc-`` id).
17372
+ *
17373
+ * A plain ``doc-`` id (optionally ``@v{n}``) names one document directly.
17374
+ */
17375
+ StepDocumentRef: {
17376
+ /** Step */
17377
+ step?: string | null;
17378
+ /** Input */
17379
+ input?: string | null;
17380
+ };
17310
17381
  /**
17311
17382
  * StepField
17312
17383
  * @description One field a step asks for (the shape of a form step's fields): what ``complete`` checks its ``inputs``
@@ -17629,6 +17700,32 @@ interface components {
17629
17700
  /** Row Height */
17630
17701
  row_height?: number | null;
17631
17702
  };
17703
+ /**
17704
+ * TabularReviewAction
17705
+ * @description Run AI review columns (tags with instructions) over documents: the annotation job of a Tabular Review. The
17706
+ * step is done when the job has finished; its output names the tags and documents, so a client opens the grid.
17707
+ * ``documents`` is a list of references, ``run_uploads`` (every file the run's upload steps took) or
17708
+ * ``workspace`` (every processed document in the workspace).
17709
+ */
17710
+ TabularReviewAction: {
17711
+ /**
17712
+ * @description discriminator enum property added by openapi-typescript
17713
+ * @enum {string}
17714
+ */
17715
+ type: 'tabular_review';
17716
+ /** Tags */
17717
+ tags: string[];
17718
+ /**
17719
+ * Documents
17720
+ * @default run_uploads
17721
+ */
17722
+ documents: (string | components['schemas']['StepDocumentRef'])[] | ('run_uploads' | 'workspace');
17723
+ /**
17724
+ * Overwrite
17725
+ * @default false
17726
+ */
17727
+ overwrite: boolean;
17728
+ };
17632
17729
  /**
17633
17730
  * TagBreakdown
17634
17731
  * @description Spend/token breakdown keyed by tag value (e.g. wrk-xxx, usr-xxx).
@@ -17893,6 +17990,9 @@ interface components {
17893
17990
  * ``form`` / ``upload`` / ``review`` steps wait for a person; an ``agent`` step is a turn the assistant
17894
17991
  * takes in the thread, running a ``skill`` (with ``inputs`` templated from the run's inputs) or a
17895
17992
  * ``prompt`` template. A ``branch`` agent step runs off the main line and delivers only its result to it.
17993
+ * An agent step with ``edit_document`` edits that DOCX with tracked changes and saves it as a new version.
17994
+ * An ``action`` step uses a platform feature (``action``: e-signing, a mail draft, a tabular review): see
17995
+ * ``src/core/workflow_actions.py``.
17896
17996
  * The structure is plaintext (the scheduler reads it to start each step, like ``Convos.prompt``); the
17897
17997
  * ``title`` is encrypted on the conversation. ``ui`` carries what a client shows (form fields, icon).
17898
17998
  */
@@ -17905,7 +18005,7 @@ interface components {
17905
18005
  * Kind
17906
18006
  * @enum {string}
17907
18007
  */
17908
- kind: 'form' | 'upload' | 'agent' | 'review';
18008
+ kind: 'form' | 'upload' | 'agent' | 'review' | 'action';
17909
18009
  /** After */
17910
18010
  after?: string[] | null;
17911
18011
  /** Skill */
@@ -17937,6 +18037,10 @@ interface components {
17937
18037
  remind_after_hours?: number | null;
17938
18038
  /** Fields */
17939
18039
  fields?: components['schemas']['StepField'][] | null;
18040
+ /** Action */
18041
+ action?: (components['schemas']['SignAction'] | components['schemas']['EmailDraftAction'] | components['schemas']['TabularReviewAction']) | null;
18042
+ /** Edit Document */
18043
+ edit_document?: string | components['schemas']['StepDocumentRef'] | null;
17940
18044
  };
17941
18045
  /**
17942
18046
  * TaskUpdateMessage
package/dist/index.d.ts CHANGED
@@ -6336,7 +6336,7 @@ interface components {
6336
6336
  * @description What happened to a task, in the order a person reads its history.
6337
6337
  * @enum {string}
6338
6338
  */
6339
- ActivityKind: 'created' | 'run_started' | 'awaiting_access' | 'access_granted' | 'done' | 'reopened' | 'failed' | 'participant_joined' | 'assistant_responded' | 'assistant_stopped' | 'artifact_created' | 'artifact_edited' | 'document_added' | 'document_removed' | 'notified' | 'step_started' | 'step_done' | 'step_skipped' | 'step_failed' | 'step_signal' | 'step_ready' | 'step_reminded' | 'step_sent_back' | 'linked_run';
6339
+ ActivityKind: 'created' | 'run_started' | 'awaiting_access' | 'access_granted' | 'done' | 'reopened' | 'failed' | 'participant_joined' | 'assistant_responded' | 'assistant_stopped' | 'artifact_created' | 'artifact_edited' | 'document_added' | 'document_removed' | 'notified' | 'step_started' | 'step_done' | 'step_skipped' | 'step_failed' | 'step_signal' | 'step_ready' | 'step_reminded' | 'step_sent_back' | 'step_waiting' | 'step_progress' | 'linked_run';
6340
6340
  /**
6341
6341
  * ActivityResponse
6342
6342
  * @description One entry of ``GET /v1/conversation/{id}/activity``.
@@ -11369,6 +11369,36 @@ interface components {
11369
11369
  */
11370
11370
  skipped: components['schemas']['DriveSyncSkippedFile'][];
11371
11371
  };
11372
+ /**
11373
+ * EmailDraftAction
11374
+ * @description Prepare a draft in native mail, in the mailbox of the step's assignee (else the run's owner). It is never
11375
+ * sent automatically: the person sends it, and the step is done when they say so or when the draft is sent.
11376
+ * ``to``, ``cc``, ``subject`` and ``body_template`` are templates over the run's inputs and earlier steps'
11377
+ * outputs (``{{field}}``, ``{{step_id.key}}``, ``{{step_id.answer}}``).
11378
+ */
11379
+ EmailDraftAction: {
11380
+ /**
11381
+ * @description discriminator enum property added by openapi-typescript
11382
+ * @enum {string}
11383
+ */
11384
+ type: 'email_draft';
11385
+ /** To */
11386
+ to?: string[];
11387
+ /** Cc */
11388
+ cc?: string[];
11389
+ /**
11390
+ * Subject
11391
+ * @default
11392
+ */
11393
+ subject: string;
11394
+ /**
11395
+ * Body Template
11396
+ * @default
11397
+ */
11398
+ body_template: string;
11399
+ /** Attachments */
11400
+ attachments?: (string | components['schemas']['StepDocumentRef'])[];
11401
+ };
11372
11402
  /**
11373
11403
  * EmailNotificationSettings
11374
11404
  * @description Per-category email notification preferences. All default on; a master
@@ -16948,6 +16978,27 @@ interface components {
16948
16978
  */
16949
16979
  role: 'delegate' | 'write' | 'read' | 'read_basic' | 'freebusy';
16950
16980
  };
16981
+ /**
16982
+ * SignAction
16983
+ * @description Ask people to e-sign a document (``src/core/esign.py``). The step waits until every signer has signed (each
16984
+ * signs the document's latest version, so later signers counter-sign), then it is done with the signed version.
16985
+ * A signer who declines, or ``expires_after_hours`` passing, fails the step.
16986
+ */
16987
+ SignAction: {
16988
+ /**
16989
+ * @description discriminator enum property added by openapi-typescript
16990
+ * @enum {string}
16991
+ */
16992
+ type: 'sign';
16993
+ /** Document */
16994
+ document: string | components['schemas']['StepDocumentRef'];
16995
+ /** Signers */
16996
+ signers: components['schemas']['StepAssignee'][];
16997
+ /** Message */
16998
+ message?: string | null;
16999
+ /** Expires After Hours */
17000
+ expires_after_hours?: number | null;
17001
+ };
16951
17002
  /** SignDocumentRequest */
16952
17003
  SignDocumentRequest: {
16953
17004
  signer: components['schemas']['SignerDetails'];
@@ -17261,11 +17312,13 @@ interface components {
17261
17312
  * StepActionRequest
17262
17313
  * @description A person finishes a step of a workflow run (``POST /v1/conversation/{id}/step``).
17263
17314
  *
17264
- * ``complete`` finishes a form (``inputs`` merge into the run's inputs), an upload, or a review (the
17265
- * approval: whoever completes it is recorded, with what it approved). A step that declares ``fields`` checks
17266
- * ``inputs`` against them. ``skip`` passes over a step so what waits for it can go on. ``send_back`` returns the
17267
- * work to an earlier step (``to``, default the one this step waits for) with an optional ``note``: that step
17268
- * and everything after it are open again, and an agent step runs again with the note.
17315
+ * ``complete`` finishes a form (``inputs`` merge into the run's inputs), an upload (``documents``: the files
17316
+ * added; without them, the files the person added while the step waited), a review (the approval: whoever
17317
+ * completes it is recorded, with what it approved), or an email draft step (the email was sent). A step that
17318
+ * declares ``fields`` checks ``inputs`` against them. ``skip`` passes over a step so what waits for it can go on.
17319
+ * ``send_back`` returns the work to an earlier step (``to``, default the one this step waits for) with an
17320
+ * optional ``note``: that step and everything after it are open again, and an agent step runs again with the
17321
+ * note. ``decline`` is a signer refusing a signature step (with an optional ``note``): the step fails.
17269
17322
  */
17270
17323
  StepActionRequest: {
17271
17324
  /** Step */
@@ -17274,7 +17327,7 @@ interface components {
17274
17327
  * Action
17275
17328
  * @enum {string}
17276
17329
  */
17277
- action: 'complete' | 'skip' | 'send_back';
17330
+ action: 'complete' | 'skip' | 'send_back' | 'decline';
17278
17331
  /** Inputs */
17279
17332
  inputs?: {
17280
17333
  [key: string]: unknown;
@@ -17283,6 +17336,8 @@ interface components {
17283
17336
  to?: string | null;
17284
17337
  /** Note */
17285
17338
  note?: string | null;
17339
+ /** Documents */
17340
+ documents?: string[] | null;
17286
17341
  };
17287
17342
  /**
17288
17343
  * StepAssignee
@@ -17307,6 +17362,22 @@ interface components {
17307
17362
  /** Project Lead */
17308
17363
  project_lead?: true | null;
17309
17364
  };
17365
+ /**
17366
+ * StepDocumentRef
17367
+ * @description A document a step works on, named by where it comes from. Exactly one shape is set:
17368
+ *
17369
+ * - ``step``: the document(s) an earlier step produced or was given (an upload step's files, an agent step's
17370
+ * drafts, a signature step's signed copy, a document edit step's new version);
17371
+ * - ``input``: the document(s) one of the run's inputs names (a document pick, or a ``doc-`` id).
17372
+ *
17373
+ * A plain ``doc-`` id (optionally ``@v{n}``) names one document directly.
17374
+ */
17375
+ StepDocumentRef: {
17376
+ /** Step */
17377
+ step?: string | null;
17378
+ /** Input */
17379
+ input?: string | null;
17380
+ };
17310
17381
  /**
17311
17382
  * StepField
17312
17383
  * @description One field a step asks for (the shape of a form step's fields): what ``complete`` checks its ``inputs``
@@ -17629,6 +17700,32 @@ interface components {
17629
17700
  /** Row Height */
17630
17701
  row_height?: number | null;
17631
17702
  };
17703
+ /**
17704
+ * TabularReviewAction
17705
+ * @description Run AI review columns (tags with instructions) over documents: the annotation job of a Tabular Review. The
17706
+ * step is done when the job has finished; its output names the tags and documents, so a client opens the grid.
17707
+ * ``documents`` is a list of references, ``run_uploads`` (every file the run's upload steps took) or
17708
+ * ``workspace`` (every processed document in the workspace).
17709
+ */
17710
+ TabularReviewAction: {
17711
+ /**
17712
+ * @description discriminator enum property added by openapi-typescript
17713
+ * @enum {string}
17714
+ */
17715
+ type: 'tabular_review';
17716
+ /** Tags */
17717
+ tags: string[];
17718
+ /**
17719
+ * Documents
17720
+ * @default run_uploads
17721
+ */
17722
+ documents: (string | components['schemas']['StepDocumentRef'])[] | ('run_uploads' | 'workspace');
17723
+ /**
17724
+ * Overwrite
17725
+ * @default false
17726
+ */
17727
+ overwrite: boolean;
17728
+ };
17632
17729
  /**
17633
17730
  * TagBreakdown
17634
17731
  * @description Spend/token breakdown keyed by tag value (e.g. wrk-xxx, usr-xxx).
@@ -17893,6 +17990,9 @@ interface components {
17893
17990
  * ``form`` / ``upload`` / ``review`` steps wait for a person; an ``agent`` step is a turn the assistant
17894
17991
  * takes in the thread, running a ``skill`` (with ``inputs`` templated from the run's inputs) or a
17895
17992
  * ``prompt`` template. A ``branch`` agent step runs off the main line and delivers only its result to it.
17993
+ * An agent step with ``edit_document`` edits that DOCX with tracked changes and saves it as a new version.
17994
+ * An ``action`` step uses a platform feature (``action``: e-signing, a mail draft, a tabular review): see
17995
+ * ``src/core/workflow_actions.py``.
17896
17996
  * The structure is plaintext (the scheduler reads it to start each step, like ``Convos.prompt``); the
17897
17997
  * ``title`` is encrypted on the conversation. ``ui`` carries what a client shows (form fields, icon).
17898
17998
  */
@@ -17905,7 +18005,7 @@ interface components {
17905
18005
  * Kind
17906
18006
  * @enum {string}
17907
18007
  */
17908
- kind: 'form' | 'upload' | 'agent' | 'review';
18008
+ kind: 'form' | 'upload' | 'agent' | 'review' | 'action';
17909
18009
  /** After */
17910
18010
  after?: string[] | null;
17911
18011
  /** Skill */
@@ -17937,6 +18037,10 @@ interface components {
17937
18037
  remind_after_hours?: number | null;
17938
18038
  /** Fields */
17939
18039
  fields?: components['schemas']['StepField'][] | null;
18040
+ /** Action */
18041
+ action?: (components['schemas']['SignAction'] | components['schemas']['EmailDraftAction'] | components['schemas']['TabularReviewAction']) | null;
18042
+ /** Edit Document */
18043
+ edit_document?: string | components['schemas']['StepDocumentRef'] | null;
17940
18044
  };
17941
18045
  /**
17942
18046
  * TaskUpdateMessage
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@arbidocs/client",
3
- "version": "0.4.76",
3
+ "version": "0.4.78",
4
4
  "description": "TypeScript SDK for the ARBI API — zero-knowledge auth, E2E encryption, and type-safe REST client",
5
5
  "type": "module",
6
6
  "sideEffects": false,