{"record":{"id":"3c34bdcc38f6ab96","repo":"deepseek-ai/deepseek-harness","slug":"session-reference-invalid-reference","errorCode":"SESSION_REFERENCE_INVALID_REFERENCE","errorMessage":"candidate limit must be a positive safe integer","messagePattern":"candidate limit must be a positive safe integer","errorType":"validation","errorClass":"SessionReferenceError","httpStatus":null,"severity":"error","filePath":"packages/context/session-reference/src/index.ts","lineNumber":165,"sourceCode":"    return prepared.flat()\n  }\n\n  /**\n   * List reference candidates, ranked by working-directory affinity.\n   * @param agent - target agent; self is excluded and its cwd drives ranking.\n   * @param query - optional case-insensitive session-id/cwd/title substring.\n   * @param limit - optional positive result cap.\n   * @param signal - optional cancellation boundary for host autocomplete teardown.\n   * @returns candidates labeled by latest title or, when absent, session id.\n   */\n  async listCandidates(\n    agent: Agent,\n    query: string = '',\n    limit: number = this.config.candidateLimit,\n    signal?: AbortSignal,\n  ): Promise<SessionReferenceCandidate[]> {\n    if (!Number.isSafeInteger(limit) || limit <= 0) {\n      throw new SessionReferenceError('candidate limit must be a positive safe integer', 'SESSION_REFERENCE_INVALID_REFERENCE')\n    }\n    const needle = query.toLocaleLowerCase()\n    const targetCwd = agent.session.header.cwd\n    assertNotCancelled(signal)\n    const records = (await settleWithCancellation(this.ctx.sessionQuery.listSessions(signal), signal))\n      .filter(record => record.header.id !== agent.id)\n      .map((record, index) => ({ record, index }))\n    const inspected = needle === ''\n      ? records\n        .sort((a, b) => candidateRank(a.record.header.cwd, targetCwd) - candidateRank(b.record.header.cwd, targetCwd)\n          || a.index - b.index)\n        .slice(0, limit)\n      : records\n    const observations = await settleWithCancellation(\n      this.ctx.sessionQuery.readTitleSnapshots(inspected.map(({ record }) => record.header.id), signal),\n      signal,\n    )\n    return inspected.map(({ record, index }, observationIndex) => {","sourceCodeStart":147,"sourceCodeEnd":183,"githubUrl":"https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/packages/context/session-reference/src/index.ts#L147-L183","documentation":"Error \"candidate limit must be a positive safe integer\" thrown in deepseek-ai/deepseek-harness.","triggerScenarios":"Thrown at packages/context/session-reference/src/index.ts:165 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set the candidate limit to a positive safe integer."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"b150a551b8d465e31e418e1b2eaf5e79bbb7d28e","analyzedAt":"2026-08-24T18:12:29.105Z","schemaVersion":2},"datasetVersion":"2026-08-24T22:17:12.610Z"}