@versionone/agility-sdk 1.0.0-alpha.3 → 1.0.0-alpha.4

package/dist/index.d.cts

@@ -11,7 +11,8 @@
  *   aborted         the caller's signal ended it
  *   commandFailure  api/asset answered 200 with failed commands inside (CommandFailureError)
  *   protocol        the server answered something the SDK cannot read
- *   usage           a mistake caught before any request (UsageError): fix the call
+ *   usage           a mistake caught before any request (UsageError): nothing was sent, so
+ *                   do not blame the server — fix the call (status is 0 here)
  *   unknown         none of the above
  */
 type ErrorKind = "auth" | "forbidden" | "notFound" | "invalid" | "transient" | "aborted" | "commandFailure" | "protocol" | "usage" | "unknown";
@@ -4302,7 +4303,7 @@ interface Violation {
     rule: string;
     /** "Story.Scope" when the violation names an attribute; null otherwise. */
     attribute: AttributeTokenRef | null;
-    /** The loc-2 tag naming what was violated, when the message carries one. */
+    /** The loc-2 tag naming what was violated (`AttributeDefinition'Scope'Story`), when the message carries one; null for the token spelling. */
     tag: string | null;
 }
 /** The violation a failure message describes, or null when it is not one. */
@@ -4311,6 +4312,8 @@ declare function parseViolation(message: string): Violation | null;
 declare function failuresOf<Row extends Asset = Asset>(response: AssetApiResponse<Row>): CommandFailureDetail[];
 /** What a batch did, in the model's terms: the services read this, never the envelope. */
 interface Outcome<Row extends Asset = Asset> {
+    /** The server's id for the request: what to quote when asking about a batch. Null for an outcome merged from several sends. */
+    requestId: string | null;
     created: Oid[];
     modified: Oid[];
     operated: Oid[];
@@ -4319,7 +4322,12 @@ interface Outcome<Row extends Asset = Asset> {
     queryResults: (Row[] | null)[];
     durationSeconds: number | null;
 }
-/** The outcome of a (translated) response: OIDs momentless, failures normalised. */
+/**
+ * The outcome of a (translated) response: OIDs momentless, failures
+ * normalised. Every field has a default, so a partial envelope (a test fake
+ * that sends only queryResult) still yields a complete Outcome; consumers'
+ * fakes rely on that, and the unit tests keep it so.
+ */
 declare function outcomeOf<Row extends Asset = Asset>(response: AssetApiResponse<Row>): Outcome<Row>;
 /** An outcome with nothing in it, to merge several sends into. */
 declare const emptyOutcome: <Row extends Asset = Asset>() => Outcome<Row>;
@@ -4773,6 +4781,40 @@ declare function reversible(transport: Transport, receipt: Pick<Receipt, "revers
     reactivated: Oid[];
 }>;
 
+/**
+ * The fields service: what a form for an asset type in a scope needs to
+ * know, from three sources the API keeps apart —
+ *   - meta.v1 (through the schema): which attributes are REQUIRED to
+ *     create one (IsRequired and writable: Name and Scope on a Story);
+ *   - api/visibleFields: which attributes the product SHOWS for the type
+ *     in that scope, custom fields included once configured;
+ *   - the scope's Scheme: its IMPORTANT fields (Scheme.ImportantFields, a
+ *     list of attribute tokens) and whether they are enforced at close
+ *     (Scheme.IsRequiredAtClose).
+ * One call, one answer, every list spelled as bare attribute names.
+ */
+
+interface FieldsOf {
+    type: AssetTypeToken;
+    scope: Oid;
+    /** The scope's Scheme; null when the scope has none. */
+    scheme: Oid | null;
+    /** Attributes the server requires on a create (meta: IsRequired, writable). */
+    required: string[];
+    /** Attributes the product shows for the type in this scope (api/visibleFields). */
+    visible: string[];
+    /** The scheme's important fields that belong to this type (or an ancestor); [] when the scheme names none. */
+    important: string[];
+    /** Whether the scheme enforces its important fields when an asset is closed. */
+    requiredAtClose: boolean;
+}
+/**
+ * An important-field token as the scheme spells it ("Story.Owners", or a
+ * bare "Owners") reduced to the attribute name when it belongs to one of
+ * the types given; null otherwise.
+ */
+declare function importantName(token: string, types: readonly AssetTypeToken[]): string | null;
+
 /**
  * The guard: an api/asset batch sent as a compare-and-set, so a change only
  * lands on an asset nobody else has changed since it was read. Ported from
@@ -5012,6 +5054,33 @@ interface ReadResult<Row extends Asset = Asset> {
 declare const list: <Row extends Asset = Asset>(transport: Transport, type: string, params: ReadParams) => Promise<ReadResult<Row>>;
 /** One asset by OID. */
 declare function get<Row extends Asset = Asset>(transport: Transport, oid: Oid, select?: string[]): Promise<Row>;
+/**
+ * What an operation answered with: the asset the server returned, as an
+ * OID token — for Copy the copy, for anything else the operated asset —
+ * and the moment the server stamped on it.
+ */
+interface OperationResult {
+    oid: Oid;
+    moment: string | null;
+}
+/**
+ * Run an operation (Copy, Inactivate, …) through rest-1, for its result.
+ * api/asset's `execute` performs the same operations but reports only the
+ * operated asset, so a Copy's new OID is unobservable there; rest-1 answers
+ * it. Not idempotent: never retried.
+ */
+declare function operate(transport: Transport, oid: Oid, op: string): Promise<OperationResult>;
+/** A new asset's template as the model carries it: the attributes the initializer set, no `_oid`. */
+type Template<Row extends Asset = Asset> = Partial<Omit<Row, "_oid">>;
+/**
+ * The template for a new asset of `type` in a context (a Scope, a parent
+ * asset): what the server's initializer would fill in — defaults nothing
+ * else exposes. Idempotent, like any GET. Without a context the template
+ * is empty, and an unknown context is echoed back, not refused.
+ */
+declare function template<Row extends Asset = Asset>(transport: Transport, type: string, options?: {
+    ctx?: Oid;
+}): Promise<Template<Row>>;
 /** A bounded history read: one row per moment, _oid carrying the moment. */
 declare const history: <Row extends Asset = Asset>(transport: Transport, target: string, params: ReadParams) => Promise<ReadResult<Row>>;
 
@@ -5019,18 +5088,22 @@ type rest1_AssetDocument = AssetDocument;
 type rest1_AssetRefDocument = AssetRefDocument;
 type rest1_AssetsDocument = AssetsDocument;
 type rest1_AttributeDocument = AttributeDocument;
+type rest1_OperationResult = OperationResult;
 type rest1_ReadParams = ReadParams;
 type rest1_ReadResult<Row extends Asset = Asset> = ReadResult<Row>;
 type rest1_RelationDocument = RelationDocument;
+type rest1_Template<Row extends Asset = Asset> = Template<Row>;
 declare const rest1_fromAssetDocument: typeof fromAssetDocument;
 declare const rest1_get: typeof get;
 declare const rest1_history: typeof history;
 declare const rest1_list: typeof list;
 declare const rest1_momentless: typeof momentless;
+declare const rest1_operate: typeof operate;
+declare const rest1_template: typeof template;
 declare const rest1_toQuery: typeof toQuery;
 declare namespace rest1 {
-  export { rest1_fromAssetDocument as fromAssetDocument, rest1_get as get, rest1_history as history, rest1_list as list, rest1_momentless as momentless, rest1_toQuery as toQuery };
-  export type { rest1_AssetDocument as AssetDocument, rest1_AssetRefDocument as AssetRefDocument, rest1_AssetsDocument as AssetsDocument, rest1_AttributeDocument as AttributeDocument, rest1_ReadParams as ReadParams, rest1_ReadResult as ReadResult, rest1_RelationDocument as RelationDocument };
+  export { rest1_fromAssetDocument as fromAssetDocument, rest1_get as get, rest1_history as history, rest1_list as list, rest1_momentless as momentless, rest1_operate as operate, rest1_template as template, rest1_toQuery as toQuery };
+  export type { rest1_AssetDocument as AssetDocument, rest1_AssetRefDocument as AssetRefDocument, rest1_AssetsDocument as AssetsDocument, rest1_AttributeDocument as AttributeDocument, rest1_OperationResult as OperationResult, rest1_ReadParams as ReadParams, rest1_ReadResult as ReadResult, rest1_RelationDocument as RelationDocument, rest1_Template as Template };
 }
 
 interface ClientOptions {
@@ -5076,12 +5149,15 @@ type Me = Pick<Member, "_oid" | "Name" | "Username" | "Nickname" | "Email">;
  * every write answers in the model's terms (an Outcome, never an envelope).
  *
  * Reads: `query`, `queries`, `get`, `queryPage`, `pages`, `all`, `me`. A
- * query body is the same everywhere; the client picks the endpoint
- * (query.v1 for plain reads — read-only by construction, so a request can
- * be retried like a GET; api/asset where a total is wanted; rest-1 behind
- * `data` for deleted assets and history). Writes: `assets.send`,
- * `assets.sendGuarded`, `batch.run`. Services: `resolve`, `attachments`,
- * `embeddedImages`, `schema`, `localize`, `urls`.
+ * query body is the same everywhere; the client picks the endpoint.
+ * query.v1 answers rows alone — the lightest response, and read-only by
+ * construction, so a request can be resent like a GET — but its shape has
+ * nowhere to put a total; api/asset reports one (`needTotal`) beside the
+ * rows, which is why `queryPage` goes there and `query` does not. rest-1
+ * sits behind `data` for what neither does: deleted assets, history, a
+ * new asset's template, an operation's result. Writes: `assets.send`,
+ * `assets.sendGuarded`, `batch.run`, `copy`. Services: `resolve`,
+ * `fields`, `attachments`, `embeddedImages`, `schema`, `localize`, `urls`.
  */
 declare class AgilityApiClient {
     readonly transport: Transport;
@@ -5097,9 +5173,12 @@ declare class AgilityApiClient {
     withSignal(signal: AbortSignal): AgilityApiClient;
     /**
      * One query, its rows, translated. Sent to query.v1: it cannot write, so
-     * the request is retried like a GET after a network failure or a 5xx. A
-     * page is required; a query the server refuses throws (kind "invalid"),
-     * never an empty result.
+     * the request is marked idempotent and the transport may resend it after
+     * a network failure or a 5xx — when `retries` is set above its default
+     * of 0. A page is required; a query the server refuses throws an
+     * ApiError (kind "invalid", code QUERY_REJECTED; `message` holds the
+     * server's sentences, `details` its whole error document), never an
+     * empty result.
      */
     query<const F extends From, const Q extends QueryBody<F>>(q: Q & QueryBody<F>): Promise<RowOf<Q>[]>;
     query<Row extends Asset = Asset>(q: QueryBody): Promise<Row[]>;
@@ -5147,16 +5226,39 @@ declare class AgilityApiClient {
      */
     localize(tags: readonly string[], options?: LocalizeOptions): Promise<Localizations>;
     /**
-     * rest-1.v1, for what query.v1 cannot do: deleted assets (`deleted:
-     * true`), one asset by OID without a page, and history (one row per
-     * moment). Parameters are spelled as a query's (`select`, `filter`).
+     * rest-1.v1, for what the other endpoints cannot do: deleted assets
+     * (`deleted: true`), one asset by OID without a page, history (one row
+     * per moment), a new asset's template (`template`: what the type's
+     * initializer fills in for a context — a Timebox's next name and dates,
+     * a Story's carry-over from a Request), and an operation's result
+     * (`operate`: api/asset performs a Copy but never says what it made;
+     * rest-1 answers the new OID). Parameters are spelled as a query's
+     * (`select`, `filter`).
      */
     readonly data: {
         list: <Row extends Asset = Asset>(type: string, params: ReadParams) => Promise<ReadResult<Row>>;
         get: <Row extends Asset = Asset>(oid: string, select?: string[]) => Promise<Row>;
         history: <Row extends Asset = Asset>(target: string, params: ReadParams) => Promise<ReadResult<Row>>;
+        template: <F extends From>(type: F, options?: {
+            ctx?: Oid;
+        }) => Promise<Partial<Omit<TypeOf<F>, "_oid">>>;
+        operate: (oid: Oid, op: string) => Promise<OperationResult>;
+    };
+    /** Copy an asset (the server's Copy operation) and answer the copy's OID: the one thing api/asset's `execute: "Copy"` does not say. */
+    copy(oid: Oid): Promise<Oid>;
+    /**
+     * What a form needs for an asset type in a scope: the attributes the
+     * server requires to create one (meta), the ones the product shows there
+     * (api/visibleFields, custom fields included once configured), and the
+     * scope's scheme's important fields and whether they are enforced at
+     * close. `visible` alone answers for several types and scopes at once.
+     */
+    readonly fields: {
+        describe: (type: From, scope: Oid) => Promise<FieldsOf>;
+        visible: (types: readonly From[], scopes: readonly Oid[]) => Promise<Record<string, string[]>>;
+        visibleByAsset: (oid: Oid) => Promise<string[]>;
     };
-    /** @deprecated since 1.0.0-alpha.3: `client.query` / `client.queries` read through query.v1. Removed in 1.0.0. */
+    /** @deprecated since 1.0.0-alpha.3: use `client.query` / `client.queries` (the same endpoint, query.v1; only the name moved). Removed in 1.0.0. */
     readonly queryV1: {
         query: <Row extends Asset = Asset>(q: QueryBody) => Promise<Row[]>;
         queries: <Row extends Asset = Asset>(qs: QueryBody[]) => Promise<Row[][]>;
@@ -5181,7 +5283,7 @@ declare class AgilityApiClient {
          * cover.
          */
         sendGuarded: <Row extends Asset = Asset>(commands: Command[], options?: Pick<SendOptions, "throwOnFailure">) => Promise<GuardedResult<Row>>;
-        /** @deprecated since 1.0.0-alpha.3: use `client.query` (or `client.queryPage` for a total). Removed in 1.0.0. */
+        /** @deprecated since 1.0.0-alpha.3: use `client.query` (rows, through query.v1) or `client.queryPage` (rows and a total, through api/asset as this does). Removed in 1.0.0. */
         query: <Row extends Asset = Asset>(q: QueryBody) => Promise<Row[]>;
         /** @deprecated since 1.0.0-alpha.3: use `client.queries`. Removed in 1.0.0. */
         queries: <Row extends Asset = Asset>(qs: QueryBody[]) => Promise<Row[][]>;
@@ -5265,8 +5367,13 @@ declare class AgilityApiClient {
     };
     /** Where a browser opens things on this instance: an asset's page, an attachment's bytes, an embedded image. */
     readonly urls: {
-        /** The asset's page: assetdetail.v1 redirects to the type's own detail page (live 2026-11-12). */
-        asset: (oid: Oid) => string;
+        /**
+         * The asset's page, from an OID token or an asset Number (S-01001,
+         * what a person typed and what a message shows): assetdetail.v1
+         * resolves either and redirects to the type's own detail page; a signed-
+         * out reader lands there after logging in. Anything else is a UsageError.
+         */
+        asset: (ref: Oid | string) => string;
         attachment: (id: string | number) => string;
         embeddedImage: (id: string | number) => string;
     };
@@ -5369,5 +5476,19 @@ declare namespace queryV1 {
   };
 }
 
-export { ASSET_STATE_CODES, AgilityApiClient, ApiError, AttachmentUploadError, BatchRecordError, BatchSendError, CommandFailureError, INLINE_LIMIT, INVERSE, NUMBER_ROOTS, CHUNK as RESOLVE_CHUNK, Schema, TypeCache, UNGUARDABLE_TYPES, UnguardableError, UsageError, WrappedError, assetApi, assetStateOf, attachment, createFetchTransport, describe as describeBatch, guard, isAssetNumber, isOidToken, kindOf, loc2, meta, momentless, namesOf, parseOid, parseViolation, queryV1, resolveNumbers, resolveRef, rest1, reverseOf, reversible, runBatch, select, sendGuarded, snapshot, stampsOf, toOid, touchedBy, typeOfOid, unguardable };
-export type { Access, Actual, Allocation, Application, Asset, AssetApiResponse, AssetChangedEventDefinition, AssetCreatedEventDefinition, AssetDocument, AssetNumberAttributeDefinition, AssetStateValue, AssetType, AssetTypeMap, AssetTypeName, AssetTypeToken, AssetsDocument, Attachment, AddOptions as AttachmentAddOptions, AttachmentCategory, AttachmentInfo, AttributeAddedEventDefinition, AttributeChangedEventDefinition, AttributeDefinition, AttributeLookup, AttributeRemovedEventDefinition, AttributeTokenRef, AttributeType, AttributeValue, BaseAsset, BatchOptions, Budget, BuildProject, BuildRun, BuildSource, BuildStatus, Bundle, BusinessRule, Bytes, CalendarEvent, CalendarEventCategory, Capacity, ChangeSet, ClassOfService, ClientConfig, ClientOptions, Command, CommandBody, CommandFailureDetail, CommandValue, Community, Concept, ConcreteAssetTypeName, Conversation, CreateBody, CreateType, CredentialsAttributeDefinition, CustomAttributes, CustomList, DateString, DefaultRule, Defect, DefectResolution, DefectType, Delivery, DeliveryCategory, Described, EmbeddedImage$1 as EmbeddedImage, Environment, Epic, EpicCategory, EpicPriority, EpicStatus, ErrorKind, ExecuteBody, ExecuteSecurityCheckAttributeDefinition, Expression, ExpressionImage, ExpressionSpace, ExternalAction, ExternalActionInvocation, FetchTransportConfig, From, Goal, GoalCategory, GoalPriority, Grant, GuardedResult, HierarchyRelationDefinition, Idea, IdeaCategory, IdeaChangeSet, IdeaComment, IdeaForum, IdeaStatus, IdeaUser, IdeasUserCache, Image, Issue, IssueCategory, IssuePriority, IssueResolution, IssueStatus, KeyResult, KeyResultCommitment, KeyResultUnit, Label, Link, LinkCategory, List, Localizations, LocalizeOptions, ManyToManyRelationDefinition, Me, Member, MemberLabel, Message, MessageReceipt, Metamodel, Milestone, MilestoneCategory, MultivalueAttributeDefinition, NameLookupFailure, Named, NoteCategory, Oid, OidParts, Okr, OkrObjective, OkrSession, OneToManyRelationDefinition, OperationExecutedEventDefinition, Outcome, Page, PagesOptions, PasswordAttributeDefinition, Phase, PlanningLevel, PlanningRoom, PrimaryWorkitem, PrincipalAttributeDefinition, Publication, QueryBody, ReadOptions, ReadParams, ReadResult, Receipt, Ref, RegressionPlan, RegressionSuite, RegressionTest, RegressionTestStatus, Release, Request, RequestBody, RequestCategory, RequestOptions, RequestPriority, RequestResolution, RequestStatus, Resolution, ResolvedAsset, ResponseType, Retrospective, RetrospectivePrompt, RetrospectiveTopic, Reverse, Roadmap, Role, Room, RowContext, RowOf, RowsOf, SavedView, Schedule, Scheme, Scope, ScopeLabel, ScopeStatus, SelectKey, SelectPath, SelectValue, Selected, SendOptions, SimpleAttributeDefinition, State, Status, Story, StoryCategory, StorySource, StoryStatus, StrategicTheme, StrategicThemeLevel, Subscription, SubscriptionTerm, SyntheticAttributeDefinition, Task, TaskCategory, TaskSource, TaskStatus, Team, TeamRoom, TeamWorkflow, Test, TestCategory, TestRun, TestSet, TestStatus, TestSuite, Theme, ThemeCategory, ThemeLabel, ThemeSource, ThemeStatus, Timebox, Timesheet, Topic, Transport, TriggerType, TypeOf, UnauthorizedContext, UnauthorizedDecision, Unguardable, UpdateBody, UpdateSecurityCheckAttributeDefinition, ValueStream, VersionLabel, Violation, Workflow, WorkflowTransition, Workitem, WorkitemPriority, WorkitemRisk };
+/** The attributes shown for each type in the scopes given: a map from type token to sorted attribute names. */
+declare function visibleFields(transport: Transport, types: readonly AssetTypeToken[], scopes: readonly Oid[]): Promise<Record<AssetTypeToken, string[]>>;
+/** The attributes shown for one asset, in its own Scope. */
+declare function visibleFieldsByAsset(transport: Transport, oid: Oid): Promise<string[]>;
+
+declare const fields_visibleFields: typeof visibleFields;
+declare const fields_visibleFieldsByAsset: typeof visibleFieldsByAsset;
+declare namespace fields {
+  export {
+    fields_visibleFields as visibleFields,
+    fields_visibleFieldsByAsset as visibleFieldsByAsset,
+  };
+}
+
+export { ASSET_STATE_CODES, AgilityApiClient, ApiError, AttachmentUploadError, BatchRecordError, BatchSendError, CommandFailureError, INLINE_LIMIT, INVERSE, NUMBER_ROOTS, CHUNK as RESOLVE_CHUNK, Schema, TypeCache, UNGUARDABLE_TYPES, UnguardableError, UsageError, WrappedError, assetApi, assetStateOf, attachment, createFetchTransport, describe as describeBatch, fields, guard, importantName, isAssetNumber, isOidToken, kindOf, loc2, meta, momentless, namesOf, parseOid, parseViolation, queryV1, resolveNumbers, resolveRef, rest1, reverseOf, reversible, runBatch, select, sendGuarded, snapshot, stampsOf, toOid, touchedBy, typeOfOid, unguardable };
+export type { Access, Actual, Allocation, Application, Asset, AssetApiResponse, AssetChangedEventDefinition, AssetCreatedEventDefinition, AssetDocument, AssetNumberAttributeDefinition, AssetStateValue, AssetType, AssetTypeMap, AssetTypeName, AssetTypeToken, AssetsDocument, Attachment, AddOptions as AttachmentAddOptions, AttachmentCategory, AttachmentInfo, AttributeAddedEventDefinition, AttributeChangedEventDefinition, AttributeDefinition, AttributeLookup, AttributeRemovedEventDefinition, AttributeTokenRef, AttributeType, AttributeValue, BaseAsset, BatchOptions, Budget, BuildProject, BuildRun, BuildSource, BuildStatus, Bundle, BusinessRule, Bytes, CalendarEvent, CalendarEventCategory, Capacity, ChangeSet, ClassOfService, ClientConfig, ClientOptions, Command, CommandBody, CommandFailureDetail, CommandValue, Community, Concept, ConcreteAssetTypeName, Conversation, CreateBody, CreateType, CredentialsAttributeDefinition, CustomAttributes, CustomList, DateString, DefaultRule, Defect, DefectResolution, DefectType, Delivery, DeliveryCategory, Described, EmbeddedImage$1 as EmbeddedImage, Environment, Epic, EpicCategory, EpicPriority, EpicStatus, ErrorKind, ExecuteBody, ExecuteSecurityCheckAttributeDefinition, Expression, ExpressionImage, ExpressionSpace, ExternalAction, ExternalActionInvocation, FetchTransportConfig, FieldsOf, From, Goal, GoalCategory, GoalPriority, Grant, GuardedResult, HierarchyRelationDefinition, Idea, IdeaCategory, IdeaChangeSet, IdeaComment, IdeaForum, IdeaStatus, IdeaUser, IdeasUserCache, Image, Issue, IssueCategory, IssuePriority, IssueResolution, IssueStatus, KeyResult, KeyResultCommitment, KeyResultUnit, Label, Link, LinkCategory, List, Localizations, LocalizeOptions, ManyToManyRelationDefinition, Me, Member, MemberLabel, Message, MessageReceipt, Metamodel, Milestone, MilestoneCategory, MultivalueAttributeDefinition, NameLookupFailure, Named, NoteCategory, Oid, OidParts, Okr, OkrObjective, OkrSession, OneToManyRelationDefinition, OperationExecutedEventDefinition, OperationResult, Outcome, Page, PagesOptions, PasswordAttributeDefinition, Phase, PlanningLevel, PlanningRoom, PrimaryWorkitem, PrincipalAttributeDefinition, Publication, QueryBody, ReadOptions, ReadParams, ReadResult, Receipt, Ref, RegressionPlan, RegressionSuite, RegressionTest, RegressionTestStatus, Release, Request, RequestBody, RequestCategory, RequestOptions, RequestPriority, RequestResolution, RequestStatus, Resolution, ResolvedAsset, ResponseType, Retrospective, RetrospectivePrompt, RetrospectiveTopic, Reverse, Roadmap, Role, Room, RowContext, RowOf, RowsOf, SavedView, Schedule, Scheme, Scope, ScopeLabel, ScopeStatus, SelectKey, SelectPath, SelectValue, Selected, SendOptions, SimpleAttributeDefinition, State, Status, Story, StoryCategory, StorySource, StoryStatus, StrategicTheme, StrategicThemeLevel, Subscription, SubscriptionTerm, SyntheticAttributeDefinition, Task, TaskCategory, TaskSource, TaskStatus, Team, TeamRoom, TeamWorkflow, Template, Test, TestCategory, TestRun, TestSet, TestStatus, TestSuite, Theme, ThemeCategory, ThemeLabel, ThemeSource, ThemeStatus, Timebox, Timesheet, Topic, Transport, TriggerType, TypeOf, UnauthorizedContext, UnauthorizedDecision, Unguardable, UpdateBody, UpdateSecurityCheckAttributeDefinition, ValueStream, VersionLabel, Violation, Workflow, WorkflowTransition, Workitem, WorkitemPriority, WorkitemRisk };

package/dist/index.d.ts

@@ -11,7 +11,8 @@
  *   aborted         the caller's signal ended it
  *   commandFailure  api/asset answered 200 with failed commands inside (CommandFailureError)
  *   protocol        the server answered something the SDK cannot read
- *   usage           a mistake caught before any request (UsageError): fix the call
+ *   usage           a mistake caught before any request (UsageError): nothing was sent, so
+ *                   do not blame the server — fix the call (status is 0 here)
  *   unknown         none of the above
  */
 type ErrorKind = "auth" | "forbidden" | "notFound" | "invalid" | "transient" | "aborted" | "commandFailure" | "protocol" | "usage" | "unknown";
@@ -4302,7 +4303,7 @@ interface Violation {
     rule: string;
     /** "Story.Scope" when the violation names an attribute; null otherwise. */
     attribute: AttributeTokenRef | null;
-    /** The loc-2 tag naming what was violated, when the message carries one. */
+    /** The loc-2 tag naming what was violated (`AttributeDefinition'Scope'Story`), when the message carries one; null for the token spelling. */
     tag: string | null;
 }
 /** The violation a failure message describes, or null when it is not one. */
@@ -4311,6 +4312,8 @@ declare function parseViolation(message: string): Violation | null;
 declare function failuresOf<Row extends Asset = Asset>(response: AssetApiResponse<Row>): CommandFailureDetail[];
 /** What a batch did, in the model's terms: the services read this, never the envelope. */
 interface Outcome<Row extends Asset = Asset> {
+    /** The server's id for the request: what to quote when asking about a batch. Null for an outcome merged from several sends. */
+    requestId: string | null;
     created: Oid[];
     modified: Oid[];
     operated: Oid[];
@@ -4319,7 +4322,12 @@ interface Outcome<Row extends Asset = Asset> {
     queryResults: (Row[] | null)[];
     durationSeconds: number | null;
 }
-/** The outcome of a (translated) response: OIDs momentless, failures normalised. */
+/**
+ * The outcome of a (translated) response: OIDs momentless, failures
+ * normalised. Every field has a default, so a partial envelope (a test fake
+ * that sends only queryResult) still yields a complete Outcome; consumers'
+ * fakes rely on that, and the unit tests keep it so.
+ */
 declare function outcomeOf<Row extends Asset = Asset>(response: AssetApiResponse<Row>): Outcome<Row>;
 /** An outcome with nothing in it, to merge several sends into. */
 declare const emptyOutcome: <Row extends Asset = Asset>() => Outcome<Row>;
@@ -4773,6 +4781,40 @@ declare function reversible(transport: Transport, receipt: Pick<Receipt, "revers
     reactivated: Oid[];
 }>;
 
+/**
+ * The fields service: what a form for an asset type in a scope needs to
+ * know, from three sources the API keeps apart —
+ *   - meta.v1 (through the schema): which attributes are REQUIRED to
+ *     create one (IsRequired and writable: Name and Scope on a Story);
+ *   - api/visibleFields: which attributes the product SHOWS for the type
+ *     in that scope, custom fields included once configured;
+ *   - the scope's Scheme: its IMPORTANT fields (Scheme.ImportantFields, a
+ *     list of attribute tokens) and whether they are enforced at close
+ *     (Scheme.IsRequiredAtClose).
+ * One call, one answer, every list spelled as bare attribute names.
+ */
+
+interface FieldsOf {
+    type: AssetTypeToken;
+    scope: Oid;
+    /** The scope's Scheme; null when the scope has none. */
+    scheme: Oid | null;
+    /** Attributes the server requires on a create (meta: IsRequired, writable). */
+    required: string[];
+    /** Attributes the product shows for the type in this scope (api/visibleFields). */
+    visible: string[];
+    /** The scheme's important fields that belong to this type (or an ancestor); [] when the scheme names none. */
+    important: string[];
+    /** Whether the scheme enforces its important fields when an asset is closed. */
+    requiredAtClose: boolean;
+}
+/**
+ * An important-field token as the scheme spells it ("Story.Owners", or a
+ * bare "Owners") reduced to the attribute name when it belongs to one of
+ * the types given; null otherwise.
+ */
+declare function importantName(token: string, types: readonly AssetTypeToken[]): string | null;
+
 /**
  * The guard: an api/asset batch sent as a compare-and-set, so a change only
  * lands on an asset nobody else has changed since it was read. Ported from
@@ -5012,6 +5054,33 @@ interface ReadResult<Row extends Asset = Asset> {
 declare const list: <Row extends Asset = Asset>(transport: Transport, type: string, params: ReadParams) => Promise<ReadResult<Row>>;
 /** One asset by OID. */
 declare function get<Row extends Asset = Asset>(transport: Transport, oid: Oid, select?: string[]): Promise<Row>;
+/**
+ * What an operation answered with: the asset the server returned, as an
+ * OID token — for Copy the copy, for anything else the operated asset —
+ * and the moment the server stamped on it.
+ */
+interface OperationResult {
+    oid: Oid;
+    moment: string | null;
+}
+/**
+ * Run an operation (Copy, Inactivate, …) through rest-1, for its result.
+ * api/asset's `execute` performs the same operations but reports only the
+ * operated asset, so a Copy's new OID is unobservable there; rest-1 answers
+ * it. Not idempotent: never retried.
+ */
+declare function operate(transport: Transport, oid: Oid, op: string): Promise<OperationResult>;
+/** A new asset's template as the model carries it: the attributes the initializer set, no `_oid`. */
+type Template<Row extends Asset = Asset> = Partial<Omit<Row, "_oid">>;
+/**
+ * The template for a new asset of `type` in a context (a Scope, a parent
+ * asset): what the server's initializer would fill in — defaults nothing
+ * else exposes. Idempotent, like any GET. Without a context the template
+ * is empty, and an unknown context is echoed back, not refused.
+ */
+declare function template<Row extends Asset = Asset>(transport: Transport, type: string, options?: {
+    ctx?: Oid;
+}): Promise<Template<Row>>;
 /** A bounded history read: one row per moment, _oid carrying the moment. */
 declare const history: <Row extends Asset = Asset>(transport: Transport, target: string, params: ReadParams) => Promise<ReadResult<Row>>;
 
@@ -5019,18 +5088,22 @@ type rest1_AssetDocument = AssetDocument;
 type rest1_AssetRefDocument = AssetRefDocument;
 type rest1_AssetsDocument = AssetsDocument;
 type rest1_AttributeDocument = AttributeDocument;
+type rest1_OperationResult = OperationResult;
 type rest1_ReadParams = ReadParams;
 type rest1_ReadResult<Row extends Asset = Asset> = ReadResult<Row>;
 type rest1_RelationDocument = RelationDocument;
+type rest1_Template<Row extends Asset = Asset> = Template<Row>;
 declare const rest1_fromAssetDocument: typeof fromAssetDocument;
 declare const rest1_get: typeof get;
 declare const rest1_history: typeof history;
 declare const rest1_list: typeof list;
 declare const rest1_momentless: typeof momentless;
+declare const rest1_operate: typeof operate;
+declare const rest1_template: typeof template;
 declare const rest1_toQuery: typeof toQuery;
 declare namespace rest1 {
-  export { rest1_fromAssetDocument as fromAssetDocument, rest1_get as get, rest1_history as history, rest1_list as list, rest1_momentless as momentless, rest1_toQuery as toQuery };
-  export type { rest1_AssetDocument as AssetDocument, rest1_AssetRefDocument as AssetRefDocument, rest1_AssetsDocument as AssetsDocument, rest1_AttributeDocument as AttributeDocument, rest1_ReadParams as ReadParams, rest1_ReadResult as ReadResult, rest1_RelationDocument as RelationDocument };
+  export { rest1_fromAssetDocument as fromAssetDocument, rest1_get as get, rest1_history as history, rest1_list as list, rest1_momentless as momentless, rest1_operate as operate, rest1_template as template, rest1_toQuery as toQuery };
+  export type { rest1_AssetDocument as AssetDocument, rest1_AssetRefDocument as AssetRefDocument, rest1_AssetsDocument as AssetsDocument, rest1_AttributeDocument as AttributeDocument, rest1_OperationResult as OperationResult, rest1_ReadParams as ReadParams, rest1_ReadResult as ReadResult, rest1_RelationDocument as RelationDocument, rest1_Template as Template };
 }
 
 interface ClientOptions {
@@ -5076,12 +5149,15 @@ type Me = Pick<Member, "_oid" | "Name" | "Username" | "Nickname" | "Email">;
  * every write answers in the model's terms (an Outcome, never an envelope).
  *
  * Reads: `query`, `queries`, `get`, `queryPage`, `pages`, `all`, `me`. A
- * query body is the same everywhere; the client picks the endpoint
- * (query.v1 for plain reads — read-only by construction, so a request can
- * be retried like a GET; api/asset where a total is wanted; rest-1 behind
- * `data` for deleted assets and history). Writes: `assets.send`,
- * `assets.sendGuarded`, `batch.run`. Services: `resolve`, `attachments`,
- * `embeddedImages`, `schema`, `localize`, `urls`.
+ * query body is the same everywhere; the client picks the endpoint.
+ * query.v1 answers rows alone — the lightest response, and read-only by
+ * construction, so a request can be resent like a GET — but its shape has
+ * nowhere to put a total; api/asset reports one (`needTotal`) beside the
+ * rows, which is why `queryPage` goes there and `query` does not. rest-1
+ * sits behind `data` for what neither does: deleted assets, history, a
+ * new asset's template, an operation's result. Writes: `assets.send`,
+ * `assets.sendGuarded`, `batch.run`, `copy`. Services: `resolve`,
+ * `fields`, `attachments`, `embeddedImages`, `schema`, `localize`, `urls`.
  */
 declare class AgilityApiClient {
     readonly transport: Transport;
@@ -5097,9 +5173,12 @@ declare class AgilityApiClient {
     withSignal(signal: AbortSignal): AgilityApiClient;
     /**
      * One query, its rows, translated. Sent to query.v1: it cannot write, so
-     * the request is retried like a GET after a network failure or a 5xx. A
-     * page is required; a query the server refuses throws (kind "invalid"),
-     * never an empty result.
+     * the request is marked idempotent and the transport may resend it after
+     * a network failure or a 5xx — when `retries` is set above its default
+     * of 0. A page is required; a query the server refuses throws an
+     * ApiError (kind "invalid", code QUERY_REJECTED; `message` holds the
+     * server's sentences, `details` its whole error document), never an
+     * empty result.
      */
     query<const F extends From, const Q extends QueryBody<F>>(q: Q & QueryBody<F>): Promise<RowOf<Q>[]>;
     query<Row extends Asset = Asset>(q: QueryBody): Promise<Row[]>;
@@ -5147,16 +5226,39 @@ declare class AgilityApiClient {
      */
     localize(tags: readonly string[], options?: LocalizeOptions): Promise<Localizations>;
     /**
-     * rest-1.v1, for what query.v1 cannot do: deleted assets (`deleted:
-     * true`), one asset by OID without a page, and history (one row per
-     * moment). Parameters are spelled as a query's (`select`, `filter`).
+     * rest-1.v1, for what the other endpoints cannot do: deleted assets
+     * (`deleted: true`), one asset by OID without a page, history (one row
+     * per moment), a new asset's template (`template`: what the type's
+     * initializer fills in for a context — a Timebox's next name and dates,
+     * a Story's carry-over from a Request), and an operation's result
+     * (`operate`: api/asset performs a Copy but never says what it made;
+     * rest-1 answers the new OID). Parameters are spelled as a query's
+     * (`select`, `filter`).
      */
     readonly data: {
         list: <Row extends Asset = Asset>(type: string, params: ReadParams) => Promise<ReadResult<Row>>;
         get: <Row extends Asset = Asset>(oid: string, select?: string[]) => Promise<Row>;
         history: <Row extends Asset = Asset>(target: string, params: ReadParams) => Promise<ReadResult<Row>>;
+        template: <F extends From>(type: F, options?: {
+            ctx?: Oid;
+        }) => Promise<Partial<Omit<TypeOf<F>, "_oid">>>;
+        operate: (oid: Oid, op: string) => Promise<OperationResult>;
+    };
+    /** Copy an asset (the server's Copy operation) and answer the copy's OID: the one thing api/asset's `execute: "Copy"` does not say. */
+    copy(oid: Oid): Promise<Oid>;
+    /**
+     * What a form needs for an asset type in a scope: the attributes the
+     * server requires to create one (meta), the ones the product shows there
+     * (api/visibleFields, custom fields included once configured), and the
+     * scope's scheme's important fields and whether they are enforced at
+     * close. `visible` alone answers for several types and scopes at once.
+     */
+    readonly fields: {
+        describe: (type: From, scope: Oid) => Promise<FieldsOf>;
+        visible: (types: readonly From[], scopes: readonly Oid[]) => Promise<Record<string, string[]>>;
+        visibleByAsset: (oid: Oid) => Promise<string[]>;
     };
-    /** @deprecated since 1.0.0-alpha.3: `client.query` / `client.queries` read through query.v1. Removed in 1.0.0. */
+    /** @deprecated since 1.0.0-alpha.3: use `client.query` / `client.queries` (the same endpoint, query.v1; only the name moved). Removed in 1.0.0. */
     readonly queryV1: {
         query: <Row extends Asset = Asset>(q: QueryBody) => Promise<Row[]>;
         queries: <Row extends Asset = Asset>(qs: QueryBody[]) => Promise<Row[][]>;
@@ -5181,7 +5283,7 @@ declare class AgilityApiClient {
          * cover.
          */
         sendGuarded: <Row extends Asset = Asset>(commands: Command[], options?: Pick<SendOptions, "throwOnFailure">) => Promise<GuardedResult<Row>>;
-        /** @deprecated since 1.0.0-alpha.3: use `client.query` (or `client.queryPage` for a total). Removed in 1.0.0. */
+        /** @deprecated since 1.0.0-alpha.3: use `client.query` (rows, through query.v1) or `client.queryPage` (rows and a total, through api/asset as this does). Removed in 1.0.0. */
         query: <Row extends Asset = Asset>(q: QueryBody) => Promise<Row[]>;
         /** @deprecated since 1.0.0-alpha.3: use `client.queries`. Removed in 1.0.0. */
         queries: <Row extends Asset = Asset>(qs: QueryBody[]) => Promise<Row[][]>;
@@ -5265,8 +5367,13 @@ declare class AgilityApiClient {
     };
     /** Where a browser opens things on this instance: an asset's page, an attachment's bytes, an embedded image. */
     readonly urls: {
-        /** The asset's page: assetdetail.v1 redirects to the type's own detail page (live 2026-11-12). */
-        asset: (oid: Oid) => string;
+        /**
+         * The asset's page, from an OID token or an asset Number (S-01001,
+         * what a person typed and what a message shows): assetdetail.v1
+         * resolves either and redirects to the type's own detail page; a signed-
+         * out reader lands there after logging in. Anything else is a UsageError.
+         */
+        asset: (ref: Oid | string) => string;
         attachment: (id: string | number) => string;
         embeddedImage: (id: string | number) => string;
     };
@@ -5369,5 +5476,19 @@ declare namespace queryV1 {
   };
 }
 
-export { ASSET_STATE_CODES, AgilityApiClient, ApiError, AttachmentUploadError, BatchRecordError, BatchSendError, CommandFailureError, INLINE_LIMIT, INVERSE, NUMBER_ROOTS, CHUNK as RESOLVE_CHUNK, Schema, TypeCache, UNGUARDABLE_TYPES, UnguardableError, UsageError, WrappedError, assetApi, assetStateOf, attachment, createFetchTransport, describe as describeBatch, guard, isAssetNumber, isOidToken, kindOf, loc2, meta, momentless, namesOf, parseOid, parseViolation, queryV1, resolveNumbers, resolveRef, rest1, reverseOf, reversible, runBatch, select, sendGuarded, snapshot, stampsOf, toOid, touchedBy, typeOfOid, unguardable };
-export type { Access, Actual, Allocation, Application, Asset, AssetApiResponse, AssetChangedEventDefinition, AssetCreatedEventDefinition, AssetDocument, AssetNumberAttributeDefinition, AssetStateValue, AssetType, AssetTypeMap, AssetTypeName, AssetTypeToken, AssetsDocument, Attachment, AddOptions as AttachmentAddOptions, AttachmentCategory, AttachmentInfo, AttributeAddedEventDefinition, AttributeChangedEventDefinition, AttributeDefinition, AttributeLookup, AttributeRemovedEventDefinition, AttributeTokenRef, AttributeType, AttributeValue, BaseAsset, BatchOptions, Budget, BuildProject, BuildRun, BuildSource, BuildStatus, Bundle, BusinessRule, Bytes, CalendarEvent, CalendarEventCategory, Capacity, ChangeSet, ClassOfService, ClientConfig, ClientOptions, Command, CommandBody, CommandFailureDetail, CommandValue, Community, Concept, ConcreteAssetTypeName, Conversation, CreateBody, CreateType, CredentialsAttributeDefinition, CustomAttributes, CustomList, DateString, DefaultRule, Defect, DefectResolution, DefectType, Delivery, DeliveryCategory, Described, EmbeddedImage$1 as EmbeddedImage, Environment, Epic, EpicCategory, EpicPriority, EpicStatus, ErrorKind, ExecuteBody, ExecuteSecurityCheckAttributeDefinition, Expression, ExpressionImage, ExpressionSpace, ExternalAction, ExternalActionInvocation, FetchTransportConfig, From, Goal, GoalCategory, GoalPriority, Grant, GuardedResult, HierarchyRelationDefinition, Idea, IdeaCategory, IdeaChangeSet, IdeaComment, IdeaForum, IdeaStatus, IdeaUser, IdeasUserCache, Image, Issue, IssueCategory, IssuePriority, IssueResolution, IssueStatus, KeyResult, KeyResultCommitment, KeyResultUnit, Label, Link, LinkCategory, List, Localizations, LocalizeOptions, ManyToManyRelationDefinition, Me, Member, MemberLabel, Message, MessageReceipt, Metamodel, Milestone, MilestoneCategory, MultivalueAttributeDefinition, NameLookupFailure, Named, NoteCategory, Oid, OidParts, Okr, OkrObjective, OkrSession, OneToManyRelationDefinition, OperationExecutedEventDefinition, Outcome, Page, PagesOptions, PasswordAttributeDefinition, Phase, PlanningLevel, PlanningRoom, PrimaryWorkitem, PrincipalAttributeDefinition, Publication, QueryBody, ReadOptions, ReadParams, ReadResult, Receipt, Ref, RegressionPlan, RegressionSuite, RegressionTest, RegressionTestStatus, Release, Request, RequestBody, RequestCategory, RequestOptions, RequestPriority, RequestResolution, RequestStatus, Resolution, ResolvedAsset, ResponseType, Retrospective, RetrospectivePrompt, RetrospectiveTopic, Reverse, Roadmap, Role, Room, RowContext, RowOf, RowsOf, SavedView, Schedule, Scheme, Scope, ScopeLabel, ScopeStatus, SelectKey, SelectPath, SelectValue, Selected, SendOptions, SimpleAttributeDefinition, State, Status, Story, StoryCategory, StorySource, StoryStatus, StrategicTheme, StrategicThemeLevel, Subscription, SubscriptionTerm, SyntheticAttributeDefinition, Task, TaskCategory, TaskSource, TaskStatus, Team, TeamRoom, TeamWorkflow, Test, TestCategory, TestRun, TestSet, TestStatus, TestSuite, Theme, ThemeCategory, ThemeLabel, ThemeSource, ThemeStatus, Timebox, Timesheet, Topic, Transport, TriggerType, TypeOf, UnauthorizedContext, UnauthorizedDecision, Unguardable, UpdateBody, UpdateSecurityCheckAttributeDefinition, ValueStream, VersionLabel, Violation, Workflow, WorkflowTransition, Workitem, WorkitemPriority, WorkitemRisk };
+/** The attributes shown for each type in the scopes given: a map from type token to sorted attribute names. */
+declare function visibleFields(transport: Transport, types: readonly AssetTypeToken[], scopes: readonly Oid[]): Promise<Record<AssetTypeToken, string[]>>;
+/** The attributes shown for one asset, in its own Scope. */
+declare function visibleFieldsByAsset(transport: Transport, oid: Oid): Promise<string[]>;
+
+declare const fields_visibleFields: typeof visibleFields;
+declare const fields_visibleFieldsByAsset: typeof visibleFieldsByAsset;
+declare namespace fields {
+  export {
+    fields_visibleFields as visibleFields,
+    fields_visibleFieldsByAsset as visibleFieldsByAsset,
+  };
+}
+
+export { ASSET_STATE_CODES, AgilityApiClient, ApiError, AttachmentUploadError, BatchRecordError, BatchSendError, CommandFailureError, INLINE_LIMIT, INVERSE, NUMBER_ROOTS, CHUNK as RESOLVE_CHUNK, Schema, TypeCache, UNGUARDABLE_TYPES, UnguardableError, UsageError, WrappedError, assetApi, assetStateOf, attachment, createFetchTransport, describe as describeBatch, fields, guard, importantName, isAssetNumber, isOidToken, kindOf, loc2, meta, momentless, namesOf, parseOid, parseViolation, queryV1, resolveNumbers, resolveRef, rest1, reverseOf, reversible, runBatch, select, sendGuarded, snapshot, stampsOf, toOid, touchedBy, typeOfOid, unguardable };
+export type { Access, Actual, Allocation, Application, Asset, AssetApiResponse, AssetChangedEventDefinition, AssetCreatedEventDefinition, AssetDocument, AssetNumberAttributeDefinition, AssetStateValue, AssetType, AssetTypeMap, AssetTypeName, AssetTypeToken, AssetsDocument, Attachment, AddOptions as AttachmentAddOptions, AttachmentCategory, AttachmentInfo, AttributeAddedEventDefinition, AttributeChangedEventDefinition, AttributeDefinition, AttributeLookup, AttributeRemovedEventDefinition, AttributeTokenRef, AttributeType, AttributeValue, BaseAsset, BatchOptions, Budget, BuildProject, BuildRun, BuildSource, BuildStatus, Bundle, BusinessRule, Bytes, CalendarEvent, CalendarEventCategory, Capacity, ChangeSet, ClassOfService, ClientConfig, ClientOptions, Command, CommandBody, CommandFailureDetail, CommandValue, Community, Concept, ConcreteAssetTypeName, Conversation, CreateBody, CreateType, CredentialsAttributeDefinition, CustomAttributes, CustomList, DateString, DefaultRule, Defect, DefectResolution, DefectType, Delivery, DeliveryCategory, Described, EmbeddedImage$1 as EmbeddedImage, Environment, Epic, EpicCategory, EpicPriority, EpicStatus, ErrorKind, ExecuteBody, ExecuteSecurityCheckAttributeDefinition, Expression, ExpressionImage, ExpressionSpace, ExternalAction, ExternalActionInvocation, FetchTransportConfig, FieldsOf, From, Goal, GoalCategory, GoalPriority, Grant, GuardedResult, HierarchyRelationDefinition, Idea, IdeaCategory, IdeaChangeSet, IdeaComment, IdeaForum, IdeaStatus, IdeaUser, IdeasUserCache, Image, Issue, IssueCategory, IssuePriority, IssueResolution, IssueStatus, KeyResult, KeyResultCommitment, KeyResultUnit, Label, Link, LinkCategory, List, Localizations, LocalizeOptions, ManyToManyRelationDefinition, Me, Member, MemberLabel, Message, MessageReceipt, Metamodel, Milestone, MilestoneCategory, MultivalueAttributeDefinition, NameLookupFailure, Named, NoteCategory, Oid, OidParts, Okr, OkrObjective, OkrSession, OneToManyRelationDefinition, OperationExecutedEventDefinition, OperationResult, Outcome, Page, PagesOptions, PasswordAttributeDefinition, Phase, PlanningLevel, PlanningRoom, PrimaryWorkitem, PrincipalAttributeDefinition, Publication, QueryBody, ReadOptions, ReadParams, ReadResult, Receipt, Ref, RegressionPlan, RegressionSuite, RegressionTest, RegressionTestStatus, Release, Request, RequestBody, RequestCategory, RequestOptions, RequestPriority, RequestResolution, RequestStatus, Resolution, ResolvedAsset, ResponseType, Retrospective, RetrospectivePrompt, RetrospectiveTopic, Reverse, Roadmap, Role, Room, RowContext, RowOf, RowsOf, SavedView, Schedule, Scheme, Scope, ScopeLabel, ScopeStatus, SelectKey, SelectPath, SelectValue, Selected, SendOptions, SimpleAttributeDefinition, State, Status, Story, StoryCategory, StorySource, StoryStatus, StrategicTheme, StrategicThemeLevel, Subscription, SubscriptionTerm, SyntheticAttributeDefinition, Task, TaskCategory, TaskSource, TaskStatus, Team, TeamRoom, TeamWorkflow, Template, Test, TestCategory, TestRun, TestSet, TestStatus, TestSuite, Theme, ThemeCategory, ThemeLabel, ThemeSource, ThemeStatus, Timebox, Timesheet, Topic, Transport, TriggerType, TypeOf, UnauthorizedContext, UnauthorizedDecision, Unguardable, UpdateBody, UpdateSecurityCheckAttributeDefinition, ValueStream, VersionLabel, Violation, Workflow, WorkflowTransition, Workitem, WorkitemPriority, WorkitemRisk };