@taktoria/sdk 0.1.6 → 0.2.1

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@taktoria/sdk",
-        "X-Fern-SDK-Version": "0.1.6",
-        "User-Agent": "@taktoria/sdk/0.1.6",
+        "X-Fern-SDK-Version": "0.2.1",
+        "User-Agent": "@taktoria/sdk/0.2.1",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/okr/client/Client.d.ts

@@ -55,10 +55,12 @@ export declare class OkrClient {
      * @example
      *     await client.okr.createObjective({
      *         title: "Make onboarding effortless",
+     *         tags: ["onboarding"],
      *         year: 2026,
      *         quarter: 3,
      *         keyResults: [{
      *                 title: "Median time to first launch under 10 minutes",
+     *                 tags: ["activation"],
      *                 priority: "P1"
      *             }, {
      *                 title: "90% of new workspaces invite a second person",

package/dist/cjs/api/resources/okr/client/Client.js

@@ -83,7 +83,7 @@ class OkrClient {
     __listObjectives() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, quarter, teamId, ownerUserId, visibility, q, draft, archived, limit, cursor } = request;
+            const { year, quarter, teamId, ownerUserId, visibility, tag, q, draft, archived, limit, cursor } = request;
             const _queryParams = {
                 year,
                 quarter,
@@ -95,6 +95,7 @@ class OkrClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                tag,
                 q,
                 draft,
                 archived,
@@ -190,10 +191,12 @@ class OkrClient {
      * @example
      *     await client.okr.createObjective({
      *         title: "Make onboarding effortless",
+     *         tags: ["onboarding"],
      *         year: 2026,
      *         quarter: 3,
      *         keyResults: [{
      *                 title: "Median time to first launch under 10 minutes",
+     *                 tags: ["activation"],
      *                 priority: "P1"
      *             }, {
      *                 title: "90% of new workspaces invite a second person",
@@ -1220,7 +1223,7 @@ class OkrClient {
     __getScorecard() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, teamId, priority, frame, mid } = request;
+            const { year, teamId, priority, tag, frame, mid } = request;
             const _queryParams = {
                 year,
                 teamId,
@@ -1230,6 +1233,7 @@ class OkrClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                tag,
                 frame,
                 mid,
             };
@@ -2135,7 +2139,7 @@ class OkrClient {
     __listMyObjectives() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, quarter, period, teamId, priority, includeTeams, q, sort, limit, cursor } = request;
+            const { year, quarter, period, teamId, priority, includeTeams, tag, q, sort, limit, cursor } = request;
             const _queryParams = {
                 year,
                 quarter,
@@ -2153,6 +2157,7 @@ class OkrClient {
                     })
                     : undefined,
                 includeTeams,
+                tag,
                 q,
                 sort,
                 limit,
@@ -2259,7 +2264,7 @@ class OkrClient {
     __browseObjectives() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, quarter, period, allPeriods, teamId, priority, q, sort, limit, cursor } = request;
+            const { year, quarter, period, allPeriods, teamId, priority, tag, q, sort, limit, cursor } = request;
             const _queryParams = {
                 year,
                 quarter,
@@ -2277,6 +2282,7 @@ class OkrClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                tag,
                 q,
                 sort,
                 limit,
@@ -2375,7 +2381,7 @@ class OkrClient {
     __listTeamScores() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, quarter, period, q, sort, onlyScored, limit, cursor } = request;
+            const { year, quarter, period, q, sort, onlyScored, tag, limit, cursor } = request;
             const _queryParams = {
                 year,
                 quarter,
@@ -2388,6 +2394,7 @@ class OkrClient {
                 q,
                 sort,
                 onlyScored,
+                tag,
                 limit,
                 cursor,
             };
@@ -2484,7 +2491,7 @@ class OkrClient {
     __getTeamOkrs(teamSlug_1) {
         return __awaiter(this, arguments, void 0, function* (teamSlug, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, quarter, period } = request;
+            const { year, quarter, period, tag } = request;
             const _queryParams = {
                 year,
                 quarter,
@@ -2494,6 +2501,7 @@ class OkrClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                tag,
             };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);

package/dist/cjs/api/resources/okr/client/requests/BrowseObjectivesRequest.d.ts

@@ -15,7 +15,12 @@ export interface BrowseObjectivesRequest {
     teamId?: string | string[];
     /** Only objectives holding a key result of this priority. */
     priority?: Taktoria.OkrPriority;
-    /** Words in titles, descriptions, key results, owners and teams. See Searching. */
+    /**
+     * Only objectives carrying this tag, or holding a key result that
+     * does. One word, matched whole; case and a leading `#` are ignored.
+     */
+    tag?: string;
+    /** Words in titles, descriptions, tags, key results, owners and teams. See Searching. */
     q?: string;
     /** `order` (the workspace's own, the default), `high` or `low` by score, unscored last. */
     sort?: string;

package/dist/cjs/api/resources/okr/client/requests/GetScorecardRequest.d.ts

@@ -17,6 +17,11 @@ export interface GetScorecardRequest {
      * their cells rolled up from those key results alone.
      */
     priority?: Taktoria.OkrPriority;
+    /**
+     * Only objectives carrying this tag, or holding a key result that
+     * does. One word, matched whole; case and a leading `#` are ignored.
+     */
+    tag?: string;
     /** `annual`, or a quarter `1` to `4`. Every period when left out. */
     frame?: string | string[];
     /** `false` leaves out the mid-quarter columns. */

package/dist/cjs/api/resources/okr/client/requests/GetTeamOkrsRequest.d.ts

@@ -8,4 +8,9 @@ export interface GetTeamOkrsRequest {
     year?: number;
     quarter?: number;
     period?: Taktoria.OkrPeriod;
+    /**
+     * Only objectives carrying this tag, or holding a key result that
+     * does. One word, matched whole; case and a leading `#` are ignored.
+     */
+    tag?: string;
 }

package/dist/cjs/api/resources/okr/client/requests/ListMyObjectivesRequest.d.ts

@@ -18,7 +18,12 @@ export interface ListMyObjectivesRequest {
     priority?: Taktoria.OkrPriority;
     /** `false` for what is theirs in person only, not their teams'. */
     includeTeams?: boolean;
-    /** Words in titles, descriptions, key results, owners and teams. See Searching. */
+    /**
+     * Only objectives carrying this tag, or holding a key result that
+     * does. One word, matched whole; case and a leading `#` are ignored.
+     */
+    tag?: string;
+    /** Words in titles, descriptions, tags, key results, owners and teams. See Searching. */
     q?: string;
     /** `order` (the workspace's own, the default), `high` or `low` by score, unscored last. */
     sort?: string;

package/dist/cjs/api/resources/okr/client/requests/ListObjectivesRequest.d.ts

@@ -16,7 +16,12 @@ export interface ListObjectivesRequest {
     teamId?: string;
     ownerUserId?: string;
     visibility?: Taktoria.OkrVisibility;
-    /** Search objectives by their title, description, key results' titles, owner's name and team's name, among those the caller may see (a private objective only by those allowed to see it). Every word must appear in one of those fields; case and accents are ignored; at most 100 characters and 8 words. See Searching under Errors and pagination. */
+    /**
+     * Only objectives carrying this tag, or holding a key result that
+     * does. One word, matched whole; case and a leading `#` are ignored.
+     */
+    tag?: string;
+    /** Search objectives by their title, description, tags, key results' titles, descriptions and tags, owner's name and team's name, among those the caller may see (a private objective only by those allowed to see it). Every word must appear in one of those fields; case and accents are ignored; at most 100 characters and 8 words. See Searching under Errors and pagination. */
     q?: string;
     /** `true` lists only drafts and `false` only what is published; left out, both. */
     draft?: boolean;

package/dist/cjs/api/resources/okr/client/requests/ListTeamScoresRequest.d.ts

@@ -16,6 +16,12 @@ export interface ListTeamScoresRequest {
     sort?: string;
     /** `true` keeps only the teams with a score. */
     onlyScored?: boolean;
+    /**
+     * Only teams holding an objective that carries this tag, or a key
+     * result that does, each scored on those alone. One word, matched
+     * whole.
+     */
+    tag?: string;
     /** At most 100; 50 when left out. */
     limit?: number;
     cursor?: string;

package/dist/cjs/api/resources/okr/types/CreateKeyResultRequest.d.ts

@@ -3,10 +3,15 @@ import type * as Taktoria from "../../../index.js";
  * Owners must be members and teams of the workspace; an id from anywhere
  * else is refused with a 422, and `details.unknown` names it: nobody is
  * dropped. The title is trimmed and never blank (at most 500
- * characters).
+ * characters). A description (at most 5000) and tags (at most 10, one
+ * word each, stored lowercase) are optional, as on an objective.
  */
 export interface CreateKeyResultRequest {
     title: string;
+    /** Optional; trimmed, blank meaning none, at most 5000 characters. */
+    description?: string;
+    /** Optional, at most 10: one word each, stored lowercase without a leading `#`. */
+    tags?: string[];
     /**
      * A first score, 0.0 to 1.0. It is recorded as a check-in by the
      * caller (a key's maker, for a key), as setting one later is.

package/dist/cjs/api/resources/okr/types/CreateObjectiveRequest.d.ts

@@ -3,8 +3,12 @@ import type * as Taktoria from "../../../index.js";
  * The same rules as the dashboard's forms and the MCP server's tools:
  *
  * - `title` is trimmed, and a 422 if nothing is left (at most 500
- *   characters); `description` is trimmed, blank meaning none (at most
- *   5000).
+ *   characters); `description` is optional, trimmed, blank meaning
+ *   none (at most 5000).
+ * - `tags` are optional: at most 10, each one word of letters, digits,
+ *   `-` or `_`, at most 32 characters. They are stored lowercase, without
+ *   a leading `#`, each once; anything else is a 422 naming the tag in
+ *   `details.tag`.
  * - `year` is a fiscal year from 2000 to 2100, and `weight` from 0.01 to
  *   100: there is no weight of 0, which the rollup never treated as
  *   "not counted".
@@ -26,7 +30,10 @@ import type * as Taktoria from "../../../index.js";
 export interface CreateObjectiveRequest {
     /** Trimmed; never blank, at most 500 characters. */
     title: string;
+    /** Optional; trimmed, blank meaning none, at most 5000 characters. */
     description?: string;
+    /** Optional, at most 10: one word each, stored lowercase without a leading `#`. */
+    tags?: string[];
     period?: Taktoria.OkrPeriod;
     /** The fiscal year, 2000 to 2100. */
     year: number;

package/dist/cjs/api/resources/okr/types/KeyResult.d.ts

@@ -8,6 +8,13 @@ export interface KeyResult {
     id: string;
     objectiveId: string;
     title: string;
+    /** What it means and how it is measured, if anybody said. Absent when none. */
+    description?: string;
+    /**
+     * Its tags, A to Z: free text, one lowercase word each (letters,
+     * digits, `-` and `_`), at most 10. Filter by one with `tag`.
+     */
+    tags: string[];
     /**
      * Google-style grade from 0.0 to 1.0, or absent until it has been
      * scored. 0.7 and up is delivered for an ambitious goal, 0.4 to 0.7

package/dist/cjs/api/resources/okr/types/Objective.d.ts

@@ -7,6 +7,11 @@ export interface Objective {
     organizationId: string;
     title: string;
     description?: string;
+    /**
+     * Its tags, A to Z: free text, one lowercase word each (letters,
+     * digits, `-` and `_`), at most 10. Filter by one with `tag`.
+     */
+    tags: string[];
     period: Taktoria.OkrPeriod;
     /** The fiscal year, 2000 to 2100, named by the year its Q1 falls in. */
     year: number;

package/dist/cjs/api/resources/okr/types/ScorecardKeyResultRow.d.ts

@@ -2,6 +2,9 @@ import type * as Taktoria from "../../../index.js";
 export interface ScorecardKeyResultRow {
     keyResultId: string;
     title: string;
+    description?: string;
+    /** Its tags, A to Z. */
+    tags: string[];
     priority?: Taktoria.OkrPriority;
     weight: number;
     cells: Record<string, Taktoria.ScorecardCell>;

package/dist/cjs/api/resources/okr/types/ScorecardRow.d.ts

@@ -5,6 +5,9 @@ import type * as Taktoria from "../../../index.js";
 export interface ScorecardRow {
     objectiveId: string;
     title: string;
+    description?: string;
+    /** Its tags, A to Z. */
+    tags: string[];
     weight: number;
     timeframe: Taktoria.ScorecardTimeframe;
     /** Rolled up from its key results, by weight. */

package/dist/cjs/api/resources/okr/types/UpdateKeyResultRequest.d.ts

@@ -5,10 +5,15 @@ import type * as Taktoria from "../../../index.js";
  * Anybody new on it must be a member or team of this workspace (a 422
  * naming them in `details.unknown`); an owner already on it who has
  * since left may stay. The title is trimmed and never blank; the weight
- * is 0.01 to 100.
+ * is 0.01 to 100. `tags` sent replace the ones it had, so `[]` removes
+ * them all.
  */
 export interface UpdateKeyResultRequest {
     title?: string;
+    /** Blank or `null` removes it. */
+    description?: string;
+    /** Replaces its tags; `[]` removes them all. */
+    tags?: string[];
     /**
      * A new score, 0.0 to 1.0, is recorded as a check-in with no note,
      * by the caller (a key's maker, for a key), and the activity feed

package/dist/cjs/api/resources/okr/types/UpdateObjectiveRequest.d.ts

@@ -7,11 +7,15 @@ import type * as Taktoria from "../../../index.js";
  * as on create; the owner it already has may stay, even if they have
  * since left. The fields sent meet the same rules as on create: a title
  * trimmed and never blank, a year from 2000 to 2100, a weight from 0.01
- * to 100.
+ * to 100, tags one word each. `tags` sent replace the ones it had, so
+ * `[]` removes them all; left out, they stay.
  */
 export interface UpdateObjectiveRequest {
     title?: string;
+    /** Blank or `null` removes it. */
     description?: string;
+    /** Replaces its tags; `[]` removes them all. */
+    tags?: string[];
     period?: Taktoria.OkrPeriod;
     year?: number;
     quarter?: number;

package/dist/cjs/serialization/resources/okr/types/CreateKeyResultRequest.d.ts

@@ -6,6 +6,8 @@ export declare const CreateKeyResultRequest: core.serialization.ObjectSchema<ser
 export declare namespace CreateKeyResultRequest {
     interface Raw {
         title: string;
+        description?: string | null;
+        tags?: string[] | null;
         score?: number | null;
         weight?: number | null;
         priority?: OkrPriority.Raw | null;

package/dist/cjs/serialization/resources/okr/types/CreateKeyResultRequest.js

@@ -39,6 +39,8 @@ const core = __importStar(require("../../../../core/index.js"));
 const OkrPriority_js_1 = require("./OkrPriority.js");
 exports.CreateKeyResultRequest = core.serialization.object({
     title: core.serialization.string(),
+    description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()).optional(),
     score: core.serialization.number().optional(),
     weight: core.serialization.number().optional(),
     priority: OkrPriority_js_1.OkrPriority.optional(),

package/dist/cjs/serialization/resources/okr/types/CreateObjectiveRequest.d.ts

@@ -9,6 +9,7 @@ export declare namespace CreateObjectiveRequest {
     interface Raw {
         title: string;
         description?: string | null;
+        tags?: string[] | null;
         period?: OkrPeriod.Raw | null;
         year: number;
         quarter?: number | null;

package/dist/cjs/serialization/resources/okr/types/CreateObjectiveRequest.js

@@ -42,6 +42,7 @@ const OkrVisibility_js_1 = require("./OkrVisibility.js");
 exports.CreateObjectiveRequest = core.serialization.object({
     title: core.serialization.string(),
     description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()).optional(),
     period: OkrPeriod_js_1.OkrPeriod.optional(),
     year: core.serialization.number(),
     quarter: core.serialization.number().optional(),

package/dist/cjs/serialization/resources/okr/types/KeyResult.d.ts

@@ -9,6 +9,8 @@ export declare namespace KeyResult {
         id: string;
         objectiveId: string;
         title: string;
+        description?: string | null;
+        tags: string[];
         score?: number | null;
         weight: number;
         priority: OkrPriority.Raw;

package/dist/cjs/serialization/resources/okr/types/KeyResult.js

@@ -42,6 +42,8 @@ exports.KeyResult = core.serialization.object({
     id: core.serialization.string(),
     objectiveId: core.serialization.string(),
     title: core.serialization.string(),
+    description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()),
     score: core.serialization.number().optional(),
     weight: core.serialization.number(),
     priority: OkrPriority_js_1.OkrPriority,

package/dist/cjs/serialization/resources/okr/types/Objective.d.ts

@@ -13,6 +13,7 @@ export declare namespace Objective {
         organizationId: string;
         title: string;
         description?: string | null;
+        tags: string[];
         period: OkrPeriod.Raw;
         year: number;
         quarter?: number | null;

package/dist/cjs/serialization/resources/okr/types/Objective.js

@@ -46,6 +46,7 @@ exports.Objective = core.serialization.object({
     organizationId: core.serialization.string(),
     title: core.serialization.string(),
     description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()),
     period: OkrPeriod_js_1.OkrPeriod,
     year: core.serialization.number(),
     quarter: core.serialization.number().optional(),

package/dist/cjs/serialization/resources/okr/types/ScorecardKeyResultRow.d.ts

@@ -8,6 +8,8 @@ export declare namespace ScorecardKeyResultRow {
     interface Raw {
         keyResultId: string;
         title: string;
+        description?: string | null;
+        tags: string[];
         priority?: OkrPriority.Raw | null;
         weight: number;
         cells: Record<string, ScorecardCell.Raw>;

package/dist/cjs/serialization/resources/okr/types/ScorecardKeyResultRow.js

@@ -41,6 +41,8 @@ const ScorecardCell_js_1 = require("./ScorecardCell.js");
 exports.ScorecardKeyResultRow = core.serialization.object({
     keyResultId: core.serialization.string(),
     title: core.serialization.string(),
+    description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()),
     priority: OkrPriority_js_1.OkrPriority.optional(),
     weight: core.serialization.number(),
     cells: core.serialization.record(core.serialization.string(), ScorecardCell_js_1.ScorecardCell),

package/dist/cjs/serialization/resources/okr/types/ScorecardRow.d.ts

@@ -9,6 +9,8 @@ export declare namespace ScorecardRow {
     interface Raw {
         objectiveId: string;
         title: string;
+        description?: string | null;
+        tags: string[];
         weight: number;
         timeframe: ScorecardTimeframe.Raw;
         cells: Record<string, ScorecardCell.Raw>;

package/dist/cjs/serialization/resources/okr/types/ScorecardRow.js

@@ -42,6 +42,8 @@ const ScorecardTimeframe_js_1 = require("./ScorecardTimeframe.js");
 exports.ScorecardRow = core.serialization.object({
     objectiveId: core.serialization.string(),
     title: core.serialization.string(),
+    description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()),
     weight: core.serialization.number(),
     timeframe: ScorecardTimeframe_js_1.ScorecardTimeframe,
     cells: core.serialization.record(core.serialization.string(), ScorecardCell_js_1.ScorecardCell),

package/dist/cjs/serialization/resources/okr/types/UpdateKeyResultRequest.d.ts

@@ -6,6 +6,8 @@ export declare const UpdateKeyResultRequest: core.serialization.ObjectSchema<ser
 export declare namespace UpdateKeyResultRequest {
     interface Raw {
         title?: string | null;
+        description?: string | null;
+        tags?: string[] | null;
         score?: number | null;
         weight?: number | null;
         priority?: OkrPriority.Raw | null;

package/dist/cjs/serialization/resources/okr/types/UpdateKeyResultRequest.js

@@ -39,6 +39,8 @@ const core = __importStar(require("../../../../core/index.js"));
 const OkrPriority_js_1 = require("./OkrPriority.js");
 exports.UpdateKeyResultRequest = core.serialization.object({
     title: core.serialization.string().optional(),
+    description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()).optional(),
     score: core.serialization.number().optional(),
     weight: core.serialization.number().optional(),
     priority: OkrPriority_js_1.OkrPriority.optional(),

package/dist/cjs/serialization/resources/okr/types/UpdateObjectiveRequest.d.ts

@@ -8,6 +8,7 @@ export declare namespace UpdateObjectiveRequest {
     interface Raw {
         title?: string | null;
         description?: string | null;
+        tags?: string[] | null;
         period?: OkrPeriod.Raw | null;
         year?: number | null;
         quarter?: number | null;

package/dist/cjs/serialization/resources/okr/types/UpdateObjectiveRequest.js

@@ -41,6 +41,7 @@ const OkrVisibility_js_1 = require("./OkrVisibility.js");
 exports.UpdateObjectiveRequest = core.serialization.object({
     title: core.serialization.string().optional(),
     description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()).optional(),
     period: OkrPeriod_js_1.OkrPeriod.optional(),
     year: core.serialization.number().optional(),
     quarter: core.serialization.number().optional(),

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.6";
+export declare const SDK_VERSION = "0.2.1";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.1.6";
+exports.SDK_VERSION = "0.2.1";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@taktoria/sdk",
-        "X-Fern-SDK-Version": "0.1.6",
-        "User-Agent": "@taktoria/sdk/0.1.6",
+        "X-Fern-SDK-Version": "0.2.1",
+        "User-Agent": "@taktoria/sdk/0.2.1",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/okr/client/Client.d.mts

@@ -55,10 +55,12 @@ export declare class OkrClient {
      * @example
      *     await client.okr.createObjective({
      *         title: "Make onboarding effortless",
+     *         tags: ["onboarding"],
      *         year: 2026,
      *         quarter: 3,
      *         keyResults: [{
      *                 title: "Median time to first launch under 10 minutes",
+     *                 tags: ["activation"],
      *                 priority: "P1"
      *             }, {
      *                 title: "90% of new workspaces invite a second person",

package/dist/esm/api/resources/okr/client/Client.mjs

@@ -47,7 +47,7 @@ export class OkrClient {
     __listObjectives() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, quarter, teamId, ownerUserId, visibility, q, draft, archived, limit, cursor } = request;
+            const { year, quarter, teamId, ownerUserId, visibility, tag, q, draft, archived, limit, cursor } = request;
             const _queryParams = {
                 year,
                 quarter,
@@ -59,6 +59,7 @@ export class OkrClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                tag,
                 q,
                 draft,
                 archived,
@@ -154,10 +155,12 @@ export class OkrClient {
      * @example
      *     await client.okr.createObjective({
      *         title: "Make onboarding effortless",
+     *         tags: ["onboarding"],
      *         year: 2026,
      *         quarter: 3,
      *         keyResults: [{
      *                 title: "Median time to first launch under 10 minutes",
+     *                 tags: ["activation"],
      *                 priority: "P1"
      *             }, {
      *                 title: "90% of new workspaces invite a second person",
@@ -1184,7 +1187,7 @@ export class OkrClient {
     __getScorecard() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, teamId, priority, frame, mid } = request;
+            const { year, teamId, priority, tag, frame, mid } = request;
             const _queryParams = {
                 year,
                 teamId,
@@ -1194,6 +1197,7 @@ export class OkrClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                tag,
                 frame,
                 mid,
             };
@@ -2099,7 +2103,7 @@ export class OkrClient {
     __listMyObjectives() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, quarter, period, teamId, priority, includeTeams, q, sort, limit, cursor } = request;
+            const { year, quarter, period, teamId, priority, includeTeams, tag, q, sort, limit, cursor } = request;
             const _queryParams = {
                 year,
                 quarter,
@@ -2117,6 +2121,7 @@ export class OkrClient {
                     })
                     : undefined,
                 includeTeams,
+                tag,
                 q,
                 sort,
                 limit,
@@ -2223,7 +2228,7 @@ export class OkrClient {
     __browseObjectives() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, quarter, period, allPeriods, teamId, priority, q, sort, limit, cursor } = request;
+            const { year, quarter, period, allPeriods, teamId, priority, tag, q, sort, limit, cursor } = request;
             const _queryParams = {
                 year,
                 quarter,
@@ -2241,6 +2246,7 @@ export class OkrClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                tag,
                 q,
                 sort,
                 limit,
@@ -2339,7 +2345,7 @@ export class OkrClient {
     __listTeamScores() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, quarter, period, q, sort, onlyScored, limit, cursor } = request;
+            const { year, quarter, period, q, sort, onlyScored, tag, limit, cursor } = request;
             const _queryParams = {
                 year,
                 quarter,
@@ -2352,6 +2358,7 @@ export class OkrClient {
                 q,
                 sort,
                 onlyScored,
+                tag,
                 limit,
                 cursor,
             };
@@ -2448,7 +2455,7 @@ export class OkrClient {
     __getTeamOkrs(teamSlug_1) {
         return __awaiter(this, arguments, void 0, function* (teamSlug, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { year, quarter, period } = request;
+            const { year, quarter, period, tag } = request;
             const _queryParams = {
                 year,
                 quarter,
@@ -2458,6 +2465,7 @@ export class OkrClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                tag,
             };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);

package/dist/esm/api/resources/okr/client/requests/BrowseObjectivesRequest.d.mts

@@ -15,7 +15,12 @@ export interface BrowseObjectivesRequest {
     teamId?: string | string[];
     /** Only objectives holding a key result of this priority. */
     priority?: Taktoria.OkrPriority;
-    /** Words in titles, descriptions, key results, owners and teams. See Searching. */
+    /**
+     * Only objectives carrying this tag, or holding a key result that
+     * does. One word, matched whole; case and a leading `#` are ignored.
+     */
+    tag?: string;
+    /** Words in titles, descriptions, tags, key results, owners and teams. See Searching. */
     q?: string;
     /** `order` (the workspace's own, the default), `high` or `low` by score, unscored last. */
     sort?: string;

package/dist/esm/api/resources/okr/client/requests/GetScorecardRequest.d.mts

@@ -17,6 +17,11 @@ export interface GetScorecardRequest {
      * their cells rolled up from those key results alone.
      */
     priority?: Taktoria.OkrPriority;
+    /**
+     * Only objectives carrying this tag, or holding a key result that
+     * does. One word, matched whole; case and a leading `#` are ignored.
+     */
+    tag?: string;
     /** `annual`, or a quarter `1` to `4`. Every period when left out. */
     frame?: string | string[];
     /** `false` leaves out the mid-quarter columns. */

package/dist/esm/api/resources/okr/client/requests/GetTeamOkrsRequest.d.mts

@@ -8,4 +8,9 @@ export interface GetTeamOkrsRequest {
     year?: number;
     quarter?: number;
     period?: Taktoria.OkrPeriod;
+    /**
+     * Only objectives carrying this tag, or holding a key result that
+     * does. One word, matched whole; case and a leading `#` are ignored.
+     */
+    tag?: string;
 }

package/dist/esm/api/resources/okr/client/requests/ListMyObjectivesRequest.d.mts

@@ -18,7 +18,12 @@ export interface ListMyObjectivesRequest {
     priority?: Taktoria.OkrPriority;
     /** `false` for what is theirs in person only, not their teams'. */
     includeTeams?: boolean;
-    /** Words in titles, descriptions, key results, owners and teams. See Searching. */
+    /**
+     * Only objectives carrying this tag, or holding a key result that
+     * does. One word, matched whole; case and a leading `#` are ignored.
+     */
+    tag?: string;
+    /** Words in titles, descriptions, tags, key results, owners and teams. See Searching. */
     q?: string;
     /** `order` (the workspace's own, the default), `high` or `low` by score, unscored last. */
     sort?: string;

package/dist/esm/api/resources/okr/client/requests/ListObjectivesRequest.d.mts

@@ -16,7 +16,12 @@ export interface ListObjectivesRequest {
     teamId?: string;
     ownerUserId?: string;
     visibility?: Taktoria.OkrVisibility;
-    /** Search objectives by their title, description, key results' titles, owner's name and team's name, among those the caller may see (a private objective only by those allowed to see it). Every word must appear in one of those fields; case and accents are ignored; at most 100 characters and 8 words. See Searching under Errors and pagination. */
+    /**
+     * Only objectives carrying this tag, or holding a key result that
+     * does. One word, matched whole; case and a leading `#` are ignored.
+     */
+    tag?: string;
+    /** Search objectives by their title, description, tags, key results' titles, descriptions and tags, owner's name and team's name, among those the caller may see (a private objective only by those allowed to see it). Every word must appear in one of those fields; case and accents are ignored; at most 100 characters and 8 words. See Searching under Errors and pagination. */
     q?: string;
     /** `true` lists only drafts and `false` only what is published; left out, both. */
     draft?: boolean;

package/dist/esm/api/resources/okr/client/requests/ListTeamScoresRequest.d.mts

@@ -16,6 +16,12 @@ export interface ListTeamScoresRequest {
     sort?: string;
     /** `true` keeps only the teams with a score. */
     onlyScored?: boolean;
+    /**
+     * Only teams holding an objective that carries this tag, or a key
+     * result that does, each scored on those alone. One word, matched
+     * whole.
+     */
+    tag?: string;
     /** At most 100; 50 when left out. */
     limit?: number;
     cursor?: string;

package/dist/esm/api/resources/okr/types/CreateKeyResultRequest.d.mts

@@ -3,10 +3,15 @@ import type * as Taktoria from "../../../index.mjs";
  * Owners must be members and teams of the workspace; an id from anywhere
  * else is refused with a 422, and `details.unknown` names it: nobody is
  * dropped. The title is trimmed and never blank (at most 500
- * characters).
+ * characters). A description (at most 5000) and tags (at most 10, one
+ * word each, stored lowercase) are optional, as on an objective.
  */
 export interface CreateKeyResultRequest {
     title: string;
+    /** Optional; trimmed, blank meaning none, at most 5000 characters. */
+    description?: string;
+    /** Optional, at most 10: one word each, stored lowercase without a leading `#`. */
+    tags?: string[];
     /**
      * A first score, 0.0 to 1.0. It is recorded as a check-in by the
      * caller (a key's maker, for a key), as setting one later is.

package/dist/esm/api/resources/okr/types/CreateObjectiveRequest.d.mts

@@ -3,8 +3,12 @@ import type * as Taktoria from "../../../index.mjs";
  * The same rules as the dashboard's forms and the MCP server's tools:
  *
  * - `title` is trimmed, and a 422 if nothing is left (at most 500
- *   characters); `description` is trimmed, blank meaning none (at most
- *   5000).
+ *   characters); `description` is optional, trimmed, blank meaning
+ *   none (at most 5000).
+ * - `tags` are optional: at most 10, each one word of letters, digits,
+ *   `-` or `_`, at most 32 characters. They are stored lowercase, without
+ *   a leading `#`, each once; anything else is a 422 naming the tag in
+ *   `details.tag`.
  * - `year` is a fiscal year from 2000 to 2100, and `weight` from 0.01 to
  *   100: there is no weight of 0, which the rollup never treated as
  *   "not counted".
@@ -26,7 +30,10 @@ import type * as Taktoria from "../../../index.mjs";
 export interface CreateObjectiveRequest {
     /** Trimmed; never blank, at most 500 characters. */
     title: string;
+    /** Optional; trimmed, blank meaning none, at most 5000 characters. */
     description?: string;
+    /** Optional, at most 10: one word each, stored lowercase without a leading `#`. */
+    tags?: string[];
     period?: Taktoria.OkrPeriod;
     /** The fiscal year, 2000 to 2100. */
     year: number;

package/dist/esm/api/resources/okr/types/KeyResult.d.mts

@@ -8,6 +8,13 @@ export interface KeyResult {
     id: string;
     objectiveId: string;
     title: string;
+    /** What it means and how it is measured, if anybody said. Absent when none. */
+    description?: string;
+    /**
+     * Its tags, A to Z: free text, one lowercase word each (letters,
+     * digits, `-` and `_`), at most 10. Filter by one with `tag`.
+     */
+    tags: string[];
     /**
      * Google-style grade from 0.0 to 1.0, or absent until it has been
      * scored. 0.7 and up is delivered for an ambitious goal, 0.4 to 0.7

package/dist/esm/api/resources/okr/types/Objective.d.mts

@@ -7,6 +7,11 @@ export interface Objective {
     organizationId: string;
     title: string;
     description?: string;
+    /**
+     * Its tags, A to Z: free text, one lowercase word each (letters,
+     * digits, `-` and `_`), at most 10. Filter by one with `tag`.
+     */
+    tags: string[];
     period: Taktoria.OkrPeriod;
     /** The fiscal year, 2000 to 2100, named by the year its Q1 falls in. */
     year: number;

package/dist/esm/api/resources/okr/types/ScorecardKeyResultRow.d.mts

@@ -2,6 +2,9 @@ import type * as Taktoria from "../../../index.mjs";
 export interface ScorecardKeyResultRow {
     keyResultId: string;
     title: string;
+    description?: string;
+    /** Its tags, A to Z. */
+    tags: string[];
     priority?: Taktoria.OkrPriority;
     weight: number;
     cells: Record<string, Taktoria.ScorecardCell>;

package/dist/esm/api/resources/okr/types/ScorecardRow.d.mts

@@ -5,6 +5,9 @@ import type * as Taktoria from "../../../index.mjs";
 export interface ScorecardRow {
     objectiveId: string;
     title: string;
+    description?: string;
+    /** Its tags, A to Z. */
+    tags: string[];
     weight: number;
     timeframe: Taktoria.ScorecardTimeframe;
     /** Rolled up from its key results, by weight. */

package/dist/esm/api/resources/okr/types/UpdateKeyResultRequest.d.mts

@@ -5,10 +5,15 @@ import type * as Taktoria from "../../../index.mjs";
  * Anybody new on it must be a member or team of this workspace (a 422
  * naming them in `details.unknown`); an owner already on it who has
  * since left may stay. The title is trimmed and never blank; the weight
- * is 0.01 to 100.
+ * is 0.01 to 100. `tags` sent replace the ones it had, so `[]` removes
+ * them all.
  */
 export interface UpdateKeyResultRequest {
     title?: string;
+    /** Blank or `null` removes it. */
+    description?: string;
+    /** Replaces its tags; `[]` removes them all. */
+    tags?: string[];
     /**
      * A new score, 0.0 to 1.0, is recorded as a check-in with no note,
      * by the caller (a key's maker, for a key), and the activity feed

package/dist/esm/api/resources/okr/types/UpdateObjectiveRequest.d.mts

@@ -7,11 +7,15 @@ import type * as Taktoria from "../../../index.mjs";
  * as on create; the owner it already has may stay, even if they have
  * since left. The fields sent meet the same rules as on create: a title
  * trimmed and never blank, a year from 2000 to 2100, a weight from 0.01
- * to 100.
+ * to 100, tags one word each. `tags` sent replace the ones it had, so
+ * `[]` removes them all; left out, they stay.
  */
 export interface UpdateObjectiveRequest {
     title?: string;
+    /** Blank or `null` removes it. */
     description?: string;
+    /** Replaces its tags; `[]` removes them all. */
+    tags?: string[];
     period?: Taktoria.OkrPeriod;
     year?: number;
     quarter?: number;

package/dist/esm/serialization/resources/okr/types/CreateKeyResultRequest.d.mts

@@ -6,6 +6,8 @@ export declare const CreateKeyResultRequest: core.serialization.ObjectSchema<ser
 export declare namespace CreateKeyResultRequest {
     interface Raw {
         title: string;
+        description?: string | null;
+        tags?: string[] | null;
         score?: number | null;
         weight?: number | null;
         priority?: OkrPriority.Raw | null;

package/dist/esm/serialization/resources/okr/types/CreateKeyResultRequest.mjs

@@ -3,6 +3,8 @@ import * as core from "../../../../core/index.mjs";
 import { OkrPriority } from "./OkrPriority.mjs";
 export const CreateKeyResultRequest = core.serialization.object({
     title: core.serialization.string(),
+    description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()).optional(),
     score: core.serialization.number().optional(),
     weight: core.serialization.number().optional(),
     priority: OkrPriority.optional(),

package/dist/esm/serialization/resources/okr/types/CreateObjectiveRequest.d.mts

@@ -9,6 +9,7 @@ export declare namespace CreateObjectiveRequest {
     interface Raw {
         title: string;
         description?: string | null;
+        tags?: string[] | null;
         period?: OkrPeriod.Raw | null;
         year: number;
         quarter?: number | null;

package/dist/esm/serialization/resources/okr/types/CreateObjectiveRequest.mjs

@@ -6,6 +6,7 @@ import { OkrVisibility } from "./OkrVisibility.mjs";
 export const CreateObjectiveRequest = core.serialization.object({
     title: core.serialization.string(),
     description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()).optional(),
     period: OkrPeriod.optional(),
     year: core.serialization.number(),
     quarter: core.serialization.number().optional(),

package/dist/esm/serialization/resources/okr/types/KeyResult.d.mts

@@ -9,6 +9,8 @@ export declare namespace KeyResult {
         id: string;
         objectiveId: string;
         title: string;
+        description?: string | null;
+        tags: string[];
         score?: number | null;
         weight: number;
         priority: OkrPriority.Raw;

package/dist/esm/serialization/resources/okr/types/KeyResult.mjs

@@ -6,6 +6,8 @@ export const KeyResult = core.serialization.object({
     id: core.serialization.string(),
     objectiveId: core.serialization.string(),
     title: core.serialization.string(),
+    description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()),
     score: core.serialization.number().optional(),
     weight: core.serialization.number(),
     priority: OkrPriority,

package/dist/esm/serialization/resources/okr/types/Objective.d.mts

@@ -13,6 +13,7 @@ export declare namespace Objective {
         organizationId: string;
         title: string;
         description?: string | null;
+        tags: string[];
         period: OkrPeriod.Raw;
         year: number;
         quarter?: number | null;

package/dist/esm/serialization/resources/okr/types/Objective.mjs

@@ -10,6 +10,7 @@ export const Objective = core.serialization.object({
     organizationId: core.serialization.string(),
     title: core.serialization.string(),
     description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()),
     period: OkrPeriod,
     year: core.serialization.number(),
     quarter: core.serialization.number().optional(),

package/dist/esm/serialization/resources/okr/types/ScorecardKeyResultRow.d.mts

@@ -8,6 +8,8 @@ export declare namespace ScorecardKeyResultRow {
     interface Raw {
         keyResultId: string;
         title: string;
+        description?: string | null;
+        tags: string[];
         priority?: OkrPriority.Raw | null;
         weight: number;
         cells: Record<string, ScorecardCell.Raw>;

package/dist/esm/serialization/resources/okr/types/ScorecardKeyResultRow.mjs

@@ -5,6 +5,8 @@ import { ScorecardCell } from "./ScorecardCell.mjs";
 export const ScorecardKeyResultRow = core.serialization.object({
     keyResultId: core.serialization.string(),
     title: core.serialization.string(),
+    description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()),
     priority: OkrPriority.optional(),
     weight: core.serialization.number(),
     cells: core.serialization.record(core.serialization.string(), ScorecardCell),

package/dist/esm/serialization/resources/okr/types/ScorecardRow.d.mts

@@ -9,6 +9,8 @@ export declare namespace ScorecardRow {
     interface Raw {
         objectiveId: string;
         title: string;
+        description?: string | null;
+        tags: string[];
         weight: number;
         timeframe: ScorecardTimeframe.Raw;
         cells: Record<string, ScorecardCell.Raw>;

package/dist/esm/serialization/resources/okr/types/ScorecardRow.mjs

@@ -6,6 +6,8 @@ import { ScorecardTimeframe } from "./ScorecardTimeframe.mjs";
 export const ScorecardRow = core.serialization.object({
     objectiveId: core.serialization.string(),
     title: core.serialization.string(),
+    description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()),
     weight: core.serialization.number(),
     timeframe: ScorecardTimeframe,
     cells: core.serialization.record(core.serialization.string(), ScorecardCell),

package/dist/esm/serialization/resources/okr/types/UpdateKeyResultRequest.d.mts

@@ -6,6 +6,8 @@ export declare const UpdateKeyResultRequest: core.serialization.ObjectSchema<ser
 export declare namespace UpdateKeyResultRequest {
     interface Raw {
         title?: string | null;
+        description?: string | null;
+        tags?: string[] | null;
         score?: number | null;
         weight?: number | null;
         priority?: OkrPriority.Raw | null;

package/dist/esm/serialization/resources/okr/types/UpdateKeyResultRequest.mjs

@@ -3,6 +3,8 @@ import * as core from "../../../../core/index.mjs";
 import { OkrPriority } from "./OkrPriority.mjs";
 export const UpdateKeyResultRequest = core.serialization.object({
     title: core.serialization.string().optional(),
+    description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()).optional(),
     score: core.serialization.number().optional(),
     weight: core.serialization.number().optional(),
     priority: OkrPriority.optional(),

package/dist/esm/serialization/resources/okr/types/UpdateObjectiveRequest.d.mts

@@ -8,6 +8,7 @@ export declare namespace UpdateObjectiveRequest {
     interface Raw {
         title?: string | null;
         description?: string | null;
+        tags?: string[] | null;
         period?: OkrPeriod.Raw | null;
         year?: number | null;
         quarter?: number | null;

package/dist/esm/serialization/resources/okr/types/UpdateObjectiveRequest.mjs

@@ -5,6 +5,7 @@ import { OkrVisibility } from "./OkrVisibility.mjs";
 export const UpdateObjectiveRequest = core.serialization.object({
     title: core.serialization.string().optional(),
     description: core.serialization.string().optional(),
+    tags: core.serialization.list(core.serialization.string()).optional(),
     period: OkrPeriod.optional(),
     year: core.serialization.number().optional(),
     quarter: core.serialization.number().optional(),

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.6";
+export declare const SDK_VERSION = "0.2.1";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.1.6";
+export const SDK_VERSION = "0.2.1";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@taktoria/sdk",
-    "version": "0.1.6",
+    "version": "0.2.1",
     "private": false,
     "type": "commonjs",
     "main": "./dist/cjs/index.js",

package/reference.md

@@ -7633,10 +7633,12 @@ under the name of whoever made the key.
 ```typescript
 await client.okr.createObjective({
     title: "Make onboarding effortless",
+    tags: ["onboarding"],
     year: 2026,
     quarter: 3,
     keyResults: [{
             title: "Median time to first launch under 10 minutes",
+            tags: ["activation"],
             priority: "P1"
         }, {
             title: "90% of new workspaces invite a second person",