@taktoria/sdk 0.1.5 → 0.2.0

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.5",
-        "User-Agent": "@taktoria/sdk/0.1.5",
+        "X-Fern-SDK-Version": "0.2.0",
+        "User-Agent": "@taktoria/sdk/0.2.0",
         "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",
@@ -2135,7 +2138,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 +2156,7 @@ class OkrClient {
                     })
                     : undefined,
                 includeTeams,
+                tag,
                 q,
                 sort,
                 limit,
@@ -2259,7 +2263,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 +2281,7 @@ class OkrClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                tag,
                 q,
                 sort,
                 limit,

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/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/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/MetricSourceKind.d.ts

@@ -6,5 +6,10 @@ export declare const MetricSourceKind: {
     /**
      * OKR Hub fetches it from an https address on a schedule. */
     readonly Pull: "PULL";
+    /**
+     * OKR Hub reads a project's progress, as a percentage from 0 to 100,
+     * on a schedule from a ticketing system the workspace has connected,
+     * such as a Linear project. */
+    readonly Ticketing: "TICKETING";
 };
 export type MetricSourceKind = (typeof MetricSourceKind)[keyof typeof MetricSourceKind];

package/dist/cjs/api/resources/okr/types/MetricSourceKind.js

@@ -10,4 +10,9 @@ exports.MetricSourceKind = {
     /**
      * OKR Hub fetches it from an https address on a schedule. */
     Pull: "PULL",
+    /**
+     * OKR Hub reads a project's progress, as a percentage from 0 to 100,
+     * on a schedule from a ticketing system the workspace has connected,
+     * such as a Linear project. */
+    Ticketing: "TICKETING",
 };

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/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/MetricSourceKind.d.ts

@@ -3,5 +3,5 @@ import * as core from "../../../../core/index.js";
 import type * as serializers from "../../../index.js";
 export declare const MetricSourceKind: core.serialization.Schema<serializers.MetricSourceKind.Raw, Taktoria.MetricSourceKind>;
 export declare namespace MetricSourceKind {
-    type Raw = "WEBHOOK" | "PULL";
+    type Raw = "WEBHOOK" | "PULL" | "TICKETING";
 }

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

@@ -36,4 +36,4 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetricSourceKind = void 0;
 const core = __importStar(require("../../../../core/index.js"));
-exports.MetricSourceKind = core.serialization.enum_(["WEBHOOK", "PULL"]);
+exports.MetricSourceKind = core.serialization.enum_(["WEBHOOK", "PULL", "TICKETING"]);

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/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.5";
+export declare const SDK_VERSION = "0.2.0";

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.5";
+exports.SDK_VERSION = "0.2.0";

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.5",
-        "User-Agent": "@taktoria/sdk/0.1.5",
+        "X-Fern-SDK-Version": "0.2.0",
+        "User-Agent": "@taktoria/sdk/0.2.0",
         "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",
@@ -2099,7 +2102,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 +2120,7 @@ export class OkrClient {
                     })
                     : undefined,
                 includeTeams,
+                tag,
                 q,
                 sort,
                 limit,
@@ -2223,7 +2227,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 +2245,7 @@ export class OkrClient {
                         omitUndefined: true,
                     })
                     : undefined,
+                tag,
                 q,
                 sort,
                 limit,

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/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/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/MetricSourceKind.d.mts

@@ -6,5 +6,10 @@ export declare const MetricSourceKind: {
     /**
      * OKR Hub fetches it from an https address on a schedule. */
     readonly Pull: "PULL";
+    /**
+     * OKR Hub reads a project's progress, as a percentage from 0 to 100,
+     * on a schedule from a ticketing system the workspace has connected,
+     * such as a Linear project. */
+    readonly Ticketing: "TICKETING";
 };
 export type MetricSourceKind = (typeof MetricSourceKind)[keyof typeof MetricSourceKind];

package/dist/esm/api/resources/okr/types/MetricSourceKind.mjs

@@ -7,4 +7,9 @@ export const MetricSourceKind = {
     /**
      * OKR Hub fetches it from an https address on a schedule. */
     Pull: "PULL",
+    /**
+     * OKR Hub reads a project's progress, as a percentage from 0 to 100,
+     * on a schedule from a ticketing system the workspace has connected,
+     * such as a Linear project. */
+    Ticketing: "TICKETING",
 };

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/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/MetricSourceKind.d.mts

@@ -3,5 +3,5 @@ import * as core from "../../../../core/index.mjs";
 import type * as serializers from "../../../index.mjs";
 export declare const MetricSourceKind: core.serialization.Schema<serializers.MetricSourceKind.Raw, Taktoria.MetricSourceKind>;
 export declare namespace MetricSourceKind {
-    type Raw = "WEBHOOK" | "PULL";
+    type Raw = "WEBHOOK" | "PULL" | "TICKETING";
 }

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

@@ -1,3 +1,3 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../../../core/index.mjs";
-export const MetricSourceKind = core.serialization.enum_(["WEBHOOK", "PULL"]);
+export const MetricSourceKind = core.serialization.enum_(["WEBHOOK", "PULL", "TICKETING"]);

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/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.5";
+export declare const SDK_VERSION = "0.2.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.1.5";
+export const SDK_VERSION = "0.2.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@taktoria/sdk",
-    "version": "0.1.5",
+    "version": "0.2.0",
     "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",